dsh 免费模型插件：桌面端安装3步免Key指南

dsh 免费模型插件：桌面端安装3步免Key指南

【免费下载链接】dsh-our-free-model在 dsh 里装上这个插件即可，无需登录、注册或填 API Key，就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费，不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.项目地址: https://gitcode.com/gh_mirrors/ds/dsh-our-free-model

装好 dsh-our-free-model 这个免登录插件，DeepSeek V4.1 Flash、Kimi K3 就能直接用——不登录、不注册、不填 API Key，免费不限量。你只需要判断一件事：跑的是纯 web profile 就一行命令；用 DSHEAC AIO 或 DeepSeek Harness 桌面端就走插件管理器；两者都不是或想要完全可控，再做桌面端手工安装的真实目录配置。

装前自检：你是哪种环境，该走哪条路

动手前先花半分钟对号入座。耗时按熟练情况估，新手多留一倍余量。

最后一条单独强调：npm 上的dsh-our-free-model不是本仓库发布的，index.js、client.js被第三方改动过，装不到审核过的构建，也拿不到签名清单校验和应用内升级。安装来源只有两个——本仓库的 Release 发布包，或本地可信源码目录。

三条安装路线：从省事到可控

路线一：桌面端插件管理器一键装

打开桌面应用，进「设置 → 插件」，在插件管理器里搜 dsh-our-free-model，点安装或升级，完事。这是桌面端最省事的走法。

注意：桌面端 profile 只由桌面应用自己管理。你在命令行执行dsh plugin add会直接被拒，报错profile "desktop" is managed exclusively by the Electron application。这是宿主的保护机制，不是插件坏了——回桌面应用里操作即可。命令行安装只适用于纯 web profile。

路线二：纯 web profile 一行命令装

不在桌面端、跑的是dsh web，最简单：

dsh plugin --profile web add /绝对路径/dsh-our-free-model

--profile填你实际用的 profile 名称。装完重启一次应用，打开输入框的模型选择器，看到 Our Free Model 分组就是成功了。

路线三：桌面端手工真实目录安装（3 步走）

为什么桌面端手工装必须用真实目录？桌面端在启动 web 服务前会做一次前置检查，扫描器只放行 dsh 自身在.dsh-module-fallback下生成的链接。你的目录树里只要混进其它符号链接或目录 junction，应用直接拒绝启动：

PROFILE_UPGRADE_REQUIRED: offline dependency migration is not yet available

由此得出两条规矩：依赖不用link:（本质是符号链接），junction 不手工建。在所用 profile 的目录（%DSH_HOME%/profiles/<profile>/）下完成三步。

第 1 步：取完整包，落到 profile 的 vendor 目录。从 Release 页下载正式 tarball 放入<DSH_HOME>/profiles/<profile>/vendor/；或从可信源码本地打包——克隆仓库后在仓库目录执行：

git clone https://gitcode.com/gh_mirrors/ds/dsh-our-free-model npm pack --ignore-scripts --pack-destination "<DSH_HOME>/profiles/<profile>/vendor"

包必须完整。对照 package.json 的files字段：index.js、client.js、adapter/、src/、locale/、icon.svg、cordis.patch.yml、package.json，外加vendor/channel-pack/下的pack.js、WASM、LICENSE、NOTICE。

常见错误 → 正确做法：只复制入口脚本会让渠道加载失败，而adapter/是最常被漏掉的目录——照files清单核对，缺什么补什么。

第 2 步：声明 file 依赖，版本跟仓库走。在 profile 的package.json的dependencies中加入：

"dsh-our-free-model": "file:./vendor/dsh-our-free-model-2.7.1.tgz"

文件名版本跟随仓库 package.json 的version字段（当前为2.7.1），版本变更时同步更新，别沿用旧值，更不要写成link:形式。

常见错误 → 正确做法：图省事用link:指目录——那会引入符号链接，直接触发上面的启动检查失败；换成file:指向 vendor 里的 tarball 才安全。

第 3 步：注册 bundle，patch 文件别再动。在dsh.profile.bundles数组末尾追加一项：

"dsh-our-free-model"

不要再向 cordis.patch.yml 添加条目。被dsh.profile.bundles引用的包，其自带的 patch 层（见 cordis.patch.yml）会自动生效；两处同时注册会直接报错duplicate loader entry id: our-free-model。

常见错误 → 正确做法：觉得"保险起见两处都登记"——正是这个想法造成报错，bundles 数组里留一条就够了。

如果这份安装的字节由包管理器拥有，把 bundle config 或插件settings.json的distribution设为managed：应用内升级、公告 feed 与热重载停用，模型功能保留。

装完三查清单：确认没白装

装完不必盲启，按编号过一遍。哪项不通过，就回到对应路线排查。

