前言¶

在 DSH 里让智能体「理解整个仓库」，常见做法是反复读文件、靠上下文堆代码片段，或手工维护一份说明文档。文档容易和代码脱节，全量扫描又占 token、难审计。AOCI（AI-Oriented Cognition Infrastructure）把认知写成 Git 版本化的受治理资产，并用本地 MCP 暴露给模型；dsh-aoci 把这一套接到 DeepSeek Harness，用斜杠命令和动态 MCP 桥完成校验、绑定与建索引指引。下面介绍它是什么、能做什么，以及如何安装与使用。

这是什么¶

dsh-aoci（GitHub：Fourteenth-Night/dsh-aoci，npm 包名 dsh-aoci，当前版本 0.2.9）是社区维护的 DSH 工作流类插件。它将 AOCI-CODE（本地 stdio MCP 服务器 + Go CLI）接入 DSH 生态：把确定性治理（初始化、基线、验证）和语义创作（模型在 AOCI 协议下撰写 FRAS 条目）分开，让智能体通过工具面读取和维护「仓库/数据库认知地图」。

插件本身采用 MIT 许可；AOCI-CODE 为 FSL-1.1-MIT（source-available）。插件不捆绑 aoci 二进制，需从官方 Release 自行下载并用 SHA-256、最低版本校验后配置路径。

核心功能¶

一键斜杠命令 /aoci¶

带路径时解析绝对路径或相对 defaultRoot 的路径；不带路径时自动定位当前会话工作区。流程包括：校验 aoci 二进制 → 按仓库状态条件执行 init/scan → 绑定动态 MCP 桥 → 通过 agent.steer 指示当前智能体构建索引。可选参数：--locale、--scope、--agent、--skip-scan、--db。

动态 MCP 桥与九类认知工具¶

按需拉起 aoci --repo <root> mcp（stdio），注册 MCP 工具：aoci_rules、aoci_overview、aoci_get_entries、aoci_search、aoci_maintain、aoci_update_entry、aoci_remove_entry、aoci_header、aoci_report。

默认 toolSurface: compact 时，模型主要看到 aoci_overview 与聚合入口 aoci_call { tool, args }，工具 schema 体积约减半；设为 full 则九工具直连暴露。

确定性治理与查询工具¶

宿主侧还提供不依赖「模型即兴写命令」的工具，例如：aoci_status、aoci_verify、aoci_check、aoci_use、aoci_unbind、aoci_refresh（自上次维护 HEAD 起的 git 变更集与增量维护指令）、aoci_audit、aoci_build_status；compact 模式下用 aoci_query { kind: relations|impact|lineage|db } 合并多类系统认知查询，full 模式可分别调用 aoci_scan、aoci_panel、aoci_relations、aoci_impact、aoci_lineage、aoci_db。

另有静态入口 aoci_cognition { action, project?, path?, args? }，在 PTC 与 native 工具模式均可用，支持 rules/overview/maintain 等动作及本地条目预校验（action: "validate"）。

Token 与压缩¶

compact 工具面、结果截断与 receipt 指针，以及 compaction 钩子：在上下文压力下可将 AOCI 正文折叠为 receipt，并配合 ctx.tokenMeter 升级恢复提示（fold → fold+compact）。

浏览器客户端¶

包内 ./client 为 web profile 的浏览器半边，经 DSH 的 __ModuleLoader__.load 协议注册；状态与审计线索落在 state/aoci/（如 projects.json、runs.jsonl、aoci-events.jsonl）。

适用范围¶

• 实测环境：DSH 0.2.0-rc.2（harness runtime ^0.2.0-rc.2，cordis ^4.0.4）；web profile。package.json 中 desktop 兼容范围为 >=2.7.0 <4.0.0。
• Node：>=20。
• 前置二进制：官方 AOCI-CODE Release 的 aoci（文档默认路径示例为 C:/aoci/bin/aoci.exe）；配置项 minAociVersion 在中文 README 默认 0.1.0-rc21（英文 README 截断处默认曾写 0.1.0-rc18，以你安装的插件 README 为准）。

安装与启用¶

1、从 AOCI-CODE Releases 下载对应平台的 aoci（例如 aoci_0.1.0-rc21_windows_amd64.zip），按发布的 SHA256SUMS 校验后放到稳定绝对路径。

2、取得插件源码目录后，按官方步骤打包并加入 profile（安装命令来自项目 README.zh-CN）：

cd <plugin-checkout>
pnpm install
pnpm check
pnpm pack
dsh plugin --profile <name> add ./dsh-aoci-<version>.tgz

3、重启 DSH 后，在设置中填写 binaryPath（及可选的 binarySha256）指向你的 aoci 可执行文件。

DeepSeek Harness 社区插件目录位于独立站点 SkillHub 上的 dsh-aoci 页，与 DeepSeek / 幻方无官方从属关系；安装前建议自行审阅源码与许可证。

典型用法¶

重启并在对话中使用斜杠命令（示例来自 README.zh-CN）：

/aoci D:\path\to\repo
/aoci

第一条绑定并引导对指定仓库建索引；第二条在无路径时自动使用当前工作区。

日常维护可让智能体调用 aoci_refresh 获取增量变更与维护批次，避免每次全量重建。首次建索引耗时随仓库规模增长（文档给出量级参考：约 1 小时 / 20 万行），并消耗模型额度。

常用配置项（节选）：

适用场景与注意¶

适合：希望在 DSH 工作流里给智能体一套可 Git 追溯、可 verify/check 的仓库认知层；需要依赖关系、影响面、lineage 或数据库表结构元数据（不读业务数据）预检的团队。

注意：

• 插件以当前 DSH 进程权限运行；子进程环境为白名单，凭据仅通过 AOCI_DB_* 等环境变量名引用，不存储密钥。
• readOnly: true 或二进制 SHA/版本校验失败时会阻止绑定或写操作。
• /aoci/api 默认关闭；启用时文档说明为只读且 loopback。
• 宿主完全退出后，文档注明 nightly 等后台调度不保证执行。
• 包内附带 scripts/aoci-mcp-driver.mjs，可在无完整宿主绑定时驱动单进程 MCP 步骤，输出目录为 state/aoci/tmp。

结尾¶

dsh-aoci 把 AOCI-CODE 的受治理认知与 DSH 的斜杠命令、动态 MCP 注册和确定性工具缝在一起：一次 /aoci 完成校验与接入，后续用 overview/search/maintain 与 refresh/audit 保持认知与 git 同步。进一步了解设计与版本史可见仓库 docs/DESIGN.md 与 RELEASE.md。

• 目录页：https://www.skillhub.cn/plugins/Fourteenth-Night/dsh-aoci
• GitHub：https://github.com/Fourteenth-Night/dsh-aoci