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