MIT 授權的 DeepSeek Harness 原生外掛，串接 Graphify 本地程式碼知識圖譜引擎：`/graphify` 建置圖譜，agent 直接查詢符號、相依性與架構社群，compact 模式專為本地小模型設計。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-10-31
授權條款
MIT
01它能幫你完成什麼？
用圖譜驅動的程式碼地圖回答架構問題，不必反覆猜路徑、翻檔案
從 `graphify-out/graph.json` 取出符號、相依路徑、架構社群，以及由圖譜支撐的專案上下文
在 DSH 會話裡探索或接手一個儲存庫的開發者
更動介面之前先評估影響範圍
到呼叫方的相依路徑、被相依方、最短路徑、所屬社群，以及 PR 影響分析（full 模式）
在 DSH 會話裡審查高風險變更的工程師
讓本地小模型在會話裡穩定地用上圖譜
compact 模式註冊六個高頻工具：狀態、圖譜查詢、節點檢視、鄰居、最短路徑、會話層級圖譜資源
在 DeepSeek Harness 裡跑本地 20B–30B 模型、工具選擇能力有限的團隊
02如何將外掛接入 DeepSeek Harness？
先決條件
- 一個可用的 DeepSeek Harness（DSH）profile
- Node.js 22.18 或更新版本
- Python 3.10 或更新版本
- `uv`——安裝 Graphify 執行環境時會用到
安裝步驟
- 01
把外掛加入 DSH profile：執行 `dsh plugin --profile <profile> add dsh-graphify`（把 <profile> 換成你平常跑 DSH 的那一個；bundle 會自行啟用，預設設定不必手動改 Cordis 設定）
$ dsh plugin --profile <profile> add dsh-graphify
- 02
安裝本地 Graphify 執行環境：執行 `uv tool install 'graphifyy[mcp]==0.9.57'`——如果是 DSH 啟動之後才裝的，裝完喊一聲 `graphify_status`，外掛會在下一次檢查或工具呼叫時自動找到執行環境，不必重新啟動 DSH
- 03
建置圖譜：在你想探索的儲存庫目錄下啟動 DSH（`cd /path/to/your/repository && dsh --profile <profile>`），在會話裡執行 `/graphify`——完整建置，會在儲存庫寫入 `graphify-out/graph.json`
驗證整合成功
- 在 DSH 會話裡執行 `graphify_status`：它會回報解析出的專案、圖譜路徑、執行環境可用性、連線狀態，以及圖譜是否與已索引的原始碼狀態一致
03DSH 整合程度與能力邊界
DSH 原生外掛，透過 `dsh plugin add` 加入：解析目前會話的專案、管理 Graphify MCP 程序、在會話裡註冊圖譜工具
/graphify 建置與更新圖譜
DSH 會話啟動時所在的儲存庫→完整建置並寫入 `graphify-out/graph.json`，或透過 `/graphify update` 做保守的純程式碼增量更新
會在儲存庫寫入 `graphify-out/graph.json`增量更新只對外掛能證明是純程式碼的變更執行；否則圖譜會保持「已過期」標記，直到跑一次完整 `/graphify` 建置full / compact 工具模式
`toolMode` 設定——`full`（預設）或 `compact`→full 公開完整的 Graphify 能力集（含社群、god node、PR 影響）；compact 只註冊六個高頻導覽工具，鎖定本地 20B–30B 模型
graphify_status 診斷
在 DSH 會話裡呼叫→解析出的專案、圖譜路徑、執行環境可用性、連線狀態，以及圖譜與已索引原始碼狀態是否一致
會話層級專案解析與隔離
目前的 DSH 工作區→圖譜請求跟隨目前會話的專案
預設阻擋模型存取工作區以外的專案；需要時再明確設定 `allowExternalProjects: true`本地執行環境韌性管理
本地安裝的 Graphify 執行環境（uv tool）→自動探索執行環境、MCP 程序意外結束後自動重連，並可用 `graphifyVersion` 固定 uv 後備版本
外掛會為會話管理 Graphify MCP 程序
04適合誰？何時不該用？
適合
- 在 DSH 會話裡探索或接手一個儲存庫的開發者
- 在 DSH 會話裡審查高風險變更的工程師
- 在 DeepSeek Harness 裡跑本地 20B–30B 模型、工具選擇能力有限的團隊
不適合
- 增量更新只涵蓋程式碼擷取。改了說明文件、套件中繼資料或設定之後，圖譜會進入過期狀態，需要完整 `/graphify` 重建；`freshness.mode` 預設為 `warn`（想要查詢前自動做安全更新就設 `auto`，只在刻意接受靜態圖譜時才設 `off`）。
05相容性、維護與安全提醒
- 僅在 macOS 和 Ubuntu Linux 上測試過，Windows 尚未驗證。整套軟體堆疊還需要 Node.js 22.18+、Python 3.10+ 和 `uv`。
- 相容 `@deepseek-ai/cordis` >=4.0.4 <5；針對 DeepSeek Harness 0.2.0-rc.2（含 0.2.1-alpha 通道）與 Graphify 0.9.57 測試，即時 contract 檢查與 schema 漂移檢查在 Graphify 0.9.90 上也通過。
- 增量更新只涵蓋程式碼擷取。改了說明文件、套件中繼資料或設定之後，圖譜會進入過期狀態，需要完整 `/graphify` 重建；`freshness.mode` 預設為 `warn`（想要查詢前自動做安全更新就設 `auto`，只在刻意接受靜態圖譜時才設 `off`）。
- 圖譜請求跟隨目前的 DSH 工作區；除非刻意設定 `allowExternalProjects: true`，模型無法存取工作區以外的專案。
- 儲存庫裡的 BENCHMARK.md 定義的是針對 Graphify 輔助 agent 的規劃中評估協定——屬於實驗性方案，不是已發布的效能資料。
MIT · 持續維護中（最新發布 v0.2.1，2026-10-13）
06常見問題
Graphify 是什麼？
Graphify 是一個本地程式碼知識圖譜引擎，會把儲存庫裡的符號、相依性和架構社群建成一張圖，上游專案位在 GitHub（Graphify-Labs/graphify）。dsh-graphify 則是 DeepSeek Harness 原生的外掛層，負責把 DSH 會話接到這張圖上——引擎和外掛分開安裝：引擎用 `uv tool install 'graphifyy[mcp]==0.9.57'`，外掛用 `dsh plugin add dsh-graphify`。
dsh-graphify 怎麼安裝？
三個步驟：先用 `dsh plugin --profile <profile> add dsh-graphify` 把外掛加入 DSH profile；再用 `uv tool install 'graphifyy[mcp]==0.9.57'` 安裝執行環境；最後在你想探索的儲存庫目錄下啟動 DSH，執行 `/graphify`。前置條件：可用的 DSH profile、Node.js 22.18+、Python 3.10+ 和 `uv`。
Graphify 如何把程式碼庫變成知識圖譜？
在你的儲存庫目錄下啟動 DSH，在會話裡執行 `/graphify`：指令會做一次完整建置，產生 `graphify-out/graph.json`，把符號、相依性、架構社群和 god node 都映射進圖譜。更新策略偏保守——增量更新只涵蓋程式碼擷取，改了說明文件或設定之後要跑一次完整 `/graphify` 重建。
full 和 compact 模式有什麼差別？
預設的 `full` 模式公開完整的 Graphify 能力集，包括社群、god node 和 PR 影響分析。`compact` 只註冊六個高頻工具——狀態、圖譜查詢、節點檢視、鄰居、最短路徑、會話層級圖譜資源——更適合本地 20B–30B 模型：選擇變少，小模型反而更能穩定發揮圖譜價值。
支援 Windows 嗎？
外掛在 macOS 和 Ubuntu Linux 上測試過，Windows 尚未驗證。相容 `@deepseek-ai/cordis` >=4.0.4 <5，針對 DeepSeek Harness 0.2.0-rc.2（含 0.2.1-alpha 通道）與 Graphify 0.9.57 測試，Graphify 0.9.90 也通過即時 contract 檢查與 schema 漂移檢查。
07相關的 DSH 工作流程
weknora
作者 tencent
開源的 LLM 知識庫平臺：把原始文件轉化為可檢索的 RAG 知識庫、自主推理智慧體和自動維護的 Wiki 系統，支援多租戶部署。
honcho
作者 plastic-labs
用於構建有狀態 AI 智慧體的記憶庫，支援跨會話連續學習與上下文工程。
webnovel-writer
作者 lingfengqaq
基於 Claude Code 的長篇網文輔助創作系統，解決 AI 寫作中的「遺忘」和「幻覺」問題，支援 200 萬字量級 連載創作。
mirage
作者 strukto-ai
全球首個面向 AI 智慧體的統一虛擬檔案系統。
08資料與來源
`dsh-graphify` connects [Graphify](https://github.com/Graphify-Labs/graphify)'s code knowledge graph to DeepSeek Harness…
The plugin resolves the active session project, manages the Graphify process, and provides `graphify_status` for diagnos…
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生；最後核實於 2026-10-31。發現錯誤？提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛，涵蓋各個分類。