微短剧工坊 0xnirlin/dsh-plugin-ziztu

Ziztu for DeepSeek Harness

在 DeepSeek Harness 智能体里策划、编写并制作微短剧和动画剧集。这个插件用你自己的 API key，把 harness 接到 Ziztu 托管的 MCP 服务器上，智能体就能拿到 Ziztu 的工具，名字是 mcp__ziztu__<tool>。

- 新增 30 个工具：创建项目、和 Director 一起策划剧集、编写和修改剧本、给任意步骤报价、生成首帧、让镜头动起来、做音乐、导出成片、跟踪任务进度。
- 在 Settings 里新增 Ziztu 页面：粘贴 API key，查看连接状态和工具列表，还能看到一小份「可以问什么」的清单。
- 花多少由你控制。每个消耗额度的工具都必须带 max_credits 上限，超过 500 额度必须带 confirm，dry_run 只返回价格、不启动任何任务。这些规则由 Ziztu 的 API 强制执行，不是这个插件。
- key 存在你电脑上 harness 自己的凭据库里（$DSH_HOME/.credentials.yaml，只有你能读；如果某个 composition 没有凭据库，插件会退回到 $DSH_HOME/ziztu/settings.json）。它只会发往 Settings 里填的服务器地址（默认 https://getziztu.com/mcp）。
- 没有依赖。插件用 Node 内置的 fetch 和服务器通信，设置页用的是 harness 已经提供的 React。

协议：MIT。这是 DeepSeek Harness 的社区插件，由 Ziztu 团队制作，并非 DeepSeek 出品，也未获 DeepSeek 认可。

安装

你需要 DeepSeek Harness（dsh）0.2.x 和一个 Ziztu API key。在 Ziztu 工作室 https://getziztu.com/app 的 Settings、API keys 里创建 key。给它 read 权限就能浏览，加上 generate 才能生成内容，加上 export 才能下载成片。新账号有免费额度，可用于剧本、角色美术和分镜。

选一种方式安装。

从 Plugins 页面安装（任何版本的 dsh）： 打开 Plugins，选 Add plugin，然后填下面任意一项：

- dsh-plugin-ziztu（npm 包）
- https://github.com/0xnirlin/dsh-plugin-ziztu（本仓库）
- 本仓库本地副本的路径

从命令行安装：

dsh plugin --profile web add dsh-plugin-ziztu

或者直接从 GitHub 装，或者从本地文件夹装：

dsh plugin --profile web add github:0xnirlin/dsh-plugin-ziztu
dsh plugin --profile web add /path/to/dsh-plugin-ziztu

dsh plugin 会把参数交给 profile 文件夹里的 pnpm，并选中这个 bundle。如果 Settings 下没出现 Ziztu 页面，重启 dsh web。

添加 Ziztu 插件索引（可选）： 打开实验性的 Custom plugin markets bundle，进入 Plugins、Discover、Add index source，填 https://getziztu.com/dsh/plugins.json。

连接

1. 打开 Settings，再进 Ziztu。
2. 粘贴 key，点 Save and connect。状态会变成「30 tools ready」。
3. 开一个会话，提个需求。例如：
- 「规划一部 60 秒竖屏微短剧，讲一个面包师在面团里发现一封情书。动手之前先给我看价格。」
- 「写一部关于灯塔看守人的动画第一集剧本，再把它转成分镜表。」
- 「为这个项目生成首批画面，上限 200 credits。」
- 「我的 credit 余额是多少？我的任务现在是什么状态？」

给插件配置密钥的其他方式，按优先级从高到低：Settings 页面（存储名 ZIZTU_API_KEY）、插件行的 config（apiKey，以及换服务器地址用的 url）、ZIZTU_API_KEY 环境变量（ZIZTU_TOKEN 也可以）。

说明

- 只支持完整版连接器。 插件用 API key 认证，/mcp 的完整版连接器接受这种认证。Ziztu 的 planner 版（/mcp/planner，不含生成媒体的工具）只接受 OAuth 登录，本插件不做 OAuth。想用 planner，请改用 harness 自带的 @deepseek-ai/dsh-mcp-client 添加。
- 工具名。 命名规则和 harness 的 MCP 客户端一致：mcp__ziztu__list_projects、mcp__ziztu__quote 等等。不要再加一行名为 ziztu 的 MCP 客户端。
- 长调用。 调用超过 180 秒会超时。剧本草稿会返回 job id，之后用 get_script_job 跟进。
- 权限。 Ziztu 工具走 harness 常规的工具审批。批准会消耗 credits 的调用之前，先看 max_credits 的值。

开发

npm test # unit tests against a fake MCP server, no network

目录结构：index.js 是 Host 部分（连接、工具注册、/api/ziztu 下的设置路由），client.js 是浏览器部分（Settings 页面），src/ 放精简的 Streamable HTTP 客户端、工具桥、设置存储和请求围栏。cordis.patch.yml 负责挂载插件；package.json 声明 dsh.bundle 和 dsh.client。

链接

- Ziztu：https://getziztu.com
- 配置指南：https://getziztu.com/connect/deepseek-harness
- Ziztu MCP 文档：https://getziztu.com/docs/mcp
- 问题反馈：https://github.com/0xnirlin/dsh-plugin-ziztu/issues