diff --git a/AGENTS.md b/AGENTS.md index 6c10bfc..917ec47 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,10 +24,10 @@ cd /Users/xs/Documents/xop # 快速检查(增量编译,最常用) cargo check --all-targets -# 跑单元测试(64 个:args(含 get -v 解析)/ secret / policy / audit / vault / keyring / auth(touchid classify + decide 决策表)/ stdout-guard / error / injector) +# 跑单元测试(68 个:args(含 get -v 解析)/ secret / policy / audit / vault / keyring / auth(touchid classify + decide 决策表)/ stdout-guard / error / injector / askpass) cargo test --lib -# 跑集成测试(17 个:help / dry-run / bad-ref / secrets-file / mask 端到端 / keyring 免密解锁 / SSH-headless / get 默认 mask / get -v 明文) +# 跑集成测试(24 个:help / dry-run / bad-ref / secrets-file / mask 端到端 / keyring 免密解锁 / SSH-headless / get 默认 mask / get -v 明文 / 6 askpass) # 集成测试需要 auth bypass + 已知 passphrase。`XOP_VAULT_PASSWORD` 仅在 # `--features test-bypass` 构建中才被读取;release binary 永远不读这个 env # ——passphrase 必须用户亲输。所以集成测试必须显式启用 feature。 @@ -85,14 +85,19 @@ xop --secret DB_PASS=db_pass \ -- mysql -h mysql.local -u app mydb # ── `xop run`:envp 注入 + argv 占位符(推荐用于 SSH)──────────────── -# envp 注入:vault 值 → 子进程环境变量 +# envp 注入:vault 值 → 子进程环境变量(sshpass -e 读 $SSHPASS) xop run --secret SSHPASS=s11_pass \ --allow-net=192.168.1.19:22 --deny-net='*' \ -- sshpass -e ssh rong@192.168.1.19 'ls /Users' -# argv 占位符:vault 值直接替换 argv 里的 xop://KEY 字符串 -# ⚠️ 替换后的字符串会出现在 /bin/ps 里 —— 密码用 --secret,命令行参数用 xop:// -xop run -- ssh user@host 'echo connect with xop://DB_PASS' +# argv 占位符:vault 值直接替换 argv 里的 %XOP_KEY% 字符串 +# ⚠️ 替换后的字符串会出现在 /bin/ps 里 —— 密码用 --secret,命令行参数用 %XOP_KEY% +xop run -- ssh user@host 'echo connect with %XOP_DB_PASS%' + +# SSH_ASKPASS 注入(v0.4,推荐用于直连 ssh)—— 密码既不进 argv 也不进 env: +# mkdtemp 0700 临时目录里写 0600 data + 0700 getpass.sh,子进程通过 +# SSH_ASKPASS=