Add authenticated LAN access, native Claude execution, checkpoint and budget recovery, and signed POC build/deploy/rollback contracts. Include local service management, regression coverage, and evidence from the completed POC delivery.
4.9 KiB
本机 Claude 到 POC 交付验收
日期:2026-10-22,Asia/Shanghai。已完成本机网页 → Claude CLI → 独立验证 → Gitea poc → 现有 POC 部署链路。适用范围是可信协作者使用的本机开发模式,不提供不可信租户的操作系统级隔离。
入口与目标
- 本机:http://localhost:3000;当前局域网:http://172.20.10.5:3000。
- 项目:
DroboticFlow POC · Claude 本机。 - 登录信息:本机
.wishforge/local-access.json,0600,不进入版本库。 - 仓库:
https://gitea.d-robotics.cc/longtao.wu/droboticflow.git,固定poc分支。 - 目标:现有
droboticflownamespace,http://120.48.164.19。 - 后台服务:
cc.d-robotics.wishforge.local-poc用户 LaunchAgent,见 运维说明。
首次真实交付
| 字段 | 结果 |
|---|---|
| Run | f40620ef-d04c-4903-a7e9-0c81551b0830 |
| 愿望 | 系统状态检查时间、手动重试、失败保留旧值并标记过期、健康与版本差异分开显示 |
| 执行器 | 本机 Claude CLI 2.1.292,沿用本机授权 |
| 结果 | succeeded / accept,交付 accepted=true |
| 实际合入与发布源码 | 7613677dfe6412355f52319e3889d3d36d6f8817 |
| Release | 33959763-fd8a-4e65-9140-794d882486ea |
| API/Web 镜像 | sha256:28442975ba18e91261e6729b64f1d87b2e4ddabcd90e82b22ec1439c868c575b |
| Worker、Coordinator | 沿用核对过的原镜像,三个 Deployment 均就绪 |
| CLI 计量 | 该业务 run 两轮执行报告 1,466,304 Token,包含缓存创建/读取;不是货币账单 |
运行期间目标分支有其他提交,平台对实际合并 commit 重新验证,再推送、构建和发布。后续下载文档提交 f553e404 仍保留在分支中,发布版本明确指向上表的已验证 commit。
/api/health、/api/ready 的 buildCommit 与交付一致。既有 health.image 字段仍来自旧环境配置,本次没有覆盖该配置;镜像验收采用 Deployment/Pod 的真实 digest,不把旧字段当作运行镜像证明。
实际过程与修复
- 通过正式 adapter 验证本机 Claude 修改临时仓库、导出 checkpoint;固定 HTTPS 到 SSH 映射完成 Gitea 只读克隆。
- POC 基线通过类型检查、262 项前端测试、前端构建和 Go 测试。独立 Kaniko 预检成功,临时 Pod 已清理;未使用预检产物发布。
- 首次最终用量超过初始预算,暴露检查点保存顺序问题。恢复了该会话 18 次成功文件操作涉及的 5 个文件,逐一核对哈希并记录操作人恢复事件,没有伪造验证证据或重发愿望。
- 执行器已修复为先保存停止后的实现,再幂等结算最终用量;保存失败/取消保留工作区和恢复材料。流式/代理计量仍即时执行。
- 初次独立类型检查受平台父目录 React 类型污染;相同源码移到外部目录后通过。运行根目录现为
~/.local/share/wishforge/runs,禁止嵌套在平台源码内。错误归因产生的项目经验已停用,原失败证据保留。 - 同一 run 通过正式预算接口继续,原用量未清零。持久化检查点支持直接恢复验证,没有第三轮模型执行。
- 最终代码通过验证及合并 SHA 复验、构建、签名 Runner、POC rollout、组件与网页入口检查。
本次包含平台故障修复和操作人恢复,不是“首轮零人工干预”的结果。
浏览器验收
真实 Chrome 在局域网登录并只提交一次愿望;运行页最终显示已交付和正确 POC 链接。POC 的公开状态面板实际验证了手动检查的加载态、成功时间更新及版本差异独立显示。仅对测试浏览器断网后,旧值与成功时间保留并标记“数据已过期”;恢复网络后重试正常。没有登录组织或操作业务数据。
本机证据:
/private/tmp/wishforge-poc-delivery-summary.json/private/tmp/wishforge-first-poc-final.json/private/tmp/wishforge-first-poc-ui-submission.json/tmp/wishforge-real-delivery-completed.png/tmp/droboticflow-status-live-ready.png/tmp/droboticflow-status-browser-offline.png
回归与运行条件
主 Vitest 388 通过、17 个显式集成开关跳过;Provisioner 27 通过;全仓类型检查、正式网页构建和脚本契约测试通过。POC 人工回滚的独立恢复 manifest 回归通过,本次未对已交付版本执行真实人工回滚。
未配置公网隧道。电脑需保持运行并能访问 Gitea、模型服务和 POC 集群。CLI 最终用量在回合结束时上报,预算会阻止后续执行,但不能保证供应商逐请求实时硬上限;缓存读取计入额度。单次 POC 愿望默认 100 万 Token,可在等待/暂停时由管理员调整。
本地实验 operator 套餐采用单并发、每月 2000 万计量 Token,仍校验额度预留。设置不购买模型额度或扣款;实际费用或订阅限制由本机 Claude 账号决定。