← Back to the directory

Ebony-Vinyl/dsh-our-free-model

Loading README…

分组	内容
Our Free Model	当前网络出口可直接使用的模型
Our Free Model · region-limited	上游对该地区不放行的模型，保留可见但单独隔离

项目	修复	验证
#19 自更新信任链	清单 Ed25519 签名（公钥 pin 在插件内，私钥不入仓）、feedUrl 与更新源彻底解耦、清单 base 只允许相对路径	updater-test 新增签名/篡改/异钥/feedUrl 不跟随 4 组用例；release-e2e 负控改为在签名处拒绝
#19 转发口面	localhost 绑定先执行 DNS 解析且要求结果全为回环；插件 API 请求体 1MB 上限（413）；转发非 JSON body 返回 400、未知模型返回 404	forward-test resolveLoopbackBind 三态用例；offline-test 404 用例
#20/#21 转发下工具不可调用（#21 报告的 Unknown tool 'bash'/'read'/'grep' 正是指纹诱饵四件套：车道强制声明这些名称，模型发起调用而转发客户端未注册）	流式 tool_calls[].index 按调用重新编号，从 0 起（不再与 reasoning 共用块索引）；指纹诱饵工具调用在转发口按块抑制（未命名块先扣留参数）；参数被截断的回合流式同样返回 length	forward-test 4 组流式/非流式用例（本地服务器 + 脚本化 lane）
#20 dsh 内诱饵隐患	stream.js 中无 index 的并行工具调用按 id 分块，裸参数续写归入前一块	现有 truncation/fingerprint 套件全绿
#13 达额体验	429 移出可重试状态码（同一回合不再自动重试三次）；探测整轮全为 429 后按 30→120 分钟指数退避（手动 reprobe/出口变化/启动轮不受限）；探测可识别 200 流内 error 帧；测速按钮调整默认档并放宽前端超时	retry-safety-test 断言更新；probe 逻辑随 offline 套件全绿
#13 转发配额集中	429 不再自动重试（同上）；转发会话键维持按 user/conversation 派生（上游按会话计额，为刻意设计）	行为不变，无新增消耗面
#11 热力图	格子 gap 归零、圆角收小，呈现 GitHub contribution graph 式连贯观感；布局本身已为列优先周对齐，无需改动	client-lint 全绿
其它	前端按路由放宽超时（bench 240s/升级 600s，8s 兜底仅作用于快速路由）；EventSource 断连改为退避重连（30s→5min），不再永久失效；升级完成推送会清除旧错误横幅；看板"速度"文案与最近 40 次的实现一致；store 落盘失败会在日志中记录一次	client-lint；speed-stat 全绿

