Introduction

DeepSeek Harness (DSH) is a plugin-extensible platform designed to reduce development costs through modular components. For developers who need to manage self-hosted book libraries (such as Talebook), calling APIs directly at the Agent level carries risks of permission leakage and unintended operations. The existing Talebook Skill provides API specifications, but lacks secure integration with the DSH platform.

The following section introduces dsh-talebook-plugin. This plugin connects Talebook’s API conventions, risk gates, and verification rules to DSH, and provides a packaged Python CLI that allows the model to safely access Talebook instances.

What This Is

This is a DeepSeek Harness plugin maintained by hehetoshang and classified under the “Model Reasoning” category.

Its core value lies in converting the capabilities of the existing Talebook Skill into DSH tools, with built-in approval mechanisms and credential management, preventing sensitive information from being directly exposed in model parameters.

Core Features

The plugin registers 12 tools, each with a clear action and parameters, and does not accept arbitrary shell commands. Main features include:

  • Site and Identity: talebook_status, check site status, current identity, and public permissions.
  • Personal Center: talebook_account, view or modify profile and devices.
  • Book Management: talebook_books, supports searching, details, upload, download, editing, favoriting, managing bookshelves, updating reading status, and sending books.
  • Audiobooks: talebook_audios, list, view, or download published audiobooks.
  • Remote Search: talebook_remote, manage Legado book sources, and perform remote search, browsing, and saving.
  • Admin Features:
    • talebook_admin_users: manage users.
    • talebook_admin_books: manage book library lists, metadata completion, format conversion, and bulk deletion.
    • talebook_admin_imports: scan and import books.
    • talebook_admin_booksources: manage network book sources.
    • talebook_admin_opds: browse OPDS, manage OPDS sources and import tasks.
    • talebook_admin_settings: manage system settings, email, database, and update checks.
    • talebook_admin_system: manage trash, SSL, themes, and logs.

Installation and Enablement

Before installing, ensure the environment meets the following dependencies:
* Node.js 22 or higher
* Python 3 (Windows defaults to py -3, other platforms use python3)
* DSH 0.1.1-rc.2 or the same 0.1.x version

Install the plugin using the official command:

dsh plugin --profile web add github:hehetoshang/dsh-talebook-plugin

After installation is complete, start DSH.

Typical Usage

The plugin supports both UI configuration and environment variables. After configuration, the model can invoke the tools mentioned above.

1. Configure via UI
Open DSH’s Settings → Plugins → Plugin Configuration → Talebook.
Configure the following in the expanded card:
* Talebook Address: Enter your instance address.
* Username (Optional): Leave blank to access as guest (read-only only).
* Password: Enter the password. The password is written only to DSH’s credential storage and will not appear in chat history or configuration files.

2. Configure via Environment Variables (suitable for containers or CI)
Set the following variables in the deployment environment:

export TALEBOOK_URL="https://books.example.com"
export TALEBOOK_USERNAME="your-username"
export TALEBOOK_PASSWORD="your-password"

The configuration precedence is: plugin configuration in the settings document > environment variables.

Applicable Scenarios and Cautions

  • Security Mechanism: The plugin includes built-in safety gates. Read-only operations are executed directly; regular write operations such as upload and favoriting require explicit user requests; sensitive operations such as sending email, admin writes, and deletion must go through DSH’s approval process and be executed after generating a confirmation preview.
  • Password Security: Passwords are saved through the DSH credentials API. The model cannot read them, and they will not appear in command-line arguments.
  • Version Compatibility: Ensure the DSH version is 0.1.1-rc.2 or the same 0.1.x series; otherwise, loading may fail due to different dependency slot contracts.
  • Permission Requirements: The plugin does not bypass Talebook’s own login and permission checks.

Conclusion

This plugin provides DeepSeek Harness users with a structured and safe way to manage Talebook. It not only wraps the API, but also reduces operational risks through approval mechanisms and credential isolation. To view the source code or submit issues, please visit the GitHub repository.