OpenFang 中文版

面向中文用户维护的开源 Agent OS 本地化版本

快速开始 · 汉化范围 · 项目文档 · 参与贡献 · 上游项目

OpenFang 是一个开源智能体操作系统。本仓库在保留核心能力的基础上，持续维护中文界面、中文表达和本地化体验，让中文用户更容易安装、理解和使用 OpenFang。

[!IMPORTANT]
这是由社区维护的中文本地化仓库，并非 OpenFang 官方中文发行版。核心架构、功能演进与安全公告请同时参考上游项目 RightNow-AI/openfang。

✨ 为什么使用这个版本

• 中文界面：覆盖主要控制台页面和常用操作路径。
• 保留上游能力：不改变核心架构，尽量让本地化补丁保持可追踪。
• 完整源码：后端、前端、SDK、示例和部署资料均保留在仓库中。
• 可参与维护：可以通过 Issue 报告漏译、术语问题和版本差异。

🌏 汉化范围

当前已覆盖 500+ 条用户可见文本，主要包括：

本地化遵循四项原则：只翻译用户可见文本；不翻译代码标识符；术语在同一功能域保持一致；与上游差异尽量控制在可审查范围内。

🚀 快速开始

环境要求

• Rust stable（版本以 rust-toolchain.toml 为准）
• Git
• 桌面构建所需的系统依赖；Linux 用户可参考 安装文档

从源码构建

git clone https://github.com/rfdiosuao/openfang-cn.git
cd openfang-cn
cargo build --release

初始化并启动：

./target/release/openfang init
./target/release/openfang start

Windows PowerShell：

.\target\release\openfang.exe init
.\target\release\openfang.exe start

启动后访问 http://127.0.0.1:4200。生产部署前请阅读 配置说明、安全说明 与 生产检查表。

🧭 文档导航

🤝 参与贡献

欢迎参与三类贡献：

1. 在 漏译 / 术语 Issue 中报告具体页面、原文和建议译文。
2. 在 Bug Issue 中提供版本、平台和复现步骤。
3. 按照 CONTRIBUTING.md 提交代码、测试或可审查的本地化补丁。

提交前至少运行：

cargo fmt --check
cargo check --workspace

🔄 与上游的关系

• 上游仓库：RightNow-AI/openfang
• 中文版问题：Issues
• 中文版发布：Releases

发现属于核心功能的问题时，建议先确认上游是否已经修复；适合通用解决的问题也欢迎优先贡献到上游，再同步回中文版本。

📄 许可证

本项目沿用上游双许可证：可选择 MIT License 或 Apache License 2.0。第三方组件仍遵循各自的许可证和商标规则。

让优秀的 Agent 基础设施更容易被中文用户理解、使用和共同维护。