配置项

全部有默认值，只挂载就够用。

字段	默认	说明
`upstream`	`https://api.cline.bot`	真网关 origin
`pin`	`['deepseek']`	所有请求限制到的上游渠道
`pins`	`{}`	按模型覆盖，如 `{ 'cline-pass/deepseek-v4.1-flash': ['deepseek'] }`
`provider`	`cline-pass`	provider 路由 id（= profile 的 key）
`model`	`cline-pass/deepseek-v4.1-flash`	模型 id，原样作为线上 `model` 字段（网关要求 `type/model`）
`displayName`	`Cline Pass`	选择器里的名字
`contextWindow` / `maxTokens`	`921600` / `131072`	模型容量，登记 profile 时使用
`apiKeyEnv`	`CLINE_PASS_API_KEY`	profile 里记录的凭据引用
`provision`	`true`	启动时自动登记 provider profile（缺失则创建；自家卡片地址过期则只修地址）
`alignReasoningEffort`	`true`	若 `agent-default-model.reasoningEffort` 不是本模型声明的档位（只剩 `high` / `max` 两个），启动时对齐：废弃的 `xhigh` → `max`，其它不认识的值 → `high`
`plainModelId`	`true`	提示词（persona 两段）里显示去掉本路由前缀的 id：`cline-pass/deepseek-v4.1-flash` → `deepseek-v4.1-flash`。线上 id、会话记录、选择器都不受影响；`false` 则原样显示完整 id
`usage`	`true`	在「设置 → 模型 → Cline Pass」卡片上显示用量条（5 小时 / 每周 / 每月，剩余量）。`false` 时宿主不注册路由、不读凭据，并显式广播 `enabled: false` 让浏览器半边不渲染这张卡片（浏览器半边是从 `package.json` 发现的，配置管不到它加载与否，所以必须显式告知）
`usageRoute`	`/api/clinepass.usage`	用量数据这条 exact 路由的路径。宿主会把它一并告诉浏览器半边，两边不会走散
`usageTimeoutMs`	`15000`	问网关的超时；超时按「网关没应答」显示，不会挂住设置页
`usageCacheMs`	`60000`	一次成功读取的缓存时长。设置页每次重渲染都会读它，缓存是为了不把重渲染变成一串网关请求；`0` = 每次都真问
`statusFile`	`true`	把钉选状态写到 `/dsh-clinepass-status.json`（见下）；也可给自定义路径，或 `false` 关掉

pin: [] = 不注入任何字段（纯透传）。pins 优先于 pin；把某个模型配成 pins: { '': [] } 等于单独关掉那条路由的钉选，启动时会警告。

plainModelId 只改提示词模板（deployment:persona-prefix / -suffix 两段里的 {{model}}），且仅当会话确实跑在本路由、且 id 以本路由自己的 / 开头时才改；官方路由的裸 id、别的 provider、本路由上的裸 id、以及 interpolate: false 的字面量段落一律不动。刻意不去改 catalog id（已存会话的 model/selection / request/header 里记的还是带前缀的 id，改名会让它们一直报 UNKNOWN_MODEL），也不去改 prompt variable（会话层的 installModelSelection 会在内层 listener 返回后覆盖 variables.model，而且 session-reference 会快照那些变量算引用预算）。

已删除（0.5.0）：transport、listen、captureDir，以及旧版的 address / baseURL。旧配置里留着不会报错，启动日志会各指出一次。

dsh-clinepass

같은 패키지 이름의 다른 저장소

설치

문서

配置项