参与开发
欢迎提交错误修正、翻译和新功能。
本地构建
构建终端主程序只需安装 Go(版本见 go.mod):
sh
git clone https://github.com/TarocchiLive/arcana-world.git
cd arcana-world
make build
./bin/arcana-world以下常用命令均在项目根目录运行:
| 命令 | 作用 |
|---|---|
make run | 直接运行 |
make check | 测试和静态检查,提交前运行 |
make desktop | 完整桌面包,含浮层和语音辅助程序 |
make clean | 清理 bin/ |
NixOS 可使用 nix build。浮层和语音辅助程序需要额外依赖(图形库、Qt、Python 等),各平台要求见从源码构建;代码组织方式见架构概览。
提交规范
提交信息使用英文,格式为 type(scope): subject,例如:
text
fix(overlay): let taller panels show more chat messagestype 取值为 feat、fix、docs、refactor、perf、style、test、build、ci、chore、revert、release、merge 之一。代码注释使用中文。其他约定见仓库根目录的 AGENTS.md。
翻译
界面文字位于 internal/i18n/locales,按 zh-CN 和 en 分别存放。修改文字时须同时更新中英文。
反馈与交流
- 问题与建议:提交到 GitHub Issues,需附带的信息见常见问题。
- 代码修改:直接提交 Pull Request。
- 交流讨论:扫码或点击此处加入 QQ 群。

许可证与致谢
Arcana World 采用 GPL-3.0-only 许可证。
本项目是独立开发的开源工具。使用者应自行遵守适用的法律法规和平台规则。本项目仅用于学习和交流 Go 及相关框架,请勿用于其他用途。
感谢以下项目: