前言¶

做智能体开发的过程中，常会遇到这种情况：对话里冒出一个「可以做个 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