docs: 记录 PikaPython 固定执行节点

This commit is contained in:
pikastech
2026-07-21 13:17:02 +02:00
parent 55acea225d
commit 3dd5256fa1
2 changed files with 18 additions and 6 deletions
+4 -6
View File
@@ -31,11 +31,7 @@
- 任务提交语义进入 `master` 后,必须立即核查并清理对应 worktree 和已合并本地分支; - 任务提交语义进入 `master` 后,必须立即核查并清理对应 worktree 和已合并本地分支;
- 存在未提交修改、未吸收提交或语义不确定时禁止强行清理; - 存在未提交修改、未吸收提交或语义不确定时禁止强行清理;
-`master` 开发、语义合并和 worktree 清理由 `docs/reference/devops-hygiene.md` 约束。 -`master` 开发、语义合并和 worktree 清理由 `docs/reference/devops-hygiene.md` 约束。
- P0: Master server 构建规则: - P0: 构建执行面遵循 `docs/reference/dev-environment.md`;通用重型构建默认使用 NC01Master server 仅执行轻量操作和受控例外。
- 禁止通用 Docker/Rust/Go/前端重型构建;
- 通用镜像构建和重型验证默认使用 NC01;
- 只有 D601 自有流水线、运行面或硬件 lane 明确要求时才使用 D601;
- 执行面和受控例外见 `docs/reference/dev-environment.md`
- P0: Agent 指令体积规则: - P0: Agent 指令体积规则:
- `AGENTS.md` 硬上限 10 KiB,只保留损害预防规则和索引; - `AGENTS.md` 硬上限 10 KiB,只保留损害预防规则和索引;
- 文档修改先加载 `$docs-spec` - 文档修改先加载 `$docs-spec`
@@ -126,7 +122,9 @@
- HWLAB 固定使用 NC01/v03 - HWLAB 固定使用 NC01/v03
- AgentRun 固定使用 NC01/nc01-v02 - AgentRun 固定使用 NC01/nc01-v02
- 具体规则分别见 `docs/reference/hwlab.md``docs/reference/agentrun.md` - 具体规则分别见 `docs/reference/hwlab.md``docs/reference/agentrun.md`
- P0: 构建执行面和工作区边界见 `docs/reference/dev-environment.md`;通用构建默认使用 NC01Master server 仅执行轻量操作和受控例外。 - P0: PikaPython V2 固定执行面:
- route/workspace 为 `D601-VM-HOST:/home/ubuntu/workspace/pika_workspace`
- `D601-VM` 只是目标 ID,不是 `trans` route;不得改用 `D601`
- P0: 控之星、CONSTAR、71-FILTER、71-FREQ、PLC 项目及 PLC 控制器相关任务的固定工作区: - P0: 控之星、CONSTAR、71-FILTER、71-FREQ、PLC 项目及 PLC 控制器相关任务的固定工作区:
- 透传路由:`G14-WSL:win/d/Work/CONSTAR_workspace` - 透传路由:`G14-WSL:win/d/Work/CONSTAR_workspace`
- Windows 路径:`D:\Work\CONSTAR_workspace` - Windows 路径:`D:\Work\CONSTAR_workspace`
+14
View File
@@ -71,6 +71,20 @@ trans D601:/home/ubuntu/workspace/unidesk-dev git remote -v
固定 workspace 只作为 source truth 预检、fetch、受控 worktree 创建和最终同步入口。实际开发、文档修改、测试补丁和 PR 准备应在固定 repo 下的独立 worktree 中完成,例如 `/home/ubuntu/workspace/unidesk-dev/.worktree/<task>`;该 worktree 必须通过 `bun scripts/cli.ts dev-env worktree add .worktree/<task> --branch <branch> --from origin/master` 从最新 `origin/master` 创建,让 `.worktreecopy` 中声明的本地配置白名单自动复制到新 worktree。使用任务专属分支或 detached worktree 隔离当前改动,结束前用 `git status` 确认只包含本任务文件。不要把 `/home/ubuntu/workspace/unidesk-dev` 根目录当作并行任务 scratch 区,也不要复用其他任务遗留 worktree。 固定 workspace 只作为 source truth 预检、fetch、受控 worktree 创建和最终同步入口。实际开发、文档修改、测试补丁和 PR 准备应在固定 repo 下的独立 worktree 中完成,例如 `/home/ubuntu/workspace/unidesk-dev/.worktree/<task>`;该 worktree 必须通过 `bun scripts/cli.ts dev-env worktree add .worktree/<task> --branch <branch> --from origin/master` 从最新 `origin/master` 创建,让 `.worktreecopy` 中声明的本地配置白名单自动复制到新 worktree。使用任务专属分支或 detached worktree 隔离当前改动,结束前用 `git status` 确认只包含本任务文件。不要把 `/home/ubuntu/workspace/unidesk-dev` 根目录当作并行任务 scratch 区,也不要复用其他任务遗留 worktree。
## D601-VM-HOST PikaPython 工作区
- PikaPython V2 的固定执行 route/workspace 是
`D601-VM-HOST:/home/ubuntu/workspace/pika_workspace`
- `D601-VM` 是目标和 Provider ID,不是 `trans` route`D601` 是另一节点,
两者均不得替代 `D601-VM-HOST` 执行该项目的构建、测试或 benchmark。
- 固定 workspace 保持 `master`,通过仓库 CLI 执行测试和 benchmark;根目录中的
`.worktree/` 属于任务隔离目录,状态检查和同步时必须保留。
- 进入任务或上下文恢复后的首个只读检查为:
```bash
trans D601-VM-HOST:/home/ubuntu/workspace/pika_workspace git status --short --branch
```
- Master server 不作为 UniDesk 重型验证机: - Master server 不作为 UniDesk 重型验证机:
- 默认执行面是 NC01、CI runner 或目标运行面; - 默认执行面是 NC01、CI runner 或目标运行面;
- 重型验证包括仓库级 check 和 Playwright/browser smoke - 重型验证包括仓库级 check 和 Playwright/browser smoke