前言¶
在 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
