From 3dd5256fa14706291a899b8a5b87a4a0a8ae9f5f Mon Sep 17 00:00:00 2001 From: pikastech Date: Tue, 21 Jul 2026 13:17:02 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20PikaPython=20?= =?UTF-8?q?=E5=9B=BA=E5=AE=9A=E6=89=A7=E8=A1=8C=E8=8A=82=E7=82=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 10 ++++------ docs/reference/dev-environment.md | 14 ++++++++++++++ 2 files changed, 18 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 50af9c3f..119a6cf0 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -31,11 +31,7 @@ - 任务提交语义进入 `master` 后，必须立即核查并清理对应 worktree 和已合并本地分支； - 存在未提交修改、未吸收提交或语义不确定时禁止强行清理； - 非 `master` 开发、语义合并和 worktree 清理由 `docs/reference/devops-hygiene.md` 约束。 -- P0: Master server 构建规则： - - 禁止通用 Docker/Rust/Go/前端重型构建； - - 通用镜像构建和重型验证默认使用 NC01； - - 只有 D601 自有流水线、运行面或硬件 lane 明确要求时才使用 D601； - - 执行面和受控例外见 `docs/reference/dev-environment.md`。 +- P0: 构建执行面遵循 `docs/reference/dev-environment.md`；通用重型构建默认使用 NC01，Master server 仅执行轻量操作和受控例外。 - P0: Agent 指令体积规则： - `AGENTS.md` 硬上限 10 KiB，只保留损害预防规则和索引； - 文档修改先加载 `$docs-spec`； @@ -126,7 +122,9 @@ - HWLAB 固定使用 NC01/v03； - AgentRun 固定使用 NC01/nc01-v02； - 具体规则分别见 `docs/reference/hwlab.md` 和 `docs/reference/agentrun.md`。 -- P0: 构建执行面和工作区边界见 `docs/reference/dev-environment.md`；通用构建默认使用 NC01，Master 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 控制器相关任务的固定工作区： - 透传路由：`G14-WSL:win/d/Work/CONSTAR_workspace`； - Windows 路径：`D:\Work\CONSTAR_workspace`。 diff --git a/docs/reference/dev-environment.md b/docs/reference/dev-environment.md index eba6285a..07f3f0ab 100644 --- a/docs/reference/dev-environment.md +++ b/docs/reference/dev-environment.md @@ -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/`；该 worktree 必须通过 `bun scripts/cli.ts dev-env worktree add .worktree/ --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；