dsh-our-free-model 用不了怎么办：连不上、额度与切换的完整排查顺序与重新启用

「昨天还能用，今天一直连不上。」 用 dsh-our-free-model 的人迟早会碰到这句话，而它背后可能是三种完全不同的故障：插件没加载、模型不可用、额度或网络被卡住（社区仓库）。这篇按分诊表排：先用一个动作分清三类，再看日志与失败码，最后给切回官方模型与重新启用的顺序。涉及插件更新与重装时，入口在 DSH Plugin Hub。

先分三类：DSH plugin 没加载、模型不可用、额度与网络

三类故障的判据不同：插件没加载看「有没有入口」，模型不可用看「请求有没有回来」，额度与网络看「返回码是什么」。 先分清，能省掉一半无效重启。

1. 打开已安装列表，确认 dsh-our-free-model 在当前 profile 里。
2. 重启宿主，看插件面板或入口是否出现。
3. 入口出现后，看模型列表里有没有免费模型可选。
4. 能选模型但请求失败，进入下一节看失败码。
5. 三类都对不上，记录时间点，按「社区反馈 / 待核实」处理。

分诊的关键是不要跳步。插件没加载时去调模型配置，或者额度用尽时反复重启，都是把问题往错误的方向推。

看日志与失败码：DeepSeek Harness 的逐层排查

排查顺序是「请求发没发出 → 返回码 → 模型名与端点 → 网络与代理」，先定位层，再谈修。 失败码比界面文案更可靠。

1. 请求没发出：插件或本地转发端口没起来，先确认插件加载与端口状态。
2. 401 / 403：凭据或转发端口鉴权问题；免费通道理论上不需要官方密钥，出现这类码要先核对插件自身的鉴权设置。
3. 404：端点或模型名对不上，检查转发地址与模型标识是否被改动。
4. 429：额度或限流，通常来自上游；本地重启一般无效。
5. 超时 / 连接重置：网络、代理或上游波动，先确认本地能出网，再换时间重试。

日志要分层看：宿主日志看插件是否加载，插件面板看通道状态，请求记录看返回码。三类日志指向同一层，结论才成立。官方模型提供方的配置方式见 官方文档；模型连接类排查可以对照 模型连接排查。

一个最省时间的判据

请求有没有发出去，是分诊里信息量最大的动作。

1. 本地准备阶段就失败：插件或转发端口没起来，先去看插件加载。
2. 请求已发出、返回 4xx：按返回码对应的层处理。
3. 请求已发出、没有返回：看网络、代理与超时。

临时切回官方模型：DSH plugin 的止损顺序

先止损再排查：切回官方模型只改「当前用哪个提供方」，不需要卸载插件。 这样你能继续工作，也保留免费通道的现场。

1. 进「设置 → 模型」，把当前模型切回官方提供方。
2. 确认官方密钥仍在有效状态；变更在下一次请求时生效。
3. 发一条短消息，确认能正常返回，排除宿主整体故障。
4. 保留免费通道的失败时间、失败码与日志，不要清空。
5. 等工作告一段落，再单独排查免费通道。

切回官方不是「放弃免费模型」，而是把「工作可用」和「通道排查」分开。两件事同时做，最容易在配置之间来回改，最后说不清哪套在生效。

重新启用：DSH Plugin Hub 里的更新、重启与验证

重新启用按「更新 → 重启 → 选模型 → 发测试消息」四步走，每一步都有可观察结果。 不要只看到「已启用」就结束。

1. 在已安装列表看 dsh-our-free-model 是否有可更新版本，有就先更新。
2. 更新后重启 DeepSeek Harness，等插件面板与模型列表重新加载。
3. 回「设置 → 模型」切回免费模型，确认模型标识属于该通道。
4. 发一条测试消息，确认有返回且不是报错兜底。
5. 看插件自带的用量看板，确认这次调用被记录。

四步里，测试消息与用量记录最有说服力。界面显示启用、模型列表出现，都可能只是加载完成；真正发出去并拿到返回，才说明通道可用。

哪些结论还不能确定：DeepSeek Harness 免费模型的待核实边界

免费模型的额度、上游与稳定性由插件方决定，很多结论只能标「社区反馈 / 待核实」，不能写成官方承诺。 这条边界要提前说清。

1. 额度规则：免费通道的额度怎么算、什么时候重置，社区说法不一，以插件面板与上游提示为准。
2. 上游模型清单：模型列表会随上游变化，今天可用的模型明天可能消失，不做长期可用承诺。
3. 限流阈值：429 的具体阈值与恢复时间不透明，只能按实际返回判断。
4. 服务条款与合规：能否用于你的场景，需要自行确认，不把社区经验当成合规结论。
5. 修复状态：插件更新是否解决某个问题，以仓库发布记录为准，不写「官方已修复」。

把这些标成「待核实」，不是降低文章价值，而是避免把不确定的东西写成结论。记录时至少写三样：

1. 时间点与失败码。
2. 插件版本与上游提示。
3. 当时的网络与代理环境。

免费模型的定位本来就是试用与体验，稳定性与归属需要自己评估；它和官方模型的差异见 dsh-our-free-model 是什么，切换与回退的完整步骤见 免费模型与官方模型怎么切换。