前言¶
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 仓库。
