gongxiangp2/docs/pi-agent-local-validation-2026-10-21.md
WuYongJie 1b6425b552 feat(desktop): connect native Pi sessions with scoped rules and recovery
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.
2026-10-22 10:49:58 +08:00

14 KiB
Raw Blame History

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」。控制通道不向模型或自编工具暴露。

在决定架构前,至少还需:

  1. 让既有98k适配的标准函数调用稳定通过,并确认未知原请求;暂不依赖会反复返回残缺JSON的兼容试验作为正式协议。
  2. 查清本账号正式品牌目录不可用的原因,接入真实店铺/品类规则、权限与版本;保留旧项目快照。
  3. 重新验收压缩后多次跨进程恢复、限制检索循环及长历史延迟;当前单次成功和后续失败都须保留。
  4. 再接正常客户端入口、正式项目身份和恢复UI,随后验证图像/像素工具、全创作链路、云端会话与跨设备恢复。

本轮没有验收生图、分层PSD/Photoshop、全部模型、完整新建项目流程、客户端分发包或商业页面质量。

实现依据:Pi SDK、Pi会话格式、QuickJS WASM。实际API使用以本机固定版本源码与回归结果为准。