diff --git a/Troubleshooting.md b/Troubleshooting.md
index 0843593..d59208c 100644
--- a/Troubleshooting.md
+++ b/Troubleshooting.md
@@ -50,3 +50,16 @@
 
 自动测试不访问真实摄像头或未授权网络。PostgreSQL、MediaMTX、目标浏览器与实验室摄像机的联合验证必须在获准部署环境完成。
 <!-- sense-mvp:end -->
+
+<!-- sense-windows-package:start -->
+## Sense Windows 打包与启动排错
+
+| 现象 | 检查与处理 |
+|---|---|
+| 打包提示 Go/Node/pnpm 版本不符 | 对照根 `goadmin-baseline.json` 安装精确版本，并把 Go 1.26.5 放到 `PATH` 首位；不要修改脚本绕过版本检查。 |
+| 生产启动提示缺少环境变量 | 在运行包外设置 `SENSE_DATABASE_URL`、`SENSE_IDENTITY_SIGNING_KEY`、`SENSE_BOOTSTRAP_TOKEN`、`SENSE_CREDENTIAL_KEY`；启动脚本不会读取示例文件。 |
+| 本机健康检查被代理返回空响应 | localhost 可能被 `HTTP_PROXY` 接管；测试工具应对 `127.0.0.1` 使用 no-proxy，再检查 `SENSE_HTTP_ADDRESS` 端口占用。 |
+| 页面可打开但视频不可用 | Windows 运行包不包含 MediaMTX；按包内说明配置独立 MediaMTX 二进制、配置和 Control API。 |
+
+`demo` 只用于临时查看。生产数据持久性、真实设备和媒体链路不能用 demo 验证替代。
+<!-- sense-windows-package:end -->