本文件适用于整个 Core 仓库及后续开发代理。
- 项目目标：在已获授权的范围内复刻闭源 EasyBot 的功能和使用流程；以可验证的协议、行为和测试为依据。
- 建议使用中文交流、编写开发文档及 PR、commit 标题和正文。技术名、路径、类型标记可以保留英文，例如
fix(web): 修复管理员登录失败。中文 CI 仅提供提醒，不因缺少中文阻断合并。 - 使用 AI 辅助贡献时，在 PR 中披露工具及用途；贡献者须理解并审阅改动，用自己的话说明问题、行为和验证结果，提交 PR 前完成人工测试。详细要求见 CONTRIBUTING.md；AI 披露及人工验证不纳入自动检测。
- 不得改写既有历史以追溯修改英文提交。
- 反编译参考仓库位于同组织的 EasyBot-Recovered。本地建议与 Core 并列；只用于功能、协议和接口对照。不得直接把私有参考源码或 DLL 提交到 Core。
- 不把配置 CRUD、页面入口或模拟器通过描述为真实运行时已完成。状态说明必须区分已实现、模拟验证、真实环境验证和待实现。
- WebUI 与管理 API 共用默认端口 5001，由 Go 进程提供构建后的页面；Bridge 独立使用 26991。Vite 仅供可选热更新，不是产品运行依赖。Bridge 运行时尚未实现时不得宣称已监听或已兼容原版插件。
- 修改入口、配置或协议时，同步检查调用方、测试、文档及构建流程。保持修复最小，不为目录规范一次性迁移整个项目。
- 提交前运行与改动相关的 Go 测试、go vet、前端构建；不能运行的检查写明原因。运行数据、凭据、构建产物及反编译文件不得进入版本控制。