项目	方式	结果
两种工具结果形状均实际送达模型	真实上游 host-selftest.mjs 第 2 步	同一模型、同一 get_weather 结果，分别按 pre-V4 的 user+tool-result 与 V4 的 role:'tool' 各发一轮：两条均 finish=stop，且模型均复述出结果中的 22°C / sunny。修改前插件对第一种形状完全无感知（src/messages.js 中从未出现 tool-result），该轮发出的请求既无工具调用也无结果
消息形状取自实际记录（不依赖推测）	本机全部 4 处 session 根、共 40 个 session*.jsonl.zstd（zstd 需按帧切分后逐段解压）	tool/result 事件共出现两种形状：role:'user' 携带 tool-result 块 362 条（V1/V3 格式——AIO 6.9.3 的 v3 家目录写入 336 条，~/.dsh 的 v1 写入 26 条），V4 的 role:'tool' 27 条（v4 格式的会话副本）。两代格式均在被使用，而插件此前仅识别后者——issue #9 的判断成立，只是其描述的形状比报告者所用内核更新
投影与配对修复	离线 projection-test.mjs（新增，40 条断言）	三条线 × 两种形状：调用与其结果均落到 wire 上、按 call id 一一对应；三个并行调用各自的结果逐个送达，Messages 线合并进同一 user 轮且 tool_result 置于最前（与内核自身的 Messages 适配器同一规则）；结果中内嵌的图像不再丢失（Chat 走紧随其后的 user 轮，Messages 直接嵌入 tool_result）；同一份结果在任一线上只出现一次（按答案字节出现次数判定，不依据块类型——块类型断言无法发现重复）；无 call id 的工具答案、悬空调用、孤儿结果照旧剔除；已配对历史逐字节不被改写
pwsh 顶替 bash 槽位可被网关接受	真实上游 probes/shell-slot-promotion.mjs（新增）	声明名称为 bash, glob, grep, read，其中 bash 携带 pwsh 的真实 schema、无诱饵：网关未返回 FreeTierError，finish=tool-calls，模型返回的调用被还原为 pwsh（{"command":"Get-Date"}）——即内核确实可执行。离线另有 fingerprint-test.mjs（新增，20 条）固定以下行为：不重复声明、真实 bash 优先、无 donor 时才落诱饵
半截流不再被判定为正常结束	离线 truncation-test.mjs（新增 22 条）	本地 HTTP 服务真实执行 res.end() 关闭一条无 finish token 的流 → kind=error、统计行 ok=false 且带 truncated 标记；三条线各验证一次；message_stop、response.completed 等真实结束帧不误判；有 finish 但无 usage 的行标记 noUsage，0/0 与"确无产出"自此可区分。重发策略按已流出内容区分：未流出任何 token 的截断仍为 TRANSPORT（可重试），已流出内容的截断为 STREAM_CUT（不在重试名单内，立即失败）——理由见下一行
一次真实内核会话实测出的重试代价	真实内核 dsh web + 浏览器中发起的一轮 MiMo V2.6 Flash · Deep	durable 会话日志逐事件取回：llm/retry retry=1 delay=702ms code=TRANSPORT 落在 304s，retry=2 delay=1124ms 落在 608s，turn/end {kind:"error",code:"TRANSPORT"} 在 912s；stats.json 中三条 ok:false truncated:true 的 0/0 行，间隔 304s；界面呈现为「本轮运行失败」加原始语句加 TRANSPORT。即：该车道的截断由本轮长度决定，可重试代码只会将同一个五分钟重复支付三次，因此内容已流出时不再重发
复查本轮发布，发现上述两项自身的问题	离线 projection-test.mjs 第 7 节、truncation-test.mjs 第 12 节，另加 tui-test.mjs 一次转发端往返	① Messages 线在识别 V4 的 role:'tool' 之后，将同一段结果既放入 tool_result、又保留在紧随的普通块中——文本重复两份，图像连同 base64 重复两份；当前实现在发出结果后跳过该消息自身，撤掉修复则此断言立即失败。② response.incomplete / response.failed / response.done 同样属于 Responses 线的正常收尾，此前仅识别 response.completed，导致触及输出上限的一轮被判定为"被截断"、白白消耗两次重试；当前实现仍由 status 决定 finish token，且不带原因的收尾帧不再清除前一帧已给出的 token。③ 转发端的 /v1/responses 此前无用例覆盖工具历史，现通过桩上游逐字节核对发出的 messages：调用与其结果均存在
该车道的正常收尾形态	真实上游 probes/stream-terminal-frames.mjs（新增）	逐帧抓取原始 SSE：finish_reason:"stop" → 带 usage 的帧 → data: [DONE] → {"choices":[],"cost":"0"}，两个模型一致。因此"始终未出现 finish token"确属异常，不属于该车道的另一种正常写法——这也是 #10 判定条件的依据
真实车道上无误判	真实上游 host-selftest.mjs 全量	11 个模型探测 + 普通对话 + 两轮工具 + 三档思考 + 视觉输入，全部落到各自的正常收尾（stop / tool-calls / max-tokens），无一条被判定为截断；被地区门拦截的模型仍返回 REGION_BLOCKED
上游来源成文（#8）	代码中全部出网目标逐条核对	新增「上游是哪些源」一节：opencode.ai/inference/v1/（推理与 /models，2026-10-14 起；原为 /zen/v1）、本仓库 feed/.json（raw 优先、jsDelivr 兜底）、api.ipify.org / ipinfo.io / ipapi.co（仅读取本机出口 IP 与国家码）。当前无号池、无中转
离线套件	npm test（18 个套件）	全绿；新增 projection、fingerprint 两套，仍不出网、不消耗免费额度

