v1.7.2 — 管理台进安装器

管理台进安装器：setup.ps1 装完就和手动配好的一样 —— 桌面两个快捷方式「DeepSeek Harness」+「dsh 管理台」。

• %LOCALAPPDATA%\dsh-cloud\ 里多放 8 个文件：console.ps1 / console.bat，以及它调用的 status / doctor / audit / update / uninstall / cloud-setup.sh（管理台按同目录找这些脚本，必须放一起）
• 取文件顺序：本地这份 install\ 里有就直接拷（clone 下来跑的场合），只有一份 setup.ps1 时按 raw.githubusercontent 取；某个没拿到会 ! 提示并把桌面快捷方式回退成「更新 dsh」，重跑一次即可补上
• 老机器上已有的「更新 dsh」快捷方式不动（doctor 两个名字都认）
• %LOCALAPPDATA%\dsh-cloud\icons\dsh.ico 存在时快捷方式会带上该图标（仓库里不带图标文件）
• 文档同步到 1.7.2 口径：README 中/英、docs/lifecycle、docs/directory-layout、docs/security-model（中英）与 install/README.md

完整说明见 CHANGELOG.md。

v1.7.1 — console launcher fix

[1.7.1] - 2026-09-29

修一个我自己引入的启动器 bug（v1.7.0 里）：

• install/console.bat 只会找同目录的 console.ps1，而旧机器上那份叫 dsh-console.ps1，
  于是双击报 The argument ... console.ps1 to the -File parameter does not exist
• 现在按 console.ps1 → dsh-console.ps1 的顺序找，两个名字都能用；
  两个都找不到时打印"把 kit 的 install/console.ps1 拷到同目录"并停下来，而不是抛一段 PowerShell 报错
• 你机器上现在是这样：outputs\console.ps1（真正的面板）+ outputs\dsh-console.bat（启动器，
  桌面快捷方式指的就是它）

v1.6.0 — English docs + GitHub Pages

[1.6.0] - 2026-09-29

英文版 + 文档站（GitHub Pages）。

• 英文文档全套：README.en.md + docs/en/（index / doctor / lifecycle / security-model /
  auto-sync / plugins / troubleshooting / ai-prompt / ai-runbook / macos-linux / directory-layout /
  cloud-scripts），中文文档顶部都加了 English version 链接
• GitHub Pages：https://wz2-z.github.io/dsh-codespaces-kit/（中文首页）
  与 https://wz2-z.github.io/dsh-codespaces-kit/en/（English）
  —— docs/_config.yml 里启用 jekyll-relative-links，文档之间的相对链接在网页上也能点
• 中文 docs/ 与英文 docs/en/ 保持同样的结构，方便对照

v1.5.1 — 界面美化

[1.5.1] - 2026-09-29

界面统一成"框线 + 颜色"的一套观感（Windows 控制台里也正常，不需要 Windows Terminal）：

• status 顶部加了框线标题（版本 + Codespace），下面每行左边一条竖线，
  状态列按显示宽度对齐（中文算两格，不再错位）；时间改成本地化的"39 分钟前"
• 本机的管理台改成用 PowerShell 画界面（dsh-console.ps1），菜单项同样按显示宽度对齐，
  .bat 只留一行启动器 —— 也顺手避开了 .bat 里 CRLF / chcp 那两个坑
• status / doctor / audit 三份输出的状态色统一：绿=好、黄=要留意、红=坏了

v1.4.2 — Launcher 检查放宽 + 断链检测

[1.4.2] - 2026-09-29

doctor 的 Launcher 那一项太死板：只认 更新 dsh.lnk，所以把「更新 / 同步 / 体检」
合并成一个「dsh 管理台」之后，它报 只有 DeepSeek Harness，缺 更新 dsh。

• 启动入口仍必须有；维护入口改成 dsh 管理台 或 更新 dsh 任一即可
  （dsh 同步 / dsh 体检 算可选项）
• 新增：解析每个快捷方式的 TargetPath，指向的 .bat 不在了就报 warn（挪过目录会撞上）

v1.3.0 — sync 插件 + 桌面控制台

[1.3.0] - 2026-09-29

自动同步有"看得见"的控制面了：一个 dsh 插件 + 一个 Windows 桌面控制台。

