前言¶

在 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