dsh-clinepass

配置项

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

字段	默认	说明
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。旧配置里留着不会报错，启动日志会各指出一次。