新插件 plugins/dsh-sync-panel/（独立包，不属于 codespace-panel）

• dsh 侧边栏底部多一个同步按钮，点开是一个面板：模式、是否暂停、守护进程在不在跑、
  待提交文件、最近一次提交、折叠窗口、~/dsh-sync.log 的尾巴
• 面板上直接操作：立即提交 / 暂停 / 恢复 / 切换 idle|interval|manual / 折叠窗口开或关
• 两条 EXACT 路由（/sync-panel/summary、/sync-panel/action）都要求自定义请求头
  x-sync-panel: 1；Host 半边不碰 git 凭据、不碰 API Key，只是代跑 sync.sh
• 隔离测试：客户端半边 10 项（假 React/假 ctx 跑 apply）、Host 半边 17 项（真机跑真实 .dsh-cloud）

Windows 桌面控制台

• outputs/同步控制台.bat + 桌面快捷方式「dsh 同步」：状态、立即提交、暂停/恢复、
  切模式、折叠窗口开关、看日志 —— 不用开终端（.bat 内容是纯 ASCII，避免中文变 ????）

其他

• 控制面在哪写进了 docs/auto-sync.md（命令 / sync.conf / 日志 / 面板）
• 修正一处文档错误：sync.conf 在持久卷上，不在仓库里，换电脑要重设

v1.2.4 — 重跑安装器后重建守护进程

[1.2.4] - 2026-09-29

• 重跑安装器后会重建同步守护进程：sync.sh / start.sh 是被覆盖重写的，
  而正在运行的那个 bash 可能还停在旧文件的字节偏移上。现在重写脚本后先停掉旧进程，
  再由 start.sh 拉起新的（真机上重复安装三次才暴露出来的）
• 顺带：安装器输出的"配置自动同步"一节会告诉你它保留了已有的 sync.conf

v1.1.1 — 安装器修复

[1.1.1] - 2026-09-29

一个真机跑出来的安装器问题 + 一个顺手升级问题。

• 不再"顺手升级" dsh：原来只按 PATH 判断有没有装过，而 Codespaces 里 dsh 常常在
  ~/.nvm/versions/node/v22.x.y/bin/，非交互 SSH 的 PATH 里没有它 —— 结果安装器又装了一份新版。
  现在优先沿用正在运行的那个 dsh 的运行时，其次在常见 nvm 前缀里找已装好的，
  真的没有才安装。实测：从"又装了一个 0.2.0-rc.2"变成"沿用它原来的 0.1.7-rc.2"。
• deploy key 能自动登记了：非交互 SSH 会话里 gh 没登录，登记必然失败。
  现在会从 /workspaces/.codespaces/shared/.env 读 Codespace 自带的平台令牌，
  只 export 到环境变量（不打印、不落盘）后调用 API；仍然失败才提示你手动加。

v1.0.0 — 一键安装 + 文档拆分

[1.0.0] - 2026-09-29

第一个正式版本：把"照着文档手搓"变成"跑一个脚本"。

一键安装

• install/cloud-setup.sh —— 云端 8 步流水线：检查 GitHub CLI → 检查 Codespace → 检查 Node →
  安装 dsh → 配置 workspace → 生成 deploy key → 配置自动同步 → 验证，
  幂等、支持 --dry-run，结束打印 ✅ Installation complete
• install/setup.ps1（Windows）/ install/setup.sh（macOS、Linux）—— 本机侧：
  便携版 gh → 一次浏览器授权 → 选取或新建 Codespace → 把云端脚本送进容器执行 →
  建隧道验证 → 放桌面启动器
• 三个云端脚本（start.sh / update.sh / sync.sh）改由 cloud-setup.sh 生成，
  带 Node 路径与仓库信息，容器重建后重跑一次即可

文档结构

• 主 README 从 514 行压到 187 行，只回答"我要做哪几步"
• 拆出 docs/：任务书、技术细节、云端脚本、插件、macOS/Linux、目录结构
• 新增 docs/troubleshooting/：按 Windows / SSH / Codespaces / dsh 分类，
  每个坑都写成「现象 → 原因 → 解法」

其他

• 新增版本号（本文件 + VERSION）
• 仓库结构与许可说明整理进 README 末尾