dan-ai-studio/dshopencodego ↗★ 1
@dan-ai-studio/dshopencodego
OpenCode Go provider for DeepSeek Harness: live gateway catalog, per-conversation session header, usage
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:dan-ai-studio/dshopencodego说明文档
阅读完整 README ↗配置
配置写在 profile 的 cordis.patch.yml:
- id: dshopencodego
name: '@dan-ai-studio/dshopencodego'
config:
enabled: true # false 仅撤下路由,插件保持挂载
apiKeyEnv: OPENCODE_GO_API_KEY # 默认值
baseURL: https://opencode.ai/inference/go/v1 # 默认值(OpenCode Go 端点)
# 只能是不带 query / fragment 的 http(s) 地址;写 ?x=1 会在保存配置时被拒
# 也可指定为 https://opencode.ai/inference/v1(Console 主端点,含按量/免费模型)
refreshMinutes: 60 # 目录缓存时长,1 ~ 10080(7 天)
streamIdleTimeoutMs: 300000 # 流空闲超时:两次流事件之间的最长静默(毫秒)
keepAliveTimeoutMs: 600000 # 连接空闲保留:两次请求之间连接留多久(毫秒,1 ~ 1800000)
# 每次收到回答后重新计时,所以常用时连接不会被断开;
# 对话中每次停顿较久都要重新握手一次(约 200ms)
imageBudgetPreset: dsh # 图片预算三选一:dsh / dshopencodego / pi-ai(默认 dsh,即宿主自带值)
modelVisibility: # 逐模型开关;未写到的模型走默认规则(见「设置页里的模型列表」)
glm-5: true
modelLimits: # 逐模型容量覆盖
kimi-k3:
contextWindow: 262144
maxTokens: 32768 # 可选:该模型的输出上限
some-legacy-model: null # 整条 null:该模型两个字段都显式回退到目录值
modelProtocols: # 最后兜底:逐模型协议覆盖
some-new-model: openai-responses # 合法值只有 anthropic-messages / openai-completions / openai-responses
pinnedAddresses: # 固定 IP:域名 → 地址(只对网关域名生效)
opencode.ai: 104.18.32.47 # 可写 IPv4 或 IPv6;不合法或未设置时走系统 DNS
requestLogEnabled: false # 请求日志总开关,默认关闭:打开后注册侧边栏入口与会话标签页;关闭后无入口,请求路径与没有该日志逐字节一致
requestLogDebug: false # 排错详情:连接池事件与请求 UA;会话 id 始终完整记录
requestLogMaxEntries: 200 # 最多保留条数,50 ~ 500,超限丢弃最旧的
retryPolicy: # 可选:本路由的重试策略(由 dsh-llm-retry 执行)
mode: normal # 也可用 always(对所有失败重试,maxRetries 被忽略)
maxRetries: 2 # 默认 5
retryableCodes: [RATE_LIMIT, TIMEOUT] # 可选:只对这些错误码重试(默认 RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT / EMPTY_RESPONSE)
backoff:
initialDelayMs: 500 # 默认 500
maxDelayMs: 10000 # 默认 10000,上限 2147483647
jitterRatio: 0.1 # 默认 0.1,取值 0 ~ 1
保存即校验:上面这些约束在写入 profile 时就检查,不会拖到第一次请求——baseURL 必须是 http(s) 且不带 query/fragment;refreshMinutes 取值 1 ~ 10080;keepAliveTimeoutMs 取值 1 ~ 1800000;requestLogMaxEntries 取值 50 ~ 500;modelLimits 的每个字段都可以写 null,语义是"显式选回目录值"(modelLimits.: null 表示两个字段一起回退);modelProtocols 只接受那三个合法值,写错会让该模型以"配置缺失"出现(开关关闭、不可选),而不是回退到猜测;retryPolicy 是联合类型(normal 读 maxRetries/retryableCodes/backoff,always 只读 backoff),未知字段会被拒绝。
API Key 通过 Harness 凭证库提供(引用名 OPENCODE_GO_API_KEY),也可以直接 export OPENCODE_GO_API_KEY=...。
流超时:streamIdleTimeoutMs 约束的是两次流事件之间的最长静默,不是请求总时长——长思考模型只要持续产出事件就不会被误判。默认 5 分钟,上限为 2147483647(约 24.8 天)。超时抛出 TIMEOUT(可重试类)。
连接保留:keepAliveTimeoutMs 决定与网关的连接在两次请求之间保留多久。计时器每次收到回答后重新开始,所以常用时连接不会被断开,它约束的只是两次请求之间的静默。默认 10 分钟。
- 背后的原因很实际:连接一旦被断开,下一次请求要重新做一次 TCP 与 TLS 握手,到网关这一侧约 200 毫秒,而这笔开销正好落在下一轮的第一个 token 上。对话里的停顿(读答案、思考、再打字)通常在 5 ~ 30 秒,正好跨过 HTTP 客户端默认的 4 秒,于是几乎每一轮都在白付一次握手。
- 这条只影响固定了地址(
pinnedAddresses)的部署:没有固定地址时走的是系统自己的 fetch,本插件不加任何东西。 - 设置页里以秒显示与填写(毫秒的数字人读不出量级),存储时换算成毫秒。取值 1 ~ 1800000 毫秒。
- 空闲满这个时间之后,连接由连接池自己回收,不需要额外的清理机制(实际释放时间比设置值多约 2 秒,那是客户端在服务端给的期限之外自留的一点缓冲)。插件被卸载时,连接池也会一并关掉——它是插件的,不该留在机器上。
请求日志:默认关闭的逐请求记录,打开它才注册侧边栏入口与会话标签页;关掉它入口一并消失,请求路径与没有该日志逐字节一致。设置页"请求日志"分组里有总开关、排错详情开关(连接池事件与请求 UA,默认关闭)、保留条数(默认 200)。
- 两个入口,同一个页面:
- 侧边栏图标 → 主区域整页:跨会话看全部请求。日志是进程级的数据,放在侧边栏最合理——位置固定、常驻可见,和 DSH 自己的插件管理器同一个范式。
- 会话里的「请求日志」标签页:就地看本会话的请求,回答"刚才那轮为什么慢"不用离开对话。
- 页面是一整页而不是浮层:标题、统计(请求数/失败数/平均耗时/平均首字/平均 tok/s/平均缓存命中/连接复用率)、筛选栏固定在上方,只有表格自己滚动。每行含时间、模型、会话、输入/输出/缓存、缓存命中、tok/s、首字、耗时与状态;点一行展开 HTTP 明细(方法、协议、地址、请求体大小、脱敏后的请求头、请求构成、结果与用量、推理拆分、缓存写入、单轮花费、内容跨度)。筛选有模型/结果/慢请求/会话,分组有会话/模型/结果;点列头按该列排序,再点一次反向。
- tok/s 是首字到结束这段解码窗口上的输出速率,口径与 Harness 自己的每轮读数一致(含推理 token)。没有 token 的请求没有速率——不编数。突发推送同样没有速率:网关把一整轮攒到最后一次性推过来时(推理模型常见:8 秒思考在 wire 上不可见,然后上百个 token 几毫秒内到达),内容跨度不足 100ms,算出来的"每秒几万 token"不是生成速度——显示为 —,也不计入平均。
- 会话列显示会话标题(标题来自会话目录;拿不到时回退显示 id,悬停可见完整 id)。会话筛选同时匹配标题与 id;按会话分组的组头同样显示标题。点标题直接打开那个会话(归档的打不开,会明说)。
- 缓存命中是输入 token 里走缓存的占比(缓存读取/(未缓存输入+缓存读取))。网关没报输入就没有占比——同样不编数。
- 输入列是未缓存的新增 token:网关把整段 prompt 拆成"未缓存+缓存命中"两部分上报,输入列只记新增的——同一会话前缀缓存全中时输入很小、缓存命中 100%,不是 bug。悬停列头有口径说明。
- 内容拆分:明细里"请求体"下面跟一行"文本 X /图片 Y"——图片是各去重后附件按 base64 估的占比(单张按路由的编码上限封顶),文本是总数减图片的剩余,两者恒等于请求体总数。图片 dominant 的请求一眼就能看出来。
- 会话 id 始终完整记录(它是会话身份,不是凭据;截断后两个会话会读成一个)。
- 记录的是环形缓冲(超限丢最旧),进程重启即清;只读快照,不轮询,没人打开的页面零流量。
- 凭据永远不进记录:记录器根本不接收请求头参数,只收白名单里的会话 id 与 UA;失败的请求同样记一条(含错误码),中断到没有终端事件的不记(网关没报总数就不编数)。
图片:三个字段各管一层,超限的图片会被明确拒绝,而不是静默降质或丢弃:
| 预设 | 单张像素 | 单张字节(base64 前) | 整单字节(base64 后) |
|---|---|---|---|
dsh(默认) | 2048×2048 | 1MB | 20 MiB |
dshopencodego | 144 万像素 | 400 KB | 6 MiB |
pi-ai | 2000×2000 | 4.5MB | 20 MiB |
模型自身不支持图片输入时,适配器会在发请求前就拒绝(UNSUPPORTED_CONTENT),不会把图发出去再等网关报错。
输出上限:调用方给了 maxTokens 就用它(仍受 modelLimits 的逐模型上限约束);没给时由宿主按路由上限物化——该上限就是目录里的输出容量,或 modelLimits 覆盖后的值。
工具声明:每个请求都发送当前完整的工具列表。宿主提供的会话折叠历史(toolHistory)故意不投影:投影需要路由声明 toolUpdate 模式,而 models.dev 对本网关模型只声明"可调用工具"、没有声明该模式;凭空声明会让模型看到的东西悄悄改变。
重试:retryPolicy 是可选的,不写就用宿主默认。写了就由可选的 dsh-llm-retry 插件执行,配置错误在写入时报错而不是等到失败发生。
固定 IP:pinnedAddresses 把网关域名固定到一个地址,用来接入更近的边缘节点(系统解析到的边缘有时离得很远,而每个请求都要为那段距离付费)。
- 只改解析,不改域名:请求里的域名、Host 头、TLS 的 SNI 与证书校验全部照旧,只有 socket 连到哪个地址被换掉。因此该地址必须能服务这个域名——证书是发给
opencode.ai的。 - 只对网关域名生效:键必须等于
baseURL的域名(默认opencode.ai)。其它名字不在本插件的请求路径上,写了不生效。models.dev与厂商文档始终走系统 DNS。 - 作用范围:模型 API 请求、网关 listing(
/models)、/usage读取——这三类都是发往网关的请求。 - 地址失效自动回退:固定地址连不上时(连接被拒、路由不可达、TLS 握手失败),请求会用系统 DNS 重试一次,并把这个地址记为失效,之后的请求直接走系统 DNS。填错 IP 不会比不填更糟:只有"请求还没发出去"才重试,已经送达的请求不会发第二遍。
- 不设置就是原样:
pinnedAddresses为空时,插件用的就是系统自己的 fetch,不加任何东西。 - 非法地址被忽略:写错的 IP(
1.2.3.256、010.1.1.1等)不会让请求失败,只是被忽略并回退系统 DNS。
设置页(OpenCode Go → 固定 IP)里可以直接填地址:填的是网关域名当前对应的那个键,非法地址当场拒绝,地址失效后页面会显示"已回退系统 DNS"。