SECURITY.md

Rama main · réplica de lectura del repositorio original.

# 安全策略

## 支持范围

安全修复优先面向 `main` 分支。保持 Node.js、系统、反向代理、Android WebView 及所用 CLI 更新，并在独立测试实例验证兼容性后升级。

Witt 能够运行代理、执行命令和修改文件。它不是操作系统沙箱，也不提供无条件安全的公共多租户运行环境。

## 报告漏洞

如仓库已启用 GitHub 私密漏洞报告，请使用 **Security → Report a vulnerability**。若该入口不可用，请先通过维护者公开列出的私密联系方式协商报告渠道，不要公开发布未修复漏洞的利用细节或真实凭据。

报告请包含受影响提交、前置条件、最小复现步骤、影响范围、已知缓解方法和脱敏证据。不要发送真实令牌、授权码、Cookie、密码、私钥、数据库或用户附件。

维护者会核实问题并协商修复及披露安排；项目不承诺固定响应时限或服务等级。

## 部署边界

- 后端监听回环地址，公网入口使用 HTTPS；不要把数据目录作为静态站点发布。
- 兼容令牌可能具有服务器级能力，应与设备凭据分开保护。
- 浏览器会话 Cookie、Android 凭据、CLI 登录和短期能力链接均属于敏感信息。
- 用户分目录、API 认证及模型白名单不等于独立系统用户、容器或资源配额。
- Codex 与其他适配器有不同的沙箱和审批参数；“支持审批”不保证每次高风险操作都会请求确认。
- 使用专用服务用户，核对目录写权限、sudo 和网络边界；开放登记默认关闭，启用前另行配置配额和隔离。
- 备份与源数据同等敏感，限制读取权限，建议加密异机保存并演练恢复。

## 凭据与公开发布

不要把 `.env`、CLI 配置目录、签名文件、数据库、用户文件或真实令牌提交 Git。`.gitignore` 不能移除历史中已经提交的数据。

公开仓库或发布包前，检查完整可达 Git 历史、分支、标签、Release 附件与自动化日志。扫描工具的结果需要人工判断，不能视为无泄露保证。第三方压缩代码可能误报，应核对上游内容，避免为通过扫描而忽略整个依赖目录。

若确认真实凭据已公开，先撤销或轮换，再处理历史、缓存和产物。只删除当前文件、改回私有或重写提交都不能保证已公开数据被收回。

数据流与权限说明见[架构文档](docs/ARCHITECTURE.md)，部署步骤见[部署指南](docs/DEPLOYMENT.md)。