dsh-taptap-maker-dev

English | 中文

为 TapTap 制造（Maker） 本地开发而生的 DeepSeek Harness 插件： 守住「不花冤枉钱」的额度红线，接入可更新的游戏开发 skills，并提供自建的图片 / 音效 / BGM 素材通道—— 全部走你自己的 Key 或 CC0 素材库，不消耗任何 Maker MCP 内置额度。

你会得到什么

能力	说明
额度红线	注入系统守则：非你在对话中明确要求，禁止调用 12 个消耗 Maker 额度的生成工具。设置页有开关，关闭需二次确认，即时生效无需重启
ChatGPT 网页生图（首选）	走你自己的 ChatGPT 账号在网页里出图（免费账号即可）。登录一次，之后全自动；支持多账号轮询，一个触配额自动换下一个
中转站生图（回退）	OpenAI 兼容 /images/generations。填 Base URL / Key / Model，支持「获取模型」自动列出可用模型。尺寸按需传，支持高质量缩小做图标
CC0 音效库	Kenney 九个包共 706 个音频（CC0，可商用免署名），首次使用自动下载；本地没有时回落到 Mixkit / 小森平 / 効果音ラボ
完整 BGM	自动生成提示词 + 打开 MiniMax Audio 网页；下载后自动导入（转格式 + 装进 assets/audio/bgm/ + 生成 .meta）
BGM 工作台挂件	主界面输入框旁的 🎵 挂件：试听刚生成的 BGM、拖波形裁剪选区间（可加淡入淡出防爆音）、一键导入项目；生成完自动亮红点提醒
音频转换	ffmpeg 批量转格式 / 压缩 / 响度归一 / 去静音 / 淡入淡出 / 短音拼循环
可更新 skills	内置游戏开发 skills + 周期更新检测；设置页可勾选禁用不需要的
初始化引导	直接用中文说「帮我初始化 taptap maker」即可触发，不必记斜杠命令

BGM 试听 / 裁剪挂件（主界面）

BGM 生成是「用法」不是「配置」，所以它不在设置页，而是主界面输入框旁的 🎵 BGM 挂件：

• /taptap-bgm 生成完成后，挂件亮红点并弹出提示条，一键打开试听
• 每条 BGM 可播放（流式加载，可拖进度），选中后看波形、拖两个手柄选区间、 「只听选中段」循环试听、可选淡入淡出（0.3s/0.5s，防裁剪点爆音）
• 「✂ 裁剪并导入项目」：ffmpeg 按 -ss/-t 精确裁剪 → 转 wav → 写 .meta → 落进当前项目 assets/audio/bgm/（不覆盖同名，自动加序号）
• 「原样导入」不裁直接用；全程本地 + 零额度（不碰 Maker/MiniMax 配额）
• 挂件每 10 秒轮询下载目录（窗口聚焦时立即刷新），挂载在主界面 conversation.composer.dock， 出错只隐藏自己，绝不影响聊天界面

安装

dsh plugin --profile <profile> add dsh-taptap-maker-dev

或手动：把仓库克隆到插件目录，在 profile 的 package.json 加上依赖，重启 DSH。

⚠️ 本插件必须装在 Maker 工作区之外。所有持久化（含 API Key）写在 $DSH_HOME/taptap-maker-dev/ 下。 原因：TapTap Maker 运行时会自动把整个工作区提交并推送，明文 Key 一旦落进工作区就会泄露。

配置

设置 → TapTap Maker 页，直接填并保存（存到 $DSH_HOME/taptap-maker-dev/，不进任何 Maker 工作区）：

• 额度红线 — 开关，关之前会弹确认
• ChatGPT 生图（首选） — 总开关（关掉后整条通道停用，模型改走中转站）+ 账号列表（主账号常驻， 退出后可再登；「+ 添加账号」一步完成"建条目 + 打开登录"）+ 多账号轮询开关
  • 图片下载目录（默认跟随项目 <项目>/.taptap-images，可自定义，支持 {project} / {home}）
• 中转站（回退） — Base URL / Key / Model（「获取模型」按钮自动拉取）/ 缺省尺寸
• 完整 BGM — 填风格描述 → 生成提示词 → 一键打开网页 → 下载后自动导入
• BGM 账号 — 账号列表（主账号常驻，退出后可再登）+ 「+ 添加账号」一步添加并登录
  • 查额度 / 换号 + 额度用完自动轮换（每个账号独立浏览器 profile）
