AOCI 绑定助手 donyue7/dsh-aoci-bind

dsh-aoci-bind

DSH Host 侧 AOCI 接入插件（v0.1.0）。

把「哪个工作区有 AOCI 索引、有没有对应的 MCP 服务器、绑到的是不是那个仓库」这件事，从手工维护 cordis.patch.yml 变成可发现、可诊断、可修复、可初始化的四条工具。

它不生成、不重写任何索引内容；只维护 MCP 绑定行。

解决什么

现在每接入一个工作区，都要手写一段：

- insert:
- id: aoci-gys
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: 'aoci-gys'
transport: stdio
command: 'C:/aoci/bin/aoci-rc19.exe'
args: ['--repo', 'C:/Users/…/Gys', 'mcp']

手写会漏、会错、会重。真实缺口示例：StoreProject 有 aoci.txt，但没有任何 MCP 行——会话里就是拿不到它的工具，而且不会报错。本插件把这类问题变成一条明确的状态与一条修复动作。

工具（4 个）

| 工具 | 作用 |
| aoci_bind_status | 逐工作区诊断：bound / unbound（有索引没绑定）/ wrong_repo（绑错仓库）/ name_conflict（serverName 冲突）/ duplicate_binding（重复行）/ no_index（还没初始化）。只读。 |
| aoci_bind_repair | 应用最小修复：补行、改 --repo、改 serverName、可选删除孤儿行。幂等；写前时间戳备份；非法 YAML 拒绝写入。 |
| aoci_project_init | 对没有索引的仓库跑 aoci init + aoci scan，注册绑定，并返回bootstrap 提示词（含 mcp__<serverName>__ 前缀与 root 自检说明）。 |
| aoci_doctor | 环境体检：CLI 可达性与版本、补丁文件是否合法、serverName 唯一性、未绑定索引、孤儿行、workspace registry 是否可读。每项带 severity 与修复建议。 |

每个工具都返回结构化 JSON + 可读摘要（摘要由 output.render 渲染）。

安装

三种方式任选，推荐第一种（走 DSH 插件管理器，最稳）：

1) 插件管理器（需要 DSH 的 plugin_manager 工具；装完需重启一次 DSH） target 传本目录的绝对路径
plugin_manager { "action": "install_bundle", "target": "C:/…/default-workspace/dsh-aoci-bind" }

2) CLI
dsh plugin --profile desktop add file:C:/…/default-workspace/dsh-aoci-bind

3) 自带脚本（复制进 profile 并写挂载行；热加载，无需重启） pwsh -NoProfile -File scripts/install.ps1 pwsh -NoProfile -File scripts/install.ps1 -Uninstall

安装脚本会：备份 profile 的 cordis.patch.yml → 在标记注释之间写入一行 - insert: 挂载条目 → 复制包到 <profile>/node_modules/dsh-aoci-bind。-Uninstall 完整回滚。

Host 侧改动需要重启 DSH 才生效（新增 MCP 行尤其如此）；插件本身不会重启 DSH。

配置

默认值即设计值；在 profile 的 cordis.patch.yml 里用同 id 覆盖：

- id: aoci-bind
config:
enabled: true
tools: true
promptSection: false # 注入一段「先确认 root 再使用 AOCI 工具」的系统提示词 aociBinary: 'C:/aoci/bin/aoci-rc19.exe' home: 'C:/Users/me/.dsh-harness-next' # 默认 $DSH_HOME profile: 'desktop' # 默认 $DSH_PROFILE legacyHome: 'auto' # auto=旧 home 有文件才维护；on/off syncProfilePatch: true # 同时维护 profiles/<profile>/cordis.patch.yml serverNamePrefix: 'aoci'
scanRoots: [] # 额外扫描目录；默认取已注册索引工作区的父目录
backupDir: '<home>/aoci-bind/backups'
initTimeoutMs: 180000
probeTimeoutMs: 20000

npm 发布：首版手动，之后 tag 自动

npm 的 Trusted Publisher（OIDC）只能给已存在的包配置。首版发布前包还不存在，因此：

