Doramagic.ai
English

Doramagic 项目包 · 项目说明书

cline 项目

作为 SDK、IDE 扩展或 CLI 助手运行的自主编码代理。

项目概览

Cline 是一个自主编码代理（autonomous coding agent）项目，旨在通过 AI 能力协助开发者完成文件创建与编辑、命令执行、浏览器操作等任务。项目以 Apache 2.0 协议开源，提供 CLI、VS Code 扩展、JetBrains 插件和 SDK 四种主要交付形态，共享同一套核心引擎。资料来源：[README.md:1-50]()

章节 相关页面

继续阅读本节完整说明和来源证据。

产品矩阵

项目采用"一个核心引擎、多端复用"的产品布局。CLI（@cline/cli）提供终端交互界面、无头模式与 shell 集成，资料来源：apps/cli/package.json:2-10；VS Code 扩展与 JetBrains 插件覆盖主流 IDE 场景；SDK（@cline/sdk）面向开发者，允许基于同一引擎构建自定义代理与集成，资料来源：README.md:30-45。此外，仓库还包含多个参考示例应用，如 code-review-bot 和 multi-agent，用于演示 SDK 在真实业务中的用法。

核心架构

SDK 的运行时由四个核心包组成，呈现清晰的分层依赖关系。@cline/shared 提供跨包共享的基础原语；@cline/llms 负责模型目录与 Provider 设置的模式定义，并构建具体的处理器实现；@cline/agents 在处理器之上运行无状态代理循环（工具、钩子、扩展、团队、流式输出）；@cline/core 组合运行时行为，管理会话生命周期与持久化存储，并提供本地与 Hub 两种运行时服务模式。资料来源：sdk/packages/README.md:5-20

模型目录（Model Catalog）是 SDK 的关键基础设施，其数据主要来自 models.dev 并通过 catalog-live.ts 归一化后写入 catalog.generated.ts。目录字段如 contextWindow、maxInputTokens、maxTokens 反映的是 Provider 报告的元数据，而非请求策略的强保证，资料来源：sdk/packages/llms/src/catalog/README.md:1-30。

graph TD
    A["@cline/core<br/>有状态运行时编排"] --> B["@cline/agents<br/>无状态代理循环"]
    B --> C["@cline/llms<br/>模型目录 + Provider 处理器"]
    B --> D["@cline/shared<br/>共享原语"]
    A --> D
    C --> D
    E["CLI 应用"] --> A
    F["VS Code 扩展"] --> A
    G["JetBrains 插件"] --> A
    H["第三方应用 / SDK 用户"] --> A