项目	方式	结果
发布清单与实物一致	离线 build-manifest.mjs --check + release-e2e.mjs	26 个发布文件全部一致。修改前线上 main 的 1.2.1 清单已漂移 6 个文件（index.js、README.md、README_EN.md、src/catalog.js、src/store.js、src/upstream.js），比 issue #1 报告的 2 个更多——即提出 issue 之后再次复发。现已随版本重新生成；--check 与新增的 release-e2e.mjs（使用真实清单与真实文件完整执行一次升级，含"清单虚报 1 个字节必须被拒绝"的反向对照）均已纳入 npm test 与 CI。本轮补充修复两个同源漏洞：清单现按 LF 归一化后的字节计算（.gitattributes 为 * text=auto eol=lf，而 Windows 编辑器可将工作区写为 CRLF 且 git status 不报错——这正是 issue #1 上次的复现路径），目录收集也改为递归（旧的单层扫描会遗漏 src/lib/x.js 这类嵌套文件：npm 会安装它、清单中却没有它，而 installStaged 会将清单未列名的文件从用户机器删除）。两条各有一条常驻断言，后者还将 26 个文件全量转为 CRLF 后再执行 --check
离线套件	npm test（14 个套件）	14/14 通过；不出网、不消耗免费额度。套件端口取自临时端口段（固定端口在两个进程同时运行时会冲突：本轮实测——先占用 tui 的固定端口再运行该套件，请求被发送至其它进程的监听，套件一直挂起直至被 runner 超时终止、打印出的"失败详情"为六行 ok），runner 对每个套件设置 60 s 硬超时并输出挂起原因
新增测试确实能捕获回归	逐条还原旧行为后重新运行	computeMembership 的未判定模型：还原旧写法 → picker 报 Cannot read properties of undefined (reading 'state')（2 条检查失败）；postStreamed 的 Content-Type 判定：还原旧写法 → sniff 7 条检查失败。恢复后各自全绿。本轮新增的断言另执行了一轮变异测试：在临时副本中将 9 处修复逐条还原后运行对应套件，9/9 变红（逐条输出见下方"本轮复审"三行）
探测判定与选择器广播	真实上游 host-selftest.mjs	清单 10 个模型 → 主分组 7 + region-limited 2，转发端口 /v1/models 同步 9 个；deepseek-v4-flash-free（Model is unavailable）移出下拉框并在设置页保留拒因；5xx/429/断网一律保持可达（issue #3 的判定不再误伤网络抖动）
未判定模型不再致命	离线假内核 picker-test.mjs	清单新增一个模型、且其探测被测试挂起时，listModels 与 /summary 均正常返回，该模型 availability=unknown 且照常广播
思考档位仍然强制生效	真实上游，MiMo V2.6 Flash	light 当前下发 4096：同一 prompt 下 2 980 tokens 正常 stop；修改前 light=2048 在同一 prompt 上以 length 收尾
长回答不再被截断	真实上游 probes/long-answer.mjs	balanced 实际下发 max_tokens=16384，单次请求输出 10 164 tokens（19 914 字符、194 秒）后 finish=stop；同一请求在旧的 8192 档上必然以 length 结束——即 issue #2 报告的现象。设置页模型卡标注每档实际数值（默认档上限 16K，已在实际浏览器中确认）
SSE 帧不再受 header 误导（issue #6）	离线假网关 sniff-test.mjs	200 + application/json + 响应体为 SSE 帧：正常输出 token，不报错；跨 chunk 截断的中文字符、超过 4 K 嗅探窗口的 400 帧长流、单包 JSON、空 body、HTML 等各类内容均按形状分流。同一场景在旧代码下会导致探测将可用模型判为 unavailable
无 web server 的 composition	离线假内核 scripts/tui-test.mjs	仅挂载 llm 时 apply() 不抛错、注册两条路由、完成一轮流式对话、转发端口启动并拒绝无 Key 请求；后台循环使用普通 unref 定时器。看板模块保持待命状态，webServer 出现后自动注册两条路由。真实 dsh-tui 尚未实机验证：本机两套内核（dsh 0.1.7 源码构建、AIO 6.9.3）均不含 tui profile
插件在真实内核中确实可安装	真实内核 dsh 0.1.7-rc.1 web，端口 3099	启动无 did not activate；/api/our-free-model/summary 返回 200（10 个模型：6 available、2 region-blocked、1 unknown、1 unavailable）、/events 启动并推送 hello；在实际浏览器中进入设置 → Our Free Model 逐项读取到 10 张模型卡、不在选择器中分组、思考不可关与默认档上限 16K 标签，控制台零报错。本轮最初版本在此步骤失败：inject 仅保留 llm 后读取 ctx.interval 抛出 cannot get property "timer" without inject，插件在所有 composition 中均不再激活
复审发现的两个新问题	定向复现 + 常驻断言	① head 嗅探阶段被 abort 时抛出的是原生 AbortError（code 为数字 20），toFailure 无法识别从而降级为 TRANSPORT——而 TRANSPORT 位于可重试名单内，用户主动取消的回合存在被内核重试的可能；当前三条读取路径共用 classifyStreamFailure，sniff 中保留两条 abort 断言。② 提交后又修改了 src/http.js，清单再次漂移，被 --check 与新增的 release-e2e.mjs 当场捕获——门禁按设计生效，同时也说明任何改动后都需重新执行
本轮复审：请求路径上两处"整轮丢弃/重复计费"	本地假网关定向复现 + 常驻断言	① readHead 需填满 4 KB 才判定形状：一条已完成输出的短回答，只要网关未立即关闭连接，就会在嗅探窗口中等待至 deadline，随后连同已读取的帧一起被 cancel 丢弃——整轮以一个可重试的 TIMEOUT 结束，内核再次发送、额度再次消耗（复现输出为 frames delivered: 0）。当前实现在首帧识别为流后立即放行，同时不再阻塞每轮开头那 4 KB 的 token。② 流内错误的分类写入了 llmCode，而 toFailure 仅读取 code——导致每条流内拒绝都降级为可重试的 TRANSPORT（已输出 token 的回合被重发），中途的 RegionError 也永远无法触发切换出口重探。当前流内错误与错误信封统一走 classifyFailure
本轮复审：设置入口缺少类型校验	离线 picker-test.mjs + effort-test.mjs	probeIntervalMinutes:'abc' → Math.max(1,'abc') 为 NaN，而 setTimeout(fn, NaN) 在 Node 中等价于 1 ms：每秒执行一次全量探测。defaultMaxTokens:0（清空设置页输入框即会提交 0）→ min(容量, 0)，每轮被裁剪至 512 token，而选择器仍标注 4 K/16 K/32 K 的档位。当前数值项在 POST /settings 入口与使用处各设一道校验，非正值一律按"未设置"回落。同一批断言还固定了转发端口只能绑定回环（0.0.0.0 直接返回 400 并注明原因），以及 connection 的准入判定为逐请求读取（还原为 apply 时的一次性快照 → 该 401 断言立即失败）
本轮复审：三条"看似在测试"的套件	变异测试（在临时副本中逐条还原旧行为）	retry-safety-test.mjs 的四个用例全部落在"模型不在清单上"的提前返回分支（传入 model:"our-free-model/test-model-free"，而 baseModelId 仅剥离 label 不剥离路由），未发出任何请求——改为真实调用后 7 个用例逐个固定 code／是否可重试／是否触发区域重探。tui-test.mjs 的 unref 断言比较的是两个不同总体的计数（移除 120 s 循环的 unref() 后仍全绿）→ 改为按周期逐个核对。写死在套件中的端口（tui 的 18931）与另一进程争用同一端口时，表现为 180 s 静默挂起、打印出的"失败详情"为六行 ok → 端口改为取自临时端口段，runner 增加 60 s 硬超时并如实说明"该套件挂起"
usage 计数正确	离线 retry-safety-test.mjs	缺少 prompt_tokens_details 的 usage 不再使 inputTokens 变为 NaN；转发端口按 prompt_tokens/completion_tokens 上报，被网关拒绝的转发请求返回错误，不返回空 200。Messages 线上 message_delta 仅携带 output 一侧，旧写法会覆盖整条 usage 记录、使每个 Claude 回合的 prompt tokens 记为 0；当前改为按字段合并
本轮复审：5xx 的原因短语不再被当作判定（issue #3 的同类回归）	离线 sniff-test.mjs + 反向验证	stateOf 的消息兜底匹配不检查状态码，而反向代理返回 503 的标准原因短语正是 Service Unavailable——过载的网关因此被判定为"点名拒绝该模型"，模型逐个从选择器中消失（issue #3 修复的代价从消息兜底路径再度引入）。当前该兜底仅在状态码无法代表网关意图时才生效；响应体中点名模型的（含 5xx 下的 type: ModelError）仍判定为拒绝。新增 4 条断言，还原旧实现后其中 2 条立即失败

