dsh-talebook-plugin

Running DeepSeek Harness alongside a self-hosted Talebook instance used to mean every catalogue task was either a manual click through the web UI or a hand-written terminal script, with no structured entry point for the model and no built-in risk controls on writes. dsh-talebook-plugin bridges that gap by bringing Talebook Skill API conventions, risk gates, and verification rules directly into DSH, so the model can query, read, write, and administer a Talebook instance through strongly-typed, parameterised tools.

Twelve tools are registered, spanning book search, upload, download, favourites, audiobook browsing, Legado remote-source management, and admin-side user management, book-source management, OPDS import, format conversion, and bulk deletion. Security is tiered: read-only actions execute immediately; routine writes require an explicit user request; destructive or sensitive operations produce a redacted preview that must pass DSH approval before execution. Passwords are stored exclusively in the DSH credentials store and never appear in chat logs or subprocess command lines.

The plugin suits DSH users who self-host Talebook and want their agent to handle catalogue management, especially admins who regularly run bulk imports or OPDS syncs. It also works in headless or CI deployments where a GUI is unavailable, since all connection settings can be provided via environment variables and the plugin loads cleanly without them.