前言¶

在 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