项目	结果
dsh 0.1.7-rc.1（源码构建）	启动无报错；选择器两个分组正确；多轮工具调用完成
dsh 0.1.5-rc.2（DSHEAC AIO 6.9.3 内核）	启动无报错；与已安装的其它第三方插件共存
EAC 启动闸门	安装时与应用内升级后各执行一次：compatible / PASS
模型可调用性	10 个清单模型全部可达（该轮行为：探测失败/暂不可用的模型也保留在选择器中；自 v1.2.2 起不再广播判定为不可用的模型）；real chat、多轮工具、视觉输入在两套内核中通过
真实 harness 对话	dsh web 与 AIO 桌面端各完成一轮真实对话并收到回复
公告 feed	在本地"仓库服务器"推送新公告 → 运行中的两端在一个轮询周期内收到
公告中心 UI	4 条公告渲染（粗体/代码/链接/列表）、紧急红色徽章、未读标记、单条/全部已读
紧急公告	urgent 推送触发全屏弹窗，点击"知道了"即写入已确认状态
Toast + 系统通知	新公告实时 toast；桌面端 window.Notification 通道存在（WebView2 权限策略拒绝授权时 UI 如实提示）
应用内升级	dsh web 与 AIO 桌面端各完成一次 1.1.0 → 1.1.2 升级：23 个文件下载、SHA-256 校验、备份、替换、热重载；升级后 /meta 立即上报新版本
升级安全性	哈希不匹配 → staging 丢弃、已安装包不变、历史记录标记失败；升级产物通过 EAC 闸门并完整重启加载
热重载	按钮、API 两种入口；ESM 缓存清除 + 重注册 + 回滚序列；generation 递增、客户端通过 localStorage 提示一次
客户端 bundle 热更	替换 client.js 后浏览器端由内核 client-hmr 自动重载（实测两次）
信任围栏	非 loopback Host / 跨站 sec-fetch-site / 异源 Origin 一律 403；无 cookie 的回环请求 401（与内核 /api 一致）
SSE 推送	hello/announcements/update/upgraded 事件实测通过；热重载后自动重连
思考强度传递	light/balanced/deep 三档实测：reasoning 2048（被预算截断）/ 3386 / 3522，输出单调上升
地区门	受限模型返回 REGION_BLOCKED 并保留在自身分组
转发端口	/v1/models、流式与非流式 /v1/chat/completions；无 Key 请求被拒 401
界面文案	无乱码；上游厂名仅出现在仓库文档与公告正文两处——#8 要求的披露需要一个用户可见的位置，公告即说明位。模型选择器、设置页与报错文案中始终不出现
未验证部分如实说明	OS 级通知的最终视觉呈现未逐像素确认——AIO 桌面端的 WebView2 权限策略拒绝了 Notification.requestPermission()（插件的 Tauri 通知通道存在，纯浏览器路径可用，被拒时设置页如实显示"需要在系统/浏览器设置中手动恢复"）；AIO 对内置插件存在报告式静态启发扫描（TROJAN_EXFIL_ENV 会对 src/upstream.js 的 env+URL 邻近模式记录一条报告日志），仅记录不改动文件

