Cline 入门：不同界面背后的编程代理
阅读 Cline 启动源码：两阶段 --config 解析
复现八种参数情况，理解为何配置目录必须在遥测前确定。
阅读 Cline 启动源码：两阶段 --config 解析知识学习CN编辑简报更新 2026-09-23
你将学会
- 定位提前扫描函数
- 离线测试实际执行范围
- 把结论用于排错
开始前需要
- 基本终端与 Git 知识
- 不含秘密的独立样例仓库
解析事件而不执行其中的建议，把代理声明和独立验证结果分开保存。
先看结论
- 提前扫描选择首次匹配值。
- 八项测试只覆盖解析。
- 目录不同可能表现为缺少凭据。
定位提前扫描函数
resolveConfigDirArg 支持 --config 后接值和 --config=value，去除首尾空白并返回首次匹配值。类似 --configure 的名称不会被当成配置参数。
扫描先于 Commander 通用解析，因为依赖配置的服务可能很早初始化。runCli 在激活遥测前调用 setClineDir，认证动作也会防御性地再次应用解析值。
离线测试实际执行范围
测试从固定 main.ts 提取该函数，去除 TypeScript 类型，在独立 JavaScript 上下文中执行。八种情况覆盖缺省、两种拼写、空白、缺值、重复与近似名称。
八项断言全部通过，但没有启动 runCli、写配置、认证、检查目录权限或调用模型。结论只涉及参数解析，不代表存储隔离或账户登录已验证。
把结论用于排错
如果凭据似乎丢失，先比较认证和执行任务时使用的目录。两次合法的 --config 指向不同位置，就可能看到不同设置，不必立刻怀疑供应商故障。
避免重复传入配置参数，路径含空格时检查 shell 引号。删除目录前先确认内容并保存必要设置，直接清空配置不应该是第一步排错动作。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
比较两种有效参数拼写。
- 2
核对认证与任务的目录。
- 3
恢复前保存必要设置。
可复制示例
json
{"argv":["--config=./trial-a","--config=./trial-b"],"earlyResult":"./trial-a","scope":"argument-parser-only"}常见问题
--config 会建立安全沙箱吗？
解析器只返回路径，不提供操作系统访问控制。
重复参数采用哪个值？
所提取的提前扫描函数选择第一次匹配出现的值。
资料来源
- Cline / apps/cli/src/main.ts来源核查 2026-09-23
- Cline / apps/cli/src/main.test.ts来源核查 2026-09-23