前言¶

在 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