• CC0 音效库 — 状态、搜索、「更新库」
• 小资源图标 — 出图 + 缩小的最佳实践
• Skill 管理 — 勾选禁用不需要的 skill，即时生效

命令行

# 生图首选：ChatGPT 网页（首次登录一次）
node <plugin-dir>/src/taptap-gpt.mjs login
node <plugin-dir>/src/taptap-gpt.mjs gen --prompt "蓝色盾牌图标，扁平，居中留白" --out icon.png --downscale 128x128

# 出图慢时：把「已经生成好但没下到」的图抓回来（不重新生成，省额度）
node <plugin-dir>/src/taptap-gpt.mjs pending   # 有没有待抓取的对话
node <plugin-dir>/src/taptap-gpt.mjs grab      # 抓 pending 那个对话
node <plugin-dir>/src/taptap-gpt.mjs grab --url https://chatgpt.com/c/xxxx

# 网页生图总开关（关掉后改走中转站）
node <plugin-dir>/src/taptap-gpt.mjs lane status
node <plugin-dir>/src/taptap-gpt.mjs lane off

# 图片存放位置：默认跟随当前项目（<项目>/.taptap-images），也可自定义
node <plugin-dir>/src/taptap-gpt.mjs dir                 # 看当前解析结果
node <plugin-dir>/src/taptap-gpt.mjs dir --set "D:\my-images"
node <plugin-dir>/src/taptap-gpt.mjs dir --set "{project}/imgs"
node <plugin-dir>/src/taptap-gpt.mjs dir --reset         # 恢复跟随项目

# 账号轮询：添加账号 → 各登录一次 → 之后自动轮换
node <plugin-dir>/src/taptap-gpt.mjs pool add --id a2 --label "小号"
node <plugin-dir>/src/taptap-gpt.mjs login --account a2
node <plugin-dir>/src/taptap-gpt.mjs pool list          # 看状态
node <plugin-dir>/src/taptap-gpt.mjs pool unban --id a2 # 恢复冷却账号

# 生图回退：中转站（尺寸按需，支持透明底 + 缩小）
node <plugin-dir>/src/taptap-image.mjs --prompt "蓝色盾牌图标" --out icon.png --transparent --downscale 128x128

# BGM 账号池：添加账号 → 各登录一次 → 额度用完自动轮换
node <plugin-dir>/src/taptap-bgm-web.mjs login                      # 主账号
node <plugin-dir>/src/taptap-bgm-web.mjs pool add --id b2 --label "小号"
node <plugin-dir>/src/taptap-bgm-web.mjs login --account b2
node <plugin-dir>/src/taptap-bgm-web.mjs pool list                  # 看状态
node <plugin-dir>/src/taptap-bgm-web.mjs gen --prompt "史诗管弦战斗音乐"  # 自动选可用账号

# 音效：搜索 / 安装 / 查看来源
node <plugin-dir>/src/taptap-audio.mjs search "金币音效"
node <plugin-dir>/src/taptap-audio.mjs add "金币音效" --project <maker-project> --out coin.wav
node <plugin-dir>/src/taptap-audio.mjs sources

# BGM：生成提示词 + 打开网页（对话里用 /taptap-bgm 即可）
/taptap-bgm 史诗管弦战斗音乐，紧张激烈

# 网页下载后，自动导入项目（转格式 + 装进 bgm + 生成 meta）
node <plugin-dir>/src/taptap-audio.mjs import --in "C:\Users\<你>\Downloads" \
  --project <maker-project> --kind bgm --to wav --latest

# 音频转换（需要 ffmpeg）
node <plugin-dir>/src/taptap-audio-convert.mjs --in sfx --out out --to wav --mono --rate 44100 --normalize

# skills 更新
node <plugin-dir>/src/taptap-skills-update.mjs

对话里也可直接用斜杠命令：/taptap-image、/taptap-audio、/taptap-bgm、 /taptap-audio-convert、/taptap-skills、/taptap-setup。

素材来源与授权（重要）

所有来源都经过逐个核实官方授权条款——「免费」不等于「可商用」：

来源	授权	自动获取
Kenney	CC0 — 可商用、可修改、无需署名	✅ 整包下载
Mixkit	Mixkit Free License — 可商用、无需署名	⚠️ 索引（安装时单文件下载）
小森平	中文页原话：商业利用、加工、应用或工业产品的使用也可；禁把音效本身再贩卖	✅ 单文件按需
効果音ラボ	FAQ 原话：商用無料、料金発生なし、報告不要、クレジット表記不要，明写可嵌入游戏有偿销售；禁再配布	✅ 单文件按需

