Skip to content

Latest commit

 

History

History
55 lines (34 loc) · 3.95 KB

fake.md

File metadata and controls

55 lines (34 loc) · 3.95 KB

客户端特征仿真

letcode 提供可选的客户端特征仿真机制(Fake / Request Disguise)。该能力主要面向特定编码服务商的兼容性要求,负责规范化封装网络传输元数据与宿主环境报告块。

用户可在 letcode.toml 中配置仿真参数,也可以在会话运行期间使用 /fake 命令开启或关闭仿真。

仿真边界与设计原则

仿真机制严格约束在网络传输的外围契约中:

  • 仅修饰请求传输元数据(如请求头、客户端标识、会话安装 ID);
  • 仅提供服务商协议约定的环境报告块(如终端环境、Git 状态与工作区路径)与客户端自述块;
  • Agent 自身系统提示词保持原样,置于客户端自述块之后;
  • 不篡改 Agent 的核心系统提示词;
  • 不篡改工具目录的真实定义与安全参数。

传输剖面

系统支持两种面向主流协议的传输剖面,各自模仿一个真实的编码客户端。

  1. Codex 剖面:面向基于 Responses 协议的服务商,构造匹配的客户端版本标头与回合扩展元数据;
  2. Claude Code 剖面:面向 Anthropic Messages 协议,构造匹配的 Claude Code 客户端标头与 /messages?beta=true 端点形态,在系统块首位报告客户端归属行 x-anthropic-billing-header 与客户端声明行 You are a Claude agent, built on Anthropic's Claude Agent SDK.,并在请求体的 metadata.user_id 中报告当前会话。

两个剖面模仿的客户端不同,可配置项各成一段。Codex 剖面读取 [fake.codex],Claude Code 剖面读取 [fake.claude]。auto 模式下,系统按当前激活的服务商协议选择剖面。

宿主环境探测机制

仿真数据并非全部虚构。对于能够在本地确认的信息,系统直接读取主机的真实状态:

  • 操作系统与架构:直接采集当前运行环境的系统类型(如 Mac OS / Linux)与 CPU 架构(如 aarch64 / x86_64);
  • 终端与 Shell:检测当前活动的终端程序与用户登录 Shell(如 zsh 或 bash);
  • 工作区与版本库:读取当前工作区的绝对路径,并自动探测当前 Git 提交哈希(git rev-parse HEAD)与工作区变更状态;
  • 时区与日期:默认依据本机系统时钟与 IANA 本地时区换算。

部分服务商的网关只接受携带客户端自述块(归属行与 Agent 声明行)且附带 metadata.user_id 的请求,缺少任一项时以 Service Unavailable 类响应退回;主轮次与 helper 请求在仿真开启时都发送这两项。

无法从本机确认的属性取自被模仿客户端的典型值,如客户端版本、依赖包版本和能力标记。这些值描述同一个已发布客户端:标头的 claude-cli/<version>、归属行的 cc_version=<version>.<build>、x-stainless-package-version、x-stainless-runtime-version 与 anthropic-beta 列表随被模仿客户端发版整体变化,需要同步更新。针对特定服务商专有的沙箱标记(如 sandbox_mode 与 node_repl_disabled),系统填充规范的默认值。用户也可以在配置文件的 [fake.codex.extra] 中添加自定义键值对,最多允许配置 16 项。

运行与动态切换

客户端特征仿真默认处于关闭状态。

启用仿真有两种方式:

  1. 配置文件声明:在 letcode.toml 中配置 [fake.codex]、[fake.claude] 等字段;
  2. 会话动态切换:在 TUI 交互界面中输入 /fake 命令,即可在当前会话中即时切换开启或关闭状态。

未启用仿真时,网络请求使用标准协议格式,不添加额外的客户端元数据。

源码索引

  • src/fake.rs:实现客户端特征仿真模型、宿主环境检测与请求元数据添加。
  • src/agent/protocol_stream.rs:在普通回合请求准备流程中连接装饰器。
  • src/tui/slash.rs:处理 /fake 斜杠命令的即时切换逻辑。
  • src/config.rs:解析配置文件中的 [fake] 相关结构体。