前言¶

在 DeepSeek Harness（DSH）裏和模型對話時，未成形的想法很容易被滾動的會話頂走；單獨開筆記或待辦，又往往和「正在聊什麼」脫節。靈感池把「記下來 → 看一眼 → 推進一步 → 收口」收進 DSH 側欄：一句話入池、原文逐字保留，進展用追加方式記錄，產出鏈接掛在同一條想法上。數據默認只在本機，不註冊賬號、不做遙測；需要多設備接力時再自行配置雲端後端。

下面按定位、能力、安裝配置與典型用法介紹該插件。事實依據爲倉庫 README 與 package.json（版本 0.3.1）。

這是什麼¶

靈感池（Idea Pool）是由 endlass 維護的 DSH 客戶端插件：在側欄提供獨立頁面，同時註冊會話內的 idea_pool agent 工具，與界面共用同一套存儲服務。分類上屬於客戶端插件；在 npm 上以包名 dsh-idea-pool 發佈，許可證 MIT。

插件面向 DSH 0.2.x（package.json 要求 dsh >=0.2.2-rc.1 <0.3.0）。升級到 DSH 0.3.x 前，需按倉庫說明重新做兼容驗證。

核心功能¶

側欄工作臺¶

側欄頁面主要包括：

1. 頂部常駐錄入條：原文逐字保存，支持 ⌘/Ctrl+Enter 入池。
2. 列表：按狀態篩選、搜索、排序；「梳理」視圖按 待決定 / 該推進了 / 正在推進 分桶，並可隨機撈一條。
3. 詳情：原文、摘要、進展時間線、關聯產出、關聯 DSH 會話，以及狀態切換。
4. 一鍵推進：打開新會話並預填推進提示詞（不自動發送）；在會話唯一時自動回填關聯。

本機與雲端兩種存儲¶

本機模式支持 30 步撤銷（三方合併語義：撤銷某步不會抹掉之後他人的改動）。雲端模式使用 rev / if_rev 樂觀鎖，衝突時返回 409，需刷新後重試；雲端模式暫不支持撤銷。

本機與雲端之間不是雙向同步：本機可從雲端做單向增量刷新（合併雲端多出的想法/進展/產出，本機獨有內容保留）；本機新內容不會自動回寫雲端。

會話內 agent 工具¶

除側欄 UI 外，插件提供 idea_pool 工具，操作包括：add / list / get / progress / link / status / export，與界面共享服務層。

安裝與啓用¶

環境要求：Node.js >=20（開發與構建）；運行側以已安裝的 DSH 桌面版爲準。

方式一：npm 包（推薦）¶

在 DSH「插件」頁 → 添加插件 → 輸入 dsh-idea-pool@0.3.1；或在本機終端執行：

dsh plugin --profile desktop add dsh-idea-pool@0.3.1

npm 包頁：https://www.npmjs.com/package/dsh-idea-pool。安裝後側欄出現「靈感池」；桌面版裝完後建議重開一次應用。本機模式零配置即可使用。

方式二：本地源碼或 tgz¶

在倉庫根目錄構建後，以本地路徑安裝（完整排障見倉庫 INSTALL.md）：

npm ci && npm run build
dsh plugin --profile desktop add "file:$PWD"

卸載命令：

dsh plugin --profile desktop remove dsh-idea-pool

卸載不會刪除數據；徹底清理需手動刪除 $DSH_HOME/idea-pool/。

安全說明：插件以當前 DSH 進程權限讀寫本機目錄、發起你所配置的雲端請求。安裝前請查看源碼與 MIT 許可證，雲端 Key 僅落在本機 settings.json（權限 600），使用前確認後端歸屬與隱私邊界（見倉庫 SECURITY.md）。

配置¶

入口：靈感池面板右上角「設置」。配置寫入 $DSH_HOME/idea-pool/settings.json（文件權限 600；密鑰只落盤、不回傳瀏覽器）。

本機數據：$DSH_HOME/idea-pool/state.json（目錄 700、文件 600），同目錄有每日 state.json.bak 與寫鎖 state.lock。刪除 state.json 即清空本機池；備份可拷貝該文件或使用設置中的「導出 JSON」。

可選：啓用雲端模式¶

1. 準備 ideas-api v2 兼容後端（rev / if_rev / client_id）。無現成服務時，可用倉庫自帶輕量服務，在 compose.yaml 中替換 IDEAS_API_TOKEN 後執行：

   docker compose up -d

或：python3 server/ideas_api.py。

2. 設置 → 運行模式 → 雲端模式。
3. 填寫雲端地址（示例：http://你的主機:8794/api）與 API Key（自建版對應 IDEAS_API_TOKEN）。
4. 點「測試連接」確認條數與延遲後保存。

需要把雲端已有內容一次性導入本機時，可使用倉庫腳本 scripts/import-cloud.mjs（--base 必填，見文件頭註釋）。

典型用法¶

在側欄快速沉澱想法¶

1. 打開 DSH 側欄「靈感池」。
2. 在頂部錄入條輸入原文，用 ⌘/Ctrl+Enter 入池。
3. 在列表或「梳理」視圖按狀態查看；需要推進時在詳情裏使用「一鍵推進」，在新會話中編輯預填提示詞後再發送。

在會話裏用 agent 記一筆¶

在已安裝插件的 DSH 會話中，可通過 idea_pool 的 add、list、get、progress、link、status 等動作維護同一份賬本，適合邊聊邊記、不改 UI 焦點。

本機優先、按需接力¶

默認本機模式不聯網，適合個人單機使用。多設備共用時切換到雲端模式並指向自有後端；若本機曾從雲端導入快照，頂部狀態條會提示落後雲端多少，可用「從雲端刷新」單向合併，避免誤以爲雙向同步。

適用場景與注意¶

適合在 DSH 日常對話中頻繁產生碎片想法、又希望與「推進會話」「產出鏈接」留在同一工作臺的開發者。已知限制包括：雲端列表首屏最多 500 條；單用戶、無多人權限體系；Electron 內導出 JSON 的落盤行爲倉庫標明尚未真機確認；雲端模式隱藏撤銷入口。

DSH 生態奉行「一切皆插件」；社區目錄站點與 DeepSeek / 幻方無官方從屬關係，本文僅介紹第三方開源插件的使用方式。

參考鏈接¶

• 社區目錄：https://www.skillhub.cn/plugins/endlass/dsh-idea-pool
• 源碼與文檔：https://github.com/endlass/dsh-idea-pool