docs(kb): report JiuwenSwarm new-init delivery and unresolved gaps

eval/knowledge-depth/jiuwenswarm-newinit-status-20261006-cn.md

@@ -0,0 +1,132 @@
+# JiuwenSwarm 最新初始化交付状态与知识库对比
+
+本轮**已经交付新的功能目录和部分基础知识；深化知识尚未发布，初始化整体尚未完成**。功能目录从79项扩展到173项，新增94项经过独立评审的能力。已合并知识库包含864个文件、5,359,641字节；原有552个深度认可项继续保留。当前未发布深化预览达到1,047/1,211项，但四个维度仍低于90%，且一个功能没有认可的深度知识，因此不能宣称深化已经交付或全部达标。
+
+官方终态核查已结束：认可记录、旧区块保留和引用/格式校验通过；全部功能深度专项检索因日志功能无深度而失败，四维覆盖门槛仍未达到。最终状态明确为“深化发布受阻、初始化未完成”，以下统计不会把完整性通过解释为达到覆盖目标。
+
+**比较对象与版本**
+
+- 原项目资料专指[`.doc_project_maintainer`](https://github.com/openJiuwen-ai/jiuwenswarm/tree/f0a69728c96b5961d993449f1a901cbd2f4dac5b/.doc_project_maintainer)，固定在上游`f0a69728…`。
+- 上轮交付知识库固定为`73b245f5…`；本轮已合并知识库的实际测量checkout为`29f28442…`，知识范围为`knowledge/repos/jiuwenswarm/`，不包含Git外深化预览及原始追踪。
+- 新目录固定为173个功能、2,199个第一方生产文件。历史79×7=553分母保留；新深度分母为173×7=1,211，不能直接把两轮百分比的变化当成内容退化。
+
+**文件数量与正文体积**
+
+| 范围 | 文件数 | 全部字节 | UTF-8文本字节 | Markdown篇数 / 字节 | Markdown体积中位数 |
+| --- | ---: | ---: | ---: | ---: | ---: |
+| 原`.doc_project_maintainer` | 461 | 8,598,881 | 2,244,000 | 313 / 905,210 | 2,982 |
+| 上轮已交付知识库 | 745 | 4,108,425 | 4,108,425 | 744 / 4,097,123 | 3,611.5 |
+| 本轮已合并知识库 | 864 | 5,359,641 | 5,359,641 | 863 / 5,345,734 | 5,821 |
+
+相对上轮，本轮增加119个文件、1,251,216字节，字节增长30.45%。原资料的全部体积大于本轮知识库，主要因为6个压缩账本文件占6,354,881字节；全部字节数包含账本、签名和索引，不能全部视为解释正文。原资料小于1KB的文件有142个，本轮有225个；当前知识库也包含短导航页。因此同时报告文件数、文本体积与正文中位数，不把文件更多或正文更长视为质量更高。
+
+**结构与内容**
+
+| 比较项 | 原维护者资料 | 本轮已经交付的知识库 |
+| --- | --- | --- |
+| 组织结构 | `project / modules / directories / code / decisions / changes`，附健康账本及核查签名 | 按组件owner组织导航、源码契约、功能基础知识及已有深度页，统一绑定固定源码 |
+| 作者上下文 | 保留维护历史、项目说明和设计背景，是作者意图的重要输入 | 引用作者资料；实现解释以固定源码为准，设计推断显式标注，不能替代作者历史意图 |
+| 代码解释重心 | `code/`有265篇，其中251篇对应`agent_ws_server.py`；其他目录还有项目级说明 | 使用全第一方生产范围，包括后端、前端、SDK、客户端、脚本和技能；结构记录覆盖2,058个生产文件 |
+| 功能边界 | 资料中声明的能力与正文关联，不能等同于我们的认可记录 | 79个原功能保留，新增94个独立确认功能；同一能力跨客户端/后端聚合，未确认边界保留未知 |
+| 基础知识 | 作者文档、维护经验、路径/函数资料 | 架构、API、配置、功能关系、取舍、验证入口六项基础维度；认可与未知分别记录 |
+| 深化知识 | 没有本系统的原生独立认可记录 | 已发布深度仍是原552项；另有495个新项在未发布预览中，不能当成生产检索已经可用 |
+
+原维护文档对生产文件的明确引用覆盖率，本轮没有重新按完整正文映射到2,199个文件，记为**未知**。265篇代码文档和251篇同文件关联只说明资料分布，不能当成生产文件覆盖；下表使用同一分母区分可比的结构指标。
+
+| 生产文件指标（分母均为2,199） | 原维护者资料 | 上轮知识库 | 本轮已交付知识库 |
+| --- | ---: | ---: | ---: |
+| 结构覆盖 | 未建立本系统结构统计 | 2,043/2,199，92.91% | 2,058/2,199，93.59% |
+| 原资料解释正文的明确文件引用覆盖 | 未知，未重新映射 | 不以结构记录代替正文引用 | 不以结构记录代替正文引用 |
+
+流程仍分为三个大阶段：阶段1先建立Skeleton，再做“文档功能发现→源码扩展→聚合和独立评审→目录PR冻结”；阶段2建立Breadth导航与基础知识；阶段3执行Deepen/Acceptance，核对原生记录、源码、检索、独立内容审查和CI。功能数量与生产范围来自各仓库适配配置；本报告的173和2,199仅属于本次JiuwenSwarm批次。
+
+**已经交付的基础知识与覆盖**
+
+[部分基础知识PR #320](https://github.com/JiusiServe/InferMatrixCopilot/pull/320)已经合并，用户明确批准了部分交付，最终深度验收目标保持原值。真实发布记录SHA为`d721ba25…`；发布收据SHA为`7390aa73…`。
+
+| 指标 | 本轮已合并结果 | 含义 |
+| --- | ---: | --- |
+| 目录功能 | 173=79+94 | 新目录经过审查冻结，不代表所有潜在功能都已被发现 |
+| 新增功能具备认可基础内容 | 94/94 | 每个新功能有已认可内容；不等于六维全部完成 |
+| 六项基础维度认可 | 927/1,038，89.31% | 剩余111项未知 |
+| 六维全部具备的功能 | 108/173，62.43% | 65个功能还有基础知识缺口，完整基础目标未达标 |
+| 生产文件结构覆盖 | 2,058/2,199，93.59% | 达到85%结构目标；含静态接口/依赖记录，不是测试覆盖或完整行为理解 |
+| 已发布七维深度认可 | 552/1,211，45.58% | 认可内容未减少；分母因新增94个功能扩大 |
+
+六项基础维度剩余：架构13、API17、配置11、功能关系21、取舍33、验证16。基础知识与七维深度认可使用不同条目和验收记录，即使同名维度有基础说明，也不能自动计入深度认可。
+
+**尚未发布的深化预览**
+
+官方原生记录审计得到1,047个匹配当前正文的认可记录，问题数0；固定源码深度审计的证明/引用问题数也为0，但其覆盖门槛仍失败。记录中的source事件状态1是纯审计API结果派生出的门槛状态，并非独立源码CLI进程退出；不能把完整性通过称为整体验收通过。该预览包括207项严格认可、840项轻量认可；所有已认可项均为正向支持，已核验缺失0项。轻量认可绑定真实源码或文档引用及一次独立评审，不要求形式化运行时调用链证明。未知项不会计入认可。
+
+| 深度维度 | 认可 / 173 | 比例 | 未知 | 达到156项门槛还需 |
+| --- | ---: | ---: | ---: | ---: |
+| 执行流程 | 157/173 | 90.75% | 16 | 0 |
+| API 契约 | 161/173 | 93.06% | 12 | 0 |
+| 配置与默认行为 | 163/173 | 94.22% | 10 | 0 |
+| 依赖与关联功能 | 146/173 | 84.39% | 27 | 10 |
+| 失败与降级行为 | 155/173 | 89.60% | 18 | 1 |
+| 设计取舍 | 151/173 | 87.28% | 22 | 5 |
+| 验证与测试入口 | 114/173 | 65.90% | 59 | 42 |
+
+认可合计1,047/1,211，86.46%；172/173个功能有至少一项认可，88/173个功能具备七项完整认可。深度证据直接涉及350/2,199个生产文件（15.92%）；这是引用证据范围，不能与93.59%的结构覆盖混用。
+
+当前只有流程、API、配置达到每维至少156/173的门槛。依赖、失败行为、取舍和验证未达标；按现有各维数量，至少还需58个对应维度的新认可才能让每一维达标。164项完整缺口仍须保留，其中验证维度有59项未知。
+
+13个worker均已自然结束、执行范围处理完成，退出码均为0，但阶段状态全部是`partial`。每个维度最多初始提取加三次修正，实际没有超过四轮；剩余164项均已耗尽本轮额度。`dev-ws-traffic-logger`七维全部未知：四次真实GLM提取未定位到足够的日志实现分片，而展示了相邻下载辅助逻辑；前两轮正文中的运行期日志路径又被源码路径扫描拒绝，当时evidence数组实际指向README，并非提交了伪造的源码证明。这是证据定位及正文路径校验问题，不能据此说该功能不存在或没有测试。该功能已合并的基础页仍具备六项认可说明，包括日志API、脱敏、默认limit和启动清空行为；这些真实基础知识不自动计入七维深度认可。
+
+**对PR评审能提供的具体上下文**
+
+下表是基于现有内容的使用情景，不是新的PR A/B实测。本轮没有测量GLM-5.3评审准确率、召回率或PR评审加速比；不能用知识认可率、生成调用耗时或文件体积替代这些指标。
+
+| 修改情景 | 已交付上下文 | 评审可核对的风险 |
+| --- | --- | --- |
+| 分享图任务创建/下载API变更 | [分享图基础页](../../knowledge/repos/jiuwenswarm/components/web-frontend/feature-share-image-export.md)明确开发态新建任务202、复用活动任务200并携带`reused:true`，未完成下载409 | 检查客户端状态机、复用语义和下载前置条件是否兼容；需在预算内实际检索到这些正文 |
+| XLSX环境自检退出码变更 | [doctor基础页](../../knowledge/repos/jiuwenswarm/components/config-resources/feature-xlsx-doctor-selfcheck.md)区分必需检查失败与可选依赖警告 | 避免把可选依赖缺失误改为整体失败；文档提供手工入口，不声称本轮运行过doctor或其测试 |
+| 开发态WebSocket日志改动 | [已合并基础页](../../knowledge/repos/jiuwenswarm/components/web-frontend/feature-dev-ws-traffic-logger.md)说明GET返回entries/count、ENOENT空200、其他读错误500、POST脱敏追加、非GET/POST为405；limit默认300、范围1–2000及启动清空 | 可检查错误处理、脱敏和默认值兼容性；七维深度仍为0，需按变更补读源码，不把未知测试写成已核实缺失 |
+
+检索约定为两页、6,000字符，搜索片段和补读同样占预算。知识库存量与模型实际注入量分开记录；本轮深化预览没有发布，所以生产评审不能自动获得这些新增深度块。官方通用检索探针已通过：功能描述加路径时命中173/173个功能，命中全部172个已有深度的功能，最大注入5,991字符。仅路径探针诊断命中168个功能及167个深度页，共享入口导致的遗漏仍保留；不能据此删除功能或缩小深度验收分母。离线探针耗时P50为2,655毫秒，这是检索时间，不是模型或PR评审速度。要求全部173功能具备深度的519项专项探针已完成，真实CLI退出1，唯一问题为`dev-ws-traffic-logger: no intact depth available`；全部功能仍保留在验收分母中。通用检索通过不等于全面深度覆盖。
+
+描述加路径的173个离线探针合计完整返回588个目标功能维度，部分返回0项、未注入623项；仅描述探针完整返回613项，未注入598项。每组统计分母为1,211个维度格，未注入包含164个真实未知格，不能全解释为“已存在但没有读取”。这些是离线探针实际返回的上下文统计，不能把1,047项库存视为每次PR评审都已收到，也不是PR评审准确率实测。
+
+验证知识的114个认可项中，分类为运行时自动化入口46、源码文本断言1、手工指南21、辅助函数单测18、未分类28。这些是现有验证入口的知识分类，不能说明本轮执行了对应项目测试。本轮工具源代码CI、原生记录审计和引用/格式校验也分别记录，不能当成JiuwenSwarm运行时测试全通过。
+
+**版本一致性与追踪保存**
+
+实际在2026-10-06 02:39:20 UTC（北京时间10:39:20）查询上游`develop`，结果仍为固定`f0a69728…`，提交差距0、受影响功能清单为空。这是一次版本核查，不承诺持续实时同步；作者文档日期和历史健康账本也不作为当前行为有效性的证明，本报告没有重新逐条核验全部作者正文与实现的冲突。[文档检索改进PR #321](https://github.com/JiusiServe/InferMatrixCopilot/pull/321)已经在准确head完成全CI并合并为`29f28442…`；源代码改进通过CI，不等于深化发布目标已经达标。
+
+GLM-5.3订阅负责提取，Codex独立评审；共享并发上限13，初始间隔5秒，保留限流调节和调用记录。实际费用未报告，保持“未知”。本轮深度707次真实尝试（首次266、恢复441）全部保留；恢复中GLM完成234次，另有两次JSON解析失败，Codex完成205次。解析失败没有被重新包装成认可。
+
+完整追踪保存在Git外`/data/zhoutaichang/copilot/.kb-jiuwenswarm-newinit-prep-20261005/archive/depth-natural-terminal-20261006T020618Z-a8309ea4/`，总385,771,097字节：707份原生调用记录、707份流式文件、2,146个压缩输入/系统/回复/事件blob、13份JSONL及13份派生SQLite快照，并附终态检查点、共享索引和过程元数据。所有2,146个blob引用均在对应worker归档内可解析且哈希验证通过，无全局缓存依赖；原始文件不变。原生记录显示该批次没有模型工具调用，因此不虚构工具结果。SQLite仅作派生查询便利数据，原生流和压缩blob才是保存的原始追踪依据。
+
+**可复核证据与最终状态**
+
+紧凑JSON列出完整路径、SHA256及逐功能缺失维度。通用检索结果SHA256为`18b7f95738116600…`。本报告只提交摘要，原生输入、全文评审和大型JSON均留在Git外。
+
+| 证据 | SHA256前缀 | 当前状态 |
+| --- | --- | --- |
+| published_size | `9bc6c33beae1667f…` | 已有真实记录 |
+| source_freshness | `7b3b4ba5442381bc…` | 已有真实记录 |
+| published_foundation | `eb210aba4b4282f8…` | 已有真实记录 |
+| native_approvals | `12b195891545a1ff…` | 已有真实记录 |
+| source_audit | `3bb54dbb1b9d915a…` | 完整性通过，覆盖门槛失败 |
+| independent1047_and_original552_binding | `6d959de1335e8e7a…` | 全区块/原生记录匹配；旧552项原文及记录未变 |
+| final_checkpoint_status | `14d988bd48aaf6be…` | 13份真实检查点绑定，初始化未完成 |
+| depth_retrieval | `87242af79987406b…` | 519例完成，日志功能无深度导致失败 |
+| original552_preservation | `fe03f99b4f282c1d…` | 552/552完整区块与原生记录未变 |
+| validators | `1905c2faf2e06592…` | 引用/格式API通过，问题0 |
+| independent_final_preview_results | `31f6f98ddf11ddbd…` | 终态核对通过；保留真实检索/覆盖失败 |
+| source_helper_full_ci | `92b71c9efbec59d5…` | 已有真实记录 |
+| terminal | `f360bf31e124a34a…` | 已有真实记录 |
+| complete_trace_archive | `983595acae56db2b…` | 已有真实记录 |
+
+独立逐项复核已确认预览全部1,047项区块哈希与原生认可记录匹配，原552项完整正文及原生认可记录未变，新增495项与实际组装、检查点和三项原生yes对应。最终官方状态绑定13份检查点，认可/源码完整性问题0、旧552项保留问题0、内容校验问题0；全部功能深度专项检索失败，四维门槛仍失败，深化发布状态为`blocked`。官方只读核查没有调用模型、没有修改源码或检查点，没有发布预览。本报告不授权深化发布；四维门槛和功能深度缺口须先解决。后续应针对实际未知项补充准确的实现、调用方或验证证据，并按既定策略决定下一步，不能重置本轮修正次数、删除功能、缩小分母或降低目标来制造完成。
+
+**后续改进优先级（建议，尚未实现或重跑）**
+
+1. 将功能发现时实际认可的源码行段继续传给后续提取，避免再次只依赖入口文件名定位。
+2. 复用已经独立认可的基础正文及其来源，避免仅送入被截断的前缀；日志基础页已经包含真实API和默认行为，是可复用证据。
+3. 改进多语言入口定位，尤其是TypeScript嵌套插件、箭头函数及文件中段的实际入口，保持无法定位的关系为未知。
+4. 区分运行期输出路径与固定版本源码引用；先删除或收窄不受支持的附加限定和引用，再进行新的独立评审，不能凭编辑后的旧认可记录认可新正文。
+
+这些建议不表示已经增加调用、实现修复或豁免额度。新一轮工作须提供有效的新证据并得到明确审查的重试授权；现有检查点、原生判定和已耗尽次数保持不变，四个未达标维度的原门槛也保持不变。