dsh-taptap-maker-dev:TapTap Maker 本地开发的额度红线与自建素材通道

前言

用 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
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