Rhoiscribe

RHoiScribe

面向 Hearts of Iron IV 模组开发 Agent 的本地 MCP 服务和 SKILL

简体中文 | Русский | 日本語

如果 RHoiScribe 帮助你改进模组开发工作流，给仓库点个星也能帮助其他 HOI4 模组作者发现它。

RHoiScribe 为 Codex、Claude Code 和其他兼容 MCP 的客户端提供本地 HOI4 模组开发参考层，以及用于生成游戏可读取文件的工具。

目标很简单：减少 Agent 因反复搜索网页、依赖过时假设、使用不安全的文件路径、遗漏本地化编码，以及编写看似合理却无法在游戏中加载的 Paradox 脚本而浪费的工作。

环境

适用对象

• 希望 AI Agent 借助更完善的本地上下文生成 HOI4 内容的模组作者。
• 需要通过一个 MCP 服务使用提示词、资源和工具的 Agent 工作流。
• 离线或很少搜索的开发场景；此时 Agent 应在写入文件前先阅读捆绑的 HOI4 指南。
• 希望生成的内容遵循固定的模组根目录路径，并采用便于审查的输出格式的团队。

提供的功能

RHoiScribe 为 Agent 提供本地 HOI4 知识层、可重复使用的提示词，以及面向文件的常见模组开发工具。配置好服务后，MCP 客户端可通过标准 MCP 列表方法发现具体的提示词、资源和工具。

概括来说，它能帮助 Agent：

• 在进行大范围修改前了解项目结构和参考资料
• 基于 cwtools 提供 HOI4 语言支持
• 在交付前检查可能影响加载的风险，并以红、黄、绿标示
• 快速检查编码、格式和媒体规范
• 在遵循工作区规范的同时安全地编辑现有文件
• 借助 Rchadow 准备 HOI4 调试启动
• 通过 RNMDB，在 .rhoiscribe 下跨 IDE 保存 Agent 状态
• 将工具调用审计日志记录到同一状态数据库，并支持通过正则表达式筛选导出
• 在用户批准创建新程序化美术作品后，实验性地生成 GUI/GFX 资源

捆绑的 Skill 包能让兼容的 Agent 无需修改 MCP 配置即可快速使用本地功能。如果 Agent 支持 MCP，建议使用 MCP 服务，以获得完整功能和更顺畅的体验。

如需详细了解工具和推荐工作流，请阅读功能指南。客户端配置请参阅 MCP 设置指南。

快速开始

从 GitHub Releases 下载预构建二进制文件：

• Windows：rhoiscribe-windows-x86_64.exe
• Linux：rhoiscribe-linux-x86_64
• macOS：rhoiscribe-macos-universal

警告

Skill 软件包目前仍可使用，但已不再是新增语言支持的推荐方案。这类支持最适合在可持续运行并保持预热状态的长期进程中实现；Skill 以短时调用的方式运行，因此将逐步弃用 Skill 支持。如果客户端支持，请使用 MCP 服务。

对于能够读取 Skill 文件夹的 Agent，请下载对应的 Skill 软件包：

• Windows：rhoiscribe-skill-windows-x86_64.zip
• Linux：rhoiscribe-skill-linux-x86_64.zip
• macOS：rhoiscribe-skill-macos-universal.zip

将其解压到一个固定文件夹中。软件包包含 SKILL.md 和对应的可执行文件，因此即使不想配置 MCP 服务，Agent 也可以直接使用 RHoiScribe。

将下载的文件保存在固定文件夹中。在 Linux 和 macOS 上，如果系统要求授予可执行权限，请对下载的文件运行 chmod +x。

只有在需要本地 Cargo 构建时，才从源代码构建：

cargo build --release

从源代码构建时，可执行文件会放在 <ABSOLUTE_PATH_TO_RHOISCRIBE>/target/release/ 下。

打印 MCP 客户端要使用的命令路径：

.\rhoiscribe-windows-x86_64.exe --print-command

Linux 和 macOS 用户可以对下载的文件运行相同选项：

./rhoiscribe-linux-x86_64 --print-command
./rhoiscribe-macos-universal --print-command

Codex、Claude Code 和通用 MCP 配置示例，请参阅 docs/client-setup.md。

帮助改进 RHoiScribe

HOI4 语法和模组制作实践会随时间变化。如果发现捆绑的知识已过时、不完整或有误，请尽可能提供游戏版本、文件类型、来源参考和最小示例，并提交 Issue。

欢迎提交拉取请求，以扩充知识目录、改进示例，或构建更多用于生成、验证、项目扫描及其他 Agent 工作流的 MCP 工具。

署名说明

基于 RHoiScribe 的项目必须在 README 中包含清晰的署名说明章节。请使用 docs/rhoiscribe-attribution.md 中的简短声明模板。

致谢

贡献者