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

docs: update agentrun v0.1 worktree rule

Browse Source
This commit is contained in:
Codex
2026-05-29 03:11:37 +00:00
parent 5b01dad112
commit 95918b05e6
2 changed files with 18 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+5 -5
View File
@@ -48,12 +48,12 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文
- P0: `hyueapi.com` / `.hyueapi.com` 是 Codex API 通道的直连域名，必须始终保留在 `NO_PROXY` / `no_proxy` 中；DeepSeek、Codex API 或其他 provider profile 切换、G14 proxy 注入、旧 D601 egress 迁移和 pod/env render 都不得把 hyueapi 流量改成走 HTTP/SOCKS proxy。
## Critical AgentRun Workspace Rule
## Critical AgentRun Worktree Rule
- P0: `pikasTech/agentrun` 是新的共享 Agent 执行基础设施仓库，不是现有 Code Queue 的就地替换；默认 source truth 是 G14 节点 `/root/agentrun`，固定使用 `master` 分支和 `origin git@github.com:pikasTech/agentrun.git`。
- 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: `pikasTech/agentrun` 是新的共享 Agent 执行基础设施仓库，不是现有 Code Queue 的就地替换；`v0.1` source truth 是 G14 节点固定 source worktree `G14:/root/agentrun-v01`，固定使用 `v0.1` 分支和 `origin git@github.com:pikasTech/agentrun.git`。
- P0: AgentRun `v0.1` 开发必须先预检 `G14:/root/agentrun-v01` 的路径、分支、remote 和 clean 状态，再在 `/root/agentrun-v01/.worktree/{pr_branch}` 创建独立 worktree 修改；不要把固定 source worktree、UniDesk、HWLAB、D601 或临时 clone 当作 AgentRun scratch 区。
- P0: AgentRun 废弃旧 `dev/prod` 运行口径；`v0.1` 固定部署目标是 `G14:k3s` 上的 `agentrun-v01` namespace，后续按 `v0.1`、`v0.2`、`v0.3` lane 滚动。
- P0: 所有 AgentRun k3s 操作必须使用 route 语法 `G14:k3s`，UniDesk 侧只维护 AgentRun 的开发和部署运维约束，细则见 `docs/reference/agentrun.md`。
- P0: AgentRun 的文档、issue、PR、review 和交付说明一律中文；代码标识符、API path、配置键、命令和必要英文专有名词可保留英文，解释性文字必须中文。
## Critical G14 HWLAB Workspace Rule
docs/reference/agentrun.md
+13 -35
View File
@@ -2,7 +2,7 @@
本文只记录 UniDesk 侧对独立仓库 `pikasTech/agentrun` 的开发与运维约束。AgentRun 的架构设计、MVP 范围、API 契约、runner/backend 协议和运行时内部规则必须维护在 AgentRun 仓库自身，不能放在 UniDesk 长期参考里作为事实来源。
## 仓库与 Workspace
## 仓库与 Worktree
AgentRun 唯一长期仓库是：
@@ -10,32 +10,13 @@ AgentRun 唯一长期仓库是：
git@github.com:pikasTech/agentrun.git
```
G14 主线固定 workspace 是：
```text
G14:/root/agentrun
```
该目录必须固定使用 `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'
```
期望状态：
- 当前路径是 `/root/agentrun`；
- 首次推送后分支是 `master...origin/master`；
- `origin` 是 `git@github.com:pikasTech/agentrun.git`；
- 固定 workspace clean。
G14 `v0.1` 固定 workspace 是：
AgentRun 当前 `v0.1` 固定 source worktree 是：
```text
G14:/root/agentrun-v01
```
该目录必须固定使用 `v0.1` 分支，`origin` 必须是 `git@github.com:pikasTech/agentrun.git`，并保持 clean。任何明确面向 `v0.1` 的 UniDesk/HWLAB 基础 Code Agent 调用服务开发、文档修改、部署观察或恢复中断后，先通过 UniDesk SSH 透传执行：
该目录必须固定使用 `v0.1` 分支，`origin` 必须是 `git@github.com:pikasTech/agentrun.git`，并保持 clean。任何明确面向 UniDesk/HWLAB 基础 Code Agent 调用服务 `v0.1` 的开发、文档修改、部署观察或恢复中断后，先通过 UniDesk SSH 透传执行：
```bash
tran G14:/root/agentrun-v01 script -- 'pwd; git status --short --branch; git remote -v'
@@ -44,37 +25,34 @@ tran G14:/root/agentrun-v01 script -- 'pwd; git status --short --branch; git rem
期望状态：
- 当前路径是 `/root/agentrun-v01`；
- 首次推送后分支是 `v0.1...origin/v0.1`；
- 分支是 `v0.1...origin/v0.1`；
- `origin` 是 `git@github.com:pikasTech/agentrun.git`；
- 固定 workspace clean。
- 固定 source worktree 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。
如果固定 source worktree 缺失、dirty、分支不对或 remote 不对，必须先修正，再继续工作。不得把 `/root/agentrun` 主线历史目录、`/root/unidesk`、`/root/hwlab`、D601 workspace、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun `v0.1` source truth。
## Worktree 规则
固定 workspace 只用于预检、fetch、worktree 管理和最终同步。常规 AgentRun 功能、文档和部署修改必须使用独立 worktree：
固定 source worktree 只用于预检、fetch、worktree 管理和最终同步。常规 AgentRun `v0.1` 功能、文档和部署修改必须使用独立 worktree：
```text
G14:/root/agentrun/.worktree/{pr_branch}
G14:/root/agentrun-v01/.worktree/{pr_branch}
```
主线 worktree 必须从最新 `origin/master` 创建，`v0.1` worktree 必须从最新 `origin/v0.1` 创建。任务分支只覆盖当前变更，提交时只提交当前任务相关文件。不要把 `/root/agentrun` 或 `/root/agentrun-v01` 根目录当作并行任务 scratch 区。
`v0.1` worktree 必须从最新 `origin/v0.1` 创建。任务分支只覆盖当前变更，提交时只提交当前任务相关文件。不要把 `/root/agentrun-v01` 根目录当作并行任务 scratch 区。
## 部署目标
AgentRun 默认部署目标是 G14 原生 k3s namespace：
AgentRun 废弃旧 `dev/prod` 运行口径。`v0.1` 固定部署目标是 G14 原生 k3s namespace：
```text
G14:k3s namespace agentrun_dev
G14:k3s namespace agentrun_prod
G14:k3s namespace agentrun-v01
```
所有 k3s 操作必须使用 UniDesk route 语法：
```bash
tran G14:k3s kubectl get pods -n agentrun_dev
tran G14:k3s kubectl get pods -n agentrun_prod
tran G14:k3s kubectl get pods -n agentrun-v01
```
不得把临时 NodePort、host port、pod IP、provider-gateway 业务 HTTP proxy 或一次性 port-forward 固化为 AgentRun 部署路径。任何公网入口、UniDesk/HWLAB 集成入口或跨服务访问路径，都必须先通过 AgentRun 仓库内经过审查的变更引入；UniDesk 只在后续记录对应运维入口。
@@ -83,9 +61,9 @@ tran G14:k3s kubectl get pods -n agentrun_prod
UniDesk 是 AgentRun 的综合分布式开发和运维中心。UniDesk 可以记录：
- AgentRun 的固定仓库、workspace 和 worktree 规则；
- AgentRun 的固定仓库、source worktree 和 worktree 规则；
- G14 预检、route 语法和远程操作入口；
- 默认 DEV/PROD namespace；
- `v0.1` 固定 namespace 与后续版本 lane 规则；
- 部署观察、受控 rollout 和运维入口；
- AgentRun 仓库定义公共契约后，UniDesk 与 HWLAB 如何接入。