项目快照:Ebony-Vinyl/dsh-our-free-model,约 69,255 个 Star,1,865 个 Fork;最新推送时间 2026-11-10T12:45:26Z。本文基于仓库公开资料撰写。

项目地址:https://github.com/Ebony-Vinyl/dsh-our-free-model

dsh-our-free-model 从代码、运行环境到实践流程的项目封面
dsh-our-free-model 的项目能力与实践流程示意。

项目速览(TL;DR)

dsh-our-free-model 是面向 dsh 的 JavaScript 插件,仓库介绍称其目标是让用户无需登录、注册或填写 API Key,即可在 dsh 中使用免费模型渠道。README 特别说明,模型清单会跟随上游刷新,而渠道可用性取决于用户自己的网络出口。

仓库元数据显示项目采用 MIT 许可证,默认分支为 main,语言为 JavaScript;所给仓库信息记录 69,255 个 Star 和 1,865 个 Fork。README 将插件标记为 beta,并称其纯插件挂载、不修改内核、没有构建步骤且零依赖;这些属于仓库所述特征,不等于对上游服务可用性或服务质量的保证。

项目维度资料所载信息阅读提示
项目类型dsh 插件README 将其描述为插件挂载方式;未提供完整安装步骤。
运行目标在 dsh 中使用模型渠道模型与渠道以仓库最新说明为准。
代码语言JavaScriptGitHub 仓库元信息。
依赖与构建README 标注零依赖、无构建步骤不应据此推断所有扩展功能均无依赖。
许可证MIT具体条件见仓库 LICENSE。
成熟度beta这是 README 中展示的状态标签。

定位与目标用户

项目面向希望通过 dsh 访问模型服务、又不想在这个插件的基本使用路径中自行填写 API Key 的用户。README 把“安装插件后直接使用”作为主要体验描述,但所给资料没有包含 dsh 的安装方式、插件安装命令或兼容版本说明正文,实际接入前需要核对当前 README。

该项目同时延伸到本地转发、桌面端渠道和独立管理界面等方向。根据 package.json 的描述,这些能力与匿名免费通道并存;不同能力所需环境、账号流程及其与 dsh 插件入口的关系,资料片段没有完整交代,不能将所有功能都视为无需配置。

核心功能

免费模型渠道

README 将 OpenCode 的 Zen 网关和 Kilo AI 的公共网关列为免费渠道来源,并称其为直连、不经第三方中转。其工作路径可概括为:dsh 插件向配置的上游渠道发起模型请求,由相应网关处理后返回结果;但所给资料未提供请求格式、渠道选择规则、失败重试逻辑及数据处理细节。

仓库描述列出了 DeepSeek V4.1 Flash 和 Kimi K3 等模型。README 同时说明模型清单会跟随上游刷新,因此这里列举的是项目资料中的名称,不构成对当前可用状态的承诺;具体模型是否可用,应以仓库最新列表和本机网络出口的实测结果为准。

网络出口可用性检查

README 明确指出,可用性由用户自己的机器网络出口实测得出。这意味着同一渠道的结果可能受本机到上游网关的网络连通情况影响;项目没有在所给资料中公布探测算法、探测频率、超时策略或可用性判定接口。

这项设计将判断落在实际运行环境,而不是仅根据一份静态模型清单作出承诺。出现模型无法调用时,应先区分模型是否仍在上游清单中、当前网络是否能访问相应来源,以及 dsh 与插件是否处于受支持版本范围内;具体诊断命令未提供。

思考强度预算

README 称思考强度下发的是“真实预算”而不是提示词。按该表述,强度设置对应传递给模型侧的预算参数,而不是仅在用户提示文本中追加一段要求;然而资料未提供参数名称、取值类型、默认值、模型间映射规则或界面操作方式。

因此,不能仅凭这项描述推定每个模型都支持相同的预算控制,也不能据此推断响应时延或输出质量。实际支持范围与调用机制需查阅最新仓库文档。

本地 OpenAI 兼容转发

README 提及另附 OpenAI 兼容的本地转发端口,package.json 描述还提到本地 OpenAI 网关与局域网转发。其用途是让其他客户端通过本地或局域网入口访问项目提供的模型服务;所给资料未包含端口号、监听地址、鉴权方式、兼容接口路径和启动命令,因而不能安全地给出可执行的客户端配置示例。

系统架构与关键模块

