前言¶
在 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。
