前言¶
DeepSeek Harness（DSH）是一個支持插件擴展的平臺，旨在通過模塊化組件降低開發成本。對於需要管理自建書庫（如 Talebook）的開發者來說，直接在 Agent 層面調用 API 存在權限泄露和誤操作的風險。現有的 Talebook Skill 提供了 API 規範，但缺少與 DSH 平臺的安全集成。
下面介紹 dsh-talebook-plugin。這個插件將 Talebook 的 API 約定、風險門禁和核驗規則接入 DSH，並提供隨包發佈的 Python CLI，讓模型能夠安全地訪問 Talebook 實例。
這是什麼¶
這是一個由 hehetoshang 維護的 DeepSeek Harness 插件，屬於“模型推理”類別。
它的核心價值在於把現有 Talebook Skill 的能力轉化爲 DSH 的工具，並內置了審批機制和憑據管理，避免敏感信息直接暴露在模型參數中。
核心功能¶
插件註冊了 12 個工具，每個工具都有明確的 action 和參數，不接受任意 shell 命令。主要功能包括：
- 站點與身份：
talebook_status，查看站點狀態、當前身份與公開權限。 - 個人中心：
talebook_account，查看或修改個人資料與設備。 - 書籍管理：
talebook_books，支持搜索、詳情、上傳、下載、編輯、收藏、管理書架、更新閱讀狀態及發送書籍。 - 有聲書：
talebook_audios，列出、查看或下載已發佈的有聲書。 - 遠程搜索：
talebook_remote，管理 Legado 書源，執行遠程搜索、瀏覽與保存。 - 管理員功能：
talebook_admin_users：管理用戶。talebook_admin_books：管理書庫列表、元數據補全、格式轉換與批量刪除。talebook_admin_imports：掃描並導入書籍。talebook_admin_booksources：管理網絡書源。talebook_admin_opds：瀏覽 OPDS、管理 OPDS 源與導入任務。talebook_admin_settings：管理系統設置、郵件、數據庫與更新檢查。talebook_admin_system：管理回收站、SSL、主題與日誌。
安裝與啓用¶
在安裝前，請確保環境滿足以下依賴：
* Node.js 22 或更高版本
* Python 3（Windows 默認使用 py -3，其他平臺使用 python3）
* DSH 0.1.1-rc.2 或同一 0.1.x 版本
使用官方命令安裝插件：
dsh plugin --profile web add github:hehetoshang/dsh-talebook-plugin
安裝完成後，啓動 DSH。
典型用法¶
插件支持 UI 配置和環境變量兩種方式。配置完成後，模型即可調用上述工具。
1. 通過 UI 配置
打開 DSH 的 設置 → 插件 → 插件配置 → Talebook。
在展開的卡片中配置：
* Talebook 地址：輸入你的實例地址。
* 用戶名（可選）：留空表示以 guest 身份訪問（僅限只讀）。
* 密碼：輸入密碼。密碼僅寫入 DSH 的憑據存儲，不會出現在聊天記錄或配置文件中。
2. 通過環境變量（適合容器或 CI）
在部署環境中設置以下變量：
export TALEBOOK_URL="https://books.example.com"
export TALEBOOK_USERNAME="your-username"
export TALEBOOK_PASSWORD="your-password"
配置生效值優先級爲：設置文檔中的插件配置 > 環境變量。
適用場景與注意¶
- 安全機制：插件內置了安全門禁。只讀操作直接執行；上傳、收藏等常規寫入需用戶明確請求；發送郵件、管理員寫入、刪除等敏感操作需經過 DSH 的 approval 流程，生成確認預覽後執行。
- 密碼安全：密碼通過 DSH credentials API 保存，模型無法讀取，也不會出現在命令行參數中。
- 版本兼容：請確保 DSH 版本爲 0.1.1-rc.2 或同一 0.1.x 系列，否則可能因依賴槽契約不同而無法加載。
- 權限要求：插件不會繞過 Talebook 自身的登錄與權限檢查。
結語¶
這個插件爲 DeepSeek Harness 用戶提供了一個結構化、安全的方式來管理 Talebook。它不僅封裝了 API，還通過審批機制和憑據隔離降低了操作風險。如需查看源碼或提交問題，請訪問 GitHub 倉庫。
