参与贡献

Vibe Bar 仍处于早期公开版本。欢迎提交聚焦的 Provider Adapter、Fixture、测试 与界面优化。

开始之前

请先阅读这些仓库文档：

• CONTRIBUTING.md
• AGENTS.md
• SECURITY.md

开发原则

• 重逻辑放在 VibeBarCore，界面胶水放在 VibeBarApp。
• JSONL 扫描保持线性。
• 实时 Timer 只作用于可见界面。
• 保持各 Provider 布局与语义一致。
• 把 Provider 协议视为不稳定接口，并用 Fixture 覆盖 Adapter。

隐私规则

不要提交：

• 真实 Token、Cookie、JWT、Organization ID、Account ID 或邮箱；
• 个人 /Users/<name> 路径；
• 原始凭据或未脱敏 Session 日志。

Fixture 需要 Home 路径时，使用 /Users/example/...。

分支与验证

从最新 main 创建聚焦的 Topic Branch。提交 Pull Request 前运行：

swift build
swift test
./Scripts/build_app.sh release
codesign -d --entitlements - ".build/Vibe Bar.app"

在 Pull Request 中说明受影响的 Provider 或工作流、用于验证的证据，以及仍然 存在的兼容性风险。

安全问题

优先使用 GitHub Private Vulnerability Reporting。如果不可用，请创建一个不含 Secret 的最小公开 Issue，并请求转入私密渠道。