前言¶
DeepSeek Harness (DSH) 採用插件化架構。開發者需要管理代碼庫知識，複用已配置的模型。dsh-openwiki 是一個 DSH 插件，由 D2Moqi 維護。它將 openwiki 的代碼庫知識庫能力搬進 DeepSeek Harness，一鍵生成 / 閱讀 / 更新倉庫 Wiki 與 Grounded Claims，直接複用 DSH 已配置的模型，無需二次填 Key。
核心功能¶
插件在 DSH 主界面提供知識庫入口、浮動窗口、目錄樹、文檔閱讀等交互。
- 知識庫入口：DSH 主界面左下角「設置」上方「openwiki知識庫」入口（可關閉，
localStorage持久化）。 - 三模式視圖：Open Wiki（倉庫 Wiki 文檔樹）、知識卡片（Grounded Claims 溯源抽點）與知識庫（personal 模式個人知識庫）三個常駐 Tab。
- 文檔閱讀：預覽 / 代碼雙視圖，目錄分欄（點擊「目錄」在工具欄下方分出左側目錄面板，獨立豎滾動條、sticky 不隨正文滾動）。
- 知識卡片：Grounded Claims 溯源抽點（statement + evidence）。
- 生成任務：實時進度（已完成 X/Y (Z%)，處理中: N，失敗: M），斷點續跑依賴 openwiki 的
.run.json。 - 模型複用：讀取 DSH 默認模型（
agentDefaultModel）與憑證，映射爲 openwiki 的 provider 配置寫入~/.openwiki/.env。 - 運行時託管：自動檢測 openwiki CLI（解析 npm shim）、版本檢查（registry）、安裝 / 升級 / 自檢（
--help）。 - 自動更新：輪詢各工作區 git HEAD，檢測到新提交自動跑增量更新（openwiki 無原生 git 觸發器，由插件補上）。
- better-sidebar 集成：檢測到
dsh-better-sidebar服務即自動註冊一個側邊頁面。 - 忽略文件：
.openwikiignore（gitignore 語法）圖形化編輯保存。 - 設置頁：運行時 / 模型 / better-sidebar 註冊 / 入口顯隱。
安裝與啓用¶
前置依賴：Node ≥ 20、openwiki CLI（插件可自動安裝）。
安裝命令：
dsh plugin --profile web add dsh-openwiki
安裝後配置：
# 編輯 <你的 DSH 用戶目錄>\profiles\web\cordis.patch.yml，追加：
- id: dsh-openwiki
name: 'dsh-openwiki'
典型用法¶
- 生成：點擊刷新或重新生成按鈕。
- 查看：點擊知識庫入口，使用 Tab 切換模式。
注意事項¶
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
fs.readBytes超限會拋錯（不是截斷）。- manifest 缺失時需走 disk-scan fallback。
- Windows 下不要 spawn
.cmd。 settings namespace依賴@deepseek-ai/schemastery，從 profile 動態 import 可能失敗。- client 服務註冊表每次刷新重建。
- openwiki 無 git 觸發器，由插件補上。
- 非 git 倉庫無法生成。
- Markdown fence 檢測需
startsWith('```')。 - 性能：空閒輪詢只刷 jobs + overview，有任務才全量 refreshWorkspace。
總結¶
該插件把 openwiki 當作增量生成引擎，DSH 側負責 UI、任務編排、模型橋接與觸發器。適合需要在 DSH 內直接管理代碼庫知識、複用模型配置的開發者。更多信息見 catalog_url 或 github_url。
