README
OpenDesign Go for DSH
在 DSH 里使用 OpenDesign 订阅的模型(Go 为 14 个,Plus / Pro / Max 更多):推理走 OpenAI 风格的 chat/completions 或 responses,额度、用量和多账号都在设置页里。

关于作者
交易员,业余写工具。这个插件起源于我自己拿 DeepSeek 做量化策略研究和复盘时的需要。
| 平台 | 地址 |
|---|---|
| 知乎 | 勇者别嚣张 |
| YouTube | @valortrader |
| B站 | 勇者别嚣张的交易室 |
| 微信公众号 | 勇者别嚣张的交易室 |
功能
| 功能 | 说明 |
|---|---|
| 接入 Go 套餐 | 注册一个 dsh-opendesign-go provider,提供 Design Plan 的 14 个模型 |
| 三条接口协议 | 同一网关的 chat/completions、responses 与 Anthropic messages 可切换,默认第一条;Responses 只返回被改写的思考摘要 |
| 一键更新 | 设置页直接调插件的更新通道:主路径走 npm registry,另有「从 GitHub 装」作为兜底 |
| 用量统计 | 记录每次经本插件发出的请求,按模型汇总输入/输出/缓存 token,并按各厂商公开单价估算成本 |
| 额度读取 | 勾选后调用本机 OpenDesign 桌面端自带的 vela 命令行,读取真实的 5 小时 / 7 天额度窗口 |
| 输入框额度条 | 选中本插件的模型时,会话输入框旁出现一枚胶囊,显示 5 小时与 7 天的剩余百分比,点开可看倒计时、钱包余额与刷新 |
| 多账号 | 每个账号对应一份独立的 OpenDesign 订阅,每份一把 API Key;可开启失败自动切换 |
| 每模型参数 | 为单个模型覆盖上下文窗口与 max_tokens 上限 |
| 模型开关 | 取消勾选的模型不出现在会话的模型选择器里 |
| 图片输入 | 声明了 image 模态的模型可以接收图片;文本模型收到的是占位文本 |
| 图片缩放 | 每张图按路由声明的尺寸与字节上限生成请求版本(2048² / 1 MiB),不再按上传原图重发;超预算按宿主的 IMAGE_OFFLOAD_REQUIRED 契约降级重试,而不是撞 413 |
| 生图模型 | 网关目录里的生图模型(gpt-image-2、seedream-5.0 等)由 opendesign_generate_image 工具调用,走 /images/generations,图片从工具结果回到会话;它们不出现在会话模型选择器里,因为生图没有文本可流式返回 |
| 工具读图 | read_image 读到的图片会随请求发给模型,不只回一段路径文本 |
所有用量数字都标注了口径。金额按官方公开价目表的基础档估算,超出阶梯阈值的长上下文请求会被低估;这不是账单,实际扣费以 OpenDesign 控制台为准。
多账号的要点:每个账号对应一份独立的订阅。同一工作空间内的多把 Key 共享同一份额度,所以多账号的意义是「多买几份 Go」,不是把一份订阅拆成多把钥匙。
适配与验证
下面这些结论都有对应的实测记录,不是「按文档应该能跑」。
| 项 | 结论 | 验证方式 |
|---|---|---|
| 宿主版本 | 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.2 三版全部通过 |
npm run test:hosts,每版在临时目录装齐 12 个 peer,再查符号 / 类型 / 挂载三层 |
| 网关上下文 | 真实窗口 1,048,576 token,未缩容 | 二分探测:喂 1,036,038 token 返 200,1,053,038 返 400 |
| 图片输入 | 声明 image 的 12 个模型全部能收图并正确识别 |
逐模型发同一张纯色 PNG,直连与经中间件两条链路各跑一遍 |
| 三条协议 | chat/completions、responses、Anthropic messages 都能流式、带工具、带图;思考内容只有 Responses 是被改写的摘要 |
同一批 prompt 各跑一遍,逐事件比对形状与 reasoning_tokens;Anthropic 另验 x-api-key/anthropic-version 头与 thinking 开关 |
| 参数表 | 14 个模型的窗口与输出上限逐条对应厂商文档;deepseek-v4.1-flash-eco 与 minimax-m3.1-flash 的输出上限无厂商文档,依据实测 |
出处逐条列在 docs/models.md |
| 额度口径 | credits 与美元 10,000 : 1;5 小时 50,000、7 天 150,000 | 两个窗口独立折算互证,与 vela 输出一致;另用 DeepSeek 调用的 credit 增量五次复核,落在 10,067–11,880 |
| 工具侧图片 | 图片改由紧随其后的 user 消息承载,直连与经中间件都到达模型 |
同一条工具结果在两种链路下逐模型比对 |
| 输入框槽位 | 三版宿主都提供 conversation.input.right(list 型、session 作用域) |
逐版解包 dsh-client-ui-conversation 的 slots.d.ts 核对 |
宿主兼容矩阵的三层是递进的,缺一层就会漏掉一类故障:符号抓导出被改名或删除(导入本身不报错,要到首次调用才炸),类型抓符号还在但签名漂移,挂载才是真实 Cordis 运行时接不接受入口。反向验证也做过——向产物注入不存在的导出会报 thisExportDoesNotExist,向源码写类型错误会报 TS2322,不会永远通过。
CI 有五个作业:Windows 与 Ubuntu 各跑 Node 24 和 22.19,加一个独立的 hosts 作业,当前全绿。
近期修复的缺陷
这些是实际撞到并定位到根因的问题,逐条记在这里,因为它们的现象都容易让人得出错误结论。
| 版本 | 现象 | 真实原因 |
|---|---|---|
| 0.1.19 | 会话用久了必定 413,压缩也必定失败,换哪个模型都一样 | 请求体里的图片按原图字节每轮重发:实测一个会话 28 张图、41.30 MB 原始、base64 后 55.06 MB,涨到网关前面 nginx 的接受上限 |
| 0.1.19 | 生图模型在列表里,选中就报错 | 网关把对话模型和生图模型混在一个目录里只给 id,插件全当对话模型发 /chat/completions,而它们只吃 /images/generations;而且生图没有文本可流式返回,本来就无法作为对话的一轮 |
| 0.1.9 | 上下文只用了三成,请求却被判超长 | 网关按 输入 + max_tokens ≤ 窗口 判据,而插件每次把模型公布的最大输出(384,000)原样发上去;宿主只量输入,不扣输出预留量 |
| 0.1.8 | 工具读到的图片,模型说「看不到」 | 请求链路上的中间件按常见形状重建 tool 消息,把 content 拍平成字符串,image_url 部件被静默丢弃 |
| 0.1.7 | 同上,模型说「看不到图片」 | 我们自己处理 tool 角色时把图片解析器传成了 undefined,每张图被替换成占位文本 |
| 0.1.7 | 插件市场安装长时间等待甚至超时 | 每次调用都无条件 settings.update,宿主会锁住 profile 根目录并重写整份 composition 文档,随后重算插件树 |
| 0.1.6 | 所有模型都被判成不能识图 | 模态字段读错了表:宿主读的是 catalog.ts 的静态目录,而那张表只有 id 和 name |
| 0.1.5 | 历史回放在部分 Node 24 上重复计数 | 会话日志一个事件一帧,旧读法依赖「一次解码只返回第一帧」;部分构建会连带后面的帧 |
对应的修法:
- 图片请求缩放(0.1.19)。先按宿主定义的
imageRequestTarget声明本路由要的尺寸与字节上限,再用attachments.readImageRequest取缩放后的请求版本——和dsh-llm-deepseek、dsh-llm-pi-ai一样取 2048² / 1 MiB。实测那个会话的请求体从 55.06 MB 降到 30.48 MB,28 张里 11 张会变小,图片全都还在。缩放解决不了的再按IMAGE_OFFLOAD_REQUIRED契约交给dsh-compaction-image-offload:抛一个带offloadImages: N的错误,由宿主记image/offload事件后重试。不自己丢是因为没记录的投影会让会话日志与实际发送的内容不一致——日志说那轮带了图,模型其实没看到。预算 20 MiB / 60 张,按 8 MiB 与 20 张整块前进,避免每轮多丢一张把 prompt 缓存打断。只统计user与tool里的图:assistant里的图既不发送也不可 offload,算进来会要求一次永远无法完成的操作。 - 生图模型(0.1.19)。目录快照多记
imageIds标出哪些 id 是生图模型;它们由opendesign_generate_image工具调用,改走POST /images/generations,返回的 base64 经attachments.saveImage落成持久引用,作为工具结果回到会话。做成工具而不是贴进 assistant 消息,是因为三条都要求如此:官方两个适配器把 assistant 图片判UNSUPPORTED_CONTENT,宿主的 offload 只扫user/tool事件,而被计入预算却无法 offload 的图会让会话卡在修不好的状态里。工具结果三条都满足——模型看得到图,会话重了能 offload,画廊照常渲染。它们不出现在会话的模型选择器里(listModels过滤掉),因为生图没有文本可流式返回;设置页仍按目录列出它们,只是不再额外标注——行里没有上下文/输出参数和「改参数」按钮,这本身已经说明它不是对话模型。 - 输出预留(0.1.9)。报给宿主的窗口改成输入预算
窗口 − max(输出上限, 窗口/4),1M 窗口 + 384K 输出的模型报 750,000;真正发出的max_tokens按本次请求的实际输入钳制,输入占满时省略该字段。图片按每张 1,024 token 计——按 base64 长度算会高估三个数量级。工具声明也计入:本机真实工具集是 326 个声明、约 163K token,占窗口 15.6%。 - 工具侧图片(0.1.7 → 0.1.8)。先是让
tool消息也走图片解析器,之后发现tool角色承载非文本部件缺乏共识——Chat Completions 规范没有约定它,各家重建实现各行其是。现在tool消息只发文本,图片提取到紧随其后的user消息,并由一句(Image content from the preceding tool result.)标明来源。 - 配置写入(0.1.7)。写入前先读该 entry 当前的值,相等就直接返回;短路放在重试循环内部,每次重写前重新读,
revision围栏语义不变。写入失败不再死重试 12 次,只有SETTINGS_CONFLICT值得重试一次。加上 5 分钟节流,实测写入量从约 1814 + 1440 次/天降到各 288 次/天。 - 模态来源(0.1.6)。删掉
catalog.ts里那份会分叉的模态字段,会话选择器、参数解析、请求门控统一读MODEL_DEFAULTS。测试强制把 14 个模型分进「支持图片」与「仅文本」两组,并要求并集等于全集,漏写一个就失败。 - 帧解压(0.1.5)。改为按帧边界切片,一片一帧,与运行时是否连帧无关。本机的 zstd 不连帧、无法复现,所以把解码器做成可注入参数,测试用一个「会连帧」的模拟解码器验证。
示意图
会话输入框的额度条:选中本插件的模型时出现,显示 5 小时与 7 天的剩余百分比,按最差的那个窗口着色;点开是明细面板。

