# 插件协议兼容验证报告

> 本文记录传统 Codex/CC 解析阶段的 164 项验证及当时的排除范围。后续独立格式接入和完整回归结果见 [Agent Plugins 1.0.0 验证报告](<Agent Plugins 1.0.0 验证报告.md>)，不把原阶段排除描述当作当前格式支持状态。当前包名已在工作区改为 `@rvaim/dsh-plugin-bridge`（插件桥 / Plugin Bridge），更名及其实际验证见[包更名说明](<包更名说明.md>)。

验证日期：2026-10-20（Asia/Shanghai）。本轮基于包版本 `0.4.4` 的工作区修订，未发布；Plugin parser / Source parser 均为 `3.0.0`。

## 兼容范围

对照 Codex 0.163.0 的传统 `.codex-plugin/plugin.json`，以及 Claude Code 2.1.304 与 2026-10-20 官方在线文档。完整提交、发布时间、证据与实施原则见[传统插件解析兼容方案](传统插件解析兼容方案.md)，实现能力和未适配项见[传统插件兼容矩阵](传统插件兼容矩阵.md)。Agent Plugins 1.0.0 作为独立格式排除，不伪装成传统 Codex 或 CC 目录。

## 实现摘要

- 分平台落实 Manifest/Marketplace 的默认发现、路径、优先级、CC strict 与 Hook 事件覆盖、同平台 MCP 顺序覆盖；Source 内联引用显式标记根目录种类，安装、更新和重启后仍能正确读取。
- 区分合法事件、未知事件、合法但运行未适配 Handler；函数模块与关键未知行为不静默丢弃。
- 支持 Codex wildcard/精确 matcher，保留工具 JSON；CC `onFailure:block`、通用停止语义和当前 DSH Shell/Agent 初始化接入新增回归。
- Hook `args` 走 subprocess argv，缺服务不降级为 Shell；失败日志与动态健康状态不再固定报告 pass/running。
- Codex Skill sidecar 隐式调用策略、CC 调用提示/布尔值、传统 MCP Header/env/bearer 与延迟 fallback 均有针对性验证。
- 未兑现的认证、权限、工具限制、Skill 执行语义等明确阻止启用；Command/Agent 继续只解析不执行。
- 项目文档中文命名，发布检查验证文档存在；旧验证事实保留在[历史版本验证报告](历史版本验证报告.md)。

## 验证记录

最终执行 `npm run verify`：**164/164 测试通过，无失败、跳过或取消；发布包结构、DSH bundle 与 382 个发布文件检查通过**。严格 TypeScript、Typert Host/Remote 生成、Client 构建均通过。

| 回归范围 | 测试数 | 最终结果 |
|---|---:|---|
| Manifest / Marketplace / 合并及来源 | 19 | 全部通过 |
| Hook 事件、Handler、matcher 和诊断 | 16 | 全部通过 |
| Skill / MCP / 凭据与策略 | 11 | 全部通过 |
| 当前 Shell / argv / 停止 / 输出与脱敏契约 | 11 | 全部通过 |
| 默认启用、独立格式排除、安装更新后的 Marketplace 来源 | 3 | 全部通过 |
| 既有安装、更新、回滚、安全、Web operations 等回归 | 104 | 全部通过 |

关键新增结果：合法 JSON 的非法决策枚举也触发 `onFailure:block`；stopReason 不泄漏已解析凭据；Stop additionalContext 触发续步并限制八次；SubagentStop 因宿主只有事后通知而明确禁止伪运行；CC 提示事件默认 30 秒；合法 `__proto__` Header 不丢失；嵌套插件的 Marketplace 内联 MCP/Hook 在安装、更新和再次启用后仍从当前 Source 快照读取。

`git diff --check` 通过；README 与中文文档的本地链接检查通过。`npm run verify:dsh` 通过，并输出其实际解析到项目 `node_modules` 的依赖位置；该结果仅为当前依赖导出契约，不是 Desktop 挂载或浏览器验证。自动测试使用临时数据，未修改用户安装记录。npm cache 使用系统临时目录，以适应当前工作区文件权限。

## 当前 DSH 与实测边界

本轮没有安装、启停或改写当前用户 profile，没有实际执行第三方插件。Hook 测试使用受控 Shell/subprocess/Session/Agent 接口与真实共享协议的输出解析；Parser 测试只读临时配置，不执行配置中的命令。远端 MCP 握手、真实模型会话和浏览器点击未完成端到端验证。

项目开发依赖与 Typert 生成器仍为 rc.6。本轮没有扩大到整个 DSH Client/Typert 版本迁移：此前已确认当前 Desktop 要求的严格 codec `create()` 与 rc.6 产物 `schema` 格式不同。因此本轮构建、发布探针或解析测试通过均不能证明当前 Desktop Web 可挂载，仍须单独完成该运行时升级。共享 Hook Protocol 库仅复用 wire codec、结果合并与日志，不把其 rc.6 版本当作 Codex/CC 规范号。

Codex Rust regex 与 JavaScript regex 引擎不完全相同：本轮支持可由 JavaScript 编译的常见语法，未声明完整 Rust 引擎等价。DSH 不能复现的事件、Handler、PowerShell shell form、输入/输出重写、动态 Skill 命令、认证与策略能力明确保留诊断。只读取到字段或成功创建父 Fiber，不算这些能力已运行。