Files
Workspace/Docs/AgentSupportAcceptance.md
T
cneicy 08246ddb01
Validate ShrinkSDK Workspace / catalog (push) Successful in 5s
Validate ShrinkSDK Workspace / unity (push) Successful in 3m20s
feat: integrate performance upgrade and agent inspection tooling
2026-09-29 10:16:02 +08:00

47 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Agent 导航与交付验收
验收基于实际本地代码、CLI、Unity/Godot/.NET 运行,不以文档关键词命中替代事实。CLI 版本 0.1.2,输出格式版本 1。未发布远程版本。
## 冷上下文 Agent
仅提供需求、CLI 入口与允许的证据路径;只读执行,未让评估 agent 参与实现。
- 第一轮:26 次 CLI 查询、14 组源码读取,暴露模组证据路径错误、中文业务问法遗漏、route 链断点、Godot 输入选择和 impact 模块过滤缺口。
- 第二轮:13 次查询复测 8 个导航任务与复用边界;修复上述入口问题,仍报告通用外部方法导致扩散、路由链不完整和真实 waiting 证据不足。
- 第三轮限定复测:2 次 CLI+1 次既有 JSON 读取,无代码修改、无无关文件正文读取。route 默认深度返回 9 条未截断结果,包含 handler-forward 到 ShrinkNetworkCommandBridge.HandleExecuteAsync;事件 flow 从 155 条降至 52 条,默认页不再经 Dictionary 方法扩散到此前无关模块。并未逐条审核全部 52 条。
- waiting fixture 返回 CurrentProviderUid=null、CommittedProviderUid=null、PotentialProviderUids=[]、IsSatisfied=false,没有 provider 绑定边。runtime-bound 修饰真实的 requires 关系,不代表依赖已经满足;该轮读取既有产物,不声称重新捕获实时状态。
## 8 个导航任务的落点
| 任务 | 证据/边界 |
|---|---|
| 启动应用 | Starter 组合、ContextLoaderHost;消费工程自己的组合根 README |
| 事件未触发 | publish/subscribe 候选与实际快照绑定分离;无快照不称已注册 |
| 远程命令 | route → 消息 → 注册/lambda → HandleExecuteAsync;继续调用 Command.ExecuteAsync 需展开深度 |
| provider 缺失 | key 查询、requires、候选 provider、waiting 依赖状态 |
| 存档入口 | ShrinkSave、模块采集、LocalStorageProvider;不假装已有任意介质注入 |
| 模组退役 | ShrinkModContextHost、fiber、effect lease 撤回 |
| Godot 主线程 | --project 加载 Godot 工程,而不是复用 Unity 编译清单 |
| 网络服务改动影响 | 直接调用、桥接、验证入口;不保证发现所有反射或动态间接调用 |
4 个复用任务结论:每帧预算先用宿主已有配置;卸载订阅用 Context EventBus adapter;新存储介质实现 IStorageProvider 后仍需确认/窄扩展宿主注入入口;新怒气玩法没有现成业务模块,基础设施可复用但业务必须设计。不为满足“复用”而虚构能力。
## 验证记录
- 独立 .NET 核心回归 64 项、CLI/分析器回归 12 项通过。
- Unity 全量 EditMode 226 项通过;实际 Windows Player 10 项通过,包含分配计数器校准、RPC/广播矩阵与存档阶段测试。
- Godot 4.6.3 Mono 实际 headless 启动、事件/命令生成合同、存档 42 回读、Context 应用及 .NET JSON golden frame 互通通过。
- 独立 NuGet 消费工程用新的隔离包缓存还原,实际运行输出 PASS;CodeGen 合同印记 0.1.0 是格式版本,不是 NuGet 包版本。
- justanyproject 安装 22 个本地 SDK UPM 包,新增 Inspection 接入和生成式 MessagePack fixture;.NET 3.1.8 编码与项目既有 MessagePack 3.1.10 生成 formatter 的 Unity PlayMode 字节互通通过。
- justanyproject 定向 EditMode 83 项:80 通过、3 失败。两项 ModSpellApi 测试仍调用已停用旧工厂重载;另一项 tooltip 断言期待“◆”,当前正文没有该字符。这些代码不是本次 SDK 迁移修改,未擅自重写玩法使其变绿,不能宣称消费项目全量测试通过。
从 Entry 启动后已进入 MainMenu,9 个应用 fiber 均 Active。宿主快照明确包含应用 Context、Network 与 Command scope,不把旧服务容器查询失败当作服务不存在。相同构建的 route 查询共 14 条未截断结果,其中 5 条为 runtime-bound;默认候选关系仍保留 candidate 标记。最终安装版本、实际运行状态、原始测试摘要保存在性能数据目录。编译通过与主场景启动不等于完整多人对局或所有内容的端到端验收。
## 保留的限制
- 静态 IDE 输入可能过期,buildId 为空时只提供候选证据;Unity 导出清单与运行快照须构建标识一致,源/引用时间戳变化会拒绝合并。
- 第三方包只作引用;第三方源生成的成员可能 unresolved,不把覆盖不足当检查通过。
- 自定义 Endless 联机协议不属于 SDK Network 运行快照覆盖;其现有协议版本 29 不变,不能与 SDK SHK2 版本 2 混同。
- 快照按需生成;没有常驻采集、生产连接、消息正文或令牌导出。按模块、深度、数量与分页控制结果,当前仍每次重新建立索引。
- 本次为本地安装和构建验收,没有验证远程 registry/Git tag/Installer 的正式发布路径,也没有发布这些版本。