前言¶
在 DSH 里做开发，最常留下的东西其实是对话：一句排查结论、一段踩坑记录、一张报错截图。这些内容默认只在会话里停留，想长期保存就得手动复制到别处，图片更麻烦。肥鱼笔记（Fatfish Notes）就是为此设计的插件：它把「保存会话、整理成笔记、在多台设备间同步」这三点收敛到一个界面里，云端用你自己 GitHub 账号下的私有仓库，不经过插件作者的服务器。
下面介绍它的定位、安装方式和实际用法。信息以插件 README 和仓库内的改名规划文档为准。
这是什么¶
肥鱼笔记由 StarWind97 维护，面向 DSH 的桌面/Web 客户端。一句话概括：在 DeepSeek Harness 中把一轮问答、选中的几轮消息或整个会话保存为私人笔记，在「纸页笔记库」里阅读、编辑 Markdown、粘贴图片、导出文件，并通过你自己 GitHub 私有仓库跨设备同步。
先交代一个名称问题。部分目录页仍用 dsh-github-notebook 这个标识登记本项目；按仓库里的改名规划文档，项目已统一为「肥鱼笔记 / Fatfish Notes」，代码仓库名、安装标识、包名、界面标签都改为 fatfish，并采用一次性迁移，不保留旧名称的兼容分支。README 里给出的当前仓库为 StarWind97/dsh-fatfish-notes。
核心功能¶
按 README 列出的四点：
- 原样保存会话：在回答下方保存当前问答，也可以选多轮、单条消息或整个会话，保留只读原始素材，随时可切回对照。
- Markdown 图文编辑：原地编辑，语法高亮与预览切换，支持标题、列表、代码块、表格和图片，配色跟随宿主深浅色。从 0.5.1 开始自动保存。
- 文件导出：笔记和会话都能导出为 Markdown（带图片时打成 ZIP）、PDF、长图或分页图片。导出不会在笔记库里留副本。
- 私有同步：笔记和图片保存在本机，同步到你 GitHub 账号下专用的私有仓库，默认不公开，不存放在插件作者的服务器上。
还要提一句：AI 只在转存会话时可选地建议标题、摘要和标签，正文全靠手动整理。插件不提供 Markdown 文件导入，也不把笔记自动附加到会话。
安装与启用¶
插件当前版本 0.6.0，定位私人笔记管理，适配 DSH 0.2.2-rc.1。README 声明 Windows 已验证，macOS 尚未实测。
安装包从 0.6.0 发布页下载 dsh-fatfish-notes-0.6.0.tgz，不要下载 GitHub 自动生成的 Source code 压缩包。然后按下面两步操作。
-
先打开一次 DSH 完成资料初始化，再完全退出。这一步跳过会导致插件找不到宿主资料目录。
-
在终端执行安装命令，把路径替换成安装包的实际位置：
dsh plugin --profile desktop add "D:\Downloads\dsh-fatfish-notes-0.6.0.tgz"
如果 desktop 不是当前 profile 名，换成你自己的名字。终端找不到 dsh 时，用 DSH 安装目录下 resources\runtime\cli\bin\dsh.cmd 的完整路径来执行。装完重新打开 DSH，在侧栏进入「肥鱼笔记」。
关于升级：README 写明这次更名采用一次性迁移，旧安装标识和旧资料格式不由新版自动兼容，历史 0.5.x 包保留原名。所以从 0.5.x 升级前，先确认旧版「已同步」，关闭 DSH 并备份本机资料，再用同一条命令安装新包。没同步就覆盖，有丢本地改动的风险。
首次设置¶
首次打开按页面上的三步完成，全程不需要碰 Git 命令。
- 准备同步工具：Git 负责文件同步，GitHub CLI 负责账号授权。缺少时点官网安装链接，装完点「重新检测」，仍检测不到就完全退出 DSH 重开。
- 登录并选择云端笔记库：没有 GitHub 账号先注册，再点「登录 GitHub」完成浏览器授权。首次使用默认推荐「新建私人笔记库」，建议名称为
fatfish-notes；换电脑或恢复资料选「连接已有笔记库」。 - 确认保存位置并同步：本机默认资料夹与云端仓库同名，也可以指定新的空资料夹。点「检查并继续」，核对账号、仓库和本机位置，然后确认首次同步。
「已安装」「已登录」只表示准备完成，首次同步成功之后才能开始用。设置完成后临时断网仍可在本机保存，恢复网络自动继续。
典型用法¶
保存会话。 在任意回答下方点「保存到笔记」，默认勾选该轮；其他回答下方可继续勾选整轮，底部可以保存、选择整个会话或取消勾选。需要精细控制时点「按消息细选」，可以单独勾问题和回答、指定笔记本、或启用 AI 建议，返回会话后保留勾选状态。按钮默认显示图标加文字，在「肥鱼笔记设置 → 外观」可以改成仅图标。
人工整理。 点「编辑」或双击阅读段落，就能改标题、标签、摘要和 Markdown 正文；从 0.5.1 起自动保存，「完成编辑」或离开后再回来，都会从最新内容的阅读态继续。列表宽度可拖动，正文可切换标准宽度与全宽，配色跟随宿主。点笔记标签可以筛选列表，点搜索框下的筛选标记清除筛选。
导出。 在回答下方点「导出」，可直接下载当前问答、整个会话或自选消息。纯文本 Markdown 是单个文件，带图片的会打包成 ZIP（推荐，解压后能离线阅读）；也可以选 PDF、长图或分页图片。导出时能分别选择是否包含标签、是否包含摘要。
换设备。 两台设备连同一个私有仓库即可。断网时打开笔记库会显示「有更改尚未同步」，但照常编辑保存，联网后自动重试。并发编辑同一篇笔记不会互相覆盖，插件会保留带冲突版本后缀的独立笔记，由你决定保留、改名还是删除。
适用场景与注意¶
适合这些情况：想把对话沉淀成长期资料、希望笔记留在自己的 GitHub 私有库里而不是第三方服务、需要多设备续看，以及需要把笔记导出成 PDF 或长图分发。
几点需要提前想清楚：
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。本项目代码使用 MIT 许可证，第三方依赖与字体说明见仓库里的 THIRD_PARTY_NOTICES.md。
- 同步依赖本机 Git 和 GitHub CLI，首次设置需要本机能访问 GitHub 并完成浏览器授权。
- README 明确：macOS 和两台物理设备之间的使用尚待实测，目前只有 Windows 的验证记录。
- 本次改名是一次性迁移，不要指望新版自动兼容旧资料格式或旧安装标识。
结尾¶
肥鱼笔记的价值在于定位清晰：它不做知识库、不做 Agent 记忆注入，只负责「会话 → 私人 Markdown 笔记 → 导出」这条链路，云端同步用你自己的 GitHub 私有仓库。如果正好符合需求，可以从发布页下载 0.6.0 的安装包，按上面的命令装完、同步一次再开始用。
- 插件目录页：https://www.skillhub.cn/plugins/StarWind97/dsh-github-notebook
- GitHub 仓库：https://github.com/StarWind97/dsh-fatfish-notes
- 0.6.0 发布页：https://github.com/StarWind97/dsh-fatfish-notes/releases/tag/v0.6.0
