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
+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。
## 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 重型验证机:
- 默认执行面是 NC01、CI runner 或目标运行面;
- 重型验证包括仓库级 check 和 Playwright/browser smoke