前言¶

DeepSeek Harness（DSH）的插件化架构让很多模型接入方式变得灵活，但依赖官方 API Key 往往意味着需要管理多套凭证或受限于调用配额。如果你已经在使用 Loomy 桌面应用，并且希望直接用 Loomy 内置的模型来驱动 DSH，那么 DSH Loomy Connect 就是一个可以减少配置的中间层。这个插件以只读方式读取 Loomy 落盘的登录态与模型清单，不复制、不上传、不改写任何文件，只做必要的发现与透传。

是什么¶

DSH Loomy Connect 是一个模型推理类插件，由维护者 2239058652 在上游基线 0.2.0（gdrpzym/dsh-loomy-connect）基础上适配到 DSH 0.2.1。它的核心作用是将 Loomy 桌面应用内置的文本模型注册为 DSH 的一个 Provider，让模型列表与登录态从 Loomy 本地发现，从而在 DSH 中使用这些模型而无需提供 API Key。插件本身是 MIT 许可，仅供个人学习与研究使用。

核心功能¶

• 零配置：安装并启用后，Loomy 的模型会直接出现在 DSH 的模型选择器中。
• 模型自动发现：启动时从 Loomy 获取当前账号可用的模型清单，只纳入支持文本输出的模型。
• 倍率与优惠展示：插件页的「模型」标签页列出全部模型及各自的积分倍率（如 x3.0、限时免费），数据随 Loomy 侧调整而变化。
• 账号与积分：插件页顶部状态行显示当前登录账号（脱敏手机号）与积分余额；「积分」标签页显示永久积分与每日赠送积分——数值取自 Loomy 自身展示所依赖的同一份数据。
• 模型明细：以三列表格列出每个模型的名称、上下文窗口大小（若 Loomy 的清单提供了该字段）与积分倍率，图像模型排在文本模型之后。
• 模型页状态条：在「设置 → 模型」的 Loomy 卡片内直接显示登录态与永久积分。
• 中英双语：界面文案跟随 DSH 界面语言。

安装与启用¶

前置条件：

• Loomy 桌面应用已安装，且至少登录过一次。
• DSH 版本 >= 0.2.1-rc.2 且 < 0.3.0。
• Node.js >= 22.19。
• pnpm 必需（dsh plugin 内部通过 pnpm 管理 profile 依赖）。

从 GitHub 安装（推荐）：

dsh plugin --profile web add github:2239058652/dsh-loomy-connect
dsh web

如果没有全局 dsh，可使用以下任一命令（两者都只下载 dsh 本身，插件安装仍走 pnpm）：

npx @deepseek-ai/dsh plugin --profile web add github:2239058652/dsh-loomy-connect
pnpm dlx @deepseek-ai/dsh plugin --profile web add github:2239058652/dsh-loomy-connect

从本地目录安装（改代码时）：

git clone https://github.com/2239058652/dsh-loomy-connect.git
cd dsh-loomy-connect
pnpm install
pnpm run build          # 仅改了 src/ 时需要，产物在 lib/
dsh plugin --profile web add /绝对路径/dsh-loomy-connect
dsh web

验证：

dsh --profile web --dump-config     # 应出现 llm-loomy 条目

--dump-config 只组合配置树，不实例化插件。确认插件能否真正启动，需运行 dsh web 后检查模型选择器中是否出现 Loomy。

配置¶

路径按平台自动探测，一般无需配置。以下覆盖项面向非标准安装。

环境变量：

• LOOMY_AUTH_FILE：登录态 auth-session.json 路径。
• LOOMY_CONFIG_FILE：模型清单 opencode.json 路径。
• LOOMY_LOCAL_STORAGE_DIR：积分缓存 Local Storage/leveldb 目录。

优先级：插件配置（authFile / configFile）→ 环境变量 → 探测到的默认值。

默认路径按 macOS / Windows 顺序探测，取第一个存在的：

安全边界¶

威胁模型：防御本机其他进程与浏览器中运行的网页；不防御以同一用户身份运行的代码——其可读取插件所读的同样文件。

已知限制¶

• 依赖 Loomy 的客户端接口（非官方开放 API），Loomy 更新后插件可能需要随之调整。
• 模型清单与倍率取自 Loomy 的接口；接口不可达时回落到 Loomy 生成的配置文件，两者都不可用时才使用内置快照。
• 积分读自 Loomy 的本地缓存，Loomy 未公开积分接口；缓存不存在时卡片不显示积分，而非显示 0。
• 模型清单在启动时读取，Loomy 侧增删模型后需重启 DSH 才会同步。
• Windows 下若登录态路径未被探测到，需通过 LOOMY_AUTH_FILE 手动指定。

适用场景与注意¶

适合希望在 DSH 中使用 Loomy 桌面应用内置模型、且希望减少 API Key 管理的开发者与使用者。使用前应：

• 确认 Loomy 已登录，且已至少使用过一次。
• 检查 DSH 版本是否在 >= 0.2.1-rc.2 < 0.3.0 范围内。
• 阅读 LICENSE 与免责声明：本项目仅供个人学习和研究使用，仅驱动使用者本人的 Loomy 账号在本机调用，请勿用于商业用途或超出个人合理使用的场景；使用者须遵守 Loomy 服务条款；本项目与 Loomy、讯飞、DeepSeek 均无关联，未获其授权或认可。

结语¶

DSH Loomy Connect 在不触碰 Loomy 文件的前提下，把桌面应用的模型能力引入 DSH 的工作流，适合习惯在 Loomy 中使用、又希望在 DSH 中统一调度的场景。更多细节与实现记录可参考 README 与相关文档。

• 插件目录页：https://www.skillhub.cn/plugins/2239058652/dsh-loomy-connect
• GitHub 仓库：https://github.com/2239058652/dsh-loomy-connect