前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常腳本時，筆記往往散落在 Obsidian Vault、Notion 頁面、飛書文檔，待辦又在滴答清單。各自打開應用查統計、搜標題、對任務，和在同一側邊欄裏看總覽、預覽 Markdown、深鏈回源相比，切換成本更高。下面介紹社區插件 dsh-knowledge-board（倉庫 PowehiG/dsh-knowledge-board）：把上述來源接到同一塊 Web 看板，並提供 Host 側 Agent 工具 knowledge_board 只讀查詢。
這是什麼¶
dsh-knowledge-board 由維護者 PowehiG 發佈，分類爲客戶端插件。形態是 Host 數據連接器加 DSH Web 側邊欄面板「知識看板」，無第三方運行時依賴；界面主題跟隨 DSH 深色或淺色。未配置的來源用演示數據兜底，便於先熟悉佈局再填 Token。
- 插件包名：
dsh-knowledge-board - 當前版本（package.json）：
1.0.0 - 許可證：MIT
核心功能¶
總覽與文檔庫¶
總覽側展示文檔總數、總字數、本週更新、待辦，以及 12 周趨勢、來源分佈、最近更新、今日焦點、標籤分佈。文檔庫支持跨來源搜索、篩選、排序；行內可預覽 Markdown，或通過深鏈打開原應用。
知識地圖與待辦¶
知識地圖提供來源卡（路徑、數量、字數）、目錄樹、12 周熱力圖、格式分佈、90 天未更新等視圖。待辦按已逾期、今天、本週、以後四列展示；可勾選完成，快速添加會寫回滴答清單。
設置與 Agent¶
設置裏可配置 Obsidian Vault、Notion Token、飛書應用、滴答 Token，每個來源支持測試連接。Agent 工具名爲 knowledge_board，供模型查詢文檔統計、搜索結果、待辦並觸發刷新；按 README 說明，該工具只讀統計、標題、路徑、任務，不返回 Token。
安裝與啓用¶
要求：DeepSeek Harness >= 0.2.0-rc.2，Node.js 22+。
方式 A：npm（README 推薦給最終用戶）¶
發佈方需先執行（維護者側）：
npm publish --access public
在 DSH Web 打開 Plugins → Add，填入包名：
dsh-knowledge-board
安裝後刷新頁面，側邊欄出現「知識看板」圖標。
方式 B：GitHub¶
倉庫需已構建並提交 client.js。在 Plugins → Add 中填寫（將 your-name 換爲實際用戶名）：
github:your-name/dsh-knowledge-board
方式 C：本地目錄或開發¶
cd ~/.dsh/profiles/<your-profile>
pnpm add link:/absolute/path/to/dsh-knowledge-board
在該 profile 的 package.json 中加入 bundle：
{
"dsh": {
"profile": {
"bundles": ["dsh-knowledge-board"]
}
}
}
重啓 DSH 或重新加載 profile。Client 改動需刷新頁面；pnpm run dev:web 時支持 Web 熱更新。
插件以當前 DSH 進程權限運行；安裝前建議查看倉庫源碼與 MIT 許可證。
典型用法：連接各來源¶
打開看板 → 設置，按來源逐步配置。
Obsidian¶
自動探測常見 Vault 路徑（如 ~/Documents/Obsidian Vault、iCloud 下的 Obsidian 目錄）；也可手動填寫 Vault 路徑，一行一個。只讀 Markdown，不修改本地文件。本地圖片附件 ![[...]] 僅顯示佔位，README 標明不提供附件服務。
Notion¶
- 在 Notion Integrations 創建 Internal Integration，複製 Token。
- 在目標頁面右上角
···→「連接」中加入該集成。 - 填入看板設置並測試連接。
飛書文檔¶
- 在 飛書開放平臺 創建企業自建應用，獲取 App ID / App Secret。
- 權限管理開通：
drive:drive、docx:document:readonly、wiki:wiki:readonly、offline_access。 - 安全設置中重定向 URL 添加：
http://127.0.0.1:17890/knowledge-board/oauth/callback。 - 發佈版本後，在看板設置中完成「授權讀取我的飛書文檔」。
授權後同步個人「我的空間」和知識庫；「知識庫空間」可填空間名稱或 space_id 限定單一知識庫，留空表示全部。租戶 token 無法看到個人「我的空間」，須完成個人 OAuth。
滴答清單¶
使用 滴答清單 Web → 頭像 → 設置 → 賬戶 → API Token（非開發者後臺 Client ID / Secret），創建後填入設置。
數據與安全¶
- 配置路徑：
~/.dsh/storages/knowledge-board/config.json（目錄權限 700，文件 600）。 - 快照：
snapshot.json用於秒開，過期後後臺刷新。 - Token 僅在本機 Host 進程使用，接口返回時脫敏；請求從本機直連各官方 API。
適用場景與已知限制¶
適合需要在 DSH 內統一瀏覽多源筆記、查看統計與熱力圖，並把滴答待辦與文檔上下文放在一起的操作習慣。飛書個人空間或滴答賬號內容很少時，看板條目也會偏少；知識庫需 wiki:wiki:readonly，權限未發佈時可能出現 99991679 / 20027。本機應用喚起（open -a）目前僅 macOS，文檔同步跨平臺可用。演示數據僅在未配置任何來源時出現。
結尾¶
dsh-knowledge-board 把 Obsidian、Notion、飛書文檔與滴答清單收進 DSH 側邊欄，配合 knowledge_board 工具便於智能體側只讀檢索。目錄頁：skillhub.cn 插件條目；源碼與完整配置說明：GitHub README。
