前言¶
用 DeepSeek Harness(DSH)配合 TapTap 制造(Maker) 做游戏时,智能体很容易在对话里顺手调用 Maker MCP 里那套按额度计费的生成工具——图、音、视频一跑,内置额度就往下掉。另一条路是全程自己接 API,但 skills、初始化、素材落盘又要自己拼。
社区插件 dsh-taptap-maker-dev(维护者 swyaoguai,GitHub 仓库 swyaoguai/dsh-taptap-maker-dev)面向「Maker 工作区外的本地开发」:在系统层注入额度红线、内置可更新的游戏开发 skills,并把生图、CC0 音效、BGM、视频动作帧等能力接到你自己的 Key、网页账号或本地素材上,尽量不碰 Maker MCP 内置额度。目录页见 SkillHub(社区站点,与 DeepSeek / 幻方无官方从属关系)。
这是什么¶
dsh-taptap-maker-dev 是 DSH 的 bundle 型客户端插件(package.json 中 dsh.client.platform 为 web)。当前资料中的版本为 0.2.0,许可证 MIT;运行要求 Node ^22.19.0 || >=24.0.0,DSH >=0.2.0。
一句话:为 TapTap Maker 本地开发守住「非你明确要求就不消耗 Maker 额度」,并提供可更新的 skills 与多条自建素材通道。
核心功能¶
下面按 README 已列能力归纳,只写资料中可核对的部分。
额度红线¶
向智能体注入系统守则:除非你在对话里明确要求,禁止调用 12 个会消耗 Maker 额度的生成工具。设置页有开关,关闭前需二次确认,即时生效、无需重启 DSH。
生图¶
| 通道 | 说明 |
|---|---|
| ChatGPT 网页生图(首选) | 使用你自己的 ChatGPT 账号在网页出图(免费账号即可);登录一次后可自动化;支持多账号轮询 |
| 中转站生图(回退) | OpenAI 兼容 /images/generations;配置 Base URL、Key、Model;支持「获取模型」;可按需传尺寸,支持高质量缩小做图标 |
网络异常时生图链路不再自动多次重试(避免重复扣费);服务端明确返回可重试类错误时仍会安全重试。
音效与 BGM¶
- CC0 音效库:Kenney 九个包共 706 个音频(CC0,可商用免署名),首次使用自动下载;本地缺失时可回落 Mixkit、小森平、効果音ラボ 等索引源。
- 完整 BGM:生成提示词并打开 MiniMax Audio 网页;下载后自动导入(转格式、写入
assets/audio/bgm/、生成.meta)。 - BGM 工作台挂件:主界面输入框旁可试听、拖波形裁剪区间(可加淡入淡出)、一键导入项目;生成完成有红点提醒。
- 音频转换:依赖 ffmpeg,支持批量转格式、压缩、响度归一、去静音、淡入淡出、短音拼循环等。
视频动作帧(视频 → 序列帧)¶
适合「只有静帧、要让角色动起来」:用视频模型按首尾帧生成动作 → 本地抽帧 → 抠像(绿/蓝/品红幕,带逐帧自检)→ 对齐合成透明序列帧 → 导入 Maker(.meta、seq.json、Lua 切图)。仅提交视频生成那一步消耗视频额度;抽帧、抠像、合成可在本地反复调整。
视频后端三类:MiniMax 官方(订阅 Key sk-cp-… 或按量 sk-api-…,可复用本机 mmx 登录态)、视频中转站(OpenAI 兼容 / MiniMax 协议 / 自定义路径映射)、自选本地视频(零额度)。auto 按设置页排序选用;也可 /taptap-video backend relay|minimax|local 显式指定。
插件在命令层对换模型、覆盖已付费视频、改通道顺序等「不可逆或属于你决定」的操作做了硬拦截,需 --yes 或你明确同意才执行;视频提交在「结果未知」(uncertain)状态下禁止静默重投,降低重复扣费风险。
Skills 与引导¶
内置游戏开发 skills,支持周期更新检测;设置页可勾选禁用不需要的项。初始化可直接用中文说「帮我初始化 taptap maker」,不必死记斜杠命令(亦可使用 /taptap-setup 等对话命令)。
设置与配置落盘¶
设置 → TapTap Maker 分组卡片:生成通道、音频素材、治理与工具等。配置与 API Key 写在 $DSH_HOME/taptap-maker-dev/,不进入 Maker 工作区。通道优先级存 lanes.json;保存采用原子写,设置页中空 Key 字段表示「不修改」而非清空。
Maker 项目内素材默认落在 <项目>/sucai/(images、video 作业目录、bgm),目录自带 .gitignore,避免被 Maker 自动提交推走;中间产物不写入 assets/,减少构建误打包。
安装与启用¶
环境需满足 Node 与 DSH 版本要求;本插件必须安装在 Maker 工作区之外(明文 Key 若进工作区,Maker 自动提交时可能泄露)。
官方 README 给出的安装命令如下(<profile> 换成你的 DSH profile 名):
dsh plugin --profile <profile> add dsh-taptap-maker-dev
也可按 README「手动」方式:将仓库放到插件目录,在 profile 的 package.json 增加依赖后重启 DSH(资料中允许手动方式,但任务要求禁止在文中引导 git clone,此处仅引用 README 表述)。
安装后打开 DSH 设置中的 TapTap Maker 页配置通道与 Key。若宿主未启用 webServer,设置页会提示改用命令行,不会白屏。
典型用法¶
初始化¶
在对话中用自然语言触发,例如:「帮我初始化 taptap maker」。
视频动作帧流水线¶
先自检环境,再按作业步骤推进(唯一计费步骤一般为 run):
/taptap-video doctor
/taptap-video new 剑士行走
/taptap-video first ./refs/swordsman.png
/taptap-video last ./refs/swordsman_end.png
/taptap-video prompt 角色原地走三步,全身入镜,相机固定,绿幕背景
/taptap-video run
/taptap-video poll
/taptap-video frames --count 12 --arrange loop
/taptap-video key --chroma auto --tol 40
/taptap-video sheet --cell 256
/taptap-video import ../my-game --fps 12
没有视频额度时,可挂本地 mp4 后继续本地抽帧与抠像:
/taptap-video use ./downloaded.mp4
/taptap-video frames && /taptap-video key && /taptap-video sheet
对话斜杠命令¶
资料列出的对话命令包括:/taptap-image、/taptap-audio、/taptap-bgm、/taptap-audio-convert、/taptap-skills、/taptap-setup,以及完整的 /taptap-video 子命令族。
BGM 示例:
/taptap-bgm 史诗管弦战斗音乐,紧张激烈
音效搜索与导入可通过 taptap-audio.mjs 完成,例如:
node <plugin-dir>/src/taptap-audio.mjs search "金币音效"
node <plugin-dir>/src/taptap-audio.mjs add "金币音效" --project <maker-project> --out coin.wav
(<plugin-dir> 为插件安装路径,以你本机为准。)
适用场景与注意¶
适合谁:在 DSH 里做 TapTap Maker 游戏原型或资源管线、希望把生图/音/视频尽量迁到自有 Key 或 CC0/本地素材、同时需要额度护栏与可更新 skills 的开发者。
权限与安全:插件以当前 DSH 进程权限运行,会读写 $DSH_HOME/taptap-maker-dev/ 与你在 Maker 项目下生成的 sucai/ 等路径。安装前应在 GitHub 阅读源码与 MIT 许可证,自行评估 Key 与浏览器登录态风险。
依赖:视频与音频转换依赖 ffmpeg(插件通过 ffmpegPath() 解析路径,不限于 PATH);部分能力依赖外站网页登录(ChatGPT 生图、MiniMax BGM 等),需你自行遵守各平台条款。
计费实情:视频按秒计费;README 对 MiniMax 套餐档位、按量 Key 能否出视频有表格说明(例如 M Plan Go 不含视频模型)。设置页所选视频模型不会被插件自动替换,不兼容时直接报错,由你决定是否更换。
生态:DSH 主张「一切皆插件」;SkillHub 为社区目录,安装包名 dsh-taptap-maker-dev 与 GitHub 仓库 swyaoguai/dsh-taptap-maker-dev 对应,星标等元数据以目录页当时展示为准(资料中 GitHub 4 stars)。
结尾¶
dsh-taptap-maker-dev 把 TapTap Maker 本地开发里最常见的两类成本——误触 Maker MCP 额度、以及素材工具链零散——收进一个 DSH 插件:红线守则、分组设置、自建生图/音/视频通道与 sucai/ 落盘约定,都围绕「额度可控、通道可选、结果可复现」展开。
- 目录页:https://www.skillhub.cn/plugins/swyaoguai/dsh-taptap-maker-dev
- 源码与完整说明:https://github.com/swyaoguai/dsh-taptap-maker-dev