1. 启动检查自检。直接调用桌面端自带的检查代码（路径换成本机实际值）：

   node -e " const g = require('<DSHEAC AIO 安装目录>/sidecar/dist/lib/profile-upgrade.js'); const app = '<安装目录>', profile = '%DSH_HOME%/profiles/<profile>'; console.log(g.planProfileUpgrade(app, profile)); g.assertProfileStartup(app, profile); console.log('startup gate: PASS'); "

   预期：status: 'compatible'、mismatches为空数组，随后打印PASS。不通过说明目录里还有不合规的链接，回路线三第 1 步重放真实目录。

2. bundle 去重检查（不启动界面）：

   dsh --profile <profile> --dump-config | grep our-free-model

   预期：id: our-free-model只出现一个。出现两次，就是路线三第 3 步 patch 重复注册惹的祸，删掉 cordis.patch.yml 里的手动条目。

3. 模型分组实测。重启应用，打开输入框的模型选择器。预期：Our Free Model 分组存在，DeepSeek V4.1 Flash、Kimi K3 等模型直接可选。分组不在，回路线一/路线二确认安装是否真的生效，或是否漏了重启。

装好后你拿到什么，以及边界在哪

免费模型分组：选择器里出现 Our Free Model 分组，DeepSeek V4.1 Flash、Kimi K3 等直接可选。清单跟随上游刷新，只广播你本机网络出口实测可达的模型。

桌面端专属 EAC 协付渠道：模型名带EAC前缀（如EAC DeepSeek V4.1 Flash）。凭据加密密封、宿主指纹把守；授权在「设置 → Our Free Model → EAC 渠道授权」浏览器里一键完成（GitHub 登录并 star 本仓库），无需复制粘贴。命令行及其它宿主中这条通道完全不存在，实现见 src/eac-login.js。

数据全在本机的用量看板：17 周 Token 热力图、总量曲线、输出速度与首字延迟逐次采样，零上传。下面是热力图布局修复前后对照，修复后格子按周对齐、不再横向拉伸：

本地 OpenAI 兼容转发端口：本机其它工具用 base URL 加 Key 即可调用这些模型。

应用内升级：下载 → SHA-256 校验 → 备份 → 原子替换 → 热重载，任一步失败自动回滚至上一版本，无需重装。逻辑见 src/updater.js 与 src/feed.js。

紧接着说边界。免费额度由上游单方面提供，Kilo 免费池明确声明 prompt 可能被上游记录并用于改进服务——请勿通过免费车道发送密码、密钥或商业机密等敏感内容。

卡住速查：5 个高频报错的成因与解法

每条先讲为什么会这样，再给解法。

1. profile "desktop" is managed exclusively by the Electron application原因：桌面端 profile 只允许桌面应用自己管理，命令行写不进去。 解法：在桌面端插件管理器里完成安装或升级；命令行安装仅适用于纯 web profile。

2. ERR_PNPM_VIRTUAL_STORE_DIR_MAX_LENGTH_DIFF原因：报错发生在下载插件之前，与本插件仓库无关。profile 里已有的node_modules由旧版 pnpm 生成，dsh 更新后内置 pnpm 版本变化，pnpm 拒绝在旧参数上继续安装。 解法：关闭 dsh，删除该 profile 的node_modules与pnpm-lock.yaml使其重建，再重新安装：

   rd /s /q "%DSH_HOME%\profiles\web\node_modules" del "%DSH_HOME%\profiles\web\pnpm-lock.yaml"

   伴随出现的Ignoring broken lockfile警告会随重建一同消失。

3. git ls-remote "git+ssh://git@github.com/..."原因：插件市场对 git 源的自动安装会把地址交给 pnpm，pnpm 再调用本机 git 执行ls-remote。若本机 git 配了insteadOf重写（常见于把 https 改写为 ssh 的规则），这一步在下载任何文件之前失败。 解法：git config --global --get-regexp insteadof可查询并修正规则；或改用本地安装——从发布包解压后dsh plugin add <解压目录>，绕开 git 解析。

4. duplicate loader entry id: our-free-model原因：dsh.profile.bundles和 cordis.patch.yml 两处都登记了同一个包。 解法：保留 bundles 数组里那一条，删掉手动加进 cordis.patch.yml 的条目。

5. PROFILE_UPGRADE_REQUIRED: offline dependency migration is not yet available原因：桌面端启动检查在 profile 目录树里发现了非 dsh 生成的符号链接或 junction。 解法：依赖用file:指向 tarball，不用link:，不手工建 junction；或干脆回插件管理器一键装。

你想查什么 → 去哪找

【免费下载链接】dsh-our-free-model在 dsh 里装上这个插件即可，无需登录、注册或填 API Key，就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费，不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.项目地址: https://gitcode.com/gh_mirrors/ds/dsh-our-free-model