docs: document worktree web dependency setup

This commit is contained in:
lyon
2026-06-17 17:29:00 +08:00
parent 7434d891c0
commit a6f2430512
2 changed files with 2 additions and 0 deletions
+1
View File
@@ -129,6 +129,7 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥
## 常用轻量命令
- 静态合同校验:`npm run validate`
- Cloud Web worktree 依赖准备:`npm run worktree:deps`;新 `.worktree/<task>` 内需要 Web 检查时先复用固定 workspace 的共享依赖,`web:check``web:build` 会自动调用。
- Cloud Web 静态检查:`npm run web:check`
- Cloud Web 构建:`npm run web:build`
- Cloud Web M3 只读护栏:`npm run web:m3-readonly`
@@ -28,6 +28,7 @@
- G14 DEV/PROD、G14 v0.2 和其他 node/lane 的固定 workspace 只在任务明确选择对应 node/lane 时使用;不得把 `/root/hwlab``/root/hwlab-v02` 或旧 `hwlab-dev`/`hwlab-prod` 运行面写成所有 HWLAB 任务默认 scratch 区。
- CI/CD source commit 选择必须使用当前 node/lane 的受控 source repo 或 control-plane 自动 fetch 后的 commit-pinned detached worktree,不能因为人工开发 workspace dirty、stale 或存在 `.worktree/` 就阻塞或改变发布。
- 固定 repo 是 source truth 和 worktree 管理入口,不是并行任务 scratch 区;不要在固定 repo 根目录堆叠未提交改动,也不要复用其他任务遗留 `.worktree/<task>`
- D601 v0.3 新 `.worktree/<task>` 需要 Cloud Web 检查时,使用 `npm run worktree:deps` 准备共享 Web 依赖;`npm run web:check``npm run web:build` 会自动先执行该入口。该 helper 只复用固定 workspace 下 ignored 的 `.worktree/hwlab-cloud-web-deps`,不得提交 `node_modules`、dist、cache 或临时 lock 产物。
- D601 legacy 只指旧 DEV/CD、迁移对照和事故回放路径;D601 node-scoped runtime lane 不属于 legacy。
- 不要清理、reset 或复用无关 runner worktree 作为发布真相。