前言¶
DeepSeek Harness (DSH) 的核心在於插件化架構。在智能體開發場景下，開發者需要實時掌握項目的 AOCI 認知索引與治理狀態。dsh-aoci-panel 插件在會話視圖標籤欄增加了一個 AOCI 標籤，提供索引概覽、治理狀態展示、條目瀏覽功能，併爲尚未接入 AOCI 的項目提供引導式安裝。
插件介紹¶
該插件由 donyue7 維護，基於 MIT 許可證。它通過在 DSH 中註冊一個新的標籤頁，讓用戶能夠以只讀方式查看當前項目的 AOCI 資產，或在必要時執行初始化操作。
核心功能¶
插件主要包含以下區塊：
- 索引概覽：展示項目名、佈局模式、索引條目數、各卷狀態、
composite_identity、基線文件數與更新時間、最近一次 verify 結果、待處理報告以及最近操作。 - 治理狀態：展示是否對齊、
check結果與下一步建議、待處理事務、Recovery 狀態、預算水位、Scope 對齊與規則數、Code 漂移明細及 Findings。 - 條目瀏覽：支持按路徑、標籤或 F 描述進行搜索。點擊條目可展開完整的 F/R/A/S 內容。標籤會自動按元卷詞典解譯爲中文含義。
- 安裝嚮導：當項目尚未構建 AOCI 時，面板會引導用戶進行環境預檢（確認 aoci CLI 與 DSH home）、配置安裝選項（Locale、Scope、Agent 等）、預覽執行動作，並執行
aoci init/aoci scan，同時向 DSH 追加 MCP 行。 - 引導卡片：通過頂部“引導”按鈕，提供 AOCI 概念、生命週期（安裝→構建→使用→維護）、面板區塊說明以及常用 CLI 命令速查。
- 頂部工具條：提供倉庫切換（來自 DSH 已註冊工作區）、aoci 二進制切換（自動探測並按 rc 版本降序）、數據時間戳、刷新、校驗（執行
aoci verify）和引導入口。
安裝與啓用¶
通過 PowerShell 執行一鍵腳本即可完成安裝：
pwsh -File scripts/install.ps1
該腳本會執行以下操作：
1. 將插件包拷貝到 $DSH_HOME/profiles/<profile>/node_modules/dsh-aoci-panel。
2. 在該 profile 的 package.json 的 dsh.profile.bundles 數組末尾追加 "dsh-aoci-panel"（安裝前自動備份原文件）。
3. 打印生效方式提示。
安裝完成後，需重啓 DSH 宿主以使插件生效。
典型用法¶
- 查看狀態：在會話視圖標籤欄打開
AOCI標籤，查看當前項目的索引概覽與治理狀態。 - 引導安裝：如果項目尚未構建 AOCI，直接在面板中點擊“安裝”，按嚮導完成
aoci init和aoci scan。 - 手動安裝：如需手動安裝，可使用上述腳本，或在手動操作後重啓 DSH。
適用場景與注意¶
- 權限與讀寫：除安裝嚮導外，面板處於只讀狀態。它不會修改業務代碼、
aoci.txt或正式的.aoci資產。安裝嚮導僅寫入目標倉庫的 AOCI 產物和可選的 DSH 組合補丁行。 - 生效機制：DSH 接入插件後需重啓才能生效。嚮導寫入的 DSH 補丁行也需重啓宿主。
- 包類型：本插件爲本地包，僅登記在
dsh.profile.bundles中，未寫入dependencies，以避免pnpm install時產生衝突。 - 熱重載限制：桌面版 DSH 宿主不支持
lib/index.js的模塊熱重載。修改宿主邏輯（lib/index.js）必須重啓 DSH；但修改前端邏輯（lib/client.js）在桌面版下通過 HMR 原地更新，無需重啓。 - 緩存機制：面板數據緩存存活在本進程內。切換標籤、重開面板不會觸發重新計算，只有點擊“刷新”或“校驗”纔會觸發重算。DSH 重啓後首次打開會重新計算。
短結尾¶
dsh-aoci-panel 旨在爲 DSH 用戶提供一個直觀的 AOCI 認知面板，解決索引與治理狀態不可見的問題。通過引導式安裝與豐富的展示功能，幫助開發者更好地維護智能體項目。完整信息請參考 GitHub。
