前言¶
在 DSH 裏做助手時，記賬往往有兩條路：要麼接第三方記賬 App，要麼自己維護表格或數據庫。前者要授權和同步，後者要把「花了多少、記在哪個賬戶」拆成結構化字段，對話裏稍一複雜就容易記錯或漏記。
鯨娘管家（dsh-plugin-whale-butler）把賬本做成工作區內的本地文件，通過一組工具讓模型用「人話」或截圖入賬，並支持查詢、改單和離線圖表。下面介紹它是什麼、能做什麼，以及如何安裝與使用。
這是什麼¶
鯨娘管家是社區維護的 DSH 插件，與深度求索公司及 DeepSeek 官方無關；插件免費分發，不收費、不捆綁付費服務。
定位是：截圖或一句話就能記賬的本地賬本，模型側不必寫借貸科目，README 寫明「人能聽懂的，她都懂」。維護者爲 cybeshi，在插件目錄中歸類爲記憶；當前 GitHub 公開倉庫星標爲 0，package.json 版本 1.0.0。
賬本數據默認落在當前工作區下的 whale-butler 目錄，格式爲 JSONL + JSON；一個工作區一本賬，卸載插件不會刪除這些文件。
核心功能¶
插件向 DSH 暴露多組工具，覆蓋日常收支、複雜分錄、購物車攤銷、退款、截圖入賬，以及賬戶、類別、信用卡、商品與庫存、定存、債權債務、待攤費用等。README 中的工具表如下（用途以倉庫原文爲準）：
| 工具 | 用途 |
|---|---|
whale_expense |
記一筆日常支出（模型不用寫借貸方向） |
whale_income |
記一筆收入；紅包券可傳 coupon=true |
whale_record |
通用記賬（複雜單據、多分錄） |
whale_cart |
購物車：滿減攤銷、紅包收入、多賬戶付款 |
whale_refund |
退款，掛原單 |
whale_snap |
截圖入賬（模型看圖，存圖和原文） |
whale_query |
餘額、月報、賬戶流水、庫存、經營毛利、進價歷史、年費、理財、債權、分期、待攤、類別 |
whale_chart |
離線 HTML 圖表 |
whale_account |
加賬戶、改名/加別名、找賬戶、設投資賬戶、補期初 |
whale_category |
查看/新增/改名/移動/刪除/遷移支出或收入類別 |
whale_fix |
改單/重分類，保留修改歷史 |
whale_card |
信用卡還款日、賬單日、額度、年費政策、共享實體卡 |
whale_product |
商品：新增、列出、查找 |
whale_inventory |
進貨、銷售、客戶退貨、供應商退貨、期初庫存 |
whale_deposit |
借記卡下活期/定期：存入、查看、到期、提前支取 |
whale_receivable |
債權：借出、利率規則、計息、還款 |
whale_debt |
債務：期初欠款、借入、利息、還款 |
whale_prepaid |
待攤：房租/學費等，首期付款日、每月同日、自動攤銷 |
技術形態上，README 寫明其爲純 Host 插件，零依賴、零構建；package.json 要求 Node.js 20 及以上、DSH 0.2.0 及以上。
安裝與啓用¶
安裝前請確認本機 Node.js 與 DSH 版本滿足上述要求。倉庫 README 給出的步驟是下載源碼後在 DSH 中從本地目錄安裝，而不是通過一條固定的在線 dsh plugin add 命令（資料中未提供該形式）。
- 克隆或下載本倉庫（路徑以你本機爲準）：
git clone https://github.com/cybeshi/dsh-plugin-whale-butler.git
- 在 DSH 的插件管理中，從本地目錄安裝這個倉庫；或者讓助手把倉庫目錄作爲 bundle 安裝。
- 確認安裝、批准提示後，新開一個會話（插件按會話加載）。
- 在新會話裏問一句「看一下餘額」，能正常返回賬本餘額就說明生效。
插件以當前 DSH 進程權限運行。安裝前應自行查看倉庫源碼與許可證（代碼 MIT；圖標 CC BY-NC-SA 4.0，見倉庫內 LICENSE、LICENSE-ASSETS、ATTRIBUTION.md）。
數據位置與隱私¶
默認賬本目錄爲工作區下的 whale-butler：
<工作區>\whale-butler\
換工作區即另一本賬。也可用環境變量指定目錄（README 示例爲 PowerShell）：
$env:WHALE_BUTLER_DATA = '<你的目錄>\whale-butler'
隱私方面：截圖解析由模型完成，圖片會隨對話發到模型服務；賬本文件始終只在本機。whale_snap 僅在給了本機路徑時複製圖片原件。
典型用法¶
資料中的驗收方式是對話查詢餘額。日常記賬由模型根據用戶自然語言或截圖調用對應工具，例如記支出、記收入、截圖入賬、查月報或生成離線圖表等，無需在對話裏手寫會計分錄。
可作起點示例（在新會話中）：
- 「看一下餘額」——驗證插件已加載。
- 用一句話描述一筆支出或收入，由助手選擇
whale_expense/whale_income等工具入賬。 - 提供賬單截圖路徑或讓助手處理截圖，使用
whale_snap相關流程（需注意圖片會發往模型服務）。
更復雜的場景（購物車滿減、退款掛原單、債權債務、待攤房租等）對應上表中的 whale_cart、whale_refund、whale_receivable 等工具，具體參數以倉庫實現爲準。
適用場景與注意¶
適合希望在 DSH 對話內完成記賬與統計、且願意把賬本留在本機工作區的開發者或個人用戶。能力覆蓋個人日常賬、多賬戶、信用卡政策、簡單進銷存與經營類查詢，並支持 whale_chart 輸出離線 HTML 圖表。
需注意：社區插件目錄（SkillHub）與 DeepSeek / 幻方無官方從屬關係；使用前請理解數據留在本地、截圖走模型鏈路的邊界。圖標爲鯨魚娘 Q 版形象（作者 @這個刀子真甜），非商業使用須遵守 CC BY-NC-SA 4.0。
結尾¶
鯨娘管家把「說人話」和截圖識別接到本地 JSON 賬本上，在 DSH 裏用工具鏈完成記、查、改與圖表，避免單獨維護一套記賬後端。更多信息見插件目錄頁與 GitHub 倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/cybeshi/dsh-plugin-whale-butler
- GitHub：https://github.com/cybeshi/dsh-plugin-whale-butler
