docs: add AgentRun v0.1 workspace

2026-05-29 00:44:19 +00:00
parent 35a512e9a9
commit 3d5e613674
2 changed files with 26 additions and 5 deletions
@@ -51,7 +51,8 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文
 ## Critical AgentRun Workspace Rule

 - P0: `pikasTech/agentrun` 是新的共享 Agent 执行基础设施仓库，不是现有 Code Queue 的就地替换；默认 source truth 是 G14 节点 `/root/agentrun`，固定使用 `master` 分支和 `origin git@github.com:pikasTech/agentrun.git`。
- P0: AgentRun 开发必须先预检 `G14:/root/agentrun` 的路径、分支、remote 和 clean 状态，再在 `/root/agentrun/.worktree/{pr_branch}` 创建独立 worktree 修改；不要把固定 repo、UniDesk、HWLAB、D601 或临时 clone 当作 AgentRun scratch 区。
+- P0: AgentRun `v0.1` 固定工作区是 `G14:/root/agentrun-v01`，固定使用 `v0.1` 分支和 `origin git@github.com:pikasTech/agentrun.git`；明确面向 UniDesk/HWLAB 基础 Code Agent 调用服务 `v0.1` 的任务必须使用该工作区。
+- P0: AgentRun 开发必须按目标分支先预检对应固定工作区的路径、分支、remote 和 clean 状态，再在对应 `.worktree/{pr_branch}` 创建独立 worktree 修改；不要把固定 repo、UniDesk、HWLAB、D601 或临时 clone 当作 AgentRun scratch 区。
 - P0: AgentRun 默认部署目标是 `G14:k3s` 上的 `agentrun_dev` 与 `agentrun_prod` namespace；所有 k3s 操作必须使用 route 语法 `G14:k3s`，UniDesk 侧只维护 AgentRun 的开发和部署运维约束，细则见 `docs/reference/agentrun.md`。
 - P0: AgentRun 的文档、issue、PR、review 和交付说明一律中文；代码标识符、API path、配置键、命令和必要英文专有名词可保留英文，解释性文字必须中文。

@@ -10,13 +10,13 @@ AgentRun 唯一长期仓库是：
 git@github.com:pikasTech/agentrun.git
 ```

-G14 固定 workspace 是：
+G14 主线固定 workspace 是：

 ```text
 G14:/root/agentrun
 ```

-该目录必须固定使用 `master` 分支，`origin` 必须是 `git@github.com:pikasTech/agentrun.git`，并保持 clean。每次开始 AgentRun 开发、部署、文档修改、恢复中断或上下文压缩后，先通过 UniDesk SSH 透传执行：
+该目录必须固定使用 `master` 分支，`origin` 必须是 `git@github.com:pikasTech/agentrun.git`，并保持 clean。每次开始 AgentRun 主线开发、部署、文档修改、恢复中断或上下文压缩后，先通过 UniDesk SSH 透传执行：

 ```bash
 tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote -v'
@@ -29,7 +29,26 @@ tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote
 - `origin` 是 `git@github.com:pikasTech/agentrun.git`；
 - 固定 workspace clean。

-如果 workspace 缺失、dirty、分支不对或 remote 不对，必须先修正，再继续工作。不得把 `/root/unidesk`、`/root/hwlab`、D601 workspace、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun source truth。
+G14 `v0.1` 固定 workspace 是：
+
+```text
+G14:/root/agentrun-v01
+```
+
+该目录必须固定使用 `v0.1` 分支，`origin` 必须是 `git@github.com:pikasTech/agentrun.git`，并保持 clean。任何明确面向 `v0.1` 的 UniDesk/HWLAB 基础 Code Agent 调用服务开发、文档修改、部署观察或恢复中断后，先通过 UniDesk SSH 透传执行：
+
+```bash
+tran G14:/root/agentrun-v01 script -- 'pwd; git status --short --branch; git remote -v'
+```
+
+期望状态：
+
+- 当前路径是 `/root/agentrun-v01`；
+- 首次推送后分支是 `v0.1...origin/v0.1`；
+- `origin` 是 `git@github.com:pikasTech/agentrun.git`；
+- 固定 workspace clean。
+
+如果 workspace 缺失、dirty、分支不对或 remote 不对，必须先修正，再继续工作。不得把 `/root/unidesk`、`/root/hwlab`、D601 workspace、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun source truth。不得把 `master` 主线 workspace 和 `v0.1` workspace 混用；任务明确指向 `v0.1` 时只能以 `G14:/root/agentrun-v01` 为固定 workspace。

 ## Worktree 规则

@@ -37,9 +56,10 @@ tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote

 ```text
 G14:/root/agentrun/.worktree/{pr_branch}
+G14:/root/agentrun-v01/.worktree/{pr_branch}
 ```

-Worktree 必须从最新 `origin/master` 创建，任务分支只覆盖当前变更，提交时只提交当前任务相关文件。不要把 `/root/agentrun` 根目录当作并行任务 scratch 区。
+主线 worktree 必须从最新 `origin/master` 创建，`v0.1` worktree 必须从最新 `origin/v0.1` 创建。任务分支只覆盖当前变更，提交时只提交当前任务相关文件。不要把 `/root/agentrun` 或 `/root/agentrun-v01` 根目录当作并行任务 scratch 区。

 ## 部署目标