docs: suffix nc01 workspaces by lane

This commit is contained in:
Codex
2026-07-09 09:49:45 +02:00
parent 8de8ac3691
commit e9457ace4a
7 changed files with 37 additions and 17 deletions
+6 -6
View File
@@ -13,32 +13,32 @@ git@github.com:pikasTech/agentrun.git
AgentRun 当前固定 source worktree 是:
```text
NC01:/root/agentrun
NC01:/root/agentrun-v02
```
该目录必须固定跟踪当前 NC01 lane 声明的 AgentRun source branchremote 必须符合 `config/agentrun.yaml#controlPlane.lanes.nc01-v02.source.remote`,并保持 clean。任何 AgentRun 开发、文档修改、部署观察或恢复中断后,先通过 UniDesk SSH 透传执行:
```bash
trans NC01:/root/agentrun sh -- 'pwd; git status --short --branch; git remote -v'
trans NC01:/root/agentrun-v02 sh -- 'pwd; git status --short --branch; git remote -v'
```
期望状态:
- 当前路径是 `/root/agentrun`
- 当前路径是 `/root/agentrun-v02`
- 分支和 remote 与 `config/agentrun.yaml` 的 NC01 lane 声明一致;
- 固定 source worktree clean。
如果固定 source worktree 缺失、dirty、分支不对或 remote 不对,必须先修正,再继续工作。不得把非 NC01 workspace、`/root/unidesk``/root/hwlab`、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun source truth。
如果固定 source worktree 缺失、dirty、分支不对或 remote 不对,必须先修正,再继续工作。不得把非 NC01 workspace、`/root/unidesk``/root/hwlab-v03`、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun source truth。
## Worktree 规则
固定 source worktree 只用于预检、fetch、worktree 管理和最终同步。常规 AgentRun `v0.2` 功能、文档和部署修改必须使用独立 worktree:
```text
NC01:/root/agentrun/.worktree/{pr_branch}
NC01:/root/agentrun-v02/.worktree/{pr_branch}
```
任务 worktree 必须从 NC01 lane 声明的最新 source branch 创建。任务分支只覆盖当前变更,提交时只提交当前任务相关文件。不要把 `/root/agentrun` 根目录当作并行任务 scratch 区。
任务 worktree 必须从 NC01 lane 声明的最新 source branch 创建。任务分支只覆盖当前变更,提交时只提交当前任务相关文件。不要把 `/root/agentrun-v02` 根目录当作并行任务 scratch 区。
## 文档落库规则