主要能力

  • 自定义工具与 MCP 集成：开发者可使用 createTool() 定义工具并注册到 Agent，也可接入 Model Context Protocol（MCP）服务器以连接数据库、API、云基础设施等外部系统，资料来源：sdk/README.md:1-30`。
  • 多代理团队（Multi-Agent Teams）：协调器代理可将复杂任务拆解为子任务，委派给具备独立工具与上下文的专家代理，团队状态在会话间持久化，资料来源：README.md:50-60。agents-squad 示例插件提供了完整的子代理编排实现，支持预设代理（Anvil、Inquisitor、Oracle、Phantom）与技能（skills）发现机制，资料来源：sdk/examples/plugins/agents-squad/README.md:1-30。
  • 定时任务（Scheduled Agents）：支持通过 Cron 表达式调度周期性自动化（如每日 PR 摘要、每周依赖检查），调度在重启后仍然有效，资料来源：README.md:60-70。.cron.md 文件格式支持工作区根路径、工具白名单、模式（act/plan）与超时配置，资料来源：sdk/examples/cron/README.md:1-40。
  • 事件驱动自动化：除时间调度外，也支持基于事件（如 github.pull_request.opened）触发的自动化流程，可配置防抖、去重窗口与最大并发数，资料来源：sdk/examples/cron/README.md:40-60`。
  • 消息平台连接：支持与 Telegram、Slack、Discord、Google Chat、WhatsApp、Linear 等平台对接，每个会话线程映射到一个具备完整上下文的代理会话，资料来源：README.md:70-80。
  • 插件系统：CLI 自动发现工作区 ~/.cline/plugins、系统插件目录下的插件，也可通过 cline plugin install 命令从本地文件、GitHub URL、npm 包或 git 仓库安装，资料来源：sdk/examples/plugins/README.md:1-30`。

社区与版本现状

项目当前最新 CLI 发布版本为 v3.0.20，该版本将已安装的插件包装器从"不透明哈希"改为"来源命名"（npm 包名、git 仓库、远程文件名、官方 slug 或本地目录），使插件更易于识别，资料来源：README.md:85-95。在社区反馈层面，常见议题包括：

  • 任务挂起与卡顿：多个版本（如 3.82.0、3.83.0、3.84.0）报告 Cline 在执行终端命令后无限期停留在 "Thinking..." 状态，问题多与交互式 CLI 命令（如 git diff 启动分页器）有关，资料来源：README.md:90-95`。
  • 身份认证兼容性：AWS Bedrock（credential_process）、Azure AI Foundry、内部 CA 证书等场景在 CLI 中存在已知问题，资料来源：README.md:95-100`。
  • Provider 兼容：GLM 等模型在 OpenAI 兼容端点上因 reasoning: {exclude: true} 字段注入而失败；Ollama 在非工具调用模型上可能出现无限 JSON 循环，资料来源：README.md:100-110`。
  • IDE 扩展：JetBrains 插件在 PowerShell 环境下执行命令时存在 shell 解析问题；VS Code 扩展在多目录工作区中文件选择受限，资料来源：README.md:110-120`。

另请参阅

  • SDK 架构与包职责
  • 模型目录语义
  • SDK 示例索引
  • 插件开发指南
  • 定时与事件自动化

来源：https://github.com/cline/cline / 项目说明书

Lib 模块

Cline 项目的 "Lib 模块" 指的是一组以 npm 包形式发布的可复用库代码,集中位于 sdk/packages/ 目录下。这些库为上层应用(CLI、桌面端、VS Code 扩展、JetBrains 插件以及示例应用)提供模型能力、Agent 运行时、共享原语和状态编排等核心能力,所有库都遵循 @cline/ 命名空间约定。

章节 相关页面

继续阅读本节完整说明和来源证据。

概述

Cline 项目的 "Lib 模块" 指的是一组以 npm 包形式发布的可复用库代码,集中位于 sdk/packages/ 目录下。这些库为上层应用(CLI、桌面端、VS Code 扩展、JetBrains 插件以及示例应用)提供模型能力、Agent 运行时、共享原语和状态编排等核心能力,所有库都遵循 @cline/* 命名空间约定。

按照 sdk/packages/README.md 的描述,库模块按职责被划分为四个包,形成清晰的依赖分层:

包名主要职责典型消费方内部依赖
@cline/shared跨包共享原语(路径解析、会话通用类型、索引辅助)@cline/agents、@cline/core、apps无
@cline/llms模型目录、Provider 设置 schema、Handler 创建 SDK@cline/agents、@cline/core、apps无
@cline/agents无状态 Agent 运行时(工具、Hooks、扩展、Teams、流式输出)@cline/core、apps@cline/llms、@cline/shared
@cline/core有状态运行时编排(运行时组合、会话生命周期/存储、Local 与 Hub 后端服务)CLI / Desktop apps@cline/agents、@cline/llms、@cline/shared

资料来源:sdk/packages/README.md:1-15

运行时依赖与分层

四个库之间存在严格的单向依赖,避免循环引用并保证可单独测试:

graph TD
    A[apps/cli & apps/examples & VS Code/JetBrains] --> B[@cline/core]
    B --> C[@cline/agents]
    C --> D[@cline/llms]
    C --> E[@cline/shared]
    B --> D
    B --> E
    D --> F[(models.dev catalog)]
    E --> G[path / session / index helpers]
    B --> H[(Local / Hub runtime services)]
  • @cline/shared 与 @cline/llms 不依赖其他 Cline 库,可以被任意层直接使用。
  • @cline/agents 在 @cline/llms 提供的 Handler 之上执行 Agent 主循环。
  • @cline/core 进一步组合持久化会话、Hub 调度以及计划任务等能力。
  • 顶层应用(例如 apps/cli 中声明 "name": "@cline/cli")通过 import 引入这些库,而不是复制实现。

资料来源:sdk/packages/README.md:5-20,sdk/packages/core/package.json:1-12

模型目录库(@cline/llms)

@cline/llms 的核心是 src/catalog 子模块,负责将上游 models.dev 的 provider/model 元数据归一化为 SDK 内部使用的 ModelInfo。生成链路在 sdk/packages/llms/src/catalog/README.md 中有明确说明:

  • catalog-live.ts 读取并归一化来自 models.dev 的实时数据。
  • catalog-live.test.ts 记录 limit 字段到 ModelInfo 的映射行为。
  • catalog.generated.ts 是可检入的、由 scripts/generate-models.ts 生成的最终目录。
  • 配套脚本命令:bun -F @cline/llms generate:models。

ModelInfo 暴露的字段含义如下,这是目录层与运行时请求策略的边界:

字段含义与上游 limit 的关系
contextWindowProvider 报告的上下文总预算来自 limit.context
maxInputTokens提示/输入 Token 上限,供压缩与诊断使用优先 limit.input,缺失时回退到 limit.context
maxTokens单次输出 Token 上限来自 limit.output

资料来源:sdk/packages/llms/src/catalog/README.md:3-45

需要特别注意的是,这些字段并非"可加和"保证,例如 contextWindow: 200000、maxInputTokens: 200000、maxTokens: 128000 是合法配置,代表提示可接近 200k、生成可至 128k,但具体请求仍须满足 Provider 的"prompt + output"规则。

扩展与插件库接口

@cline/agents 通过 AgentExtension 暴露工具、命令、规则、技能、Provider 等能力注册点,这部分在 sdk/examples/plugins/README.md 的 "Capabilities" 表格中列出:

Capability作用
toolsapi.registerTool()
commandsapi.registerCommand()
rulesapi.registerRule()
skills从插件包中发现 skill
providersapi.registerProvider()
messageBuildersapi.registerMessageBuilder()
automationEventsapi.registerAutomationEventType() 与 ctx.automation?.ingestEvent()
hooks运行时生命周期回调

插件安装方式(本地文件、GitHub 文件 URL、包目录、git 仓库、npm 包)在 sdk/examples/README.md 中给出,例如 cline plugin install https://github.com/cline/cline/blob/6138bdfe400767405d438b2c4a3f376006b99677/sdk/examples/plugins/weather-metrics.ts。这些能力都基于库层 API,而不是 CLI 私有逻辑。

资料来源:sdk/examples/plugins/README.md:30-65,sdk/examples/README.md:10-30

版本与工程配置

根 package.json 声明使用 Bun 与 Node 22+ 工具链,并统一管理 TypeScript、husky、lint-staged、vitest 等开发依赖。库层 sdk/packages/core/package.json 同样要求 "node": ">=22",并使用 zod 与 yaml 进行 schema 与配置解析,这与 @cline/llms 中的 Provider 设置 schema 形成一致的数据建模风格。

CLI 入口由 apps/cli/package.json 描述:"bin": { "cline": "src/index.ts" }、版本 3.0.20,发布的制品为 dist/index.js,意味着 CLI 本质上是库层之上的薄封装。

资料来源:package.json:1-20,sdk/packages/core/package.json:30-40,apps/cli/package.json:1-30

常见误用与边界

根据社区反馈(例如请求在"Thinking..."阶段挂起、Provider 鉴权失败、reasoning: {exclude: true} 被注入到不识别该字段的端点等),库层引入了一些保守策略:

  • 目录数据保留上游 limit 原始语义,运行时再按"保守且可观测"原则裁剪请求参数。
  • maxOutputTokens 由 providers/ai-sdk.ts 显式传入,由 providers/gateway.ts 解析每请求/默认值,以避免超出 Provider 输出预算。
  • 路由型 Provider 与上游模型的实际限制可能不一致,应优先使用目录原始值,并在运行时观察实际行为。

资料来源:sdk/packages/llms/src/catalog/README.md:50-70

See Also

  • sdk/packages/README.md — 库职责与交互总览
  • sdk/packages/ARCHITECTURE.md — 运行时流程与跨包交互
  • sdk/CHANGELOG.md — SDK 发布历史
  • apps/cli/CHANGELOG.md — CLI 发布历史

资料来源:sdk/packages/README.md:1-15

Src 模块

Src 模块是 Cline CLI（@cline/cli）的源代码根目录，承载 CLI 二进制的入口与所有 TypeScript 源码。其包定义位于 apps/cli/package.json，将 src/index.ts 声明为可执行入口（"bin": { "cline": "src/index.ts" }），构建产物最终输出到 dist/index.js（"main":...

章节 相关页面

继续阅读本节完整说明和来源证据。

模块定位与职责

Src 模块是 Cline CLI（@cline/cli）的源代码根目录，承载 CLI 二进制的入口与所有 TypeScript 源码。其包定义位于 apps/cli/package.json，将 src/index.ts 声明为可执行入口（"bin": { "cline": "src/index.ts" }），构建产物最终输出到 dist/index.js（"main": "dist/index.js"） 资料来源：apps/cli/package.json:30-44。

从仓库根级的 package.json 可以看到，CLI 使用 Bun 作为包管理与构建工具，要求 Node.js ≥ 22，并启用 ESM（"type": "module"） 资料来源：package.json:1-12。Src 模块正是这套工具链下的实际源码承载目录。

在产品矩阵中，Src 模块属于终端用户接触面：仓库根 README.md 把它与 VS Code 扩展、JetBrains 插件、SDK 并列为 Cline 的核心产品形态之一 资料来源：README.md。

入口与构建

src/index.ts 是 CLI 命令的总入口。在 apps/cli/package.json 中同时存在 build、build:platform 等脚本，由根 package.json 中安装的 [email protected] 驱动 资料来源：apps/cli/package.json:50-60、资料来源：package.json:18-24。

apps/cli/src/index.ts  ──(bun run build)──►  apps/cli/dist/index.js
                                                │
                                                └─ 作为 `cline` 可执行命令被调用

构建过程将 TypeScript 源码（src/）编译为发布到 npm 的 JavaScript 产物（dist/），并在 files 字段中显式声明仅发布 dist 目录 资料来源：apps/cli/package.json:63-68。

与 SDK 包的协同

虽然 apps/cli/src/ 是 CLI 自身的代码，但其运行时能力来自 sdk/packages/ 中的四个核心包：

包主要职责
@cline/shared跨包共享原语（路径解析、会话公共类型、索引辅助）
@cline/llms模型目录、Provider 设置 schema、Handler 创建 SDK
@cline/agents无状态 Agent 运行时循环（工具、钩子、扩展、团队、流式）
@cline/core有状态运行时编排（运行时组合、会话生命周期/存储、本地与 Hub 服务）

Src 模块的 CLI 逻辑通常以 @cline/core 提供的 ClineCore.create() 等 API 为主入口 资料来源：sdk/packages/README.md:1-25、资料来源：apps/examples/README.md:21-30。

在 @cline/llms 内部，还有一个文档化的 src/catalog/ 子模块，负责把 models.dev 的原始 limit 字段归一化为 SDK 内部使用的 ModelInfo（包含 contextWindow、maxInputTokens、maxTokens） 资料来源：sdk/packages/llms/src/catalog/README.md:1-50。

常见运行场景

基于 Src 模块之上的 CLI，官方与示例应用展示了若干典型用例：

  • 交互式终端聊天：apps/examples/cli-agent 演示多轮 run()/continue() 与 createTool 用法 资料来源：apps/examples/README.md:17-21。
  • 核心驱动的 CLI 代理：cline-core-cli-agent 示例直接使用 ClineCore.create() 与 cline.start()/cline.send() 资料来源：apps/examples/README.md:21-23。
  • 多 Agent 协同：multi-agent 示例通过 Promise.all 并行启动四个 Agent 实例，再由合成 Agent 汇总决策 资料来源：apps/examples/multi-agent/README.md:1-20。
  • GitHub PR Code Review：code-review-bot 示例通过 SDK 提供的 get_file_context、add_review_finding 等自定义工具，对真实 PR 进行审查 资料来源：apps/examples/code-review-bot/README.md:1-20。

社区关注与已知风险

从社区反馈看，围绕 CLI 的 Src 模块与运行时，常见痛点集中在以下几类（最新一次发版为 CLI v3.0.20）：

  • 挂起与“Thinking…”无响应：多个版本（v3.82.0、v3.83.0、v3.84.0）报告在执行终端命令后或面对交互式分页器（如 git diff）时无限挂起，例如 #10537、#10853、#10931。
  • 企业代理与证书：NODE_EXTRA_CA_CERTS 在某些内部 CA 场景下仍报 unable to get local issuer certificate（#11175）。
  • Provider 鉴权：AWS credential_process 在 Bedrock 鉴权流程中失败（#10930）；Azure AI Foundry 在 CLI 3.0.15 上出现“resources not found”（#11237）。
  • OpenAI 兼容端点兼容性：为 GLM 模型注入的 reasoning: { exclude: true } 字段会被不识别该字段的端点拒绝（#11086）。
  • 本地 CLI 任务调用失败：与本地服务（如 Kanban 在 127.0.0.1:3484）通信时报 fetch failed（#10133）。
  • JetBrains 上的 PowerShell 行为：在 PowerShell 中执行 /d /s /c claude 时被解释为命令而非参数（#11290）。

这些问题大多位于 CLI 运行时、Provider 适配与终端执行层，而 Src 模块的入口、构建产物（dist/index.js）以及通过 @cline/core 注入的运行时服务是其主要的可调试边界。

See Also

  • sdk/packages/README.md — SDK 包职责总览
  • apps/cli/package.json — CLI 包元数据与脚本
  • sdk/packages/llms/src/catalog/README.md — 模型目录语义
  • apps/examples/README.md — 可运行示例索引
  • README.md — 产品矩阵与总览

来源：https://github.com/cline/cline / 项目说明书

失败模式与踩坑日记

保留 Doramagic 在发现、验证和编译中沉淀的项目专属风险，不把社区讨论只当作装饰信息。

high 来源证据："reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize t…

可能增加新用户试用和生产接入成本。

high 来源证据：Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1

可能增加新用户试用和生产接入成本。

high 来源证据：Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands

可能增加新用户试用和生产接入成本。

high 来源证据：Error: unable to get local issuer certificate with Internal CA

可能增加新用户试用和生产接入成本。

Pitfall Log / 踩坑日志

项目：cline/cline

摘要：发现 38 个潜在踩坑项，其中 17 个为 high/blocking；最高优先级：安装坑 - 来源证据："reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize t…。

1. 安装坑 · 来源证据："reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize t…

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题："reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize the field
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11086 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

2. 安装坑 · 来源证据：Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11296 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

3. 配置坑 · 来源证据：Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/10537 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

4. 配置坑 · 来源证据：Error: unable to get local issuer certificate with Internal CA

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Error: unable to get local issuer certificate with Internal CA
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11175 | 来源讨论提到 node 相关条件，需在安装/试用前复核。

5. 配置坑 · 来源证据：Task command failed at http://127.0.0.1:3484: fetch failed

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个配置相关的待验证问题：Task command failed at http://127.0.0.1:3484: fetch failed
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/10133 | 来源讨论提到 python 相关条件，需在安装/试用前复核。

6. 维护坑 · 来源证据：API error CODEX

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：API error CODEX
  • 对用户的影响：可能影响升级、迁移或版本选择。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11221 | 来源类型 github_issue 暴露的待验证使用条件。

7. 维护坑 · 来源证据：Cline ask question but dont have any answer

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Cline ask question but dont have any answer
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11302 | 来源类型 github_issue 暴露的待验证使用条件。

8. 维护坑 · 来源证据：Cline hangs indefinitely

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Cline hangs indefinitely
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/10853 | 来源类型 github_issue 暴露的待验证使用条件。

9. 维护坑 · 来源证据：Cline hangs indefinitely when interactive CLI commands (like default "git diff")

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Cline hangs indefinitely when interactive CLI commands (like default "git diff")
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/10931 | 来源类型 github_issue 暴露的待验证使用条件。

10. 维护坑 · 来源证据：Cline is executing `/d /s /c claude` in PowerShell without `cmd.exe`

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：Cline is executing /d /s /c claude in PowerShell without cmd.exe
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11290 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。

11. 维护坑 · 来源证据：cannot see Cline icon in Activity bar,

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个维护/版本相关的待验证问题：cannot see Cline icon in Activity bar,
  • 对用户的影响：可能增加新用户试用和生产接入成本。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11292 | 来源类型 github_issue 暴露的待验证使用条件。

12. 安全/权限坑 · 失败模式：security_permissions: CLI Bedrock profile auth fails with AWS credential_process

  • 严重度：high
  • 证据强度：source_linked
  • 发现：Developers should check this security_permissions risk before relying on the project: CLI Bedrock profile auth fails with AWS credential_process
  • 对用户的影响：Developers may expose sensitive permissions or credentials: CLI Bedrock profile auth fails with AWS credential_process
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/10930 | CLI Bedrock profile auth fails with AWS credential_process, failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/10930 | CLI Bedrock profile auth fails with AWS credential_process

13. 安全/权限坑 · 来源证据：Add API Key field to LM Studio provider for authenticated servers

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Add API Key field to LM Studio provider for authenticated servers
  • 对用户的影响：可能影响授权、密钥配置或安全边界。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/9668 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。

14. 安全/权限坑 · 来源证据：Azure AI Foundry profile authentication broken in CLI 3.0.15

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Azure AI Foundry profile authentication broken in CLI 3.0.15
  • 对用户的影响：可能影响授权、密钥配置或安全边界。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11237 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

15. 安全/权限坑 · 来源证据：CLI Bedrock profile auth fails with AWS credential_process

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：CLI Bedrock profile auth fails with AWS credential_process
  • 对用户的影响：可能影响授权、密钥配置或安全边界。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/10930 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

16. 安全/权限坑 · 来源证据：Deadlock on remote-SSH after terminal commands

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：Deadlock on remote-SSH after terminal commands
  • 对用户的影响：可能阻塞安装或首次运行。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11295 | 来源讨论提到 macos 相关条件，需在安装/试用前复核。

17. 安全/权限坑 · 来源证据：bug(ollama): Infinite JSON tool loop & HTTP 400/500 errors on non-tool/streamed models

  • 严重度：high
  • 证据强度：source_linked
  • 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：bug(ollama): Infinite JSON tool loop & HTTP 400/500 errors on non-tool/streamed models
  • 对用户的影响：可能影响升级、迁移或版本选择。
  • 证据：community_evidence:github | https://github.com/cline/cline/issues/11263 | 来源类型 github_issue 暴露的待验证使用条件。

18. 安装坑 · 失败模式：installation: CLI v3.0.16

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this installation risk before relying on the project: CLI v3.0.16
  • 对用户的影响：Upgrade or migration may change expected behavior: CLI v3.0.16
  • 证据：failure_mode_cluster:github_release | https://github.com/cline/cline/releases/tag/cli-v3.0.16 | CLI v3.0.16

19. 安装坑 · 失败模式：installation: CLI v3.0.19

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this installation risk before relying on the project: CLI v3.0.19
  • 对用户的影响：Upgrade or migration may change expected behavior: CLI v3.0.19
  • 证据：failure_mode_cluster:github_release | https://github.com/cline/cline/releases/tag/cli-v3.0.19 | CLI v3.0.19

20. 安装坑 · 失败模式：installation: CLI v3.0.20

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this installation risk before relying on the project: CLI v3.0.20
  • 对用户的影响：Upgrade or migration may change expected behavior: CLI v3.0.20
  • 证据：failure_mode_cluster:github_release | https://github.com/cline/cline/releases/tag/cli-v3.0.20 | CLI v3.0.20

21. 安装坑 · 失败模式：installation: Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this installation risk before relying on the project: Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1
  • 对用户的影响：Developers may fail before the first successful local run: Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11296 | Claude Code provider fails to connect with Claude Code CLI 2.1.163: command exits with code 1

22. 安装坑 · 失败模式：installation: Cline: "Cline wants to use a tool on the `simple-mcp-server` MCP server" is showing twice in...

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this installation risk before relying on the project: Cline: "Cline wants to use a tool on the simple-mcp-server MCP server" is showing twice in the response.
  • 对用户的影响：Developers may fail before the first successful local run: Cline: "Cline wants to use a tool on the simple-mcp-server MCP server" is showing twice in the response.
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11250 | Cline: "Cline wants to use a tool on the simple-mcp-server MCP server" is showing twice in the response.

23. 配置坑 · 失败模式：configuration: "reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoi...

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: "reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize the field
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: "reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize the field
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11086 | "reasoning: {exclude: true}" injected for GLM models breaks OpenAI-compatible provider endpoints that don't recognize the field

24. 配置坑 · 失败模式：configuration: Add API Key field to LM Studio provider for authenticated servers

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Add API Key field to LM Studio provider for authenticated servers
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Add API Key field to LM Studio provider for authenticated servers
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/9668 | Add API Key field to LM Studio provider for authenticated servers

25. 配置坑 · 失败模式：configuration: Azure AI Foundry profile authentication broken in CLI 3.0.15

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Azure AI Foundry profile authentication broken in CLI 3.0.15
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Azure AI Foundry profile authentication broken in CLI 3.0.15
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11237 | Azure AI Foundry profile authentication broken in CLI 3.0.15, failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11237 | Azure AI Foundry profile authentication broken in CLI 3.0.15

26. 配置坑 · 失败模式：configuration: CLI v3.0.17

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: CLI v3.0.17
  • 对用户的影响：Upgrade or migration may change expected behavior: CLI v3.0.17
  • 证据：failure_mode_cluster:github_release | https://github.com/cline/cline/releases/tag/cli-v3.0.17 | CLI v3.0.17

27. 配置坑 · 失败模式：configuration: Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/10537 | Cline v3.82.0 hangs indefinitely at "Thinking..." after executing terminal commands

28. 配置坑 · 失败模式：configuration: Deadlock on remote-SSH after terminal commands

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: Deadlock on remote-SSH after terminal commands
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: Deadlock on remote-SSH after terminal commands
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11295 | Deadlock on remote-SSH after terminal commands

29. 配置坑 · 失败模式：configuration: bug(ollama): Infinite JSON tool loop & HTTP 400/500 errors on non-tool/streamed models

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this configuration risk before relying on the project: bug(ollama): Infinite JSON tool loop & HTTP 400/500 errors on non-tool/streamed models
  • 对用户的影响：Developers may misconfigure credentials, environment, or host setup: bug(ollama): Infinite JSON tool loop & HTTP 400/500 errors on non-tool/streamed models
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11263 | bug(ollama): Infinite JSON tool loop & HTTP 400/500 errors on non-tool/streamed models

30. 能力坑 · 能力判断依赖假设

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：README/documentation is current enough for a first validation pass.
  • 对用户的影响：假设不成立时，用户拿不到承诺的能力。
  • 证据：capability.assumptions | github_repo:824874689 | https://github.com/cline/cline | README/documentation is current enough for a first validation pass.

31. 运行坑 · 失败模式：runtime: Cline is executing `/d /s /c claude` in PowerShell without `cmd.exe`

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this runtime risk before relying on the project: Cline is executing /d /s /c claude in PowerShell without cmd.exe
  • 对用户的影响：Developers may hit a documented source-backed failure mode: Cline is executing /d /s /c claude in PowerShell without cmd.exe
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11290 | Cline is executing /d /s /c claude in PowerShell without cmd.exe

32. 维护坑 · 失败模式：migration: API error CODEX

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：Developers should check this migration risk before relying on the project: API error CODEX
  • 对用户的影响：Developers may hit a documented source-backed failure mode: API error CODEX
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11221 | API error CODEX

33. 维护坑 · 维护活跃度未知

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：未记录 last_activity_observed。
  • 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
  • 证据：evidence.maintainer_signals | github_repo:824874689 | https://github.com/cline/cline | last_activity_observed missing
  • 严重度：medium
  • 证据强度：source_linked
  • 发现：no_demo
  • 证据：downstream_validation.risk_items | github_repo:824874689 | https://github.com/cline/cline | no_demo; severity=medium

35. 安全/权限坑 · 存在评分风险

  • 严重度：medium
  • 证据强度：source_linked
  • 发现：no_demo
  • 对用户的影响：风险会影响是否适合普通用户安装。
  • 证据：risks.scoring_risks | github_repo:824874689 | https://github.com/cline/cline | no_demo; severity=medium

36. 能力坑 · 失败模式：conceptual: Cline ask question but dont have any answer

  • 严重度：low
  • 证据强度：source_linked
  • 发现：Developers should check this conceptual risk before relying on the project: Cline ask question but dont have any answer
  • 对用户的影响：Developers may hit a documented source-backed failure mode: Cline ask question but dont have any answer
  • 证据：failure_mode_cluster:github_issue | https://github.com/cline/cline/issues/11302 | Cline ask question but dont have any answer

37. 维护坑 · issue/PR 响应质量未知

  • 严重度：low
  • 证据强度：source_linked
  • 发现：issue_or_pr_quality=unknown。
  • 对用户的影响：用户无法判断遇到问题后是否有人维护。
  • 证据：evidence.maintainer_signals | github_repo:824874689 | https://github.com/cline/cline | issue_or_pr_quality=unknown

38. 维护坑 · 发布节奏不明确

  • 严重度：low
  • 证据强度：source_linked
  • 发现：release_recency=unknown。
  • 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
  • 证据：evidence.maintainer_signals | github_repo:824874689 | https://github.com/cline/cline | release_recency=unknown

来源：Doramagic 发现、验证与编译记录