DSH Loomy Connect：零配置接入 Loomy 内置模型

前言¶

DeepSeek Harness（DSH）采用“一切皆插件”的架构。开发者在对接本地桌面应用或特定模型时，常面临配置繁琐或缺乏 API Key 的问题。DSH Loomy Connect 解决了这一痛点，它允许你直接使用 Loomy 桌面应用内置的文本模型，无需额外申请 API Key。

是什么¶

DSH Loomy Connect 是一个插件，由 gdrpzym 维护。它以只读方式读取 Loomy 落盘的登录态与模型清单，将其注册为 DSH 的一个模型 Provider。

核心功能¶

1. 零配置
   安装并启用后，Loomy 的模型会直接出现在 DSH 的模型选择器中，无需手动配置参数。

2. 模型自动发现
   插件在启动时会拉取当前 Loomy 账号可用的模型清单，并自动过滤出支持文本输出的模型。

3. 账号与积分管理
   在 DSH 的设置卡片中，顶部状态行显示当前登录账号（脱敏手机号）。
   「积分」标签页显示永久积分与每日赠送积分，数据取自 Loomy 自身展示的数据源。

4. 模型明细
   在设置卡片的「模型」标签页，以三列表格展示每个模型的名称、上下文窗口大小（若清单提供）与积分倍率（如 x3.0、限时免费）。

5. 中英双语
   卡片文案跟随 DSH 界面语言自动切换。

安装与启用¶

在使用前，请确保环境满足以下条件：
* 已安装并登录过 Loomy 桌面应用。
* DeepSeek Harness 版本需 >= 0.1.5-rc.1。

执行以下命令进行安装：

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

安装完成后，启动 DSH Web 服务：

dsh web

验证插件是否生效，可以运行配置导出命令：

dsh --profile web --dump-config

在输出中找到 llm-loomy 条目即表示注册成功。随后在模型选择器中查找 Loomy 即可。

配置与注意事项¶

路径配置¶

插件默认会自动探测 Loomy 的数据路径，一般情况下无需手动配置。若遇到路径探测失败（例如 Windows 下登录态未探测到），可通过环境变量覆盖：

• LOOMY_AUTH_FILE：登录态文件路径
• LOOMY_CONFIG_FILE：模型清单文件路径
• LOOMY_LOCAL_STORAGE_DIR：积分缓存目录

安全边界¶

该插件以当前 DSH 进程的权限运行，设计上具有以下安全特性：
* 只读操作：仅读取 Loomy 落盘的文件，不复制、不上传、不改写任何文件。
* 本地网关：内部网关仅绑定 127.0.0.1。
* 鉴权机制：客户端鉴权使用 timingSafeEqual 比较。

限制与注意事项¶

1. 依赖 Loomy：必须依赖 Loomy 的客户端接口，若 Loomy 更新导致接口变化，插件可能需要调整。
2. 数据同步：模型列表仅在启动时拉取。Loomy 侧增删模型后，需重启 DSH 才会同步。
3. 积分缓存：积分读自 Loomy 的本地缓存。若缓存不存在，卡片将不显示积分，而非显示 0。
4. 使用范围：仅供个人学习和研究使用，请勿用于商业用途。

结语¶

DSH Loomy Connect 实现了从本地桌面应用到 DSH 的无缝接入。对于已经在使用 Loomy 的开发者，这是一个无需额外 API Key 即可利用现有资源的便捷方案。

• GitHub 仓库
• 社区目录