前言¶

在 DeepSeek Harness 裏跑 agent 時，瀏覽網頁、查資料、執行任務的過程往往很長，上下文窗口卻有限。事後想回顧「那天看了什麼、當時怎麼想的」，通常只能翻對話記錄，既難檢索，也不便於按主題整理。社區插件 dsh-fish-notes（魚魚碎碎念）把 agent 的所見所想寫成結構化條目，並在 DSH 側欄提供「魚魚碎碎念」入口，按天瀏覽、搜索、過濾，還能用記憶圖譜和時間軸做概覽；同一主題條目夠多時可沉澱成長期記憶頁，或一鍵生成周記。下面介紹它的定位、能力與在 desktop profile 下的本地 link 安裝方式。

這是什麼¶

dsh-fish-notes 是維護者 yeahmahao（README 署名「不乖魚魚」）發佈的 DSH 插件，在 SkillHub 插件目錄 中歸類爲「記憶」。源碼與說明見 GitHub：yeahmahao/dsh-fish-notes。當前 package 版本爲 0.3.0，許可證 MIT。

插件由 host 與 client 兩半組成：host 側 lib/index.js 註冊 3 個 agent 工具與 5 條 HTTP 路由；client 側 client/client.js 提供側欄菜單、按天時間流面板，以及記憶圖譜 / 時間軸視圖。

核心功能¶

隨手記與側欄面板¶

Agent 通過工具寫入碎碎念；側欄面板按天分組展示，支持搜索，並可按 kind 過濾。數據默認落在 JSONL 文件（見下文配置）。

記憶圖譜與時間軸¶

右側面板可切換 記憶圖譜（SVG）：節點之間按「共享關鍵詞 / 同一天 / 同域名」連邊，標籤傳播聚類上色，圖例可點選過濾主題。時間軸 視圖按天橫排，便於看出「哪天想得多」。

0.3.0：沉澱、週記與一鍵摘錄¶

• 沉澱成記憶頁：同一主題攢夠 3 條時，面板頂部會出現「可以沉澱」建議；確認後寫成 projects/<主題>.md，並更新記憶庫中的 index.md 與 log.md。
• 魚魚週記：一鍵把最近 7 天整理成一段復盤，追加到記憶庫 log.md。
• 一鍵摘錄：capture_page 抓取網頁標題與描述，存成一條 browse 類型碎碎念。

Agent 工具與 HTTP 接口¶

Agent 側可用工具（參數以 README 爲準）：

側欄與沉澱功能通過 HTTP 路由與 host 交互：

• GET /fish-notes/entries — 返回 { total, entries }（側欄輪詢）
• GET /fish-notes/suggestions — 可沉澱的主題建議
• POST /fish-notes/settle — 將一組條目沉澱成記憶頁
• POST /fish-notes/weekly — 生成魚魚週記並寫入 log.md
• GET /fish-notes/health — 自檢（版本、數據文件、記憶庫路徑）

配置¶

在插件配置中可調整（未改則使用默認值）：

• dataFile — 碎碎念 JSONL，默認 ~/.dsh/data/fish-notes/thoughts.jsonl
• memoryDir — 長期記憶庫目錄，默認 ~/.memory（沉澱與週記寫入此處）

安裝與啓用（desktop profile）¶

README 說明：desktop profile 下通過 CLI 的 dsh plugin 安裝會被官方拒收（尤其 --profile desktop 或從運行中的 app 內執行），因此需 本地 link 安裝。以下路徑以 Windows 示例爲準，Linux/macOS 用戶需把 C:\Users\<你> 換成自家 home 與路徑分隔方式，邏輯相同。

1、將插件目錄放到：

C:\Users\<你>\.dsh\plugins\fish-notes\

2、編輯 C:\Users\<你>\.dsh\profiles\desktop\package.json：

• 在 dependencies 中加入："dsh-fish-notes": "link:C:/Users/<你>/.dsh/plugins/fish-notes"
• 在 dsh.profile.bundles 數組中加入："dsh-fish-notes"

3、在 profile 目錄執行 pnpm install，建立 node_modules 鏈接。

4、重啓 DeepSeek Harness 桌面 app。

Client 註冊注意：必須使用 ctx.slots.inject(槽名, () => ctx.slots.register(...)) 先探測插槽再註冊；直接 register 會拋錯並導致 web boot 失敗（web boot: 1 entry did not activate）。該說明來自插件 README，集成或 fork 時需遵守。

典型用法¶

Agent 在瀏覽或思考過程中調用工具即可，例如記一條想法：

record_thought({ text: "這篇文檔把 settle 流程寫清楚了", kind: "thought" })

瀏覽某 URL 時帶鏈接與類型：

record_thought({ text: "對照官方路由列表", url: "https://example.com/doc", kind: "browse" })

需要快速留痕某頁時：

capture_page({ url: "https://example.com/page", note: "待讀" })

回顧最近條目：

list_thoughts({ limit: 20 })

人類用戶主要在 DSH 側欄打開「魚魚碎碎念」，查看時間流、圖譜或時間軸；當面板提示某主題「可以沉澱」時，通過 UI 觸發沉澱或週記（對應 POST /fish-notes/settle 與 POST /fish-notes/weekly）。

適用場景與注意¶

適合誰：希望在 DSH 里長期跑 agent、又需要把瀏覽與推理過程留痕、並在 UI 裏按天/主題回顧的開發者；與「記憶」類 workflow 搭配時，可把零散碎碎念沉澱到 memoryDir 下的 Markdown 記憶庫。

權限與安全：插件與當前 DSH 進程同權，讀寫 dataFile、memoryDir 及 HTTP 路由所觸發的文件操作均在用戶本機完成。安裝前請閱讀 倉庫源碼 與 MIT 許可證，確認路徑與數據落盤位置符合你的環境策略。

生態說明：DeepSeek Harness 採用「一切皆插件」的擴展方式；SkillHub 爲社區目錄站點，與 DeepSeek / 幻方無官方從屬關係，本文安裝步驟以倉庫 README 爲準，勿自行拼接未在文檔中出現的 dsh plugin add 命令。

結尾¶

dsh-fish-notes 把 agent 的瀏覽與想法收成可檢索的 JSONL，並在側欄用時間流、記憶圖譜和時間軸呈現；0.3.0 起還支持主題沉澱、週記與 capture_page 摘錄。若你需要在 desktop profile 裏啓用，按 README 的 link 安裝四步操作即可。

• 目錄頁：https://www.skillhub.cn/plugins/yeahmahao/dsh-fish-notes
• GitHub：https://github.com/yeahmahao/dsh-fish-notes