mirrors/pikasTech-unidesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add AgentRun v0.1 workspace

Browse Source
This commit is contained in:
Codex
2026-05-29 00:44:19 +00:00
parent 35a512e9a9
commit 3d5e613674
2 changed files with 26 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference/agentrun.md
+24 -4
View File
@@ -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 区。
## 部署目标