在 DeepSeek Harness (DSH) 體系中，插件是擴展核心能力的核心單元。Ren’Py galgame 的製作涉及大量腳本、資源與配置文件的協同，傳統開發方式在文件管理、版本同步和流程自動化上存在割裂。GALFree 旨在通過插件化的方式，將 Ren’Py 的全流程製作搬到 DSH 的工作臺裏，實現從立項到成品的自動化。
插件定位¶
GALFree 是一個由 netori 維護的 DSH 插件，核心定位是 Ren’Py galgame 的全流程自動化工作臺。它通過“環節零接縫契約”的設計，將項目服務（後端邏輯）與工作臺（前端面板）解耦，但在數據狀態上保持一致，提供一套從素材管理到試玩的完整解決方案。
核心功能¶
插件主要包含以下能力：
- 工作臺面板：提供舞臺板（場景 × 素材槽 × 印章）、文件樹篩選、內容預覽、快照歷史/diff/回滾、項目切換以及釘版 SDK 卡等界面組件。
- 項目服務：提供寫網關、Git 快照、方言解析、推導進度、審讀戳、釘版 SDK 校驗及試玩控制等後端服務。
- T8-T15 功能：涵蓋角色登記簿、素材賬本、設定集、逐場生成、對話編輯、分支圖、整線組裝試玩、圖像渠道/任務隊列以及出圖操作。
- T16-T32 功能：涵蓋參考鏈、音頻接線、聲音錨、封面、界面換皮、快照回滾等後續功能。
- 架構特性：實現環節零接縫契約，支持 SDK 卡供給與項目服務邏輯的深度集成。
安裝與啓用¶
推薦使用預構建包進行安裝。插件要求宿主環境版本爲 DSH 0.1.7 或更高。
dsh plugin --profile web add "https://github.com/netori/galfree/releases/download/v0.1.2/dsh-galfree-0.1.2.tgz"
安裝完成後，側邊欄會出現「GALFree 工作臺」入口。
典型用法¶
在開發過程中，可以通過以下命令進行常規工程操作（對應插件內部的測試與構建流程）：
npm run typecheck
npm test
npm run build
npm run test:slow
適用場景與注意¶
- 適用場景：需要進行 Ren’Py galgame 開發的 DSH 用戶，希望利用工作臺面板統一管理項目文件、配置和流程的開發者。
- 版本兼容性：
- 插件 0.1.2 起要求宿主 ≥ DSH 0.1.7。
- 插件 0.1.1 及更早版本在 DSH 0.1.7 上無法安裝（由於設置模型變更導致
apply拋出錯誤）。
- 源碼安裝：從倉庫源碼安裝時，需在
pnpm-workspace.yaml中配置allowBuilds，否則構建腳本會被攔截。 - 預設機制：0.1.7 起預設機制改變，不再需要手動拷貝文件，而是通過插件 bundle 自帶聲明行。
- 許可證：插件許可證字段在 package.json 截斷中未明確顯示。
總結¶
GALFree 爲 DSH 用戶提供了一個完整的 Ren’Py 開發工作臺，通過自動化服務和麪板交互，降低了 galgame 開發中繁瑣的文件與流程管理成本。相關文檔與源碼可參考目錄頁與 GitHub 倉庫。
