Tourmind-Booking-Skills安全实践:Token防泄露、文件权限600与401认证失败恢复策略
Tourmind-Booking-Skills安全实践:Token防泄露、文件权限600与401认证失败恢复策略
Tourmind-Booking-Skills 是一套让 AI Agent 端到端完成酒店与机票预订的技能包:实时比价、验价、下单、取消和支付都通过 TourMind API 完成。因为涉及真实的账号认证和资金操作,它的安全设计格外值得新手参考。本文用通俗语言讲清三件事:Token 防泄露机制、skill_token.txt 文件权限 600 的含义,以及遇到 401 认证失败时的恢复策略,帮你安全地把 AI 预订助手用起来。
一、先认识 Tourmind-Booking-Skills 的凭证体系
要理解安全机制,先要理解 Token 是怎么用的。
| 概念 | 说明 |
|---|---|
| 共用 Token | 酒店技能与机票技能共用同一个 TourMind Skill Token,只需申请一次 |
uk_ 前缀 |
个人渠道凭证(ToC),用于个人用户 |
sk_ 前缀 |
企业渠道凭证(ToB),用于企业用户 |
| 存储位置 | 安装目录下的 skill_token.txt 文件,由 Agent 自动保存,用户无需手动管理 |
| 读取顺序 | 先读当前技能目录的文件,文件为空时再读兄弟技能目录的文件 |
🔑 几个关键设计:
- 免 Token 也能用一部分功能:酒店搜索、机场查询、机票实时搜索不需要 Token;只有验价、下单、查单、支付这类"受保护操作"才强制认证。
- 前缀只是选路,不是授权证明:Token 前缀决定走哪个渠道,但"保存成功"不代表"有权限",服务端响应才是最终权威。
- 渠道严格绑定:
uk_只能发往个人渠道字段,sk_只能发往企业渠道字段,一次请求中绝不混发两个字段。规则见 skills/tourmind-booking/SKILL.md 的 "API and authentication" 一节。
二、Token 防泄露:从写入到输出全链路管控
泄露凭证是 AI 工具最常见的安全事故。Tourmind-Booking-Skills 在四个环节做了硬约束:
1. 写入环节:落盘不落地(屏幕)
当你在私密对话中把 Token 发给 Agent 后,Agent 会:
- 去除首尾空白,仅接受以
uk_或sk_开头的完整 Token; - 安全写入
{baseDir}/skill_token.txt,覆盖该技能原有的凭证; - 之后永远不重复输出完整 Token——不出现在回复、日志、截图、Git 提交、Issue 或共享报告中。
2. 读取环节:禁止回显
技能规范明确要求"读取和保存凭证时不得打印其内容":不 cat 文件、不把 Token 拼进可见命令行参数、不开启请求头调试输出。甚至配置完成后也只确认"已配置",不复述任何前缀、后缀或打码片段。规则来源:skills/flight-booking-ai/SKILL.md 的 "Credential lifecycle" 章节。
3. 传输环节:字段与渠道一一对应
| 渠道 | 凭证 | 发送方式 |
|---|---|---|
| 个人(ToC) | uk_... |
仅在接口契约接受 user_key 时发送 |
| 企业(ToB) | sk_... |
以 token 字段(或 X-Skill-Token 头)发送 |
| 无凭证 | 无 | 仅走公开接口,不发送任何身份字段 |
永远不把 Token 放进 URL 或 JSON 请求体其他位置,避免被访问日志和分享链接二次泄露。
4. 更新环节:升级不覆盖凭证
技能自动更新流程有一条铁律:任何更新都绝不允许静默覆盖本地修改或任一技能的 skill_token.txt,防止升级过程把凭证弄丢或被篡改。
三、文件权限 600:chmod 600 skill_token.txt 是什么意思?
🛡️ 在 macOS 或 Linux 上,Agent 保存 Token 后会执行 chmod 600 skill_token.txt。
| 权限位 | 含义 |
|---|---|
6 = 读写(rw) |
属主(当前用户)可以读取和修改文件 |
0 |
同组用户无任何权限 |
0 |
其他用户无任何权限 |
通俗地说:600 表示 只有当前用户本人能读写 Token 文件,同一台机器上的其他账号、以及运行在其他用户身份下的进程都无法偷读。相比默认的 644(其他用户可读),这一步把"本机多用户共享"场景下的凭证窃取风险直接消除。
对普通用户的实际意义:你不需要自己创建或编辑任何文件,Agent 已经替你处理了;但如果你好奇,可以用 ls -l skill_token.txt 看到 -rw------- 这样的权限串,确认防护生效。安全总览可参考 README.md 的 "Token and security" 章节。
四、401 认证失败恢复策略:清除、停止、换证、重建
当受保护请求返回 HTTP 401、unauthorized 或 invalid_token 时,技能不会"默默换条路再试一次",而是走一套完整的恢复流程。完整定义见 skills/flight-booking-ai/references/authentication.md。
第一步:立即清除被拒凭证并停止
- 从记录的来源文件(机票技能或酒店技能的
skill_token.txt)中删除该凭证,并清出所有可复用的请求头; - 停止本次操作,绝不自动重试;
- 清除和保存过程中不输出任何凭证内容。
第二步:明确"不许做什么"(负面清单)
这一部分是整个策略最有价值的地方:
| 诱惑场景 | 正确行为 |
|---|---|
| "同一个 Token 再试一次" | 零次受保护调用,被拒 Token 永不复用 |
| "我接受风险,就用一次" | 风险接受不构成授权,仍不重试 |
| "换组日期/换个参数再试" | 改变参数不等于修复认证,仍停止 |
| "去别的安装、备份、环境变量、历史记录里找个 Token" | 禁止跨位置翻找任何替代凭证 |
| "悄悄降级成匿名搜索" | 不允许静默降级;公开机场查询仍可用,但它不能证明授权,也不能恢复失败的受保护操作 |
| "换成另一个技能的 Token 顶一下" | 同一次恢复中禁止回退到兄弟技能文件 |
第三步:通过官方路径获取替换 Token
- 个人用户:前往 Journione 登录页(auth.journione.ai)验证邮箱后获取新的
uk_Token; - 企业用户:登录 TourMind 账号后,在 Skill Token 页面(tourmind.com/user/skill-token)创建新的
sk_Token;没有企业账号则先注册; - 渠道未知时:同时展示两条路径,不替用户做选择。
收到替换 Token 后同样"安全保存、不回显"。特别注意:保存不等于授权——Agent 不会仅因为收到了新 Token 就自动补发之前失败的请求,只有当你明确请求或批准下一个受保护操作时才使用它。也不允许"自创一个验证接口"来测 Token,更严禁用 create_booking 或 create_payment 这类会产生订单/支付的操作来试探凭证。
第四步:安全恢复业务流
Token 更换会使此前的报价、验价会话、乘客信息确认和支付上下文全部失效,因此:
- 若之前是搜索类操作:重新搜索、展示新结果、等待你重新选择;
- 若之前是下单/支付且结果不明:先对账(查询已知订单状态),保留"是否已下单"的不确定性,绝不自动重放创建请求;
- 后续任何下单或支付都必须重新走完整审查 + 显式确认流程;
- 已有订单绑定创建它的渠道,需用前缀匹配的凭证访问,绝不拿另一个渠道的 Token 去探测。
📢 面向用户的回复也有规范:使用固定的"认证恢复"模板(response_templates.md 的 Authentication recovery 一节),只说明哪个操作未完成、如何获取新 Token、下一步做什么,不展示原始认证错误,也不泄露任何 Token 片段。
别混淆:401 的三种"相似"情况
| 响应 | 含义 | 处理方式 |
|---|---|---|
HTTP 401 / invalid_token |
Token 失效 | 走上述完整恢复流程 |
HTTP 403 + HOTEL_BUSINESS_PERMISSION_REQUIRED |
Token 有效,但账号未开通酒店企业权限 | 不删除 Token、不重试,联系账号管理员开通 |
verify_offer 业务码 20105 |
搜索后 Token 发生了变化 | 保留当前 Token,重新搜索一次展示新报价,请用户重新选择(见 parameter_guide.md 的 token-change recovery) |
五、这些规则如何被验证:行为回归测试
规则写在文档里不算数,Tourmind-Booking-Skills 用离线行为回归测试来"考试",全程使用合成凭证、不触碰真实接口:
- tests/flight-booking-ai/auth_recovery.md:A–G 七组序列,覆盖"拒绝后清除凭证""重试诱惑免疫""换证后只执行用户授权的一次调用""永不重放下单/支付""只读凭证测试""20105 报价刷新""共享 Token 发现边界"等场景。例如 Sequence A 中,即使用户连续施压"再试一次""我接受风险""换个日期""去备份里找个 Token",验收标准都是零受保护调用。
- tests/flight-booking-ai/payment_safety.md:验证支付创建前的"可支付订单白名单"和最终二次查询门禁,确保认证恢复后也不会产生重复支付。
- tests/test_repository.py:保证仓库结构、技能命名与版本同步等基础约束。
六、给新手的安全使用清单
把以下习惯当成默认操作,基本就能安全使用这套技能:
- [x] Token 只在私密对话中发给可信的 Agent,不发公开渠道;
- [x] 不在 Prompt、日志、截图、URL、Git 提交或 Issue 中粘贴完整 Token;
- [x] 让 Agent 自动管理
skill_token.txt,无需手工编辑文件; - [x] 看到 401 时不催促"快点重试",配合 Agent 走"清除 → 官方换证 → 重新选择/确认"流程;
- [x] 下单、支付、取消前,认真核对 Agent 展示的完整审查表并显式确认;
- [x] 更新技能后确认 Token 文件仍在(更新流程保证不会覆盖它)。
总结
Tourmind-Booking-Skills 的安全模型可以浓缩为一句话:写入不落屏、传输绑渠道、存储 600 隔离、失效即清除、恢复不自动。对新手而言,你真正需要记住的只有两点——把 Token 只发给自己信任的 Agent;遇到认证失败时给流程一点耐心,让"清除—换证—重新确认"完整走完。安全不是多出来的步骤,而是这套预订能力本身的一部分。