feat: integrate performance upgrade and agent inspection tooling

2026-09-29 10:16:02 +08:00
parent f92105c97d
commit 08246ddb01
114 changed files with 7135 additions and 87 deletions
@@ -0,0 +1,37 @@
+# ShrinkSDK Inspect
+
+本地语义导航与能力查询工具。无需模型 API、向量数据库或常驻服务。
+
+```powershell
+dotnet pack Tools/AgentSupport/Shrink.Inspect -c Release -o Artifacts/Inspect
+dotnet tool install ShrinkSDK.Inspect --tool-path Artifacts/Inspect/bin --add-source Artifacts/Inspect --version 0.1.2
+Artifacts/Inspect/bin/shrink inspect capabilities "存档" --root .
+Artifacts/Inspect/bin/shrink inspect modules --root .
+```
+
+支持 `modules`、`capabilities`、`symbol`、`flow`、`impact`、`check`。能力默认 3 项；其他结果默认 20 项，链路深度 2。使用 `--module`、`--limit`、`--depth` 缩小或展开，`--json` 返回结构化数据。
+
+Unity 使用菜单 **Tools/ShrinkSDK/Inspection/Export compilation inputs** 导出实际编译引用、源文件和宏，然后传入 `--compilation Artifacts/Inspection/compilation.json`。没有导出时 IDE 工程输入只作为可能过期的辅助；无工程输入时采用标记不完整的源码候选索引。
+
+.NET/Godot 消费项目先正常 restore/build，再使用 `--project path/to/project.csproj`，通过 MSBuildWorkspace 获取语义。工具需要 .NET 8 或兼容运行时，以及可加载该项目的 SDK。
+
+```text
+shrink inspect flow "route:command/execute" --compilation Artifacts/Inspection/compilation.json
+shrink inspect symbol ShrinkContextRuntime --compilation Artifacts/Inspection/compilation.json
+shrink inspect impact ShrinkNetworkService.cs --compilation Artifacts/Inspection/compilation.json
+shrink inspect check --compilation Artifacts/Inspection/compilation.json --json
+```
+
+`static` 是静态绑定，`candidate` 是动态候选/待注册关系，`runtime-bound` 来自相同构建的按需快照，`unresolved` 表示信息不足。静态订阅关系不等于活跃订阅；影响查询不证明没有其他间接影响。索引每次从当前输入构建，不保存不可见的跨任务记忆。
+
+通过 `--snapshot` 加载宿主导出的快照；无可验证构建标识或标识不符时不合并。工具不自动连接生产宿主，不输出消息正文或令牌。
+
+新增内容的工作方式见 [复用优先设计](../../Docs/ReuseFirstDesign.md)。源码、配置与行为验证优先于描述；无命中不意味着不存在能力。
+
+退出码：0 查询完成，1 `check` 发现确定错误，2 参数/输入错误。覆盖不足以结构化 coverage 返回，不伪装为完整检查通过。
+
+当前目录下的 Unity PackageCache 只纳入已安装的 `com.cneicy.shrink-*` 源码与能力说明，其他第三方包作为引用。消费项目用自己的 README 声明业务能力，工具不会从 SDK 基础设施推断玩法已经存在。
+
+本机仅安装较新 .NET SDK 时，CLI 允许前滚到最新已安装主版本；共享内核仍为 netstandard2.1。能力查询无需 MSBuild，`--project` 需要可加载目标项目的 SDK。
+
+本地发布与验证入口：`Pack-Local.ps1` 打包 NuGet，`Install-Unity.py <工程路径>` 生成可随工程保存的 UPM tarball；它只改消费工程的 ShrinkSDK 依赖并保留原 manifest 备份。新版安装和回退说明见 [迁移指南](../../Docs/NetworkV2Migration.md)。