Track the fixed PhotoCraft source baseline with the existing native client integration. Use the actual Pi SDK for normal sends, durable session recovery, demand-loaded enterprise rules and checked undoable canvas tools. Retain request identities and never resend unknown inference. Include local packaging and real-call acceptance evidence.
14 KiB
Pi Agent 本地验证记录 · 2026-10-21
本文保留首次探索的实际现场。后续已完成当前模型的标准函数调用、真实规则导入和两次重启复验,最新结论见 后续兼容修复验收。原未知请求仍保持未知,没有重发。
结论
主要机制已经通过真实模型与原生画布验证,但尚未达到整体稳定验收。Pi 继续作为候选,不在本轮确定最终架构,也不替换正式客户端的 Agent 发送入口。
长历史、事实更正、跨进程恢复、规则注入、自编工具和原生画布命令可以连通。当前98k调用协议仍有缺口:原生函数调用未验收通过;显式JSON兼容试验中多次出现不完整指令。首次重启恢复成功,但后续复验失败,不能据此承诺「始终不忘事」。
正式店铺/品类目录尚未接入。本轮用清晰标记的QA规则检查绑定与隔离;画布测试显式采用仓库中顾家规范草案,未将其冒充实时企业知识库。
本轮仅改本地代码和验收副本;没有 Git 提交、推送、部署或线上数据修改。生产素材平台仅复用既有鉴权和公开只读目录;模型只调用98k对外API,未读取98k源码、数据库或服务器。
实现范围
原生 PhotoCraft 保持 Rust / egui / wgpu,未引入 Electron、WebView 或网页UI。新增同级目录 apps/detail-agent-pi 作为本机 Node 验证宿主,不把JS加入PhotoCraft的Rust工作区。
| 部分 | 本次实现 |
|---|---|
| Pi 宿主 | @earendil-works/pi-coding-agent、pi-ai、pi-agent-core 固定为1.3.0,实际使用SDK会话和工具循环 |
| 历史 | SDK JSONL完整记录、手动压缩、证据化事实更正、历史原文检索;账号/项目/品牌版本/店铺/品类隔离 |
| 98k | 原生 jiansun_pi.rs 复用个人Key、模型目录、账号检查、公开接口和既有无重试HTTP客户端 |
| 凭据 | Key仍在Windows系统凭据库;不传入Node、模型、生成工具、项目文件或命令行 |
| 自编工具 | QuickJS WASM 0.32.0,JSON输入输出;8MB内存、256KB栈、约200ms中断期限;不注入宿主文件/网络/终端/凭据能力 |
| 工具版本 | 3~12项自测通过才保存不可变版本;实际执行重新核验哈希 |
| 画布 | 读取、现有文字层修改、位移和受限属性修改,全部通过现有原生编辑队列,共享手工撤销历史 |
| 并发 | proper-lockfile 4.1.2保护同一项目;宿主操作串行;SDK Core可等待事件保证工具与状态顺序 |
| 接手 | 原生按钮和手工编辑使旧操作许可失效,后续工具拒绝写入;下一个模型步骤在本机停止 |
| 失联 | 心跳丢失约10秒解除忙碌,保留已有草稿;不宣称能取消已经派发的远端推理 |
全部模型测试沿用用户当时选择的 grok-4.7 和本人Key,未擅自切模型。不能推断其他候选模型具有相同表现。SDK成本字段为未配置价格的0占位,不能视为免费、实扣金额或未重复收费的证明。
实际验收与证据
证据根目录:output/pi-validation-20261021/,其中 structured-json/ 是明确选择JSON兼容协议的独立试验。accepted-*只证明该次断言通过;失败记录保留,不能把后续局部成功覆盖为整体成功。
| 检查 | 实际结果 | 证据 |
|---|---|---|
| 事实与更正 | 真实调用记录编号QA-PI-7316、1100×550×720毫米;颜色米白色更正为胡桃色,旧事实不继续使用 | structured-json/accepted-memory.json、accepted-long.json |
| 长历史 | 100条会话消息中包含80条明确标注的压力夹具;真实模型仍找回编号、最新颜色、尺寸及历史标记松石-9052 | structured-json/accepted-long.json |
| 压缩 | SDK手动压缩完成;本地估算13292→2615 tokens,原文仍保存在会话树 | structured-json/accepted-compact.json |
| 跨进程恢复 | 退出并重开Node宿主后,真实模型找回事实、QA-A店/书桌和规则口令;该次用了7个模型回合 | structured-json/accepted-restart.json |
| 恢复复验 | 检索工具成功,但最终JSON不完整,本次未通过;没有偷偷执行残缺指令 | structured-json/failed-restart-recall-1792586575693.json |
| 规则注入与隔离 | A店/书桌使用晨雾-2168;B店/餐椅真实调用返回海盐-7391,未混入A店编号与历史标记 | structured-json/accepted-restart.json、accepted-shop.json |
| 自写工具 | 模型反复修正尺寸格式化工具,最终10项自测全过,额外独立检查null、非法字符串、数值溢出、正常厘米换算均通过 | structured-json/accepted-tool-hardening.json、generated-tool-summary.json |
| 实时画布 | 1440×12337的五屏样张,原生右侧Agent展示流式文字及工具步骤;首屏图层16「实木电脑桌」改为「温润质感」,再右移12px | structured-json/accepted-canvas-finish.json、pi-canvas-after.png |
| 原生接手按钮 | 在真实下一次 canvas_edit 执行前点击界面上的接手按钮;写入被拒绝、所有图层不变,下一模型步骤本机结束,没有额外POST |
structured-json/accepted-handover.json、pi-handover.png |
| 撤销与重做 | 实际撤销两步/重做两步,图层元数据精确还原;其他图层不变;Noto Sans SC及112.01399993896484pt字号不变 | structured-json/real-model-undo-redo.json、pi-undo-redo.png |
| 保存并重开 | 保存自有QA副本并重新打开原生客户端;宽高、修改后文字、字体再次核对一致;重开后的历史为Open,不声称跨重启保留撤销栈 | structured-json/pi-local-final.png、canvas/pi-1440-local.pcraft |
| 原响应恢复 | 超时后从98k GET取得留存SSE,恢复一个只读画布步骤;0次生成重发、0次画布写入 | structured-json/recovered-original-sse.json |
100条消息不等于100轮真人对话,也不等于百轮真实付费调用。Token数是SDK本地估算,未验收模型对100K窗口的承诺;元数据中的窗口值仅供试验预算使用。
画布首次双步骤测试在完成改字后收到残缺JSON,未自动重试;之后明确的新指令仅读取当前画布并补完位移。不是一个全程无故障的单轮结果。素材和模板为既有验收样张,本轮未新生成产品图,也未验收商业详情页的整体设计质量。
工具由模型编写,不是预埋实现
尺寸工具的源码来自模型 tool_develop,经多次失败反馈后修正;随后模型实际调用 tool_run。最终输出为「长1200 × 宽600 × 高750 mm」。
- 最终不可变版本:
3eb65e07a111e68d6cbcfe65636d14472bc68cbcbb5e58bebdd576e985a2b0e2。 - 10项自测包含空值、缺字段、毫米/厘米换算、舍入、非法单位、字符串、零、负值和过大值。
- 验收脚本另用未交给模型的检查输入核对结果。不能仅以模型自己写的测试作为正确性证明。
- 原样提取源码:
structured-json/generated-format-dimensions.js;没有替模型改写实现。 - 这验证了受限纯计算工具的生成/测试/版本调用,不是任意操作系统工具、终端或文件访问能力的验收。
真实品牌与QA规则的边界
本轮正式账号访问 GET /api/desktop/catalog/brands 未取到目录,返回「资源不存在或无权访问」。不能据此断定后台没有部署;能确认的是本账号当前没有取得该数据。
随后通过显式准备脚本选取仓库 lib/detail-generator/knowledge/enterprise-20261013.json 中的顾家草案,用于画布测试;没有静默降级。来源版本为 enterprise-web-20261013.1,状态draft,文件哈希保存在 structured-json/rule-source-manifest.json。
店铺与品类的QA-A店/书桌、QA-B店/餐椅及检索口令都是验收夹具。已证明精确绑定、快照与隔离机制,尚未证明公司的真实店铺/品类规则实时接入。缺失组合直接拒绝,不套用其他店铺规则。
协议与异常恢复
原生函数调用没有通过
native-tools按Pi标准函数调用编码;当前选择的模型有一次只在普通文字中描述调用,未产生结构化工具指令,该文字未被执行。另一次强制函数调用后响应未完整取得,结果未知。不能把这些表现直接归因于模型本身或98k内部线路;当前证据不足以定位内部原因。
structured-json是明确选择的兼容试验,不是失败后的自动兜底。只将完整JSON转换为Pi类型化工具调用,仍经SDK参数、沙箱和原生版本检查;普通文字、残缺JSON、未知工具及输出截断均不能触发工具。已跑通的核心功能主要来自这条试验路径,仍出现多次格式失败,不能当成最终稳定协议。
仍保持未知的原请求
| 字段 | 值 |
|---|---|
| 创建时间 | 2026-10-21 19:05:24(UTC+8) |
| 模型 | grok-4.7 |
| 本地请求/幂等键 | 0447b17b-1c45-4902-a6a5-18357a3e2a3f |
| 98k客户请求号 | 9dd3eebf-3b86-46c8-ac9e-3e4bb33c959b |
| 公开结果查询 | GET https://api.vip98k.com/api/external/requests/9dd3eebf-3b86-46c8-ac9e-3e4bb33c959b/result |
| 核查结果 | 410 result_not_retained;仍未知,不等同于失败 |
| 处理 | 保留记录,不重发;该项目的新模型步骤继续被拦截。实际执行结果、计费均未获确认 |
其余不同协议/店铺/画布试验是不同的新任务,没有用新项目号重做上述未知的强制调用。未知请求的结果仍须由98k只读核查,本文不要求提供Key或重新生成。
已取回的另一笔请求
画布会话请求 d1c9021d-32b0-4b1e-80c6-f561b62b9859 原连接约180秒中断;客户请求号 6800f412-fda4-44fa-adf5-37f0191136d1。GET取回完整留存SSE,包含结束标记。
修复了两项本地问题:恢复器接受原始SSE并交给Pi原协议解析器;查询响应自身的 x-request-id 单独保存,不覆盖原客户请求号。恢复后此笔已是complete,不能继续列为未知。pending-readonly.json仅为较早时间的历史现场,当前状态以原生请求日志和 recovered-original-sse.json 为准。
只读恢复经SDK检查补回一个 canvas_read 结果,未请求新推理、未修改画布。重复恢复不追加已完成消息、不重复执行工具。若取回的是修改建议但缺少执行证据,则存入待核对列表,不自动重放画布操作;其用户界面尚未实现。
每次POST前先落盘请求身份;SDK重试和HTTP重试均关闭。410保留未知;完整但无效的JSON记为本轮失败,保留原响应与此前已完成的编辑,不拿自动重发掩盖错误。
本地回归
| 检查 | 结果 |
|---|---|
apps/detail-agent-pi · npm test |
16/16;包含真实SDK驱动的假传输协议测试、历史重启、结果未知门禁、只读SSE恢复、接手及工具隔离,不冒充真实API验收 |
原生定向测试 cargo test -p photocraft -p photocraft-ui-egui --lib --bins jiansun |
主程序34通过、2既有测试忽略;UI18通过,共52通过 |
严格Clippy:两包 --all-targets -- -D warnings |
通过;构建脚本仍提示本地exe图标/版本资源未编译,不宣称零构建提示 |
cargo xtask layers |
31个crate层级检查通过 |
cargo xtask wasm |
涉及的L0~L6编译通过;既有engine dead-code警告保留 |
| 原生构建与重开 | 本地debug构建通过;重新打开自有QA文件复核通过 |
最终定向测试日志:native-tests-final.log、native-clippy-final.log。未改引擎命令定义、PSD编解码、像素格式或字体引擎,没有把本轮结果扩称为全仓库/所有格式验收。
界面审查
按Impeccable的Operate工作台要求保留现有原生UI,没有增加说明面板或重做视觉。实际1440×900窗口检查了流式回复、工具步骤、接手按钮及结果反馈;原生界面截图与编辑结果均为实际运行取得。
残缺JSON原始语法错误已改为可读提示:「模型指令未完整返回,本轮建议未执行;已完成的改动已保留」。历史截图里的旧错误为真实现场,不抹除。没有移动端或网页UI改动,也未声称完成屏幕阅读器、全客户端或跨设备验收。
资源与后续接入边界
Pi进程、会话检索、工具沙箱、画布渲染、编辑和本机保存都在用户电脑。生产素材平台继续负责权限与只读目录/素材;推理在98k服务执行。客户端本地化不等于服务器零开销,也未进行10人并发或内存上限测试。
正常客户端发送入口仍沿用原Agent;Pi通过验证脚本连接本机可信控制通道展示真实操作。不能在未切换入口的情况下告诉用户「现在整个客户端已经是Pi」。控制通道不向模型或自编工具暴露。
在决定架构前,至少还需:
- 让既有98k适配的标准函数调用稳定通过,并确认未知原请求;暂不依赖会反复返回残缺JSON的兼容试验作为正式协议。
- 查清本账号正式品牌目录不可用的原因,接入真实店铺/品类规则、权限与版本;保留旧项目快照。
- 重新验收压缩后多次跨进程恢复、限制检索循环及长历史延迟;当前单次成功和后续失败都须保留。
- 再接正常客户端入口、正式项目身份和恢复UI,随后验证图像/像素工具、全创作链路、云端会话与跨设备恢复。
本轮没有验收生图、分层PSD/Photoshop、全部模型、完整新建项目流程、客户端分发包或商业页面质量。
实现依据:Pi SDK、Pi会话格式、QuickJS WASM。实际API使用以本机固定版本源码与回归结果为准。