前言¶
在 DeepSeek Harness（DSH）里跑对话时，模型回答里常有值得留档的段落：整条结论、某一句表述，或一段可复用的说明。若只靠会话历史翻找，跨会话检索成本高，也不便和笔记工具联动。下面介绍社区插件 dsh-message-pins（维护者 deciia，目录分类为「记忆」）：在回答操作条与文本选区上提供收藏入口，把内容写成带 frontmatter 的 Markdown，落到本机目录或 Obsidian 仓库，并在 DSH 右侧栏与会话视图里做搜索、标签与导出。
这是什么¶
dsh-message-pins 是 DSH 的收藏类插件：支持收藏整条已完成回答，也支持划选一句话或一段话后收藏；落盘格式为 Markdown，可选用本地目录或 Obsidian 仓库。仓库 deciia/dsh-message-pins，当前 package 版本为 2.0.0，许可证 MIT。适配 DSH 0.2.x（README 写明开发与验证版本为 0.2.2-rc.1）。
插件生态上，DSH 强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前宜自行阅读源码与许可证——插件在当前 DSH 进程权限下读写文件与配置。
核心功能¶
收藏入口¶
- 五角星收藏：每条已完成回答的操作条上有 ☆ 按钮，一键收藏或取消。
- 选中文字收藏：在任意回答里划选文字，选区右侧出现圆形 ☆，点击收藏该句或该段。
浏览与管理¶
- 右侧栏「收藏」标签：通过 DSH 右侧栏（
sidebarRightTabs官方 API）打开列表，支持搜索、按会话筛选、导出。 - 会话视图「收藏」页签：顶部视图栏在对话 / 轨迹 / 上下文 / 编队之外增加 收藏。
- 笔记与标签：展开收藏后可填写笔记、标签，写回 Markdown frontmatter。
- 跨会话收藏中心：可按标题、内容、标签、笔记搜索。
- 一键导出：将全部收藏导出为 Markdown 文件。
- 引用跳回原文：引用类收藏可「跳到原文」，滚动到对应消息并高亮约 4.5 秒。
落盘方式¶
两种方式可在插件详情页切换：
| 方式 | 默认路径说明 |
|---|---|
| 本地目录（默认） | <DSH_HOME>/storages/message-pins/pins/ |
| Obsidian 仓库 | 仓库根 + 相对目录（默认 DSH 收藏/回答收藏） |
左栏入口默认隐藏，可在插件详情页打开。
安装与启用¶
安装步骤以仓库 README 为准（无单独的 CLI dsh plugin add 命令表述）：
- 打开 DSH → 设置 → 插件 → 添加 / 安装插件，选择本仓库地址或本地路径。
- 安装后重启 DSH，使宿主半区加载。
- 打开任意对话：回答下方应出现 ☆；划选文字应出现圆形 ☆。
配置¶
在插件详情页的 「收藏设置」 中调整：
| 项 | 说明 |
|---|---|
| 保存方式 | 「本地目录」或「Obsidian 仓库」，点选即保存 |
| 仓库根 | Obsidian 仓库根目录（仅 Obsidian 模式） |
| 保存目录 | 相对仓库根的目录（仅 Obsidian 模式） |
| 左栏入口 | 是否在左侧栏显示收藏入口（默认关闭） |
| 当前保存到 | 实时显示实际落盘路径 |
宿主侧配置保存在：
~/.dsh/storages/message-pins-config.json
首次使用时：若本机已存在旧版收藏目录 C:/Sync/datas/moonlightGarden/20-卡片/回答收藏，会自动沿用 Obsidian 模式；否则默认本地目录模式（README 中的 Windows 路径示例，其他系统以本机是否命中该路径为准）。
典型用法¶
- 整条收藏：在一条已完成回答的操作条上点 ☆，需要时到右侧栏「收藏」或会话视图「收藏」页签中补标签与笔记。
- 片段收藏：在回答中划选文字，点选区旁的圆形 ☆；引用类条目之后可用「跳到原文」回到上下文。
- 导出备份：在收藏中心使用一键导出，得到若干 Markdown 文件，便于归档或迁入其他笔记系统。
- Obsidian 联动：在详情页选「Obsidian 仓库」，填仓库根与相对保存目录，收藏文件直接写入库内目录。
每条收藏对应一个 Markdown 文件，frontmatter 示例结构如下（摘自 README）：
---
title: 标题
created: ISO 时间
source: dsh
sessionId: 会话 id
messageId: 消息 id
type: answer-pin | quote-pin
tags: ["标签"]
note: "笔记"
# 引用类额外字段
flowKey: 消息行标识
offset: 文本偏移
prefix: 前文
suffix: 后文
quote: 原文
---
# 标题
正文（引用类为 `> 原文`）
适用场景与注意¶
适合：长期在 DSH 里做方案推演、写说明、对答案做批注，并希望内容与 Obsidian 或本地 Markdown 树保持一致的用户。
注意：
- 兼容性以
package.json中dsh.compatibility.dshReleases为准（README 列出 0.2.1-rc.3、0.2.2-rc.1 为 compatible）；升级 DSH 后若 UI 槽位变化，需对照上游 DSH 与插件仓库说明。 - 插件会读写你配置的目录与
~/.dsh/storages/message-pins-config.json，安装前应确认路径与权限。 - 本实现合并了 dsh-bookmarks、dsh-pins 等项目的功能设计思路，代码为独立实现；上游 MIT 项目要求在文档中保留署名，详见仓库 README「参考与致谢」。
结尾¶
dsh-message-pins 把「整条回答」与「选中片段」两条收藏路径、右侧栏与会话内的管理界面，以及本地 / Obsidian 落盘串成一条可复现工作流。目录页：https://www.skillhub.cn/plugins/deciia/dsh-message-pins；源码与完整说明：https://github.com/deciia/dsh-message-pins。