现有资料支持的架构判断是:项目以 dsh 插件作为接入方式,并连接 OpenCode Zen、Kilo AI 公共网关等上游来源。README 所称“不改内核、无构建步骤、零依赖”说明其强调由宿主 dsh 加载插件,而不是要求用户修改 dsh 内核;插件加载协议细节没有包含在资料中。

package.json 的入口字段显示,包的主入口为 index.js,另提供 client.js 子路径导出,以及 locale/*.json 形式的本地化资源导出。它还列出了 standalone 相关脚本,表明仓库包含独立运行或管理功能的构建与测试任务,但不能仅凭这些脚本名称确定其完整部署拓扑。

模块或入口资料中的证据可确认范围
插件主入口package.json 的 main 为 ./index.js,导出路径 . 指向 ./index.js包主入口文件名可确认;内部实现未提供。
客户端入口导出路径 ./client 指向 ./client.js存在子路径导出;调用签名未提供。
本地化资源导出路径 ./locale/*.json存在 locale 资源导出模式;语言列表未提供。
独立程序scripts 中含 standalone 构建、启动与测试脚本脚本名称可确认;安装、部署与界面细节未提供。
上游渠道README 提及 OpenCode Zen 与 Kilo AI 公共网关来源名称可确认;协议与数据字段未提供。

依赖与运行环境

仓库语言为 JavaScript,package.json 声明模块类型为 ESM,并将 package 版本标为 2.8.3。README 展示 dsh 适配内核范围为 0.1.5 至 0.1.7-rc.2;该范围应按 README 原标签理解,不能扩展为对其他 dsh 版本的兼容承诺。

README 的“零依赖”徽标描述的是插件特征,但所给 package.json 片段并未展示完整依赖字段或锁文件内容。Node.js 版本、操作系统范围、安装器要求以及 standalone 部分的运行依赖,官方仓库未提供该信息,建议以最新 README 为准。

  • 语言:JavaScript,来源为 GitHub 仓库元信息。
  • 模块模式:ESM,来源为 package.json 的 type 字段。
  • 包版本:2.8.3,来源为 package.json;不应将其直接等同于 dsh 内核版本。
  • dsh 适配范围:README 标注 0.1.5 至 0.1.7-rc.2。
  • 构建与依赖:README 标注无构建步骤、零依赖;完整运行环境仍须以仓库当前文档为准。

快速开始

当前资料没有给出插件安装命令,也没有给出 dsh 的启动或插件加载命令。为避免虚构命令,下面只展示 package.json 中真实存在的独立程序启动脚本;它不是 dsh 插件的安装步骤,也不能替代 README 中尚未提供的插件接入说明。

Bash
# 在仓库根目录运行 package.json 中定义的独立程序启动脚本
npm run start:standalone

该命令要求用户已取得项目源码并具备可用的 Node.js 与 npm 环境,但具体版本要求未提供;命令是否适合直接用于生产环境也未说明。启动后如何确认服务状态、访问地址和健康检查路径,官方仓库未提供该信息,建议以最新 README 为准。

安装、运行与验证的边界

请求中要求的安装、运行、验证三步闭环无法从所给资料完整构造:缺少插件安装命令、dsh 启动命令和插件加载后的验证方法。为保证命令可核查,不能用猜测的包管理命令或本地端口补齐缺失部分。

Bash
# 在仓库根目录运行项目定义的测试入口
npm test

package.json 将 npm test 指向 scripts/test-all.mjs。运行测试是仓库层面的验证,不等价于验证 dsh 已成功加载插件、模型渠道可访问或某个模型当前可用;测试前置条件和测试覆盖范围也未出现在所给资料中。

配置说明

所给 package.json 可核查的信息主要是包元数据与 npm 脚本,没有提供插件配置样例、环境变量、监听端口或模型参数默认值。下表将已知字段和未知运行配置分开列出,避免把包构建信息误写成用户可配置项。

字段名类型默认值作用
name字符串dsh-our-free-modelpackage.json 中的包名称。
version字符串2.8.3package.json 中的包版本标识。
private布尔值truepackage.json 的包发布控制字段;不是模型服务的隐私设置。
type字符串module声明 JavaScript 包采用 ESM 模块模式。
main路径字符串./index.js指定包主入口。
OPENAI_API_KEY未提供未提供所给资料没有确认该环境变量存在,不应据此配置。
本地转发端口未提供未提供README 提及本地转发端口,但没有给出端口号或配置字段。

README 的免 Key 描述针对其所述免费渠道基本体验;package.json 又提到账号渠道、积分领取和桌面端协付渠道等功能。不同渠道是否需要账号或其他凭据,资料片段没有逐项说明,不能把“无需 API Key”解释为所有扩展功能均无需任何身份验证或配置。

进阶用法

仓库脚本显示,项目还包含 standalone 打包、渠道构建、UI 构建、管理功能测试以及 Magpie 引擎更新任务。下面列出 package.json 中实际存在的命令名称,供维护者识别仓库工作流;这些命令不等同于普通用户的插件安装步骤。

Bash
# 构建独立发行包
npm run pack:standalone

# 检查独立发行包
npm run test:package

# 构建独立版渠道
npm run build:standalone-channels

# 构建独立版界面
npm run build:standalone-ui

根据 package.json,这些脚本分别调用 scripts/ 下的 Node.js 文件。所给资料没有说明构建产物目录、命令参数、发布流程、更新回滚步骤或渠道凭据管理方式,执行维护任务前应先查阅仓库对应脚本和最新 README。

同一文件还定义 test:contributor、test:release、manifest、channel-pack、manifest:check、selftest、typecheck 等脚本。这些名称表明仓库具有贡献者测试、发布测试、清单生成与自检入口,但具体检查内容必须以脚本实现为准;仅凭名称不能推断其验证覆盖率。

可观测性与运维

package.json 描述提到数据看板与运行日志,并称 standalone 管理界面包含六页毛玻璃界面。README 片段也提到可用性由本机网络出口实测;这些信息表明仓库考虑了运行状态展示,但未提供指标定义、日志格式、保留周期或运维告警机制。

运行中遇到问题,可按边界逐层核对:dsh 是否在 README 标注的适配范围内、插件是否成功加载、目标上游是否可从当前网络出口访问、模型是否仍在最新清单中。该排查顺序是根据 README 所给机制整理的建议,不代表仓库提供了对应自动诊断功能。

  • 日志字段与脱敏规则:官方仓库未提供该信息,建议以最新 README 为准。
  • 数据看板所含指标及刷新周期:官方仓库未提供该信息,建议以最新 README 为准。
  • 健康检查路径、监听端口与告警配置:官方仓库未提供该信息,建议以最新 README 为准。
  • 故障恢复、限流和重试策略:官方仓库未提供该信息,建议以最新 README 为准。

安全与合规边界

该项目会将模型请求发往外部网关,使用者应在提交请求前确认数据处理边界。README 将 OpenCode Zen 和 Kilo AI 公共网关列为渠道来源,并称请求直连、不经过第三方中转;这不等于请求仅在本机处理,也不构成上游对数据保留、训练使用或保密义务的承诺。

涉及个人信息、客户资料、源代码、凭据或受监管数据时,应先依照组织政策和适用法律判断是否允许发送至对应上游。上游数据保留周期、加密细节、训练用途、地域位置与合同保障,所给资料均未说明;需要这些保障的工作负载不应仅凭“免费”或“直连”描述作出合规结论。

README 提到局域网转发与本地 OpenAI 兼容端口,但未给出默认绑定地址和认证机制。部署这类入口时,应只在已授权且隔离的环境中使用,并先查明访问控制、网络暴露范围和日志内容;不得将未经核实的默认配置暴露给不受信任的网络。

账号渠道、账号池、积分领取等能力出现在 package.json 描述中。具体授权来源、服务条款适用范围和自动化边界未见于所给资料,使用者应遵守各上游服务的条款与账户授权范围,不应尝试规避访问控制或绕过平台限制。

许可证与商用条款

仓库提供的 LICENSE 为 MIT License。其文本允许取得软件副本者使用、复制、修改、合并、发布、分发、再许可及销售软件副本,因此许可证文本允许商用使用和分发,但应遵守许可证条件。

分发软件或其重要部分时,必须在软件的所有副本或实质性部分中包含原版权声明与许可声明。许可证同时按“现状”提供软件,不作明示或默示保证,并排除文本所述范围内的责任;具体法律适用仍以仓库 LICENSE 为准。

许可证覆盖的是仓库软件,不自动授予 OpenCode Zen、Kilo AI 或其他上游服务的额外权利,也不能替代上游服务条款。对第三方名称、渠道服务及其数据处理的权利义务,应分别核对相应官方条款;所给资料没有提供相关合同条款。

局限性与已知限制

README 将项目状态标注为 beta,并限定了其展示的 dsh 内核适配范围。用户若使用范围之外的宿主版本,资料没有给出兼容性结论,应先核对仓库最新版本说明,而不是将插件可安装等同于功能受支持。

免费渠道的模型清单会随上游刷新,可用性依赖本机网络出口。因而 README 中列出的模型名称不能视为固定服务目录;上游调整、网络不可达或渠道规则变化时,使用体验可能不同于静态描述。

  • 未提供完整安装和卸载流程。
  • 未提供模型接口签名、请求参数及响应结构。
  • 未提供本地转发端口、监听地址、鉴权方式和安全默认值。
  • 未提供上游可用性承诺、服务等级协议、限流数值或性能基准。
  • 未提供数据保留政策、日志脱敏细节及第三方服务的完整条款。
  • README 的功能描述和 package.json 的版本信息可能对应不同更新时间;资料未提供两者的发布时间对照。

这些限制来自所给资料的覆盖范围,不意味着仓库完整内容中一定不存在相关说明。对具体部署决策,应以仓库当前 README、LICENSE 和对应实现文件为准。

适合谁 / 不适合谁

是否采用该插件,关键取决于团队对数据流向、上游渠道变化和可用性控制的容忍程度。下面的判断条件依据仓库明确描述及其缺失信息整理;超出资料所载事实的取舍建议,属于根据本文作者的经验判断。

适合的使用场景

  • 使用 dsh,且宿主版本落在 README 标注的 0.1.5 至 0.1.7-rc.2 范围内,并希望通过插件方式接入模型渠道的个人或团队。
  • 工作负载不要求固定模型清单,能够接受免费渠道模型随上游刷新这一特征的用户。
  • 数据内容允许发送至 README 所列外部网关,且组织能自行核验上游数据处理条件的试用或开发场景。
  • 希望评估本地 OpenAI 兼容转发或 standalone 能力,并愿意先核对端口、认证与部署细节的维护者。

不适合的使用场景

  • 必须使用固定模型版本、固定服务端点或明确服务等级承诺的生产业务;仓库资料没有提供这些承诺。
  • 处理规则禁止向所列上游传输数据,或尚未完成隐私与合规审查的敏感业务。
  • 依赖 README 适配范围以外的 dsh 版本,且无法承担自行验证兼容性的团队。
  • 需要已文档化的账号授权流程、精确限流参数、审计字段或运维告警定义,而这些信息尚未从仓库资料中核实的系统。

常见问题与排查(FAQ / Troubleshooting)

仓库资料能回答项目来源、许可证、部分入口与渠道描述,但不足以覆盖具体故障命令。下列答复将已确认事实与需要回到最新文档核对的事项分开,不提供未经资料证实的诊断参数。

使用免费模型是否需要 API Key?

README 对其主要免费插件体验的描述是无需登录、注册或填写 API Key。该说法不能推广到 package.json 提到的所有账号渠道、账号池或其他协付渠道,后者的凭据要求需查阅当前说明。

为什么模型清单与实际可用性不一致?

README 表示模型清单会跟随上游刷新,并由本机网络出口实测可用性。先核对仓库最新模型清单,再确认当前运行环境能够访问对应上游;具体探测命令和失败码未提供。

怎样确认插件已成功加载?

所给资料没有提供 dsh 插件安装命令、加载日志样例或成功标志。应按仓库当前 README 的安装与验证章节操作;不能用 npm test 代替宿主加载验证。

独立程序启动后从哪里访问?

package.json 定义了 npm run start:standalone,但资料没有给出该程序的访问 URL、监听端口或默认账号。启动后不要猜测端口,也不要将未确认的服务入口暴露到局域网;应先查阅 standalone 文档和启动输出。

测试命令能证明哪些内容?

npm test 会执行 scripts/test-all.mjs,这是 package.json 中的脚本映射。由于测试覆盖内容未提供,它只能确认仓库定义了该测试入口,不能据此宣称已验证所有模型、上游渠道或生产部署行为。

项目地址与资源

以下资源均来自仓库资料中的项目地址或 README 所列官方站点。上游服务的条款、数据处理政策及当前可用性应分别以各站点的现行说明为准。

README 原文将项目定位为免登录、免注册、免 API Key 的免费模型插件,并提醒可用性取决于用户本机网络出口。引述如下:

“模型清单跟随上游刷新,可用性由你自己这台机器的网络出口实测得出,思考强度下发的是真实预算而不是提示词,另附一个 OpenAI 兼容的本地转发端口。”

来源:README