对话收藏夹 xypang33-sketch/dsh-save-chat

dsh-save-chat

Awesome DSH Plugin

我发现自己经常在跟 AI 重复问一样的问题, 不知道你们有没有这样的问题? 一个报错明明之前解决过，过几天又碰到，却找不到当时的回答。一个方案之前聊了半天，换个会话，又得再问一遍,等AI再答一遍. 来来回回，造了不少重复的轮子。
所以做了个插件 dsh-save-chat，把聊过的、有用的东西存下来，以后接着用。

把好的回答留下来。 点一下心形，就把整轮对话（你的问题 + 完整回答）存成项目里的真实 Markdown 文件；之后面板可以浏览它们，模型也能按需检索它们。

English · 完整参考

零依赖、无数据库，就是你自己的 Markdown 文件。

60 秒上手

装好之后，一条完整动线是这样：

1. 点一下红心，收下这一轮。 任意一条回复下方的动作行里，红心就是收藏按钮——整轮问答（你的问题 + 完整回答）会写进 <会话工作目录>/.dsh-favorites/<会话标题>.md。

在动作行收藏一轮对话

2. 在侧栏「收藏」里翻看。 左侧是按工作区 / 会话 / 条目分组的可搜索树（知识库视图按月份分组），右侧并排渲染选中的那一节；工具条可切换「只看该节 / 展开全文」、在文件夹中显示、关闭阅读区。

浏览收藏与知识库

3. 把值得留的加入个人知识库。 右键任意条目：置顶 / 重命名 / 复制引用 / 加入个人知识库 / 删除；右上角的「知识库」切换到知识库视图，顶部提示写明了它的行为。

把这一轮加入个人知识库

知识库视图与它的提示

4. 在之后的对话里用起来。 「复制引用」把 @文件路径 放进剪贴板，粘到新对话里模型就会读到这份记录；也可以直接问"上次那个结论是什么"，它会调用 search_knowledge 找到你保存的那一轮，并给出文件与日期。知识库的内容只在模型需要时才会被检索，不会自动注入对话。

复制引用，可粘到之后的对话里

安装

桌面 App 和 dsh web 两种形态都适用。插件会装进当前正在运行的那个 profile：桌面 App 是 desktop，dsh web 通常是 web。用界面不需要知道 profile 名，用命令则必须写对。

用界面（通用，dsh web 也一样）

打开 设置 → 插件 → 添加插件。包名、仓库地址、预构建 .tgz、本地路径都能填，日常最常用的是这两种：

| 粘贴内容 | 来源 |
| dsh-save-chat | npm（国内镜像同样可用） |
| 本地目录的绝对路径 | 开发调试用 |

然后重启 DSH（dsh web 就重启那个进程），再刷新页面。

用命令行

dsh plugin 会把参数交给 pnpm，并且必须带 --profile <名字>：写你实际运行的那个 profile（桌面 App 是 desktop，dsh web 是 web，自定义的就写自定义名）。在哪个目录执行都可以。

dsh web
dsh plugin --profile web add dsh-save-chat
桌面 App
dsh plugin --profile desktop add dsh-save-chat

命令行接受同样的几类形式（包名、仓库地址、预构建 .tgz、本地路径），例如预构建包（不克隆、不构建）：

dsh plugin --profile web add https://github.com/xypang33-sketch/dsh-save-chat/releases/latest/download/dsh-save-chat.tgz

这里的 dsh 就是你平时启动 DSH 的那个命令（dsh web，或桌面 App 自带的那一份）。它在哪个目录执行都可以；如果你手上没有这个命令（例如只装了桌面 App），直接用上面的界面方式即可。

插件市场（可选，不是人人都有）

如果你装了社区插件 dshmarket（插件市场），本插件被收录后也会出现在那里，可一键安装。市场本身是一个插件、不属于 DSH 自带功能，所以这条路只在你先装了它之后才存在。

DSH 目前不支持插件自动更新——升级需要先卸载再安装新版本。

为什么用它

同类书签插件已经存在，这个的差别在四点：

| | dsh-save-chat |
| 存什么 | 整轮问答（你的问题 + 完整回答），不是单条消息、也不是一个链接。 |
| 两层结构 | 会话内收藏（跟着项目、原始记录）+ 个人知识库（跨项目、你把值得留的挑进去）。 |
| 模型能检索 | 通过 search_knowledge / read_knowledge 按需取用；不自动注入，没人问的库一分钱不花。 |
| 纯文件、零依赖 | 一个会话一个 Markdown 文件，图片复制在旁边；无数据库、无锁定、无 npm 依赖——能扛核心版本变化，也能进 git、Obsidian 或直接 grep。 |

你会得到什么

- 动作行里的心形——一次点击，先乐观更新、失败自动回滚；
- 收藏面板——工作区 → 会话 → 条目的树、每条带序号、时间小字、各层可折叠、按当前视图搜索、知识库按月分组、「在文件夹中显示」、阅读区可关闭；
- 条目操作——置顶、重命名、复制引用、加入/移出知识库、删除；
- 图片不会丢——图片会复制到 Markdown 旁边并在阅读区显示；加入知识库时再复制一份，并在图下写一句图片摘要，让图片之后能按内容被检索；
- 懂你存了什么的检索——段落级切块 + BM25 + 中文二元组，一个小节只出一条，两条矛盾时以时间较晚者为准；
- 成本透明——面板显示"为收藏这件事已消耗多少 token"。

模型那一侧

两个工具，都是按需——不问就完全看不到：

| 工具 | 作用 |
| search_knowledge | 搜个人知识库（scope: "all" 可连收藏层一起），返回小命中：标题、日期、文件#行号、片段和 id。 |
| read_knowledge | 片段不够时取回该节全文（上限 8 KB）。 |

默认只搜个人知识库——"加入知识库"就是你告诉模型"这条值得你看"的方式。原始收藏仍归你自己，除非你提升它或明确要求。

常见问题

文件在哪？ <会话工作目录>/.dsh-favorites/<会话标题>.md；知识库在 ~/.dsh/knowledge/<年-月>.md（可配置）。都是普通 Markdown，用任何编辑器都能打开。

会把数据发到别处吗？ 插件自己不发送——没有遥测，也没有我们的服务器；收藏与知识库都是本机文件，接口只监听回环地址。唯一离开本机的是 DSH 本来就在为你做的模型调用：收藏时给这一轮起标题、提升图片时写一句摘要，走你自己配置的服务商。

花钱吗？ 收藏时一次小模型调用给这一轮起名（几百 token，面板里可见）；提升图片时一次小视觉调用写摘要；检索是本地免费的。

会拖慢 DSH 吗？ 解析结果按文件大小与 mtime 缓存，只重读变过的文件。

项目删了怎么办？ 收藏跟着项目走；你提升进知识库的那些还在，图片也在。

模型能看到我全部收藏吗？ 只有它用 scope: "all" 搜索时（你问过去的事就会）。否则它只看到你提升过的。

反馈

GitHub Issues —— 新建 issue：有 bug 与功能建议两个模板。bug 模板里已经列好该附哪些信息；功能建议模板只要说清你想做什么。

懒得填模板也行，告诉我三件事就能开始：插件版本（npm view dsh-save-chat version）、你用的是 dsh web 还是桌面 App、你遇到的问题，或者你希望它改进什么（有报错就贴报错）。

开发

npm test # 宿主单测 + 真实 DOM 测试（jsdom）

文件格式、全部 HTTP 接口、设计取舍与限制都在 docs/reference.zh.md。

许可

MIT