PPanel
当前交付状态
PR112 已正常合并,发布main为 9d655203ae72e7eb78323e2279957d4b0995a6ad。产品代码、测试、扑克及冻结树与获准候选 7a1c0e21de39d991370d71c0bdfa3f18b789b079 相同;后续为发布文档增量。控制面A01–A12与扑克九项已由独立QA按明确证据范围核验通过,环境升级核验也已通过。扑克任务#102已completed,CR107、QA108、合入后QA109均pass,PR104合入5d260210。
当前代码实测为两端build/typecheck、后端31/31、适配故障20/20、扑克11/11。独立真实生命周期及适配语义复核通过;历史业务证据按未变路径映射,不冒称所有实验均在最终SHA重新执行。
环境负责人已核验:4498自主扑克闭环控制面、4497验收样本控制面、临时公网扑克。控制面只绑定loopback;扑克公网依赖本机4399源站与cloudflared存活,不是永久托管。配置/数据路径、管理凭据文件位置与恢复步骤见环境报告,不公开凭据内容。进程身份是取证时事实,运维前必须重新核对。
本地 Web 控制面:pi-agent SDK 编排开发、独立 CR、QA 与 Git 集成,Gitea 保存可读业务交流,SQLite 保存运行状态。后端监听 127.0.0.1:4380。
启动实际 Web 与后端
需要 Node 24、Git,以及已配置的 pi、opencode、codex CLI。Gitea 凭据从本机 Git credential helper 获取,不写入仓库、命令参数或前端配置。下面命令均从仓库根目录执行。
node --version
npm ci --prefix apps/server
npm ci --prefix apps/web
npm run typecheck
npm run build
npm start
浏览器打开 http://127.0.0.1:4380。生产方式由后端同时提供 apps/web/dist 和 /api,不需要另起静态服务器。必须先完成两端构建;根 npm start 只重新构建后端,不更新前端产物。根 build/typecheck 已覆盖两端,因此无需新增入口。
建议显式固定运行数据目录,避免不同启动目录产生不同数据库;例如从仓库根目录运行:
PPANEL_DATA="$PWD/.ppanel/control" npm start
npm start --prefix apps/server 的实际工作目录为 apps/server,未设置 PPANEL_DATA 时数据在 apps/server/.ppanel。数据包含 SQLite、任务独立 clone、会话与完整脱敏日志,不提交 Git。
开发模式使用两个终端,在根目录执行:
# 终端一:后端 4380
PPANEL_DATA="$PWD/.ppanel/control" npm start
# 终端二:Vite 4381,/api 代理到 4380
npm run dev --prefix apps/web
打开 http://127.0.0.1:4381。后端没有自动重编译监听,修改后端后需重启;前端由 Vite 热更新。隔离检查可使用 PPANEL_PORT=4488 PPANEL_DATA="$PWD/.ppanel/check" npm start,然后访问 http://127.0.0.1:4488;开发代理仍固定为 4380,隔离检查应使用生产页面。
在启动终端按 Ctrl-C 停止服务。关闭浏览器不会停止后台任务;停止控制面也不等于取消独立 supervisor。需要终止任务时先使用页面取消,再停止服务;保留原数据目录用于下次恢复,不删除运行数据来模拟取消。
默认模型配置只读加载 ~/.d-sre-agent/config/sre-agent.yaml,使用 D-SRE 的 llm.items 格式;模型映射参考其 packages/agent-core/src/model-provider/ 的配置语义,包括本地 provider ID、上游 model ID 和 OpenAI compat 参数。不复制其密钥或依赖整个参考项目。SDK 固定 0.85.0。
可通过本机环境调整:
| 环境变量 | 默认 |
|---|---|
PPANEL_MODEL_CONFIG |
~/.d-sre-agent/config/sre-agent.yaml |
PPANEL_DATA |
当前目录 .ppanel |
PPANEL_PORT |
4380 |
PPANEL_REPOSITORIES |
https://gitea.d-robotics.cc/peng01.guo/ppanel,逗号分隔允许列表 |
PPANEL_RUN_MINUTES |
15 |
PPANEL_TASK_MINUTES |
90 |
PPANEL_MAX_RUNS |
20 |
PPANEL_MAX_CORRECTIONS |
3 |
工作流程
通过 POST /api/tasks 提交 {title,goal,acceptance?,repository?,targetBranch?,modelId?},获得 HTTP 202。默认目标分支 mvp/acceptance,不存在则从 main 建立。运行期间可补充要求或取消,详情、原始事件和完整脱敏日志由契约 API 提供。
模型只能调用受限决定工具,不能编辑代码或执行测试。每次分派创建子 Issue、独立 clone 和 supervisor;最多两位执行者并行。角色报告通过 worker.js 从绑定会话发布,身份、revision 和 SHA 由服务校验。报告必须有中文正文与仓库证据链接。独立 CR/QA 同版本通过后合并;合入后 QA 通过才完成。
supervisor 独立于 HTTP 服务存活,保存 PID、启动身份、会话和日志。服务恢复会核对实际进程;未知身份标记 recovery_required。关闭浏览器无影响。取消先持久化,再请求运行进程停止。运行目录是协作隔离,不是操作系统安全沙箱。
冻结验收文件与升级
后端在首次开发前,从目标基线自动冻结已有测试/验收目录(如 tests/、e2e/)及 test_*、*.test.*、*.spec.* 文件。acceptance/ 可以包含被测业务实现,因此只按测试文件命名规则及验收文档(.md)、摘要清单(.sha256/.sha512)自动识别,不整目录冻结;显式声明仍优先保护。任务描述中“冻结/不可修改”后用反引号指定的基线文件也会纳入。对于不符合这些命名的验收程序,创建任务可附加 acceptanceFiles: ["checks/paging.py"];路径必须已存在于基线。新增项目尚不存在的测试不会被冒充为开发前冻结程序,正式验收样本必须先准备基线程序。
根 Issue 公布原始 blob、mode 和 SHA-256 清单摘要,worker 的 read 响应包含同一清单。清单不可被开发者报告、后续候选或目标分支前进覆盖。修改业务代码允许,修改、删除、改名、替换冻结文件会阻断开发通过报告、合并以及合入后 QA 分派。已有测试不能在原文件内增加断言,需新增测试文件;这是冻结样本的明确约束。
升级后不从普通事件表推断旧报告可信:活跃任务若缺少独立已发布 outbox 来源记录,会进入 recovery_required,不沿用旧评审合并。已完成历史记录保持原样。Codex 执行者使用已授权的 danger-full-access / never 配置以完成真实开发;这不提供 OS 沙箱隔离。
扑克项目运行
从完整独立Git clone根目录执行:
npm ci --prefix projects/agent-poker
npm run build --prefix projects/agent-poker
POKER_PORT=18439 POKER_DATA="$PWD/.ppanel/poker" node projects/agent-poker/server.mjs
根build/typecheck只覆盖控制面两端,不包含扑克。扑克依赖共享UI,不能只复制项目子目录;无独立Git边界、嵌在外层忽略目录的归档会改变Tailwind扫描结果。邀请、管理与持续运行说明见项目README。扑克模型加载器读取本机 /Users/pptg/.d-sre-agent/config/sre-agent.yaml,不使用控制面的配置覆盖变量。
验证
安装依赖后,从仓库根目录执行:
mkdir -p .ppanel/t
npm run typecheck
npm run build
TMPDIR="$PWD/.ppanel/t" npm test --prefix apps/server
TMPDIR="$PWD/.ppanel/t" node evidence/issue-19-3b47015/check-adapted.mjs "$PWD" all
npm run build --prefix projects/agent-poker
TMPDIR="$PWD/.ppanel/t" npm test --prefix projects/agent-poker
该序列对应后端31项、适配20项和扑克11项。短TMPDIR避免本机tsx IPC socket路径过长;若clone路径本身过长,应使用更短的独立clone路径。适配程序由c2cb4b9原样导入,保留所有原场景/断言,新增Git helper许可边界已独立复核。它包含明确受控故障,不代替真实模型/Gitea全链路证据。
前端额外回归可运行 npm test --prefix apps/web 和 npm run test:e2e --prefix apps/web。e2e使用真实Chrome但API为契约替身,并占用4380/4381,需先确认端口空闲。此文档修正未重新执行构建、模型或生命周期实验。
恢复与历史限制
升级前核对版本和进程身份,保留原PPANEL_DATA,不重发任务、改库或重置预算;条件不全仍为recovery_required。停止HTTP不等于取消独立supervisor。角色私有tmp和报告路径校验不是OS沙箱,未知身份不能盲目重派。详细机制见后端说明。
原 acceptance/control-plane/check.mjs 在新Git helper下历史实测18/20,旧spawn夹具不兼容;它原样保留,不是当前默认成功验证命令。原版失败、适配diff及结果见原始证据。旧Store条件注入21/4与3b独立原样25/25分别保留,不把历史改成全绿。
冻结样本以acceptance/FROZEN.v2.sha256六项为准,故意缺陷HTTP 8失败/2通过、浏览器5失败是预期历史基线。扑克原31项冻结绑定411/5d;当前后端测试保持受审3b,不回退去匹配旧blob。原#38/#72失败、OpenCode超时、pi退出143及旧预算均保留在Git/Gitea;当前说明不复写原始报告。