前言¶
在 DeepSeek Harness 里做问答时，会话内容往往只留在当前界面：想事后整理成笔记、跨设备继续编辑，或导出成 Markdown/PDF 留档，通常要靠自己复制粘贴或另开工具。社区插件 肥鱼笔记（Fatfish Notes） 把「保存会话、编辑 Markdown、导出图文」和「自有 GitHub 私有仓库同步」放在同一套流程里，笔记与图片默认落在本机，经你账号下的专用私有仓库在多端延续，不经过插件作者的服务器。
下面介绍插件定位、核心能力、安装步骤与典型用法；版本与命令均以仓库 README 为准。
这是什么¶
- 名称：肥鱼笔记 / Fatfish Notes（仓库
StarWind97/dsh-fatfish-notes） - 维护者：StarWind97
- 分类：记忆（社区目录 skillhub.cn）
- 当前版本：
0.7.0，面向 DSH0.2.2-rc.1；许可证 MIT
一句话：在 DSH 内把一轮问答、多轮消息或整个会话存为私人笔记，在笔记库中阅读、编辑 Markdown、处理附件并导出；首次使用需绑定专用 GitHub 私有仓库，完成同步后可在本机工作并在自己的设备间继续。
0.7.0 相对此前版本增加了默认笔记本、迁入迁出、普通附件、文章互链与批量清理等能力（详见仓库内 0.7.0 更新说明）。
核心功能¶
会话保存与导出（不进入笔记库副本）¶
- 原样保存会话：在回答下方保存当前问答；也可多选轮次、单条消息或整个会话，保留只读原始素材。
- 细选与可选 AI 建议：「按消息细选」可单独选问题与回答、指定笔记本或启用 AI 建议；默认原样转存文字和图片，仅勾选「AI 建议标题、摘要和标签」时才调用当前会话模型。
- 会话侧导出：在回答下方点「导出」，可下载当前问答、整个会话或自选消息；支持纯 Markdown、带图 ZIP、PDF、长图或分页图片；导出不会在笔记库里生成副本。
笔记库：Markdown、笔记本与同步¶
- Markdown 图文编辑：原地编辑，语法与预览切换；支持标题、列表、代码块、表格和图片，配色跟随宿主深浅色。自
0.5.1起自动保存。 - 笔记本与默认本：未指定位置的笔记进入默认本；列表可拖宽，正文可标准宽度或全宽；标签可筛选，搜索框下可清筛选。
- 自己的私人笔记库：本机保存，通过专用 GitHub 私有仓库跨设备同步；默认不公开，资料不在插件作者服务器上。
导入导出、附件与互链¶
- 迁入迁出：从列表底部「导入 / 导出」支持 Markdown 文件、文件夹或 ZIP；整库或单本导出为 ZIP，解压后笔记本为目录、标题为文件名，图片与附件为相对路径，可作为 Obsidian vault 使用（仓库记载 Obsidian 导出兼容验证为 1.10.6）。不建议让其他笔记软件直接改肥鱼笔记内部资料目录。
- 普通附件：编辑时可添加 PDF、音频、视频等；超过 10 MiB 会提醒，单文件上限 50 MiB。
- 笔记互链：「链接 → 链接到笔记」可搜索插入另一篇笔记，改名或换本不影响跳转。
- 批量清理：多选移入回收站，支持单篇、多篇彻底删除及清空；仍被其他笔记引用的文件会保留。
同步与多设备¶
在「同步与设置」可查看绑定账号、私有仓库、本机资料夹与同步状态。两台设备连接同一私有仓库；断网仍可本地编辑，恢复网络后自动重试。并发编辑同一篇会保留带冲突版本后缀的独立笔记，由使用者分别处理。
安装与升级¶
安装包须从 v0.7.0 发布页 下载 dsh-fatfish-notes-0.7.0.tgz，不要下载自动生成的 Source code 压缩包。Windows 已验证，macOS 尚未实测；需自备 GitHub 账号，首次设置会检测 Git 与 GitHub CLI。
先做 DSH 资料初始化并完全退出，再在终端安装（路径替换为实际 tgz 位置）：
dsh plugin --profile desktop add "D:\Downloads\dsh-fatfish-notes-0.7.0.tgz"
Web 使用者将 desktop 换成自己的 profile 名称。若终端找不到 dsh，可用安装目录下 resources\runtime\cli\bin\dsh.cmd 的完整路径。重新打开 DSH，在侧栏进入「肥鱼笔记」。
升级使用同一命令、替换安装包路径即可，无需先卸载或重新绑定。若库中已有内容，升级前确认「已同步」、关闭 DSH 并备份本机资料；0.7.0 更新了数据格式，多端宜一起升级，回退需相配套备份。卸载与问题反馈见仓库 使用说明。
典型用法¶
首次设置（三步）¶
- 准备同步工具：缺少 Git 或 GitHub CLI 时按页面链接安装，点「重新检测」；仍失败则完全退出并重开 DSH。
- 登录并选择云端笔记库：浏览器授权 GitHub；首次默认推荐新建私人笔记库（建议名
fatfish-notes），换机或恢复选「连接已有笔记库」。 - 确认本机位置并同步：本机资料夹默认同名，可指定空文件夹；「检查并继续」后确认首次同步。仅「已安装」「已登录」不算可用，首次同步成功后才算就绪。
从会话写入笔记¶
在任意回答下方点「保存到笔记」，默认勾选当前轮；底部可保存整会话或取消。按钮样式可在「肥鱼笔记设置 → 外观」改为仅图标。
阅读与编辑笔记¶
点「编辑」或双击段落改标题、标签、摘要与正文；阅读态可导出 Markdown、PDF、长图或分页图片，可选是否包含标签、摘要。带图 Markdown 建议用 ZIP 解压离线阅读。
导入与整库备份¶
列表底部「导入 / 导出」扫描后选择目标笔记本；有图或附件时用完整文件夹或 ZIP。网络图片可选下载归档，失败项保留引用并提示。
适用场景与注意¶
适合：希望在 DSH 内闭环管理 AI 会话摘录、个人 Markdown 与附件，并用自己的 GitHub 私有仓做多端同步的开发者；需要 Obsidian 等只读打开导出副本的场景。
限制（README 明文）：暂不支持把笔记自动附回会话；AI 仅在转存时可选建议标题/摘要/标签，正文需手动整理。macOS 与两台物理设备间使用尚待实测。彻底删除不重写 Git 历史，不等同安全擦除，也不立即缩小远程仓库体积。
安全与审计：DSH 插件在当前 DSH 进程权限下运行；安装前应查看 GitHub 源码 与 MIT 许可证。反馈 Issue 时不要上传令牌或完整私人笔记库。
结尾¶
肥鱼笔记把会话留存、Markdown 笔记库和自有 GitHub 私有同步串成一条可复现路径：本机为主、云端在你账号下、导出与迁入迁出便于与现有笔记工具衔接。
