docs: document worktree web dependency setup
This commit is contained in:
@@ -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 作为发布真相。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user