Skip to content

Agent 工作线(v0.2) ​

2026-11-16(新加坡时间)。接续 agy 已提交的子保险库、授权引擎、CLI/MCP 实现;本分支已合入 main 的 data、daemon、extension、release、sync 工作线;只提交 feat/agent,不推送、不修改 main。

组件与进度 ​

  • passno-agent:Approver、Clock、GrantStore、AuditLog 接口;模拟/TTY 审批、绝对到期授权、身份、可见性、子进程注入、SSH 代签、安装说明。
  • passno-proxy:HTTP 占位符注入、绑定目标、禁止重定向、响应打码、回环代理服务。
  • passno-mcp:官方 rmcp,stdio 八个工具,每个工具必填 reason。
  • passno-vault::SubVault 与 passno-crypto 新增服务令牌能力,主库格式保持不变。
  • 当前阶段:完成 daemon 路由集成;真实 Claude Code 和 Codex 都已跑通验收(脚本里审批用模拟审批器,真实审批走 Mac 弹窗或 iPhone,见第 7 节)。

Contract changes ​

  • docs/design.md 第 7 节新增服务令牌 HKDF-SHA256 + XChaCha20-Poly1305 包裹设计,撤销轮换目标子库纪元,旧纪元所有令牌一起失效。
  • passno-service::LocalPassnoService::with_unlocked_vault 是给本分支管理命令使用的新增 owner 入口;未改既有 PassnoService 或 TypeScript 契约。
  • 默认走 CliBackend / passnod。新增 agent / agent_admin IPC:前者执行授权后的操作,后者管理子库、令牌和条目策略。只有显式 --no-daemon 才在 CLI 内执行。

参考项目 ​

阅读并沿用接口思路,不复制 GPL/AGPL 代码:

  • 官方 Rust MCP SDK(MIT):tool_router、参数 JSON Schema、stdio 生命周期,直接依赖 rmcp。
  • ssh-agent-lib(MIT/Apache-2.0):Session 的公钥枚举和代签契约,直接依赖协议库。
  • varlock(MIT):引用与密钥分离、子进程注入和输出打码的思路。打码不构成安全边界,获准子进程仍能变换或外传密钥。

构建与检查 ​

cargo build -p passno-cli --bin pn -p passno-daemon --bin passnod,仅使用本工作树的 target/debug/pn。所有手工测试必须显式设临时 PASSNO_HOME 和 PASSNO_APPROVER=sim;不安装 App、不改用户 agent 配置。

最终检查:cargo fmt --all、cargo clippy --workspace --all-targets -- -D warnings、cargo test --workspace。本线没有前端/iOS 更改。

需要用户本人 ​

此轮无。后续 daemon 集成后的真实桌面审批、Touch ID、代码签名和主观验收才需要用户在场;本轮始终使用 SimulatedApprover,不弹窗。

授权与身份边界 ​

  • PASSNO_APPROVER=sim 显式启用模拟器,默认最多 15 分钟;Reveal 即使条目 opt-in 也不能走默认批准,必须在策略文件写明 agent + item + reveal 的 approve 规则。TTY 实现仅供后续本人交互使用,非终端永不打开 /dev/tty。
  • PASSNO_SIM_POLICY JSON 可设 default_allow、deny 列表、max_ttl_ms,以及 rules: [{agent, item, tier, decision: "approve"|"deny", ttl_ms}]。规则用规范 agent ID(登记 id 或 service:<token_id>),item 为 id/标题,匹配后的 TTL 仍受总上限约束。
  • owner 模式的 CLI/MCP 入口用 --agent + PASSNO_AGENT_KEY 验证登记凭据;服务令牌模式自动固定身份为该 token ID,不信任调用者自报名称。引擎函数接收已验证身份;IPC 复用 daemon 的 PeerVerifier,生产签名策略和开发同 UID 警告均保留。独立的 agent 签名挑战仍待后续实现。
  • 服务令牌优先于环境中的主密码,每次访问重开并验证注册表、绝对有效期、当前纪元;撤销不会被长期运行 MCP 的缓存绕过。
  • 列表字段只公开非隐藏的 username,任意自定义文本不公开。授权复用仍检查 reason、身份状态、库和档位。
  • 子进程环境采用运行变量白名单和显式注入;默认超时 300 秒(最大 300 秒)、每个输出流最多 1 MiB。Unix 子进程有独立进程组,结束时清理仍持有输出管道的后代。
  • 文件授权存储及审计写入用跨实例文件锁,防一次性授权并发消费和审计分叉。哈希链可检测内容/链路更改;没有外部可信锚点时,不能抵御拥有本机写权限者完整重写/截短后重算日志。

