Skip to content

Contributing

Jump to bottom
ruibaojian edited this page Jul 16, 2026 · 1 revision

Contributing

欢迎提交代码、文档、schema、测试和可公开复现的示例。StarBridge 的贡献首先要保持能力边界清晰和本地数据安全。

提交前

  1. 阅读仓库根目录的 AGENTS.md 与 CONTRIBUTING.md。
  2. 先确认改动属于 MCP、bridge、UXP、矢量化、文档还是示例。
  3. 为 schema、协议、安全边界和可复现行为补充测试。
  4. 不把客户素材、本机路径、账号状态或生成物加入提交。

推荐验证

python scripts\security_check.py
python scripts\starbridge_preflight.py --markdown
python -m unittest discover -s tests
npm.cmd run preflight
npm.cmd test

桌面软件未安装时，使用 probe、soft-exit 或 mock 验证结构化结果，不要为了让 CI 变绿而伪造桌面成功。

Pull Request 应说明

  • 改动范围和对应能力状态。
  • 新增或更新的测试命令及结果。
  • 哪些验证未运行，以及原因。
  • 是否涉及真实写入、外部依赖、权限或隐私边界。
  • 如果是 experimental / prototype，明确证据边界和后续计划。

文档规范

文档应说明前置条件、输入输出、失败行为、验证入口和安全限制。不要把“接口存在”“probe 可用”“dry-run 通过”写成“生产桌面控制已完成”。

返回 Home。

Clone this wiki locally