@taptap/dsh-maker

DeepSeek Harness（DSH）插件：把 TapTap Maker 的本地开发闭环接入 DSH。

装上后，DSH 会自动获得三样东西：

1. Maker MCP 工具（mcp__taptap-maker__*）：构建/提交/预览、状态、广告配置、素材生成等；
2. Maker 技能：工作流 + 常用功能指南（广告 / 云存档 / 排行榜），并内置“以工程内 engine-docs 为准、禁止网上搜错文档”的防错引导；
3. 可发现的 CLI 路径：环境变量 DSH_TAPTAP_MAKER_BIN 指向随包 @taptap/maker 的 CLI， 一次性 init/agents update/mcp report 用 node "$DSH_TAPTAP_MAKER_BIN" <cmd> 零网络执行。

本插件是仓库 DSH 集成的 L2 形态（bundle 插件）。它区别于已有的 L1 形态（taptap-maker install --ide dsh 写入 $DSH_HOME/cordis.patch.yml）： L1 只注册一个裸的 Maker MCP；本插件则把 MCP + 技能 打包成可分发、可一键安装、可 HMR 的 DSH bundle。两者不要同时启用，避免同 serverName 冲突。已用 L1 时，不要手改 YAML；安装前用 Maker CLI 的结构化命令检查并迁移旧注册：

npx -y --package @taptap/maker@<maker-version> taptap-maker plugin inspect --client dsh --json
npx -y --package @taptap/maker@<maker-version> taptap-maker plugin migrate --client dsh --confirm --json

<maker-version> 使用本包 package.json 中 dependencies["@taptap/maker"] 的精确值；固定版本 安装时直接使用对应 npm 包版本或 Release INSTALL.md 中已写入的命令。

安装

前置：已安装 DSH（dsh 命令）与 pnpm。

dsh plugin --profile web add @taptap/dsh-maker

headless profile 同理：

dsh plugin --profile headless add @taptap/dsh-maker

1024Store 使用公开 npm 包 @taptap/dsh-maker 作为市场安装和更新入口。需要固定版本时，在包名后 追加版本号，例如 @taptap/dsh-maker@<version>。对应的 dsh-maker-v* GitHub Release 继续提供 tarball 和 SHA-256，作为预览版、离线安装及排障备用入口。

DSH 会热重载该 patch，无需重启。验证：

dsh --profile web --dump-config | grep -A 20 'mcp-taptap-maker\|taptap-maker'

做了什么

插件通过一个 bundle patch 行（id: taptap-maker）在激活时挂载两个子插件，并注册一个 shell 环境变量：

• Maker 技能：宿主平面 skill-filesystem 实例（DSH 官方 repository-plugin 模式）， providerName: maker + includeDefaultRoots: false + bundledSkillDir: skills/， 只读挂载本包 skills/ 目录，与 standard preset 的本地技能各司其职、不重复扫描项目/用户根。
• Maker MCP：@deepseek-ai/dsh-mcp-client，通过随包依赖 @taptap/maker 的 dist/maker.js 启动（绝对 Node + 包内路径，require.resolve 运行时解析，不依赖 npx、 不绑定 profile 路径）。
• CLI 发现：通过 ctx.shellEnv 注册 DSH_TAPTAP_MAKER_BIN（随包 @taptap/maker 的 bin/taptap-maker 绝对路径），让一次性 CLI 操作零网络、零路径猜测。

为什么这样最贴合 DSH

| 决策 | 理由 | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 单 patch 行 + 程序内挂两个子插件 | 入口只有一个模块，路径全部用 import.meta.url 运行时计算，任意 profile/安装位置都正确；纯 YAML 写绝对路径会绑定机器/profile | | failOnStartupError 默认 false | 本插件同时挂技能 + MCP。若 MCP 启动失败用 true，会连技能一起 dispose 并拖垮 DSH 启动；用 false 则技能仍可用、MCP 由重连自愈（失败仍会打日志，不静默）。L1 裸 MCP 行才用 true 快速暴露 | | 只用 inject: ["shellEnv"] | 技能/MCP 由两个子插件各自声明 inject；本插件只声明它直接使用的 shellEnv 服务，不无谓延迟激活 | | 技能走 skill-filesystem + bundledSkillDir | 零文件复制、装插件即带技能、卸载即消失、HMR 生效，是 DSH 的“仓库插件”一等形态 | | CLI 走 ctx.shellEnv | profile 的 node_modules/.bin 不在 shell PATH，shellEnv 是 DSH 注入会话 shell 的一等通道，比 npx 更稳、零网络 |

使用要点（DSH 特有）

• 每次项目相关的 Maker 工具调用都要显式传 target_dir（DSH 不广播 MCP Roots）。
• DSH 不读 MCP Resources：用 maker_status_lite 看状态、用 get_ad_config 查广告配置， 不要尝试读 maker://*。
• 工程根 AGENTS.md（含 Maker 管理策略块）由 DSH 自动加载，无需额外操作。
• 一次性初始化（登录 / 选 app / clone）走 node "$DSH_TAPTAP_MAKER_BIN" init（该变量由本插件 注入；若运行在未装本插件的客户端才退回 npx -y --package @taptap/maker@<版本> taptap-maker init）。 高频开发循环（状态 / 构建 / 提交 / 预览）用 MCP 工具，不要重造 CLI/API。

配置（可选覆盖）

在 profile 的 cordis.patch.yml 里给插件行加 config 即可覆盖（不覆盖则用默认值）：

- id: taptap-maker
  config:
    mcp:
      serverName: taptap-maker # 默认 taptap-maker
      toolCallTimeoutMs: 3600000 # 默认 1 小时
      failOnStartupError: false # 默认 false：技能不受 MCP 启动失败影响，重连自愈
      env: {} # 可选：合并进 MCP 子进程环境
      cwd: '' # 默认不写（保持项目无关）

卸载

dsh plugin --profile web remove @taptap/dsh-maker

排障

| 现象 | 处理 | | ------------------------------------ | ------------------------------------------------------------------------------------------------------ | | dsh plugin 报 pnpm not found | 先装 pnpm（或 npm i -g pnpm） | | 工具列表没有 mcp__taptap-maker__* | dsh --profile web --dump-config 确认 patch 合成；看 DSH 日志里的 mcp-client(taptap-maker) 重连信息 | | 工具调用约 60s 超时 | 确认生效的是本插件的 1h 超时配置，而非旧的裸 npx 行 | | 广告/云存档等接口用错 | 触发 taptap-ads/taptap-cloud-save 等技能，读工程内 engine-docs，不要网上搜索 | | 与 L1 同时存在导致 serverName 冲突 | 运行 plugin inspect --client dsh 检查，再用 plugin migrate --client dsh --confirm 结构化禁用旧注册 |

版本兼容

• 依赖 @deepseek-ai/cordis ^4.0.1 及配套 @deepseek-ai/dsh-mcp-client / dsh-skill-filesystem / dsh-shell-env（^0.1.0-rc.6，peer 锁定，随 DSH rc 版本同步升级）。
• Maker MCP 由随包依赖的 @taptap/maker 提供；精确版本以本包 package.json 的依赖值为准，并与 仓库 config/maker-version-policy.json 的对应渠道一致。升级 Maker 时同步 bump 本包依赖并随 插件发版。

发布与市场

• 正式包由仓库的 Publish DSH Maker Plugin workflow 同时发布到 npm latest 和 GitHub Release。
• develop 预览版只发布 GitHub prerelease，不写入 npm；main 稳定版才发布公开 npm 包。
• 1024Store 使用 npm 包名 @taptap/dsh-maker；源码和问题反馈入口由 package.json 提供。