TeamAI Session Save 详解：如何脱敏存档有价值会话并保护隐私

TeamAI Session Save 详解：如何脱敏存档有价值会话并保护隐私

【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli

TeamAI（teamai-cli）是"让每个团队 AI 原生化"的开源命令行工具，其中的teamai session save子命令可以把一次 AI 编程会话存档为精简的 Markdown 摘要，并在写入前自动完成密钥脱敏与隐私保护——既保留有价值的协作信号，又确保 API Key、Token 等敏感信息不会随档案外泄。本文带你快速搞懂它的脱敏原理、隐私边界和实用参数，几分钟即可完成配置。

什么是 TeamAI Session Save？

Session Save 解决的是一个很实际的问题：AI 编程会话里的"高价值信号"很容易流失。你纠正 AI 的一次操作、一次工具被拒、一段反复重试——这些"摩擦"恰恰是团队最想沉淀的经验，但原始对话又绝不能整段共享。

它的做法很克制：

• 只收集，不生成：直接复用 dashboard 已有的单次会话事件流（工具调用序列、prompt 轮次、干预记录），折叠成一份紧凑摘要，不调用 LLM，也不新增采集路径
• 只留计数与工具名：上传团队的内容默认只有数字 + 工具名，prompt 原文永远留在本机
• 脱敏后才落盘：任何进入档案的文本都会先经过内置脱敏器

核心实现在 src/save-session.ts，摘要折叠与月度日志逻辑在 src/session-collector.ts。

一键存档：本地日志始终安全落盘

最常用的方式只需一条命令，它会自动识别最近一次活跃会话，把摘要追加到本月的本地日志：

teamai session save

本地行为有三个贴心设计：

也可以指定某个具体会话，或用--dry-run先预览而不写入：

teamai session save --session-id <id> teamai session save --dry-run

脱敏机制：两层密钥保护是怎么工作的

这是 Session Save 最值得展开的部分。脱敏器位于 src/utils/redact.ts，采用"两层防御"策略，按顺序执行：

第一层：环境变量值精确掩码

扫描当前环境中名字带有TOKEN、SECRET、KEY、PASSWORD、CREDENTIAL等特征的变量（值长度 ≥ 8），如果某段文本里出现了这些真实值，就整体替换为占位符——对"已在环境里的密钥"做到 100% 精确命中。

第二层：常见密钥"形状"正则兜底

有些密钥从未经过环境变量，只是被粘贴进了对话。此时靠内置正则目录拦截，覆盖了 SECRET_PATTERNS 定义 中的十余类形态：

• 各模型厂商 Token（sk-ant-…、sk-…、gsk_…、xai-…等前缀）
• PEM 私钥块、JWT、Authorization: Bearer头
• AWS 密钥、Slack Token、Google API Key、Stripe 密钥
• key=value形式的凭据、数据库连接串里的密码
• 甚至 Git URL 中内嵌的用户名密码（https://user:pass@…→https://***@…）

命中后统一替换为可读的占位符，例如ghp_…→<REDACTED:gh_pat>，你一眼就能看出"这里曾被保护过"。

⚠️ 官方态度很诚实：脱敏是纵深防御而非绝对保证。所以涉及 prompt 文本的共享功能全部设计为"显式开启"（见下文），默认值永远偏向更安全的一侧。

隐私边界：本地与团队各存什么？

理解下面这张对照表，就理解了 Session Save 的隐私哲学——"counts only, no prompt text"（只有计数，没有 prompt 文本）：

"有价值"会话的判定规则在 isValuable 函数：出现过用户干预（中断 / 拒绝工具 / 纠正重问），或动用了 3 种以上不同工具。纯闲聊和琐碎会话默认只留本地，不占用团队档案。

推送成功后，该会话会出现在 teamai digest 的Session Highlights板块，成为团队周报里"谁在什么项目上踩了什么坑"的素材。对于只读（HTTP 模式）的团队，--push会优雅失败并保留本地日志，不会报错中断。

常用参数速查

完整说明可查阅中文使用指南中的Session Save 章节。

最佳实践小结

1. 养成收尾习惯：一次有波折的会话结束后随手执行teamai session save，90 天内的记录自动归档、过期自动清理，零维护成本
2. 先本地，再团队：默认只用本地日志；确认会话确实有团队价值后再加--push，隐私风险最小化
3. 谨慎使用--include-prompt：脱敏是尽力而为的，涉及客户数据或机密业务的对话，不建议开启 prompt 行共享
4. 配合 digest 复盘：月底跑一次teamai digest，从 Session Highlights 里回顾团队 AI 协作中的共性摩擦点

Session Save 用"少即是多"的设计证明了一件事：让会话档案真正能被团队共享，靠的不是更大的权限，而是更严的脱敏边界。

【免费下载链接】teamai-cliMake Every Team AI Native项目地址: https://gitcode.com/GitHub_Trending/te/teamai-cli