订阅额度卡片:5 小时与 7 天两个滚动窗口各自的剩余百分比、剩余金额、已用金额与外推天数,底部是钱包余额与本周期的两套对账口径:

可用模型列表:关闭后该模型不再出现在会话的模型选择器里(仍可走 API),右侧「改参数」可逐项覆盖上下文窗口与输出上限:

安装
更多「其他」外掛
dsh-oil-creator
作者 oil-oil
AI 輔助的本地創作者工作臺,支援在 DeepSeek Harness 中創作內容
dsh-novel-writer
作者 akira399
大肥魚的小說工坊 — DSH 網路小說創作外掛:九階段門禁式創作流程 + 世界書設定注入 + 本地書籍匯入 + AI 一鍵潤色 + 去AI味 + 黃金三章診斷 + 百萬字一致性 + 市場調研與模板複製。
dsh-multica-runtime
作者 multica-ai
為 Multica 平臺提供 DeepSeek Harness 執行時支援,讓智慧體工作流無縫執行。
dsh-plugin-radar
作者 adamplatin123
DSH Plugin Radar — open-source ecosystem radar for DeepSeek Harness plugins: continuous discovery (21k+ candidates), k8s runtime validation (13k+ tests), 15-min snapshots; the catalog is a generated artifact — 開源 DSH 外掛生態雷達:持續發現 2.1 萬+ 候選、k8s 執行級實測 1.3 萬+、15 分鐘快照;外掛目錄為自動生成的產物
