docs: add agentrun operations reference

2026-05-27 07:26:21 +00:00
parent fc7902f709
commit d7ebed6ced
2 changed files with 84 additions and 0 deletions
@@ -42,6 +42,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
+
+- 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 默认部署目标是 `G14:k3s` 上的 `agentrun_dev` 与 `agentrun_prod` namespace；所有 k3s 操作必须使用 route 语法 `G14:k3s`，UniDesk 侧只维护 AgentRun 的开发和部署运维约束，细则见 `docs/reference/agentrun.md`。
+
 ## Critical G14 HWLAB Workspace Rule

 - P0: `G14:HWLAB` 是当前 HWLAB DEV/PROD source workspace 和 k3s/GitOps 运行面真相；唯一长期 source workspace 是 G14 节点上的 `/root/hwlab`，固定使用 `G14` 分支和 `origin git@github.com:pikasTech/HWLAB.git`；所有 HWLAB 新开发、文档、render、polling、CI/CD/GitOps 修复默认都必须以该目录和 G14 运行面为准。