前言¶
在 DeepSeek Harness（DSH）里配好各家 provider、登录态和额度之后，对话通常只在本机浏览器里完成。手机、平板或同一 WiFi 下的另一台电脑想用同一批模型，常见做法是把 API Key 再复制到每台设备，或各自再登一遍账号。维护者 Saretheya 的 dsh-lantern（仓库 Saretheya/dsh-lantern）针对的是另一种路径：在本机 DSH 内起一个兼容 OpenAI 与 Anthropic 协议的小网关，只读复用已注册的模型清单与上游登录态，局域网内持有你签发 Key 的设备即可调用。下面介绍它做什么、怎么装、怎么连。
这是什么¶
LANtern（插件包名 dsh-lantern，当前版本 0.1.5，MIT 许可证）的定位可以概括为：把本机 DSH 已注册的全部 AI 模型，通过局域网暴露为 OpenAI 兼容（/v1/chat/completions 等）与可选的 Anthropic 兼容（/v1/messages）端点。
它不新增上游账号、不修改 ~/.dsh/settings.yaml 、不改动其它插件；写入仅发生在插件目录下的 data/（配置、API Key 哈希、用量账本等）。模型列表来自 DSH 的 llm 注册表，只读访问。
请求路径在概念上如下：
手机 / 平板 / 另一台电脑 → LANtern 网关（本机 DSH 内） → 各家 API（已有登录态）
局域网 你的电脑 上行
社区目录 SkillHub 上的 dsh-lantern 页 将其归类为联网类工具；DSH 生态理念是「一切皆插件」，该目录为独立社区站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
兼容端点¶
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/models |
GET | 模型目录（支持 ?provider=<slug> 过滤） |
/v1/models/{id} |
GET | 单个模型详情 |
/v1/chat/completions |
POST | OpenAI 兼容主推理（流式 / 非流式） |
/v1/messages |
POST | Anthropic 兼容（默认关闭，可在设置中开启） |
/v1/lantern/health |
GET | 自检，无需鉴权 |
OpenAI 风格客户端 Base URL 填 http://<IP>:<端口>/v1；Anthropic 风格填 http://<IP>:<端口>，Key 分别用 Authorization: Bearer 或 x-api-key。
模型命名¶
公开模型名强制为 <模型>@<provider>，例如 deepseek-v4-pro@buddy。不带 @provider 会 404，响应中会附带可用列表。同名模型可能来自多个 provider，后缀用于唯一性与显式路由。
访问控制与治理¶
- API Key：在设置面板生成，明文仅显示一次，服务端存 sha256；默认格式为
sk-+ 43 位 base64url。 - 监听模式：
standalone由插件自绑端口（如0.0.0.0:3081）；reuse复用 DSH 端口，绑定地址受 DSH 启动参数--host约束（默认127.0.0.1时局域网不可达，需dsh --host 0.0.0.0或优先用standalone）。 - 限额：总并发、每 Key 的 rpm/tpm、单次
max_tokens、为本机保留的并发槽。 - 模型过滤：黑名单 / 白名单同时作用于列表与调用。
- 熔断：上游连续限流时暂停局域网通道（503，冷却期内不向上游打请求）；余额不足、网络超时等不触发熔断。
- 图片输入：默认关闭；开启后图片会短暂落盘到插件附件目录以满足 DSH 附件流程，附带账本与 dry-run 清理策略。
用量与诊断¶
仅统计经本插件的调用。可按时间、API Key、调用类型查看 token 用量，并导出自包含 HTML 报告。诊断区可查看在飞请求、熔断状态，并导出脱敏信息。
环境与 DSH 版本¶
- Node.js：
^22.19.0 || >=24.0.0（见package.json的engines）。 - DSH：需 0.1.5-rc.2 以上；README 标明 0.1.5 与 0.2.0 均已实测支持安装、转发与设置面板。
安装与启用¶
先做全局 DSH 与 Node 环境，再安装插件。安装命令以仓库 README 为准（将 web 换成你的 profile 名）：
npm install -g @deepseek-ai/dsh
dsh plugin --profile web add dsh-lantern
新增 bundle 不会热应用到已运行进程，需要重启 DSH 并刷新浏览器：
dsh --profile web
重启后，侧边栏底部齿轮 → 左侧会出现 LANtern 设置项。
跑通服务的建议顺序：
- 状态与安全 → 服务开关：打开总开关（默认关闭）。
- 状态与安全 → 监听与端口：选
standalone，绑定0.0.0.0，端口自定（如3081）。 - 状态与安全 → API Key 管理：生成 Key 并立即复制明文。
- 在其它设备上用局域网 IP 与上述端口调用（Windows 可用
ipconfig查 IP）。
卸载：
dsh plugin --profile web remove dsh-lantern
卸载后同样需重启 DSH 并刷新页面；删除插件目录后 data/ 一并移除。上游额度仍与本机 DSH 对话共享，这是复用登录态的设计前提。
典型用法¶
在局域网另一台设备上，将 <你的电脑IP>、<端口>、<你生成的Key>、<模型>@<provider> 替换为实际值。
查看可用模型：
curl http://<你的电脑IP>:<端口>/v1/models \
-H "Authorization: Bearer <你生成的Key>"
OpenAI 兼容对话：
curl http://<你的电脑IP>:<端口>/v1/chat/completions \
-H "Authorization: Bearer <你生成的Key>" \
-H "Content-Type: application/json" \
-d '{"model":"<模型>@<provider>","messages":[{"role":"user","content":"你好"}]}'
若客户端只认 Anthropic 协议，在 设置 → LANtern → 状态与安全 → 协议通道 中开启 /v1/messages，Base URL 使用 http://<IP>:<端口>，Key 放在 x-api-key 头。
适用场景与注意¶
适合：已在单机上用 DSH 集中管理多 provider，希望在同一局域网内用 OpenAI / Anthropic 兼容客户端（含部分 CLI 工具）访问同一批模型，且愿意自行管理 Key、端口与防火墙。
使用前请知悉：
- 插件在当前 dsh 进程权限下运行；安装前应阅读 源码与 LICENSE，确认符合你的安全策略。
- 局域网可达性依赖绑定地址（
127.0.0.1仅本机）、防火墙与是否同一网段；401 多为 Key 缺失或错误，404 多为模型名未带@provider，429 为限速，503 可能为熔断。 - DSH 未注册的 provider，LANtern 无法公开；能力声明与实际上游行为可能不一致，模型页的「功能测试」会真实消耗额度。
- 已知限制包括上游额度共享、依赖 DSH 模型注册表，以及功能/性能测试结果不会自动改写能力声明。
结尾¶
dsh-lantern 把「本机已配好的 DSH 模型」收敛成局域网内的标准兼容 API，用 Key、限流与本机优先的并发策略控制暴露面，配置与密钥留在插件自有 data/ 目录。进一步了解可在 SkillHub 目录页 查看摘要，在 GitHub 仓库 阅读完整 README、排错与 reuse 模式说明。