未接入（有原因）：

• Freesound — 需要用户自己的 API Key（实测裸请求 401）
• OpenGameArt — 授权混杂，含 CC-BY-NC 等禁止商用 的协议

诚实限制

使用前请读完这几条，我们不假装它们不存在：

1. 没有可无缝循环的完整 BGM。Kenney 音乐包只有 1~3 秒短 jingle。完整 BGM 要走网页版生成。
2. 完整 BGM 无法全自动。MiniMax 音乐 API 对新用户账号直接返回 HTTP 410（实测：真 key 调 music-3.0/music-2.6/music-cover 全 410，假 key 才 200/1004）；其网页版是需登录的单页应用、没有公开 API（实测 /api/music 返回 HTML 页面），脚本无法代你生成/下载。 所以插件能自动的只有前后两段：生成提示词 + 打开网页，以及下载后自动导入项目。中间「点生成 + 下载」必须你亲手做。不要反复重试 API，也不要据此判断接口故障。
3. 効果音ラボ 的 robots.txt 禁止 AI 爬虫抓 mp3。它的授权允许你把音效嵌进有偿游戏，但本插件只在你要装某一个文件时才下载它，串行 + 限速 + 遇错退避，绝不整站抓取。
4. 设置页的保存依赖宿主 web 服务（webServer）。若你的 DSH 组合没启用，卡片会提示改用命令，不会白屏。
5. 生图 / 音乐用的是你自己的 Key，账单在你那边；本插件不代付、不代理、不上传你的 Key 到任何第三方。
6. ChatGPT 网页生图依赖界面选择器。OpenAI 改版频繁，脚本可能失效——失效时它会如实报告卡在第几步（no_composer / no_image / download_failed），不会假装成功；此时回退到中转站。
7. 网页出图要 1~3 分钟。脚本会等"生成中"结束、只认本次新出现的图再下载（不会把上一轮对话里的旧图当结果）。真等超时会记住那个对话的链接：用 grab 抓回来即可，不要重新生成（会白烧一次额度）。
8. 多账号轮询违反 OpenAI 服务条款。轮换账号会绕过单账号配额，可能导致账号被封。这是应要求实现的功能，风险由你承担；每个账号用独立浏览器 profile 隔离，且不会自动重试被标记封禁的账号。

关于「额度红线」

它守的是这 12 个消耗 Maker MCP 内置额度的工具： generate_image、batch_generate_images、edit_image、create_video_task、query_video_task、 text_to_music、text_to_sound_effect、batch_sound_effects、audition_voices_for_character、 confirm_character_voice、text_to_dialogue、create_3d_asset。

只读 / 状态 / 构建 / 反馈 / LSP 类工具不受限。

隐私

• API Key 只写进 $DSH_HOME/taptap-maker-dev/{image,music}.json，绝不进入会自动提交的 Maker 工作区。
• 本插件不联网上报任何遥测；联网只发生在你主动下载素材或调用你自己的生图 / 音乐端点时。
• 发布前可运行 node scripts/sanitize-for-release.mjs 清掉本机路径与密钥残留。

---

English

A DeepSeek Harness plugin for local TapTap Maker game development: enforces a "don't spend the user's credits" red line, ships updatable game-dev skills, and provides self-hosted image / SFX / BGM lanes — all via your own API keys or CC0 libraries, never consuming Maker MCP built-in quota.

Highlights: a live-togglable credit red line, ChatGPT web image generation as the primary image lane (login once, with optional multi-account rotation), an OpenAI-compatible relay lane as the fallback, a 706-file CC0 Kenney audio library with fallbacks to Mixkit / Taira Komori / 効果音ラボ, a BGM helper that writes the prompt and opens the MiniMax Audio page then auto-imports the download, ffmpeg-based audio conversion, and checkbox skill management — all configurable from the Settings page without hand-editing JSON.

See the tables above for verified licenses, and read the honest limitations: there is no seamless looping BGM in the CC0 library, and full BGM cannot be fully automated — the MiniMax API answers HTTP 410 to new-user accounts, and their web page is a login-only SPA with no public API, so "click generate and download" must be done by hand. The plugin automates the two ends: writing the prompt and opening the page, then importing the finished file. 効果音ラボ's robots.txt restricts AI bulk fetching (we fetch one file per install, sequentially, and never crawl).

License

MIT. This covers the plugin code only — each downloaded asset carries its own license (documented above), and you are responsible for complying with those.