Confidant

核心用法

Confidant 是专为 AI Agent 设计的敏感信息传递工具，解决"如何安全获取用户 API 密钥、密码而不暴露于聊天历史"的核心痛点。核心工作流为：Agent 调用 request-secret.sh 脚本 → 生成一次性安全网页链接 → 用户浏览器提交 → 本地接收并可选自动保存。

关键特性：

• 零聊天暴露：全程通过浏览器表单交互，密钥永不经过对话窗口
• 智能隧道：自动检测或启动 localtunnel/ngrok，支持远程用户场景
• 灵活存储：支持 --service 约定路径、--save 自定义路径、--env 环境变量注入
• 即开即用：单条命令完成服务端启动、请求创建、隧道检测全流程

显著优点

1. 安全设计到位：密钥文件自动设置 chmod 600 权限，服务端接收后立即销毁，24小时过期机制
2. 无账号依赖：默认 localtunnel 无需注册，降低使用门槛
3. Agent 友好：脚本封装完备，避免直接调用 API 的误操作风险
4. 开发体验佳：JSON 输出模式支持自动化流水线集成

潜在局限

• 网络依赖：localtunnel 公共 URL 存在被拦截的理论风险（虽 ID 随机且 24h 过期）
• 单点服务：默认固定 3000 端口，多 Agent 并发需自行协调
• 无持久化：密钥不存储于服务端，意外中断需重新请求
• 平台限制：依赖 Node.js/npm 环境，纯容器场景需预装

适合人群

• 本地/远程 CLI Agent 开发者需获取用户敏感凭证
• 自动化工作流需安全注入环境变量（CI/CD 场景）
• 注重聊天历史隐私合规的企业用户

常规风险

• 中间人攻击：localtunnel 公共子域理论上可被运营商或 DNS 层嗅探，建议高敏感场景优先使用自托管 ngrok 或 VPN 内网方案
• 浏览器环境风险：用户侧可能存在恶意插件录屏，属不可控端点风险
• 进程残留：异常退出可能导致 Node 进程残留，建议定期 check-server.sh 清理

核心用法

Confidant 是一个专为 AI Agent 设计的安全凭证交接工具，解决"如何在不暴露于聊天记录的前提下获取用户敏感信息"的核心痛点。通过本地启动 Web 服务生成安全表单，用户通过浏览器提交 secrets，Agent 接收后自动保存至指定路径或环境变量。

典型工作流：
1. Agent 执行 request-secret.sh 脚本，指定标签（如"OpenAI API Key"）和服务名
2. 脚本自动启动本地服务器（默认 3000 端口），生成唯一 URL
3. 若用户远程，添加 --tunnel 自动启动 localtunnel 生成公网地址
4. Agent 将 URL 分享给用户，用户浏览器提交后 secret 被接收
5. 文件以 chmod 600 保存至 ~/.config/<service>/api_key，服务器销毁数据

显著优点：

• 设计目标明确：从根本上杜绝"请把 API key 发给我"的不安全交互模式
• 用户体验流畅：用户无需安装任何软件，普通浏览器即可完成提交
• 自动化程度高：服务器复用、隧道检测、环境变量设置一键完成
• 远程友好：localtunnel 无需账户即可使用，降低远程协作门槛

潜在缺点与局限性：

• 供应链风险：核心依赖 @aiconnect/confidant 和 localtunnel 通过 npx 动态下载，无版本锁定，存在包劫持风险
• 网络暴露面：使用隧道服务将本地服务暴露至公网，虽有临时 URL 机制，但理论上可被扫描拦截
• T3 来源可信度：个人开发者/社区项目，非知名机构背书，动态代码加载模式对来源可信度要求更高
• 权限验证盲区：文档声称 chmod 600 但未在脚本中显式验证执行结果

适合人群：

• 需要频繁获取 API keys、tokens、密码等敏感凭证的 AI Agent 开发者
• 远程协作场景下需安全交接 credentials 的技术团队
• 重视聊天记录隐私合规、需避免敏感信息持久化存储的场景

常规风险：

• 依赖包的供应链攻击（npm 账户被盗、恶意版本发布）
• 隧道 URL 被第三方意外访问或扫描发现
• 多实例并发时的进程管理竞争条件
• 目标目录权限配置不当导致 secrets 文件可被其他用户读取