前言¶
在 DeepSeek Harness（DSH）里接免费或匿名 LLM，常见做法是自行改 cordis.yml、填第三方 API Key，或依赖已经失效的「万能 key」端点。模型一换、网络一抖，还要自己维护分流和用量统计。社区插件 shendao325/dsh-freebridge（目录页：SkillHub）把匿名模型桥接、Token 记账、网络分流、桌面编排、操作守门和模块级故障隔离收进一个工作流类插件，维护者为 shendao325，目标是「装完即用」：不登录、不注册、不填 API Key，模型直接进选择器，设置页有完整界面。
这是什么¶
FreeBridge 是 DSH 一体化插件（版本 1.0.0，MIT 许可证）。它不替代 DSH 宿主，而是在插件进程内完成协议转换、转发与本地统计；主上游通道为 Kilo Gateway（README 写明匿名可直接 200、无需 key，并提到实测可拉到 408 个可用模型）。插件声明零运行时依赖，Node 需满足 ^22.19.0 || >=24.0.0，peer 依赖包括 @deepseek-ai/cordis、@deepseek-ai/dsh-llm、@deepseek-ai/schemastery。
DSH 生态理念是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能（六个模块）¶
下面按 README 划分的六个模块说明能力边界；任一模块出错不会阻断 DSH 启动，设置页可查看状态并单独重启。
Token 用量统计¶
双计数避免重试虚增：逻辑级只记最终成功渠道（设置页默认）；尝试级记每次真实发出的请求。账本按请求事件追加写，编辑/撤回只改标记、不回溯扣减；旁支提问单独记 branch=true；失败请求记 attempt 但 billable=unknown，不算进渠道消耗。只存计数与元数据，不存 prompt/completion 原文。设置页支持按渠道、模型、日趋势查看，会话统计支持「会话 → 供应商 → 模型」三层下钻。
按需网络分流¶
直连优先，超时或失败再走代理；规则自学习，不强制用户维护域名列表。模型请求与网页抓取分两条策略；连续失败 2 次才改判代理。节点健康只标记不删除。
桌面操作编排¶
插件只做编排层，调用宿主已注册的桌面控制能力；需要才拉起应用，无底层能力时提示手动操作，不静默假装成功。
操作边界守门（默认开启）¶
子操作（桌面、网络、文件写入等）发出前做范围检查：硬禁区直接 deny，意图不匹配 ask，可选 AI 审查处理灰色地带；审查失败降级为 ask。三态：allow / ask / deny。
零配置体验¶
全部配置项有默认值；首次引导只问两个问题（是否自动配置免费模型、是否开启守门），均有默认「是」。探测失败不阻塞启动。
插件级故障隔离¶
模块可降级运行；/freebridge/restart?module= 可单独重启某模块。README 提到账本与分流同时异常时对话仍可正常进行。
设置页入口：重启 DSH 后打开 设置，左侧 FreeBridge，数据来自同源接口 /freebridge/*。
安装与启用¶
官方提供两种方式；本地脚本要求实体拷贝到 profile 的 node_modules（软链接会导致找不到宿主 @deepseek-ai/schemastery 而崩溃）。
方式一：本地安装脚本（README 推荐）
git clone https://github.com/shendao325/dsh-freebridge.git
cd dsh-freebridge
node tools/install-local.mjs
脚本会把插件实体拷贝到 profile、注册 dsh-freebridge 到 dsh.profile.bundles 并确认挂载点。完成后重启 DSH。
方式二：标准插件命令
dsh plugin --profile desktop add dsh-freebridge
重启 DSH 后，模型选择器出现 FreeBridge 分组；选 kilo-auto/free 即可开始对话。首次启动会自动完成上游探测、分流初始化、守门与统计账本，无需改 cordis.yml（README 写明重启不会被覆盖）。
典型用法¶
- 安装并重启 DSH，确认启动日志有
[freebridge] ready；若无 FreeBridge 分组，按 README 排查是否已重启。 - 在模型选择器选 FreeBridge 分组下的 Kilo 模型（如
kilo-auto/free），正常对话即可。 - 在设置 → FreeBridge 查看模块状态、Token 用量、分流与守门；需要时用设置页或 HTTP 单独重启模块。
宿主在 exposeHealth: true 时可只读访问健康与统计，例如：
/freebridge/health
/freebridge/stats?level=attempt
/freebridge/sessions
/freebridge/session?id=
/freebridge/restart?module=
完整路径表见 GitHub README「接口」一节。
README 还对比了若干已失效的免费接入方式（如 LLM7 万能 key、Pollinations 老端点、OpenCode -free 池等），并说明若对话报「额度已用尽」应切到 FreeBridge 的 Kilo 模型而非 OpenCode 免费池。
适用场景与注意¶
适合谁： 想在 DSH 里快速试用匿名免费模型、同时需要本地 Token 统计、网络分流和操作守门的工作流开发者；愿意接受免费上游随时变更的风险。
权限与安全： 插件以当前 DSH 进程权限运行；安装前应自行审阅 源码 与 MIT 许可证。README 明确：免费池可能记录 prompt 用于改进服务，不要发送敏感内容；仅供个人学习与测试，遵守各上游服务条款。
自测： 仓库内可运行 node test/all.mjs（14 套件、356 项断言），用于验证 adapter 契约、账本、分流、守门等逻辑。
结尾¶
dsh-freebridge 把免费模型接入与用量、网络、桌面、守门、隔离合成一条可落地的 DSH 插件路径，减少手改配置和依赖失效端点。进一步了解请查看 SkillHub 目录页 与 GitHub 仓库。
