README-zh.md

BFMeta-PC-Mars（中文）

英文版请参见 README。

简介

BFMeta 全节点/控制台程序，负责链服务、P2P、API 与运维脚本，支持测试网与主网部署。

使用

1. 安装依赖：yarn install。若需切换依赖渠道，设置 DEPS_CHANNEL、DEPS_INJECT 后再安装。
2. 初始化配置：yarn init 按提示生成 testnet/mainnet 或自定义链配置；在 conf/*.json 中补充 mongoDb.user、调整 logConfig。
3. 构建：开发监听 yarn dev；全量构建 yarn rebuild。
4. 运行节点：node index.js（首次运行按提示输入 Mongo 账号）。
5. 绑定身份：日志出现 waiting for keypairs from master process 后执行 node index.js /ba /?，按示例填写 delegateSecret。
6. Mongo 工具：在根目录创建 mongoComponents/win|linux 并放置 Mongo shell 可执行文件，便于导入导出。

贡献（简要）

• Node >=14，Yarn 管理；保持 TS 类型安全，避免 any/@ts-ignore。
• 业务逻辑放 src/*，通用函数放 helpers，避免重复（DRY）。
• 配置/脚本改动需更新文档或注释；新增命令记得同步 package.json scripts。
• 提交前运行 yarn build 或相关 bdk-tsc 确保可编译。