docs: 固化 CONSTAR 固定工作区例外

2026-07-10 17:43:21 +02:00
parent 7593b7afde
commit 92686ff213
2 changed files with 3 additions and 0 deletions
@@ -78,6 +78,8 @@ When diagnosing a missing worktree file, first classify ownership. A tracked fil

 允许不创建新 `.worktree` 的场景包括 P1 只读探测、运行面临时热补、上述文档/skill/长期参考轻量修改，或目标项目长期参考明确声明的直接修改例外。例外必须能解释为什么不会污染 fixed repo source truth，并且不得触碰无关并行修改；一旦需要写源码、配置、issue closeout、部署脚本、验收产物或其他高风险交付记录，立即切回独立 `.worktree`。

+CONSTAR、控之星、71-FILTER、71-FREQ、PLC 项目和 PLC 控制器任务是目标项目明确声明的直接修改例外。固定入口为 `G14-WSL:win/d/Work/CONSTAR_workspace`，Windows 路径为 `D:\Work\CONSTAR_workspace`；这些任务直接在该固定主 worktree 及其嵌套项目仓库工作，不创建任务 `.worktree`。开始前仍须核对目标仓库分支和 remote 对齐状态，保留全部既有并行修改，只精确提交当前任务文件，禁止用 reset、覆盖式 checkout 或删除清理他人改动。该例外不扩展到 `/root/unidesk` 或其他未明确列出的固定仓库。
+
 When UniDesk's own CLI, wrapper or controlled toolchain is repaired, merge the durable fix into `master` before relying on it for the original operation. The checkout that actually executes the tool must then contain that merged revision. If a fixed checkout cannot fast-forward because of unrelated changes, preserve it and run the tool from a clean worktree based on current `origin/master`; never reset or overwrite concurrent work to update the executable path.

 在模型 provider、API provider、硬件链路、跨平台 bridge、CLI/trans/tran 或高频工具链问题上，判定外部 blocker 前仍需完成 UniDesk 的防误判核查：确认当前 runtime config / Secret key presence / env / proxy / NO_PROXY / endpoint / args，使用实际目标运行面复现，并尽量与 UniDesk/HWLAB 成熟实现对照。用户反馈或新证据推翻 blocker 判断时，立即切回 `$dad-dev` 的现场修复闭环。