前言¶
用 DSH 干活时，脑子里常会冒出还没排进当前任务的事：想试一个新插件、改一版方案、回头查一段资料。记在手机便签里和对话上下文脱节；全塞进当前会话又容易淹没。需要的是一句话能记下来、能按状态整理、还能交给 Agent 或 CLI 同一份数据读写。
下面介绍社区插件 dsh-thought-capsule（维护者 Holo-dataanalyst），在 SkillHub 分类为「记忆」。它把点子写成「胶囊」，经固定分类与状态流转整理成待办，并提供侧边栏面板、Agent 工具与命令行，数据落在本地 JSON。
这是什么¶
思维胶囊的定位是：干活时想到的点子、待试插件、待查事项，用一句话写入；插件会做自动分类，并在面板里按 未整理 → 待办 → 已完成 → 归档 等状态管理（README 还提到六种固定分类自动归类，并可自建分组）。它不是单纯便签：单条或批量可「转给 AI」，对话里也可让 Agent 调用 capsule_add 记一条。
- 目录页：skillhub.cn/plugins/Holo-dataanalyst/dsh-thought-capsule
- 源码与文档：github.com/Holo-dataanalyst/dsh-thought-capsule
- 当前包版本（package.json）：
0.2.2，许可证 MIT
核心功能¶
侧边栏面板与入口¶
- 左侧栏 胶囊图标 打开主面板；在面板 ⚙ 中可开启 悬浮球，点击弹出便签式输入。
- 面板上方输入框：写完按
Enter保存（Shift+Enter换行），新条目先进「未整理」。 - 卡片底部状态段点击即可挪动；✎ 可就地改文字与分类。
与 AI 协作¶
- 随手记：例如在对话里说「记一下：试试 better-sidebar 插件」，Agent 会调
capsule_add；也可直接写在面板输入框。 - 转给 AI：单条「转给 AI」，或勾选多条「批量转给 AI」→ 选工作区与会话 →「准备提交」只把内容放进该会话输入框、不自动发送；转出后条目变为「已完成」并记录转给了谁。
- 找漏掉的待办：面板右上「找漏掉的待办」读取最近会话，由宿主默认模型列出可能遗忘事项，可逐行「存胶囊」或「忽视」（
POST /api/find-missed，不新开会话）。
阅读与回顾¶
- 划词捕获：读网页或文档时选中至少 2 个字，选区旁浮出「记下来」，一键存为「阅读」类胶囊并带来源；默认关闭，需在 ⚙ 或设置中打开（
settings.float.capture）。 - 本周回看：页签右侧按钮，本地统计本周新增、完成、归档及超过 7 天未动的待办，不调模型。
- 搜索：当前页签与分类下边打边筛（本地过滤）。
命令行与数据¶
安装后提供 dsh-thought-capsule 命令，与面板、Agent 共用 capsules.json。支持 add / list / update / categories / path / export 等；读命令可加 --json。
数据默认在 <profile 目录>/.dsh-thought-capsule/capsules.json，可通过插件 config 的 dataDir 覆盖；真实路径也可查 GET /thought-capsule/api/health 返回的 dir / file。写入采用备份、临时文件与回读校验，异常时用 .bak 恢复。面板设置里 导出 JSON 可整库备份。
说明：Agent 侧故意不提供删除胶囊的工具，删除需在面板二次确认。
安装与启用¶
要求 DSH >= 0.1.7-rc.2（dsh.engines 会拦截旧版）、Node >= 22。装完后需 重启 DSH。
# 跟随 main
dsh plugin --profile <档案> add github:Holo-dataanalyst/dsh-thought-capsule
# 钉死某个 Release 的 tag（推荐）
dsh plugin --profile <档案> add github:Holo-dataanalyst/dsh-thought-capsule#v0.2.2
# 不装 git 也行：直接装 Release 附件
dsh plugin --profile <档案> add https://github.com/Holo-dataanalyst/dsh-thought-capsule/releases/download/v0.2.2/dsh-thought-capsule-0.2.2.tgz
也可在插件市场搜索 thought-capsule 一键安装。首次上手可看仓库内 docs/tutorial.md（README 称约五分钟上手与五个场景）。
典型用法¶
面板三步¶
- 打开胶囊面板或悬浮球。
- 输入一句话，Enter 记入「未整理」。
- 点状态段移到「待办」，需要实现时再「转给 AI」。
CLI 示例¶
下列命令与 README 一致，<档案> 需换成你的 profile 名；桌面端若 $DSH_HOME 不在环境里，可对 CLI 使用 --data 指向 profile 目录。
dsh-thought-capsule add "试试 better-sidebar 插件"
dsh-thought-capsule add "周五交汇报" -c work --due 2026-10-23 --tag 汇报
dsh-thought-capsule list -s todo -n 5
dsh-thought-capsule update <id> -s done
dsh-thought-capsule export > capsules.json
数据目录解析顺序：--data <dir> > --profile <name> > $DSH_HOME > ~/.dsh。
适用场景与注意¶
适合谁：长期在 DSH 里做方案、试插件、读长文的开发者，希望灵感与待办和当前工作区、会话在同一套 UI 与 API 里流转，而不是散落在系统备忘录里。
权限与安全：插件以当前 DSH 进程权限运行，可读写 profile 下的 capsules.json 并调用宿主模型做「找漏掉的待办」。安装前建议浏览 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。
排障提示（来自 README 常见问题）：刷新后未见新功能可先 Ctrl+R；左侧无胶囊图标可查 GET /thought-capsule/api/client-report；悬浮球可用 Alt+C 隐藏（焦点在输入框时不抢键）。
DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
思维胶囊把「一句话灵感」收成可分类、可跟进、可交给 Agent 的本地数据，面板、划词、回看与 CLI 共用一份 capsules.json。若你要在 DSH 记忆里少丢点子，可从目录页或上述安装命令启用当前 release（如 v0.2.2）。