Ebony-Vinyl/dsh-our-free-model

dsh-our-free-model

交流群

亮点

你会看到什么

独立本地服务（开发中）

安装

桌面安装包（macOS，社区构建）

使用说明

Gemini 与 Cline 的代理连接

聚合渠道、省 Token、路由与本地网关

聚合渠道：自带 Key 的 76 家提供商

省 Token：工具输出压缩、提示词瘦身与本地应答

路由：命名降级链（combo）

本地网关：原生 Anthropic 接口与接入配方

实现结构

思考强度：档位菜单与预算阶梯

三个实际消耗过调试时间的内核行为

为什么按 body 的形状而不是 Content-Type 读响应

为什么速度那一栏会显示 —

长思考截断后的自动恢复（issue #12）

验收情况

Issue #12：验收状态

历史：v1.3.2（对应 issue #11、#13、#19、#20、#21）

历史：v1.3.1（对应 issue #8、#9、#10）

上一轮：v1.2.2（对应 issue #1–#4、#6）

上一轮：v1.1.2（公告、升级、热重载与信任围栏）

已知边界

开发

EAC 渠道（桌面端专属）

上游是哪些源

免责声明

安全与隐私

许可证

Star 趋势

用途	目标	携带何种凭据
推理请求	POST …/inference/v1/chat/completions、…/inference/v1/responses、…/inference/v1/messages（按模型分流，见 endpointFor）	Authorization: Bearer public——该车道本身即为公开免密额度，插件中不含任何属于你的密钥
模型清单	GET …/inference/v1/models	同上
公告与升级清单	本仓库的 feed/*.json：raw.githubusercontent.com 优先，cdn.jsdelivr.net 兜底	无
出口地区判定	api.ipify.org / ipinfo.io / ipapi.co，仅用于读取本机公网 IP 与国家码	无

用途	目标	携带何种凭据
推理请求	POST …/api/gateway/chat/completions（OpenAI Chat Completions 兼容，SSE 流式）	无——该网关的免费池（清单中 `isFree: true` 的模型，含 kilo-auto/free 自动路由）不需任何账号、Key 或登录态
模型清单	GET …/api/gateway/models	无