1. 首版手动发（维护者执行，需要交互式 2FA，或一个带 Bypass-2FA 的 granular token）：

npm publish --registry=https://registry.npmjs.org --access public

2. 首版发布后，到 npmjs.com → dsh-aoci-bind → Settings → Trusted Publisher 配置：

| 字段 | 值 |
| Provider | GitHub Actions |
| Organization or user | donyue7 |
| Repository | dsh-aoci-bind |
| Workflow file | publish.yml |
| Permissions | Allow npm publish |

3. 之后每次发版：

git tag v0.1.1 && git push --tags

.github/workflows/publish.yml 会用 OIDC 自动 npm publish --provenance，不需要任何长期 token。
配置了 stage-only 权限时，改为 npm stage publish，发布仍需维护者批准。

安全边界（为什么可以放心让它写配置）

- 只拼接、不重排：编辑器是行模型，只替换/追加它自己拥有的 MCP 行，注释、空行、别人的行逐字节保留。
- 非法 YAML 一律拒绝：写前写后都做结构校验（tab 缩进、引号未闭合、重复 id 都会拦下），拒绝时零写入。
- 每次写入先备份：<home>/aoci-bind/backups/<file>.<timestamp>.bak。
- 原子写：临时文件 + 替换，不会留下半个补丁文件。
- 幂等：重复调用 repair 不产生第二行；第二次运行 changes = []。
- 删除是显式选项：孤儿行只在 prune_orphans: true 时删除。

脚本

| 脚本 | 用途 |
| scripts/install.ps1 | 把插件装进 / 卸出一个配置档：写前备份、标记注释包裹的挂载行、复制包目录；-Uninstall 完整回滚 |
| scripts/status.mjs | 只读演示：对真实 $DSH_HOME 跑 aoci_bind_status / aoci_doctor / aoci_bind_repair --dry_run |
| scripts/apply.mjs | 对真实 $DSH_HOME 执行 repair（带 --dry-run 只预览）；与 Host 工具走同一条代码路径 |

自测

cd dsh-aoci-bind
node --test test/yamlpatch.test.mjs test/discovery.test.mjs test/binding.test.mjs test/tools.test.mjs test/plugin.test.mjs

40 个用例，覆盖：

| 验收点 | 用例 |
| 工作区发现（registry + 扫描根 + 去重 + 坏 registry） | discovery.test.mjs |
| 重复注册幂等（第二次 repair 零改动、文件逐字节不变） | binding.test.mjs、tools.test.mjs |
| serverName 防碰撞（同名目录 → aoci-twin / aoci-twin-2） | binding.test.mjs |
| StoreProject 未绑定 → 修复 → 已绑定 | binding.test.mjs、tools.test.mjs |
| 重复绑定收敛：同一仓库多条行 → 保留规范行、删除多余行（含跨 home/配置档两个文件） | binding.test.mjs |
| 损坏 YAML 拒绝（文件保持原样） | binding.test.mjs、yamlpatch.test.mjs |
| 旧 home ~/.dsh 兼容（legacy-only 视为未绑定，repair 只写 active home） | binding.test.mjs |
| 与其它工具共存：别的工具写入的行按 --repo 路径识别为已绑定，repair 不追加重复行；路径斜杠/大小写差异不影响识别 | binding.test.mjs |
| 非 AOCI 的 MCP 行（zxy / omnisockit）与本插件挂载行不被误判 | binding.test.mjs |
| 工具面（4 个工具、schema、渲染、错误路径） | tools.test.mjs、plugin.test.mjs |

测试全部在临时目录里构造 home / workspace / patch 文件，不触碰真实 DSH 配置。

0.1.0 的限制

- 只处理 code 侧 MCP 行，不管理 AOCI 索引内容、Baseline、scope。
- 绑定以「--repo 目录 = 已知工作区」为准；注册表里没有、也不在扫描根里的仓库需要显式加入 scanRoots。
- aoci_project_init 依赖本机 AOCI CLI；CLI 不可用时如实返回错误与步骤，不会假装成功。
- 新增 Host 行需要重启 DSH 后才会出现在会话工具表中。

许可

MIT