Contribute

源码、issues 和贡献路径。

Oak Keyring 已在 OpenKeyring 组织下开源。贡献应尊重当前预览版边界、本地优先安全模型,以及项目的 secret-handling 规则。

提交 issue 前

可通过 GitHub Issues 报告可复现 bug、安装失败、crash 和文档问题。请包含 ok --version 输出、macOS 版本、Mac 架构,以及问题是否涉及 new vault、restored vault、imported data 或 synced data。

使用 GitHub Discussions 讨论使用问题、早期反馈,以及不一定属于产品 bug 的排查。

Secret handling

不要公开发布真实密码、vault databases、recovery words、OAuth client secrets、OAuth tokens、private keys,或包含敏感值的完整日志。如果复现需要数据,请创建一次性 vault,使用假 records 和假 credentials。

从源码构建

源码构建适合检查和开发。Google Drive sync 构建需要显式配置 OAuth2 values;如果只是做不触发 sync 的开发检查,可以使用 placeholder OAuth values。