前言¶

在 DeepSeek Harness 里做 Starsector（Moci 风格）mod 开发时，常见做法是手写 Maven 命令、自己记 JDK 路径、在 API 文档和游戏目录之间来回切换。Codex 生态里已有完整的 starsector-mod-workflow skill 与 moci CLI，但 DSH 的工具注册、skill 目录和用户确认方式与 Codex 不同，不能直接照搬。下面介绍维护者 erenamochizuki 将这套工作流移植成的 DSH 插件：一个包同时注册 skill 与 starsector_moci 工具，让模型按既定流程调用编译、校验、API 检索等步骤，而不必每次从零拼命令。

这是什么¶

dsh-starsector-mod-workflow 是 DeepSeek Harness 的工作流类插件（仓库：erenamochizuki/dsh-starsector-mod-workflow，目录页：SkillHub 插件页）。它把 Codex skill starsector-mod-workflow（Starsector / Moci mod 开发工作流）移植进 DSH，并提供：

1. skill：将 starsector-mod-workflow 注册到 DSH 的 skill 目录（含 REF/、KIT/、API/、Script/ 等资源），并在展示给模型的正文末尾追加 DSH 运行环境，把 Codex 专有命令与交互方式换成 DSH 用法。
2. tool：注册 starsector_moci，直接执行捆绑的 moci CLI（doctor、compile、build、verify、sync、api-src、api-grep、find-class、javap、logscan、templates、new、preview、help 以及本地教程检索 tutorial），并自动带上绑定文件、工作目录和 Node 路径。

插件版本 1.0.0，许可 MIT。插件以当前 DSH 进程权限运行；安装前建议在 GitHub 上查看源码与许可证。

环境要求¶

插件本身为纯 JS，无安装期依赖；assets/ 里的 CLI 只依赖 Node 内置模块。

核心功能¶

Skill 侧¶

捆绑目录 assets/starsector-mod-workflow/ 是 skill 的完整发行版，主要入口包括 SKILL.md / WORKFLOW.md（工作流总则与命令入口）、REF/（环境、性能、UI、战役内存、Janino、教程库等）、API/（本地 API 索引）、KIT/（配方与骨架模板）、GATE/ 与 VERIFY/（校验与回归脚本）、Script/（moci CLI 与教程检索）。相对 Codex 版，正文末尾追加 DSH 运行环境说明；参考文档中的个人绝对路径已脱敏为占位符，路径以本机 moci.json 为准。

工具侧¶

模型通过 starsector_moci 调用 CLI，工作目录默认为绑定工程的 projectRoot。写游戏目录的操作（sync 或 build --game-approved）须按 skill 规则先经 ask_user_question 取得用户明确同意，插件不会自动加开关。

安装与启用¶

方式一：DSH 插件管理器（推荐）¶

打开 DSH 的插件/市场界面，在「包名或自定义安装源」输入：

github:erenamochizuki/dsh-starsector-mod-workflow

确认后重启 DeepSeek Harness。插件声明了 dsh.bundle.patch，安装后会在 profile 的 dsh.profile.bundles 里启用。若市场卡片未列出该源（仅收录 awesome-dsh-plugin 时常见），请用上述自定义安装源或下面的 CLI。

方式二：命令行¶

dsh plugin --profile desktop add github:erenamochizuki/dsh-starsector-mod-workflow

--profile 换成你实际使用的 profile（桌面版通常是 desktop）。装完后确认该 profile 的 package.json 中依赖与 dsh.profile.bundles 已包含 dsh-starsector-mod-workflow（插件管理器自动追加时一般无需手改）。

必须重启 DSH 才会生效：bundle 在启动时组合，运行中的进程不会热加载。重启后 skill 列表会出现 starsector-mod-workflow，工具列表会出现 starsector_moci。

方式三：预构建 tarball¶

从 Releases 下载 dsh-starsector-mod-workflow-1.0.0.tgz，然后：

dsh plugin --profile desktop add ./dsh-starsector-mod-workflow-1.0.0.tgz

绑定 Moci 工程¶

moci CLI 通过 moci.json 定位工程、游戏与工具链。查找顺序为：config.binding → 环境变量 SSMOD_CONFIG → %CODEX_HOME%\starsector-projects\moci.json → %USERPROFILE%\.codex\starsector-projects\moci.json。

在 profile 的 cordis.patch.yml 里可为该条目覆盖（全部可选）：

- id: starsector-mod-workflow
  name: dsh-starsector-mod-workflow
  config:
    binding: D:/path/to/moci.json
    node: C:/path/to/node/node.exe

profile 在绑定文件中必须是 moci-maven。绑定文件为本机配置，不应提交到版本库。未配置 gameRoot / gameMod 仍可离线编译，但 build / sync 的游戏同步部分不可用。

典型用法¶

模型侧示例（参数 args 原样追加；--file 使用工程相对路径）：

starsector_moci({ command: "doctor" })
starsector_moci({ command: "compile" })
starsector_moci({ command: "build" })
starsector_moci({ command: "verify", args: ["--file", "data/hullmods/Foo.java"] })
starsector_moci({ command: "api-src", args: ["ShipAPI"] })
starsector_moci({ command: "tutorial", args: ["search", "--exact", "EveryFrameCombatPlugin"] })

超时默认：compile 600s、build 900s、sync 300s，其余 300s；可用 timeoutSec 覆盖（上限 1800s）。手工调用等价于：

node "<包目录>/assets/starsector-mod-workflow/Script/moci.mjs" doctor

适用场景与注意¶

适合：在 Windows 上维护 Moci 风格 Starsector mod 工程、希望 DSH 里的模型按 skill 规则走编译/校验/API 查文档/教程检索，并少踩 Codex 与 DSH 命令差异的开发者。

注意：

• Codex 配套 skill starsector-moci-shipbuilding、starsector-rules-writing 未一并移植；DSH 中未单独安装时，对应专项规则不可用。
• Script/ 内部仍会调用 Windows PowerShell 5.1 做部分检查，与 DSH 的 pwsh 7 并存。
• 本地教程库需要工程内 tools/knowledge/starsector 索引且依赖 git；缺失时 tutorial 会失败。
• 无 moci.json 或 JDK/Maven 不可用时，doctor 会报缺失项；插件仍可安装与加载。

卸载：插件管理器移除，或 dsh plugin --profile desktop remove dsh-starsector-mod-workflow，再重启 DSH。

结尾¶

dsh-starsector-mod-workflow 把 Starsector Moci mod 开发工作流整包搬进 DSH：skill 资源与 moci CLI 同装，模型用 starsector_moci 即可对齐编译、校验与 API 检索流程。社区插件目录见 SkillHub，源码与完整说明见 GitHub。