轮换失败恢复 ​

SubVault 新纪元的操作/快照放进独立目录,回滚状态也按纪元分离,先完整写新基线再切换 header,之后清理旧密文。新增写盘故障回归:阻止新快照落盘后,owner 仍可重开旧纪元并读到全部条目。失败后的旧 handle 应丢弃并重开;已撤销令牌保持失效。该布局与写盘顺序已同步 docs/design.md 第 7 节(Contract changes),不修改主保险库格式。

使用方法 ​

  1. owner 在测试环境建库:pn init --password-stdin,然后 pn vault create Agent --agent-usable --password-stdin;pn add --vault Agent --title 'Demo API' --secret-field token=合成值 --allow-host api.example.com --password-stdin。
  2. owner 签发:pn agent token create --vault Agent --read-only --ttl 30d --password-stdin --json。令牌仅输出一次;由启动器放进 MCP 子进程的 PASSNO_SERVICE_TOKEN,不要让模型读取配置或环境值。登记 owner 身份则用 pn agent enroll codex --json,运行时配 PASSNO_AGENT_KEY 与 --agent codex。
  3. 测试审批设 PASSNO_APPROVER=sim。pn agent setup codex --config-dir /tmp/passno-codex --vault-dir /tmp/passno-vault --json 写 MCP 配置与 skill;重复执行不变,--dry-run 不写。setup 只打印自己生成的片段,不回显其它服务的旧配置。Codex 明确继承 PASSNO 环境变量,八个工具的客户端审批交给 passno;没有其它 MCP 的审批变更。
  4. Claude:不带 --config-dir 时,pn agent setup claude 调用 claude mcp add --scope user passno -- <pn> mcp … 注册(Claude Code 的用户级 MCP 存在 ~/.claude.json,passno 不直接改这个文件;已注册且一致时不重复添加)。带 --config-dir(测试用)时才写 mcp.json,要配合 claude --mcp-config <dir>/mcp.json。2026-11-16 合并时发现原实现把配置写到 ~/.claude/mcp.json,Claude Code 不会读,已修正并加测试。agent 的环境变量不再转发 PASSNO_MASTER_PASSWORD。Agy 使用 mcp_config.json,默认目录来自 官方配置说明。Codex env_vars / 每工具 approval_mode 使用官方配置契约。
  5. agent 用 search 找引用,再用 http(header/body 内 {{pn://Agent/条目/token}})或 run(env_refs 对象,精确 argv)。CLI 示例:pn run --reason 'deploy staging' --env DB_PASSWORD=pn://Agent/db/password -- ./deploy.sh。这是最弱档位,允许的程序确实能读取注入值,不具备沙盒隔离保证。
    • 交给子进程的方式(2026-11-16 加):--env / --env-file(文件里每行 名称=pn://…,# 开头是注释,引用里的 $VAR、${VAR} 用调用方的环境变量展开,没设置的变量直接报错,单引号里不展开,只允许 pn:// 引用);--stdin pn://… 把一个值写进子进程标准输入(末尾补换行),给 docker login --password-stdin、gh auth login --with-token 用;--file 名称=pn://… 把值(字段,或主保险库条目上同名的附件)写进 $PASSNO_HOME/agent/run-files/run-<uuid>/名称,目录 0700、文件 0600、create_new,变量里只放路径,子进程退出(或出错)后先覆写再删除;被强杀留下的目录由下一次运行清理(超过 10 分钟的都算遗留,运行最长 300 秒)。三种方式同属 EnvExec 档,每个引用都按精确 argv 审批,MCP run 工具对应 env_refs、stdin_ref、file_refs。文本内容同样参与输出打码(文件 64 KiB 以内)。经 passnod 时子进程在 passnod 里运行,所以临时文件也在 passnod 这边建删;--env-file 在 pn 这边用调用方的环境展开后再发过去。
  6. pn agent grants --json 查看授权,--revoke gr_... 撤销一条;pn agent lock --json 作废 owner 会话和所有授权(独立服务令牌仍可重新申请)。pn agent audit --verify --json 核验链(2026-11-16 起审计是活动记录里 agent 部分的视图,存在 $PASSNO_HOME/activity/journal.jsonl,随同步发布到其他设备;跨设备查看和校验用 pn activity,见 docs/dev/activity.md)。pn agent token revoke <id> --vault Agent --password-stdin 轮换整个子库,旧纪元全部令牌失效,需重新签发。
  7. 本地代理:设至少 32 字符随机 PASSNO_PROXY_KEY 后 pn http --serve --listen 127.0.0.1:0 --json;客户端 POST /proxy 的 JSON 使用 HttpProxyRequest,外层 Authorization: Bearer <proxy-key> 鉴权,实际身份固定为启动时已认证的主体,JSON 的 agent_id 不能冒充别人。只允许回环监听;远程目标必须 HTTPS,本地合成 API 可以 HTTP。host、path(含 query)、method 绑定,禁止路由/分帧 header 覆盖、不跟重定向,响应上限 1 MiB,超时 30 秒。
  8. SSH:pn ssh-agent --socket /tmp/passno-demo.sock --reason 'deployment authentication',另一个进程设 SSH_AUTH_SOCK 后用 ssh-add -L 枚举公钥或用 ssh 请求签名。不删除已有 socket/文件,不支持转发约束或指定目标主机(标准 SSH agent 签名请求没有可信主机字段),精确用途由审批约束。

真实 agent 验收 ​

可重复脚本:python3 tools/agent/acceptance.py --pn target/debug/pn --output /Volumes/Code/github/passno-wt/shots/agent。脚本为每次运行创建临时保险库和各客户端独立配置,Codex 只复制既有登录凭据到临时私有目录,Claude 直接沿用本机登录(见下),都不改用户配置;本地 API 真正校验令牌,部署脚本校验密码摘要,最后检查转录不含生成的主密码、API/DB 密码、服务令牌。临时配置退出时清理;stdout 只报告布尔结果。

  • Codex 首次因客户端自身审批策略拒绝工具调用;setup 增加 passno 工具级委托后,真实 codex exec 在 20.9 秒完成 API、部署、用户名三项,明文扫描通过、审计链有效。证据:shots/agent/retry/codex.jsonl、results.json。
  • Claude Code 首次真实 claude -p 已连 MCP,但默认模型连续返回 429 资源配额耗尽;Sonnet 别名和兼容型号均返回 400 未配置模型路由。已保留失败转录,并在冷却后再试默认模型。冷却后最后一次默认模型重试仍为 429;Claude 真实任务验收未完成,需服务配额恢复后重跑。不能用协议测试冒充真实 agent 验收。
  • 2026-11-16(新加坡时间)配额恢复后重跑:真实 claude -p(daemon 路径)12.4 秒完成 API(search → http)、部署(run)、用户名三项,明文扫描通过。中途两次失败都是登录问题,不是 passno 的问题:临时 CLAUDE_CONFIG_DIR 和 --setting-sources '' 都会让 Claude Code 显示未登录(本机登录存在钥匙串里,~/.claude/.credentials.json 是旧文件)。脚本现在直接用本机登录加 --setting-sources user,靠 --strict-mcp-config(只加载 passno MCP)、--tools ''(不给其他工具)、--no-session-persistence 保持隔离,不写用户配置。证据:shots/agent/claude-final5/。敏感条目、本人确认和 App 开关合入后,2026-11-16 用真实 Claude Code 重跑:17.5 秒,三项全部通过,没有明文(shots/agent/claude-regress/)。

已知边界 ​

(2026-11-16 更新)审批已经是真实的:Mac App 弹窗、已配对的 iPhone,取出明文和敏感条目还要 Touch ID / Face ID(见上文)。仍待做的:agent 签名挑战(当前靠登记凭据和服务令牌认证),以及 agent 经扩展的 WebFill(只定义了请求和结果类型)。owner 请求使用 daemon 的实时服务会话并重载外部改动;锁定标记和令牌撤销每次检查。拥有同一 OS 用户文件权限的恶意进程能读 broker 本地状态,不能把此实现视为进程隔离或防本机用户篡改的保险箱。

独立复核修复 ​

四项均先复现失败再修复:注册表期限限制令牌重新包裹(不能延长 TTL);所有身份注册表读改写共用文件锁(touch 不能覆盖 revoke);setup 默认绑定目标客户端身份,并支持 --agent <custom-name>;禁止保留子库名且生成入口对旧保留名数据也拒绝写入主库。

评审排除的范围维持原约定:模拟审批、真实桌面审批、同 OS 用户文件权限、任意编码绕过打码已明确说明。daemon/PeerVerifier 和 owner 实时会话已在本次合并接入。这些不是本轮提供的安全保证。没有留下评审中的 P1/P2 不修复。

最终验证记录 ​

  • 独立复核的四项修复后,最终真实 Codex 再次完成三项任务,全部返回成功且转录无明文(见 shots/agent/final/results.json)。
  • 回归覆盖:绝对期限不续期、锁定/撤销、跨实例单次消费、并发身份撤销、令牌期限重包裹攻击、轮换写盘失败恢复、保留库名、子进程环境隔离、HTTP 目标/query/重定向/鉴权、防冒充、SSH 签名验证与文件保留、八工具输出无明文及 Schema 快照、setup 幂等/不回显旧凭据/身份选择、嵌套 JSON 帮助。
  • 测试脚本对密码使用 --item-password=<值>,并强制合成 API 密钥以 - 开头,防止随机值被 CLI 误当成选项导致间歇失败。
  • 无前端、iOS UI 或桥接契约改动,本线不需要 npm/iOS 检查;Rust workspace 会同时编译测试现有桌面后端。

合并前检查(2026-11-16,新加坡时间):cargo fmt --all、cargo clippy --workspace --all-targets -- -D warnings、cargo test --workspace 全部通过;workspace 共 91 个测试通过,0 失败。最终带 - 前缀合成密钥的真实 Codex 验收耗时 18.7 秒,API/部署/用户名/无明文检查全部通过。Claude 验收仍因 429 配额失败而未完成;下一步是在配额恢复后运行 python3 tools/agent/acceptance.py --pn target/debug/pn --client claude --output /Volumes/Code/github/passno-wt/shots/agent/claude-recheck,无需更改用户配置或授权界面。

main 合并后的执行路径(2026-11-16,新加坡时间) ​

  • pn vault create、pn agent token create/revoke、pn add --vault 和 --agent-enabled 复用 CliBackend 的解锁状态;默认不再要求每条命令重新输入主密码。
  • pn run、pn http(含 --serve)、pn ssh-agent、pn mcp 默认只做前端:通过 IPC 发送身份凭据、条目引用和操作参数;授权、注入、代签、生成入库与输出打码在 passnod 内完成。SSH 前端只拿公钥和签名,每次请求重新检查会话和撤销状态。
  • MCP 八个工具的参数 Schema 保持一致。agent IPC 不提供任意读取明文接口;只有显式 reveal 例外经过条目 opt-in 和单次批准。agent_admin 返回的首次签发服务令牌属于已有 owner 管理契约,不暴露条目秘密或主库密钥。
  • 服务令牌在 daemon 内每次重新校验,主库锁着也能使用其独立子库。pn lock、pn agent lock 和自动锁定撤销全部已有授权;独立令牌可以重新申请。daemon 不缓存第二份 owner 解锁保险库。
  • 审批策略只从 daemon 启动环境读取 PASSNO_APPROVER=sim / PASSNO_SIM_POLICY,RPC 调用方不能覆盖策略。测试 harness 启动私有 daemon 并在退出时清理;不触碰用户实例。未配置模拟器时保持 pending,绝不弹出 TTY 或系统审批。
  • 长操作不持有 daemon 核心锁,锁屏/休眠/手动锁定仍可响应。已经批准并启动的子进程仍拥有注入值,锁定不能收回它已经拿到的值。相对命令路径使用 CLI 工作目录;IPC 读取超时覆盖子进程 300 秒上限。
  • pn agent-help 从 clap 命令树追加完整清单(含 sync/device/vault 恢复、附件、历史、回收站);gen-pn-docs 同时生成 docs/cli/pn.md 和 help JSON 快照。
  • 主库继续使用 sync 工作线的多设备签名验证与跨纪元快照;服务令牌子库保留独立成员日志验证和先落盘后切换纪元的恢复流程。没有更改密码学原语或两种保险库的磁盘格式。

合并期间 main 新增 b894355(browser/desktop daemon 整合),已继续合入该提交,保留新浏览器调用方校验、原子填充/更新、桌面锁定事件与空闲计时修复。

最终真实 Codex(daemon 路径)完成 HTTP 认证、部署注入和用户名查询,19.2 秒,转录及 daemon 日志的合成明文扫描通过,审计链有效。证据目录:/Volumes/Code/github/passno-wt/shots/agent/merge-main-final/。Claude 未重跑(用户指定因限流跳过)。

最终合并验证:cargo fmt --all 与格式复查通过;cargo clippy --workspace --all-targets -- -D warnings 通过;cargo test --workspace 151 项通过、0 失败。新增回归覆盖 daemon 不可用时禁止隐式回退、完整 agent-help、owner/令牌共用 daemon、HTTP 单次/常驻前端、SSH 签名与锁定复查、broker Debug 隐藏敏感值、响应丢失时不重复执行。最终 clippy/test 日志随验收证据保存在上述目录。

在 passno App 里批准 agent 请求(2026-11-16) ​

之前后台进程默认的审批器是 NonInteractivePendingApprover:真实环境里所有要用密钥的请求都只返回“待批准”,没有任何地方能批。现在改为:

  • 后台进程默认审批器 HubApprover(crates/passno-daemon/src/approval.rs)。agent 请求进来后放进审批中心,向订阅了 approvals 事件的桌面 App 发 ApprovalRequested,然后在 broker 线程里等最多 90 秒(不持有保险库锁)。
  • 桌面 App 收到事件后把窗口拉到前台,弹出审批窗:哪个 agent、哪个条目和保险库、方式(注入命令 / 代发 HTTP / SSH 签名 / 代填网页 / 取明文)、具体操作(完整命令或 方法 + 主机 + 路径)、agent 写的用途、剩余秒数。先选一项再点“允许”,或“拒绝”。2026-11-16 和用户商定(从用户友好出发,不是选项越多越好):弹窗默认只有三项——仅这一次、直到电脑锁定(默认选中;任何锁定都结束,锁屏时即使保险库不锁也结束,最长 24 小时)、总是允许。本次运行(15 分钟)、1 小时、24 小时、7 天收在 设置 → Agent → 授权时长 →“更多时长”里,打开后弹窗才出现。设置里还能改默认项和“总是允许多久不用自动取消”(7 / 30 / 90 天或不自动取消,默认 30 天)。存在 agent/approval-choices.json,IPC Approvals 的 choices / set_choices;daemon 只接受提供了的选项,iPhone 收到的签名请求里带同一份列表、放行范围和天数。敏感条目和取出明文永远只有“仅这一次”。到期时间是绝对的,不会因使用而延长;注入命令和取明文这两档会额外提示“程序本身能读到值”。
  • 只有桌面 App 能批:approvals 请求只接受可执行文件名为 passno / passno-desktop 的已校验对端;pn、MCP、浏览器插件的本机程序都会被拒绝(PeerDenied),agent 不能自己批自己。
  • 没人能批就立刻告诉 agent:只有订阅了审批事件的桌面 App 才算“有人在”。App 没开时请求立即返回“待批准”,提示用户打开 passno;90 秒没人点也返回“待批准”。保险库锁定时所有等待中的请求按拒绝处理。
  • PASSNO_APPROVER=sim / deny 仍然可用于测试和无人值守的开发环境。服务令牌那条路不经过审批。
  • 测试:approval.rs 单元测试(批准、不能改决定、锁定取消、没 App 立即待批准、超时);tests/approval_tests.rs 端到端(真实后台进程 + 事件订阅 + 决定;pn 身份的对端不能列出或批准);前端 src/test/agent-approval.test.tsx。
  • 设置 → Agent(AgentSection.tsx):已登记的 agent(最近使用时间、移除)、当前有效的授权(条目、具体操作、几分钟后到期、单个撤销、全部撤销)、最近 50 条审计日志和哈希链是否完整。数据来自 approvals 请求的 overview / revoke_grant / revoke_all_grants / revoke_agent,同样只接受桌面 App 对端,只返回元数据。
  • iPhone 也能批:配对过的 iPhone 走同一个手机通道审批 agent 请求。手机用新的 PollAgents 消息取待批请求(和解锁流程分开,Mac 解锁状态下也能取);Mac 对请求列表签名(SignedAgentRequests,域 passno-phone-agent-requests-v1,时间差不超过 30 秒),手机先验签再显示,路上被改过的列表会被拒绝。手机的决定用 AgentDecision { id, choice, at },经过配对通道的手机签名,时间差超过 30 秒拒绝,同一个请求只能决定一次,重放无效。手机端每次查看或决定都要先 Face ID 解开配对凭据(模拟器上是模拟 Face ID)。配对了 iPhone 时,即使 Mac 上没开 App,agent 也会等满 90 秒。
  • 测试:tests/approval_tests.rs::paired_iphone_sees_signed_agent_requests_and_decides(真实配对、真实 TCP 通道:签名列表、篡改拒绝、过期时间戳拒绝、没提供的时长被拒、只生效一次、agent 拿到 24 小时长授权)。

长授权:总是允许、24 小时、7 天(2026-11-16) ​

  • 为什么这样设计: 用户要“直到锁屏 / 24 小时 / 7 天 / 永远”。每次弹窗让人在七八个时长里挑,等于把“这个 agent 有多可信”变成每次都要做的算术题,所以弹窗只放三项,“永远”做成一条长期权限(总是允许)而不是一个时长,计时的选项收进设置。
  • 总是允许: 这个 agent、这个条目,HTTP 按同一主机放行(任意方法和路径,条目本身的允许主机仍然生效),命令、SSH 签名等按原样放行。弹窗写明范围(“以后 claude 用「GitHub」做「api.github.com」都不再询问”)。N 天不用自动取消(默认 30,设置可改,0 = 不自动取消;每次使用重新计时,Grant.idle_timeout_ms / last_used_at_ms),参考手机 App 权限和浏览器网站权限对长期不用的自动回收。在 Mac 上选它要过一次 Touch ID;iPhone 上本来每次决定都要 Face ID,手表 / 通知的快捷批准不能选它。
  • 锁屏时也能用: 24 小时、7 天、总是允许批准时,把这一个条目复制一份放在 passnod 内存里,只给这个 agent、这个授权用(passno-agent/src/escrow.rs)。从不写盘,Item 销毁时清零。保险库解锁时照常用实时数据并刷新副本。
  • 锁定的含义(对用户只有一句话): 锁屏、睡眠、空闲自动锁定结束短授权(含“直到电脑锁定”),长授权照常;手动“立即锁定”= 全部暂停,长授权保留但用不了(内存副本丢掉),下次解锁后不用重新批准;撤销才是取消(单条撤销、条目详情里撤销、“全部撤销” → AgentEngine::revoke_everything)。passnod 退出(重启电脑)后副本清空,解锁后自动恢复。
  • 自动作废: 在条目上关掉“允许 agent 使用”、打开“每次使用都要我确认”或调低它的免确认时长 / 次数,这个条目上的所有授权(含总是允许和内存副本)立即作废(AgentEngine::revoke_item)。
  • 锁定时能做什么: 只有长授权覆盖的条目可见,只能做覆盖的那类操作;要做别的或换条目都要新批准,而新批准需要保险库解锁。生成密码等写操作一律拒绝。
  • 在哪看、怎么撤: 设置 → Agent 的授权列表显示“总是允许 · 上次使用 …”或“N 天后到期”;条目详情的“允许 agent 使用”下面列出可以一直使用这个条目的 agent,一键撤销。
  • 测试:crates/passno-agent/tests/long_grants.rs(锁定时只能用那个条目和那项操作、手动锁定暂停后解锁恢复、全部撤销、短授权和敏感条目不保留、总是允许按主机放行、30 天不用失效而使用会续期、关掉条目的 agent 权限即作废);approval_choices.rs 单元测试;approval_tests.rs(只接受提供的选项、手机选总是允许拿到长期权限、快捷批准不能选总是允许);桌面 agent-approval / approval-durations / item-agent 测试。模拟器实测:iPhone 选“总是允许”后 Mac 收到 standing: true, idle_timeout_ms: 30 天。
  • 踩坑:iPhone 请求行里的时长起初用菜单式 Picker,点它会连带触发同一行没设样式的“拒绝”按钮,菜单也打不开;改成带样式的按钮组,并在 apps/ios/tests/check_localization.py 加了检查(列表行里有多个控件时每个 Button 都要 .buttonStyle)。

敏感条目的免确认时长和次数(2026-11-17) ​

  • 为什么: 用户觉得“每次都问”和普通时长之间缺一档:敏感条目(比如银行、生产数据库)一次任务里常要连用几次,每次都按 Touch ID 太烦,但又不想给“直到锁定”那么宽。用户选的做法:打开“每次使用都要我确认”后,下面多两项“免确认时长”(5 分钟 / 15 分钟 / 1 小时,默认 5 分钟)和“免确认次数”(1 次 / 3 次 / 5 次 / 10 次,默认 1 次 = 原来的每次都问)。
  • 数据: AgentPolicy.confirm_window_minutes / confirm_max_uses(passno-model,serde(default);旧条目读出为 5 分钟、1 次)。AgentPolicy::confirm_limit() 只在敏感且次数大于 1 时返回 ConfirmLimit { window_ms, max_uses },超出提供范围的值(新版本写的)按最宽的提供值截断,不会放宽。
  • 引擎(passno-agent/src/sensitive.rs,一个模块管三处): 发请求时 requested 把 ttl_ms / max_uses 定为条目限额(agent 自己要的只能更少),GrantRequest.confirm_limit 带给审批方;批准后 issued_terms 把时长截到窗口内、去掉“锁屏保留 / 总是允许”;复用旧授权前 grant_fits 检查授权没超过条目当前限额(调低了或先有授权后才标记敏感的旧授权不算数,显式传 grant id 也一样拒绝);may_reuse 对取出明文和 1 次的敏感条目一律不复用。授权的“次数”就是 uses_remaining,时长是 expires_at_ms,到了任何一个都要重新批准;锁定时它和其他短授权一起作废,也不进锁屏副本。
  • 审批中心: ApprovalView.confirm_limit(single_use 仍为 true,只有一个批准选项 once),任何批准都换成“窗口时长、普通短授权”;仍要本人确认,Touch ID 提示写成“允许 agent 使用「条目」5 分钟或 3 次”。手机的 AgentRequest.confirm_limit 同样带上;快捷批准密钥(通知 / Apple Watch)仍然不能批(needs_owner_check)。活动记录 ApprovalRecord 加 max_uses,ttl_ms 就是窗口。
  • 设置入口: Mac 条目详情 ItemConfirmLimit.tsx(在“允许 agent 使用”区块里,次数为 1 时时长变灰);iPhone 条目详情;pn add/edit --confirm-window 5m|15m|1h --confirm-uses 1|3|5|10,--from-json 的 agent.confirm_window_minutes / confirm_max_uses;IPC SetItemConfirmLimit、FFI set_item_confirm_limit、owner 操作 item-policy-patch。调低时 passnod 作废这个条目上的授权。
  • Mac 锁着时经 iPhone 批准: 这时手机看不到条目,所以照旧显示普通时长;Mac 打开保险库执行这一次时按条目限额截短,授权也不进锁屏副本。
  • 测试:crates/passno-agent/tests/confirm_limits.rs(按次数、按时间(FakeClock)、锁定作废、换操作要重批、宽的批准被截短且不过锁、取出明文每次都问、旧条目每次都问、调低限额后旧授权失效);sensitive.rs 单元测试;passno-daemon/tests/confirm_limit_tests.rs(真实 passnod + IPC 设置限额、审批窗只有一个带限额的批准、假 Touch ID 只确认一次、次数 / 时间 / 锁定 / 取出明文 / 旧条目、活动记录);approval.rs 单元测试(取消 Touch ID 请求仍在、批准得到窗口时长、提示文字);pn 的 item_input.rs;桌面 item-agent / agent-approval / activity-section 测试。

代填网页:fill_login / pn fill(2026-11-16) ​

场景:agent 要登录一个网站(例如 GitHub 网页),密码不交给它。

  • 调用: MCP fill_login { reason, item, url, submit } 或 pn fill --item pn://Agent/GitHub --url https://github.com/login --reason ... [--submit](只经 passnod)。agent 只拿到 { filled, submitted, detail },detail 为 no_tab(网站没在 Chrome 里打开)、no_form、refused、locked、timeout。
  • 检查: 条目的网址规则必须匹配这个页面(passno_service::login_matches_url,不匹配直接拒绝,不弹审批);审批档位 WebFill,绑定页面的 origin(scheme + host + 端口);Mac 审批弹窗提示“能控制浏览器、在页面运行脚本的 agent 可能读到填进去的值”。
  • 传递: 批准后 passnod 在内存里登记一个待办(crates/passno-daemon/src/agent_fill.rs,最多 30 秒,带着批准时的那份条目,Item 销毁时清零;所以 agent 专用保险库、锁屏时的内存副本、锁屏时手机临时打开的保险库都能用),发 IpcEvent::AgentFillRequested { id, origin, submit }。passno-nmhost 订阅后转给扩展;扩展挑这个 origin 的标签页(当前窗口的活动标签页优先,否则最近用过的),用 agent_fill_claim(id, pageUrl) 领取:只有经 Chrome 签名校验的 nmhost 能领,标签页 origin 必须等于批准的 origin,再按条目网址规则核对一次,只能领一次;填写走和人手动填充同一套逻辑,submit 时用表单自己的提交(requestSubmit)或提交按钮;最后 agent_fill_done 报结果。
  • 扩展常连: 扩展后台一启动就连上 nmhost 并在断开 3 秒后重连(NativeMessagingClient.connect),否则没人点过扩展时收不到代填请求;有活动的原生连接也让 MV3 后台保持可用。
  • 测试: crates/passno-daemon/tests/agent_fill_tests.rs(网站不匹配直接拒绝;只有扩展能领;错误网站的标签页被拒;只能领一次;agent 结果里没有密码)、agent_fill.rs 单元测试、扩展 tests/unit/agentFill.test.ts、扩展 e2e daemon.spec.ts 的 agent 用例(真实 passnod + nmhost + Chromium:服务令牌调用 pn fill,页面上账号密码被填好,输出里没有密码)。
  • 限制: 两步验证码会一起填(和人手动填充一样),但短信、邮件验证码、验证码图片等需要人的步骤,agent 仍要找你。

文档对应提交 56d1c45 · 由仓库 docs/ 自动生成