Skip to content

Security: Thanksgiver233/pocket-assistant

Security

SECURITY.md

Security Policy

一个把权限交给 AI 的项目,安全页不能是样板文件。这里写的是:我们认为什么是漏洞、 什么不是、以及你应当期待多快的响应。

支持的版本

版本 支持情况
0.1.x ✅ 安全修复
< 0.1.0 ❌ 不支持(发布前的本地开发版本)

什么是安全漏洞(请报告)

按危害从高到低:

  1. 审批被绕过:任何能让工具在未经 consent 允许(allow / 已确认)的情况下执行的路径
  2. 污点出网失效:untrusted 上下文触发的对外动作没有被拒绝,或能通过"再确认一次"放行
  3. D2/D3 数据外泄:邮件正文、凭证等高敏内容出现在 journal、索引、投递、HTTP 响应或导出文件中
  4. 自我授权:工作区内的任何文件(包括 pa-profile.json)能影响 grants/vault 的判定
  5. 审计链可篡改:能在不破坏哈希链校验的前提下修改或删除账本记录
  6. resume 越权:篡改 journal 后 approve 能执行与原始审批不同的动作
  7. 令牌问题:HTTP 鉴权可被时序侧信道、默认值或可预测性绕过

什么不是漏洞(不必报告)

  • 规则引擎没听懂你的话(这是 P1 模型规划的工作,见 docs/10)
  • 用户自己把令牌发给了别人(令牌轮换是使用问题,pa-serve 已支持重启即换)
  • 本机 root/管理员权限下的攻击(能读你磁盘的人已经赢了,我们不防御操作系统层面)
  • 提醒/日记的内容质量

如何报告

请勿提交公开 Issue。

请包含:复现步骤、涉及的模块路径、你预期的行为与实际行为。 能带上一个失败的测试用例是最好的——本项目所有安全不变量都有对应测试, 一条红测试胜过十段描述。

响应预期

阶段 时限
确认收到 48 小时
初步评估(是否属于上表) 7 天
修复或给出缓解措施 30 天(审批绕过类:7 天)
公开披露 修复发布后,与报告者协商

安全设计的边界(我们公开承认的取舍)

这些不是漏洞,是 P0 的已知边界,详见 docs/08 §6:

  • journal 是 0600 明文文件(resume 重校验缓解篡改,P1 加密封装)
  • 连接器是内存 transport,未验证真实网络的失败模式
  • 规则引擎可被足够刁钻的措辞绕开语义(fallback 会兜住并降级为询问,不会误执行)
  • 单机部署没有高可用;备份恢复 RTO < 30 分钟是设计目标

There aren't any published security advisories