TodoAgent 可以启动拥有用户权限的 Coding Agent、访问用户授权的工作目录并保存 Open Responses 模型服务凭据,因此安全问题应在公开前得到私下处理。
请优先使用 GitHub 的私有安全报告入口:
https://github.com/day0n/todoagent/security/advisories/new
如果该入口不可用,请先通过仓库维护者的 GitHub 主页请求一个私下联系渠道,不要在 公开 Issue、Discussion、PR、commit 或日志附件中披露漏洞细节。
报告请尽量包含:
- 受影响 commit、组件和 macOS 版本;
- 相关 Runtime/CLI 及其版本;
- 可重复的最小步骤或 proof of concept;
- 实际影响、攻击前提和可观察结果;
- 已知缓解措施;
- 是否包含第三方组件问题。
请勿附带真实 API Key、认证 Token、完整私人终端内容或无关用户数据。维护者确认收到 后会评估影响、协调修复与披露时间;请在双方同意前保持私密。
TodoAgent 尚处于 developer preview。最新预览 tag 为
v0.2.0,但安全修复只面向
最新 master;预览 DMG 不构成长期支持版本。
legacy/web 仅用于历史兼容参考,不承诺持续安全维护。
| 版本/分支 | 安全修复 |
|---|---|
最新 master |
支持 |
v0.2.0 预览 DMG |
跟随最新 master,不单独维护 |
legacy/web |
不主动维护 |
| 未知 fork、旧 commit、第三方重打包 | 不支持 |
Codex、Claude Code、Cursor Agent 和 Kiro CLI 使用用户自己的安装、身份和权限。 TodoAgent 不替代它们的 sandbox、approval、网络策略或供应商安全模型。用户选择工作 目录后,CLI 可能按自身能力读取/修改文件和运行命令。
TodoAgent 负责验证 executable、构造参数、启动独立进程组、恢复 Provider Session 和结束进程;不解析或持久化终端 scrollback。binary 或上游 CLI 被替换、升级或入侵 属于重要安全边界,应重新执行 Runtime 验证。
Engine stdout 专用于本地 stdin/stdout NDJSON IPC,不监听 TCP 端口。Terminal status 事件需要 Run-scoped token 认证;用户输入、模型输出和诊断不得混入 IPC stdout。
- Codex/Cursor 的用户级 Hook 只在用户确认后合并,写入前备份现有配置;卸载只移除 TodoAgent 管理的 handler。
- Claude Code 的受管 Run 使用 run-scoped 临时 settings;用户在任务终端自行启动的
claude在用户确认后合并用户级settings.json的 hooks 段。 - Kiro CLI 当前不安装 Hook。
- Hook 仅报告有限生命周期状态,不读取终端内容;TodoAgent Run 之外缺少认证环境时 Wrapper 直接退出。
Hook 配置处理应拒绝符号链接、错误 owner、异常文件类型、多个硬链接、过宽权限和 超大/未知 JSON 结构。
单一模型服务 Key 保存在 mode 0600 的 Application Support 文件中,通过 IPC 注入
Engine 内存,并只作为 sensitive Bearer Header 发送。Key 不进入 SQLite、UserDefaults、
环境变量或日志。当前文件不是 Keychain 加密项;同一账户进程和系统备份可能读取,
建议启用 FileVault。
用户配置的是完整 Open Responses endpoint 和 model,而不是从内置服务商列表选择。
该 exact URL 是安全边界:它会收到 API Key、当前已选会话上下文和用户显式附加的
.txt / .md 内容。更改全局配置后,已有会话的下一轮也会发送到新 URL,因此只应
填写可信服务。远程 endpoint 必须使用 HTTPS;HTTP 只允许 localhost、
127.0.0.0/8 或 ::1 loopback,明文 LAN endpoint 会被拒绝,不能用来传输 Bearer
Key。所谓兼容要求服务真正实现 Open Responses / OpenAI Responses 请求、输出项和
semantic SSE schema;Chat Completions 兼容接口不等价。
配置、Key 注入和 Key 清除都携带同一个单调递增的 mutation revision,并绑定完整 URL 与 model。Engine 会拒绝迟到或身份不匹配的操作;活动发送也记录其 revision,因此旧 设置窗口不能覆盖新配置、清除新 Key,或让已经清除的旧 Key 继续发出请求。
连接测试会向 exact URL 发出一次最小 store=false Responses 请求,产生极少量 Token
和可能费用;它不会查询 /models。助手没有 shell、任意文件读取或 CLI 派发权限;
远程服务自身的条款和日志政策仍然适用。
Application Support 目录使用 0700,数据库和敏感文件使用 0600。文件访问和原子
替换应保持 no-follow、owner、file-type、hard-link 和权限检查。
每次需要改写结构的数据迁移都会先生成受限权限备份;v7 → v8 会删除旧的 Assistant Session provider/legacy 标记,同时保留全部历史和 Turn model provenance。无法识别的 旧/未来 schema 应原样保留并拒绝打开, 不能为了恢复启动而静默擦除用户数据。
以下通常属于产品限制或上游问题,但仍欢迎普通 Bug Report:
- ad-hoc 签名预览 DMG 触发 Gatekeeper;
- 未安装或未登录的 Runtime 返回
missing/auth_required; - 上游 CLI 改变未承诺的 flags、Hook schema 或 Session store;
- 用户明确授权 Agent 修改工作目录后产生的预期文件变更;
- 删除 App 后 Application Support 数据仍然保留。
如果某项限制能被绕过授权、导致跨目录访问、凭据泄露、命令注入、配置破坏、权限 提升或无法恢复的数据损坏,则应按漏洞私下报告。
GhosttyKit、shell integration、Rust crates 和其他第三方组件保留各自安全与许可责任。
来源和版本信息见 THIRD_PARTY_NOTICES.md 与
vendor/ghostty/。发现上游漏洞时,请同时说明受影响 revision 和 TodoAgent 是否实际
启用了相关代码路径。