前言¶
在 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 私有同步串成一條可復現路徑：本機爲主、雲端在你賬號下、導出與遷入遷出便於與現有筆記工具銜接。
