前言¶
在 DeepSeek Harness（DSH）里跑智能体时，常见做法是接一堆 MCP 工具，让模型自己查资料、改代码、调 API。若目标是「从创意到成片」的微短剧或番剧，往往还要在 Ziztu 工作室和 Harness 会话之间来回切换：立项、导演规划、写剧本、估价、出首帧、动画镜头、配乐、导出，每一步都可能对应不同界面或脚本。
dsh-plugin-ziztu 把 Harness 接到 Ziztu 托管的 MCP 服务（默认 https://getziztu.com/mcp），用你自己的 API Key 注册约 30 个工具，在会话里以 mcp__ziztu__<tool> 的形式调用。下面介绍它做什么、如何安装连接，以及使用时需要留意的边界。
这是什么¶
- 名称：
dsh-plugin-ziztu（npm 包名与仓库名一致） - 维护：社区插件，由 Ziztu 团队制作；非 DeepSeek 官方出品或背书（README 说明）
- 分类：工作流（SkillHub 目录归类）
- 许可证：MIT（
package.json与 README 一致） - 版本：
0.1.0（以package.json为准） - 定位：在 DSH 0.2.x 中，用 API Key 连接 Ziztu MCP，让智能体完成「规划剧集 → 写改剧本 → 按步骤估价与生成 → 跟任务状态」一类流程；并在 Settings 中提供 Ziztu 配置页。
插件无额外依赖：服务端用 Node 内置 fetch 与 MCP 通信；设置页使用 Harness 自带的 React。
核心功能¶
MCP 工具（30 个）¶
README 概括的能力包括：创建项目、用 Director 规划单集、编写与编辑剧本、对任意步骤报价、生成首帧、动画镜头、制作音乐、导出影片，以及跟踪任务进度。工具名与 Harness MCP 客户端约定一致，例如 mcp__ziztu__list_projects、mcp__ziztu__quote 等。
Settings 中的 Ziztu 页¶
粘贴 API Key 后可选 Save and connect；连接成功时状态会显示「30 tools ready」。同一页可查看连接状态、工具列表，以及 README 提供的简短「可以怎么问」示例。
额度与确认（由 Ziztu API 执行）¶
花费积分的工具需要传入 max_credits 上限；超过 500 credits 的操作需要 confirm；dry_run 只返回价格、不真正启动任务。README 写明：这些规则由 Ziztu 的 API 强制，而非插件本地二次实现。
密钥存放与发送范围¶
Key 优先保存在 Harness 本机凭证库（$DSH_HOME/.credentials.yaml，仅本用户可读）；若当前 composition 没有 credential store，则回退到 $DSH_HOME/ziztu/settings.json。密钥只发往 Settings 里配置的服务地址（默认 https://getziztu.com/mcp）。
密钥优先级（README 顺序）：Settings 页（存为 ZIZTU_API_KEY）→ 插件行的 config（apiKey，可选 url 换服务器）→ 环境变量 ZIZTU_API_KEY（ZIZTU_TOKEN 也可用）。
安装与启用¶
前置条件：DeepSeek Harness dsh 0.2.x，以及 Ziztu API Key。在 https://getziztu.com/app 的 Settings → API keys 创建密钥：read 用于浏览；若要生成与导出，需加上 generate、export 作用域。新账户 README 提到有用于剧本、角色图、分镜等的免费额度。
任选一种安装方式。
Plugins 页面（任意 dsh 版本）：打开 Plugins → Add plugin，输入其一：
dsh-plugin-ziztu（npm 包）https://github.com/0xnirlin/dsh-plugin-ziztu- 本地仓库路径
命令行（web profile）：
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。
可选：开启实验性 Custom plugin markets 后，在 Plugins → Discover → Add index source 填入 https://getziztu.com/dsh/plugins.json，便于从 Ziztu 维护的索引发现插件。
安装插件等于在本机 DSH 进程中加载第三方代码；安装前建议阅读仓库源码与 MIT 许可证，并确认你信任维护者与网络出口（MCP 默认连 getziztu.com）。
连接与典型用法¶
- 打开 Settings → Ziztu。
- 粘贴 Key，选择 Save and connect，直至状态为「30 tools ready」。
- 新建会话，用自然语言驱动工具。README 示例（可直接改写使用）：
- 「Plan a 60 second vertical micro drama about a baker who finds a love letter in the dough. Show me the price before you make anything.」
- 「Write the script for episode one of an anime about a lighthouse keeper, then turn it into a shot list.」
- 「Make the first frames for this project with a cap of 200 credits.」
- 「What is my credit balance, and what is the status of my jobs?」
在 Harness 里批准工具调用前，留意参数里的 max_credits；花费类调用应与你账户额度策略一致。
适用场景与注意¶
适合谁：已在用 DSH 做智能体工作流，并希望把 Ziztu 的「微短剧 / 番剧」管线（规划、剧本、媒体生成、导出）收进同一会话的团队或个人开发者。
连接器类型：插件仅支持带 API Key 的完整连接器（/mcp）。Ziztu 的 planner 版（/mcp/planner，不生成媒体）只支持 OAuth，本插件不做 OAuth；若只要 planner，需用 Harness 自带的 @deepseek-ai/dsh-mcp-client 另行添加。
不要重复挂载：工具已由插件注册为 mcp__ziztu__*；不要再加第二个名为 ziztu 的 MCP client 行，以免冲突。
超时与异步：调用默认 180 秒超时；剧本草稿可能返回 job id，需用 get_script_job 跟进。
运行环境：package.json 要求 Node >=22；插件随当前 dsh 进程权限运行，密钥与生成内容均在你本机策略与 Ziztu 账户之下。
生态说明：DSH 社区插件目录（如 SkillHub）是独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以插件 README 与 package.json 为准。
结尾¶
dsh-plugin-ziztu 把 Ziztu 的 30 个 MCP 工具与 Settings 配置页接到 DeepSeek Harness，适合在一条 agent 会话里完成微短剧与番剧从规划到导出的步骤，并在 API 层用 max_credits、confirm、dry_run 约束花费。
- 目录页：https://www.skillhub.cn/plugins/0xnirlin/dsh-plugin-ziztu
- 仓库：https://github.com/0xnirlin/dsh-plugin-ziztu
- Ziztu 接入说明：https://getziztu.com/connect/deepseek-harness
- MCP 文档：https://getziztu.com/docs/mcp
