Appearance
活动记录(后台可追溯、可审计)
2026-11-16(新加坡时间)。用户要求:“所有的授权和读取,虽然是分布式的,但是都可以回溯可审计吧?”“human 的操作不用管,主要看后台的记录 可审计 可以追溯”“不同设备端的登录 解锁这些也需要的,但是复制啥东西 不需要”。
设计和理由见 design.md 7.2 节。这里写实现、用法、测试和边界。
记什么,不记什么
| 类别 | 记录 | 记录在哪台设备 |
|---|---|---|
| agent 请求 | 引擎的每条记录:请求(含策略拒绝)、授权生效、拒绝、待批准、每次使用、列表/搜索;以后新档位(如经扩展代填网页)自动进来 | 执行请求的设备(Mac 的 passnod) |
| 谁批的、怎么批的 | approval_decided:在 Mac App 里批 / 经触控 ID 确认 / iPhone 面容 ID / iPhone 通知或 Apple Watch 快捷批准 / Mac 锁定时在 iPhone 上批;选的时长(仅这一次、直到锁定、24 小时、7 天、总是允许……;敏感条目的限额记成“15 分钟内或 3 次内”,即 ttl_ms 加 max_uses);锁定时没人批而作废的请求 | 收到决定的 Mac |
| 授权结束 | 单条撤销、条目关掉 agent 访问、“总是允许”长期不用自动取消(idle_expired)、全部撤销、锁定时结束的授权数 | Mac |
| agent 身份 | 登记、移除(含结束的授权数) | 执行命令的设备 |
| 服务令牌 | 签发(库、只读、到期)、撤销;每次使用就是 agent 记录(agent_id 为 service:<令牌 id>) | 执行的设备 |
| 设备 | 解锁(主密码、触控 ID / Apple Watch、iPhone 批准、面容 ID、恢复、创建保险库)、锁定(手动、空闲、会话上限、锁屏、睡眠、退出、账户吊销、App 进入后台)、终端会话授权(方式 + 调用链,如 pn ← zsh ← Terminal)、iPhone 配对/解除、快捷批准密钥、“只能用 iPhone 解锁”开关、生物识别解锁开关、生成加设备二维码、加入保险库、移除设备 | 各自设备 |
不记: 主人在 App 里查看、复制、编辑条目;AutoFill 填充(主人自己的使用);条目内容。所有字段都是元数据(agent 名、条目 id/标题、GET api.github.com/user 这类动作、理由、时长、设备名、方式),没有任何密钥值。
存在哪里
$PASSNO_HOME/activity/journal.jsonl 本机日志:先写这里(锁着也能写),哈希链,0600,不同步
$PASSNO_HOME/activity/state.json 本机发布进度缓存(可从文件重建)
$PASSNO_HOME/activity/tips.json 本机校验过的各设备最新位置(发现回滚和改写)
vault/vaults/<id>/activity/<设备>/<序号> 加密 + 签名的段(一批记录),随同步走
vault/vaults/<id>/activity-checkpoints/<设备>/<序号> 压缩检查点- 单一来源: 每台设备的所有记录先进本机日志,段是它的签名、加密发布;agent 审计(
pn agent audit、设置 → Agent 里的审计列表)是同一份日志里 agent 记录的视图(ActivityAuditLog),不再有第二个文件。旧的agent/audit.jsonl第一次用到时校验后整份导入,导入后改名为audit.jsonl.imported,日志里留一条legacy_audit_imported(条数、旧链头、旧链是否完整)。 - 什么时候发布(封段): 锁定前(还有密钥时,
LocalPassnoService::lock)一定发布;解锁时、同步推送前按批发布(最老的一条超过 15 分钟或攒满 200 条);查看列表不强制封段,免得存储里文件太多;移除设备后立即发布。锁着时(长授权、锁屏时手机批准)记录先留在本机日志,下次解锁再发布。 - iPhone: App 解锁后调
record_unlock(面容 ID / 主密码 / 恢复),锁定用lock_with_reason(手动 / 空闲 / 进入后台);保险库创建由 Rust 自动记。同步走已有的 iCloud 等位置。
格式
- 记录:
{seq, prev_hash, body, hash},body是{at_ms, event}的 JSON 原文,hash = SHA-256("passno-activity-entry-v1" ‖ seq ‖ prev_hash ‖ body)。按存储的原文算哈希,所以旧版本不认识的新事件类型也能校验,只是显示成“新版本的记录”。 - 段: 公开字段
{version, vault_id, device_id, seq, epoch, prev_hash(上一段文件的 SHA-256 或 GENESIS)};记录列表补齐长度后用当前纪元密钥 XChaCha20-Poly1305 加密,AAD 绑定库、纪元、设备、序号、上一段哈希;再用设备的 Ed25519 密钥对全部公开字段和密文签名(域passno-activity-segment-v1)。一段最多 1000 条。 - 检查点: 公开
covers_segment_seq和被覆盖的最后一段的文件哈希;加密的摘要里有最后一条被压缩记录的 (seq, hash)、累计条数、时间范围、按类型计数。签名域passno-activity-checkpoint-v1。
保留期限(压缩)
- 一台设备每天最多压缩一次:最后一条早于 90 天的段,以及总数超过 2 万条时最老的段,被压进新的签名检查点;最新的一段永远保留,链从它接着走。
- 压缩后本机删掉被覆盖的段和旧检查点,本机日志也裁到检查点之后(文件第一行记下锚点,链照样能验);下次同步推送时只由写入的那台设备删掉存储里的对应文件(
SyncTransport::delete_compacted,目录、Git、S3、WebDAV 都实现了,其他种类的文件一律拒绝删除)。 - 其他设备拉取时,看到存储里少了被签名检查点覆盖的文件,不算回滚,并删掉本地副本;少了没被覆盖的文件,照旧报
RollbackDetected。 - Git 的历史里仍然有被删的文件(Git 的性质),工作区不再增长。
- 设备不再上线时它的记录不再增长,也不会被别的设备删(单写入者),保留到它被移除后很久也只是固定大小。
校验能发现什么,不能发现什么
pn activity verify / App 的校验状态逐台设备检查:
| 问题 | 名称 |
|---|---|
| 段或检查点被改(密文、字段) | bad_signature、unreadable、chain_broken |
| 中间的段被删 | missing_segment |
| 段被调换顺序 | chain_broken |
| 伪造签名 | bad_signature |
| 签名有效但段里删改了某条记录(写入方自己的 bug 或被盗用的设备) | chain_broken(记录哈希链) |
| 纪元倒退 | epoch_regressed |
| 被移除的设备之后又写记录(用旧纪元密钥也算) | written_after_removal:纪元不低于移除纪元,或序号超过移除它的设备当时看到的最后一段;这些记录照样列出,标“移除后写入” |
| 之前见过的最新段不见了(截断) | rolled_back |
| 之前见过的段内容变了 | forked |
| 本机日志被改或和已发布的不一致 | local_journal_damaged、local_journal_diverged |
| 成员日志里没有的设备 | unknown_device(同步时直接拒收) |
同步层另外保证:所有活动文件只写一次、内容不能变(分叉报错),拉取时必须是该设备的有效签名。
发现不了的(没有服务器、没有外部见证):
- 设备在发布之前(还在本机日志里、或者还没同步出去)就丢掉最新的记录,其他设备从没见过它们,无从得知。本机日志和已发布部分不一致能查出来,但能改本机文件的同用户恶意程序可以同时改日志和
state.json。 - 某台设备第一次校验之前,存储就已经截掉了另一台设备最新的记录:没有“之前见过”的位置可比。一旦校验过,之后的截断就会被发现。
- 被盗用而且仍在成员里的设备可以写假记录(签名是真的);时间戳是设备自己报的。
- 压缩前的细节只剩检查点摘要(条数、时间范围、类型计数)。
- 记录说明“发生了什么”,不能证明某个人在场;批准方式(如“iPhone 面容 ID”)以收到决定的 Mac 看到的签名通道为准。
参考思路(只看设计,没有复制代码):Secure Scuttlebutt 的“每个写入者一条只追加的签名链”、Certificate Transparency / C2SP tlog-checkpoint 的“签名检查点 + 见证者记住见过的位置”、prooflog 的“按来源分段、封段签名、加密后再上传”。passno 没有服务器,所以“见证者”就是每台设备自己的 tips.json。以后如果要更强,可以让设备互相对别人的最新位置签名(互为见证)。
用法
pn activity # 最近 100 条,全部设备,末尾是校验结果
pn activity --since 7d --agent claude
pn activity --device 'MacBook Pro' --limit 20 --json
pn activity verify [--json] # 全部完整退出码 0,有问题 8- Mac App:设置 → 活动记录。iPhone:设置 → 活动记录。都在最上面显示“记录完整,已校验 N 台设备”,或指名哪台设备哪里有问题。
- IPC:
RequestBody::Activity { filter }→ResponseBody::Activity(ActivityView);只给桌面 App 或已授权的终端会话(同其他主人命令),要求已解锁。 - FFI:
record_unlock、lock_with_reason、activity_json。
代码
crates/passno-activity:event.rs(事件,只有元数据)、entry.rs(记录和哈希链)、journal.rs(本机日志,ActivityRecorder)、format.rs(段、检查点、路径)、keys.rs(ActivitySigner/ActivityOpener两个小接口,Vault实现;测试可换假实现)、publish.rs(封段、压缩)、public.rs(同步用的无密钥检查、压缩覆盖范围)、verify.rs(全部设备的读取和校验)。passno-vault:Vault::seal_side_record/open_side_record,用已有纪元密钥和 AEAD,不暴露密钥。passno-sync:activity.rs(覆盖范围、清理本地副本、只删自己的)、engine.rs(拉取、推送、暂存校验)、device.rs(加设备、移除设备记录)、各存储的delete_compacted。passno-agent/src/activity_audit.rs:ActivityAuditLog(引擎的AuditLog实现)、revocation_event。passno-daemon/src/activity.rs和server.rs、phone.rs、approval.rs、agent.rs里的记录点;passno-service/src/activity.rs(解锁/锁定时发布、activity()读取);passno-cli/src/activity_cmd.rs;passno-ffi/src/activity.rs。
测试
crates/passno-activity/tests/activity_log.rs:发布与读取、未发布记录可见、存储只有密文;篡改:改段、删中间段、调换顺序、伪造签名、签名有效但删改记录、截断最新段、改写见过的段、改本机日志;压缩后仍能校验、删检查点被发现。crates/passno-sync/tests/activity_sync.rs:两台设备经目录存储互相看到并校验对方记录、存储里只有密文;压缩后存储和另一台设备都删掉被覆盖的文件且不误报回滚,存储私自删未覆盖的段报回滚;被移除设备之后写的记录被标出;Git 只能删被覆盖的活动记录。tests/recovery.rs:S3、WebDAV 同样只能删活动记录。crates/passno-daemon/tests/activity_tests.rs:真实后台进程记录解锁方式、锁定原因、在 App 里的批准(方式、时长、动作)、全部撤销;不记主人读条目;过滤。crates/passno-cli/tests/cli_integration.rs(agent 端到端末尾):服务令牌签发、使用、撤销都在记录里,输出不含令牌;改本机日志后pn activity verify退出码 8。crates/passno-agent/src/activity_audit.rs:审计是日志视图、改动可查、旧审计文件只导入一次。crates/passno-ffi/src/activity.rs:iPhone 解锁/锁定记录与读取。