前言¶

做智能體開發的過程中，常會遇到這種情況：對話裏冒出一個「可以做個 XX 工具」的念頭，當時覺得有價值，隨手略過，事後想不起來。這類想法的特點是散落、模糊，但其中一部分日後確實能長成項目，甚至彼此關聯。

常見的處理方式是記到備忘錄或者另開一個筆記應用，代價是離開當前工作環境，而且後續的篩選、評估、立項都要手動搬運。靈犀（Lingxi）的思路是把這一整條鏈路放進 DSH 裏：隨時錄入 → 隨時打撈深入 → 制定計劃 → 立項管理，中間的解析、評分、打標籤、關聯檢測交給 AI 完成。

這是什麼¶

靈犀是一個 DSH Web GUI 插件，由 ppjun2026 維護，許可證爲 MIT，當前 package.json 中的版本爲 0.2.0。安裝後在 DSH 側邊欄出現「靈犀」入口，點擊即可在主區打開靈感工作臺。

它解決的問題是：想法從「一句話」到「一個有任務看板的項目」之間缺少一個承載和加工的場所。靈犀用一份單文件 JSON 存儲所有想法、項目與合併記錄，並提供對話、網頁兩個使用通道。

核心功能¶

靈感池與生命週期¶

• 靈感池以卡片牆展示所有想法，支持按狀態、標籤、關鍵詞篩選與搜索。
• 每條想法有完整的生命週期：靈感種子 → 孵化中 → 計劃中 → 已立項，另有「已合併 / 已歸檔」兩個終態。
• 網頁頂部有快捷框，輸入想法回車或點「入池」即可錄入；也可以在對話裏直接對 DSH 助手說一個想法。
• 每條想法可累積「構想記錄」，方便持續補充思路。

AI 解析與關聯合並¶

以下能力通過對話通道完成，由 AI 讀寫數據文件：

• 一句話概括、展開解析、多維評分（新穎性 / 可行性 / 價值潛力 / 綜合）、自動標籤、領域分類。
• 檢測想法之間的關聯，給出高 / 中 / 低關聯度及理由；關聯度高的想法會建議合併，合併後保留歷史。

另外提供 Canvas 力導向網絡圖，直觀查看想法之間的關聯簇。

立項與任務看板¶

想法進入「已立項」後，會生成對應的項目和任務看板。看板分待辦 / 進行中 / 已完成三列，任務支持優先級（高 / 中 / 低）與截止日期，逾期會自動標註。

安裝與啓用¶

安裝方式二選一，在 DSH 環境中執行：

# 方式一：從 Git 倉庫安裝（link 模式，改代碼後重啓 DSH 生效）
dsh plugin --profile web add "link:<本倉庫路徑>"

# 方式二：從 npm 安裝（發佈後）
dsh plugin --profile add @linxin666/dsh-client-ui-lingxi

注意：npm 安裝方式在 README 中標註爲「發佈後」可用，即以倉庫實際發佈狀態爲準。

安裝後重啓 DSH，側邊欄出現「靈犀」入口即安裝成功。如果打算改代碼，可以在倉庫目錄內用 link 模式做本地安裝，修改後重啓 DSH 即生效：

dsh plugin --profile web add "link:."

數據存儲與配置¶

數據存放在單文件 JSON 中，可隨時備份、導出、遷移。默認位置和相關配置如下：

• 默認路徑：~/.dsh/lingxi/lingxi-data.json（lib/index.js 中的兜底路徑）
• 可通過 cordis.patch.yml 的 config.dataFile 指定路徑，相對 / 絕對路徑均可
• 也可用環境變量 LINGXI_DATA_FILE 覆蓋

數據文件的核心結構大致如下（節選自 README）：

{
  "ideas": [{
    "id": "…", "raw": "原始想法", "title": "一句話標題",
    "status": "seed|incubating|planning|project|merged|archived",
    "scores": { "novelty": 0, "feasibility": 0, "value": 0, "overall": 0 },
    "tags": ["…"], "domain": "領域",
    "related": [{ "ideaId": "…", "strength": "high|medium|low", "reason": "…" }]
  }],
  "projects": [{ "id": "…", "ideaId": "…", "name": "…", "tasks": ["…"] }],
  "merges": [{ "intoId": "…", "fromId": "…", "reason": "…" }]
}

典型用法¶

靈犀有兩條使用通道，共享同一份數據文件。

通道一：對話（推薦）¶

在任意對話裏對 DSH 助手說即可，例如：

我又有個想法：做一個把散落靈感收集成項目池的工具
解析一下靈犀裏的新想法
靈犀裏有哪些想法關聯性很強？幫我合併
幫我把「xxx」這個想法深入構想一下
把「xxx」立項，制定一個計劃

助手會讀寫數據文件，完成解析、評分、打標籤、關聯檢測與合併，網頁刷新即可看到結果。

通道二：網頁¶

1、側邊欄點「靈犀」進入工作臺；
2、在頂部快捷框輸入想法，回車或點「入池」。

網頁錄入的想法先以「靈感種子」入池，後續的 AI 解析可以再回到對話裏讓助手處理。

實現要點¶

• 文件即真相：宿主側每次讀寫都直接操作 JSON 文件，不做緩存。因此對話通道（AI 直接寫文件）與網頁通道（經 /api/lingxi 路由寫文件）天然共享同一份數據，不存在同步問題。
• API 面很小：只有 GET /api/lingxi/state（讀全量）和 POST /api/lingxi/action（寫變更）兩個接口，且僅迴環 + 同源可訪問。
• 架構清晰：lib/index.js 爲 Host 側，負責 API 路由和系統提示注入；lib/client.js 爲瀏覽器側，負責渲染工作臺。
• 零構建工具鏈：純手寫 ESM + 原生 DOM，不依賴 TypeScript、React 或任何構建工具，想讀源碼或二次開發的門檻很低。

適用場景與注意¶

適合已經在使用 DSH、希望把日常想法管理收進同一個工作流的人：對話裏隨手記、讓 AI 定期整理評分、關聯合並，成熟了直接立項看板，全程不離開當前環境。

使用前有幾點需要注意：

1、插件以當前 dsh 進程的權限運行，能讀寫文件、註冊路由，安裝前建議先查看源碼與許可證（本項目爲 MIT）；
2、link 模式安裝後修改代碼，需要重啓 DSH 才生效；
3、數據是單文件 JSON，注意定期備份。

結尾¶

靈犀做的事情很集中：給想法一個統一的池子，用 AI 降低整理成本，用生命週期和看板把「想到」和「做成」連起來。對於想在 DSH 裏沉澱靈感的開發者，可以直接試用。

• 插件目錄頁：https://www.skillhub.cn/plugins/ppjun2026/dsh-client-ui-lingxi
• GitHub 倉庫：https://github.com/ppjun2026/dsh-client-ui-lingxi