前言¶

在 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。