At a glance
What it does
Use models from a locally signed-in Loomy Desktop app in DeepSeek Harness without a separate API key.
Web Profile
>= 0.1.5-rc.1
Evidence-verified
Checked Sep 11, 2026, 2:18 PM UTC
Code-evidenced contributions
What it adds to DSH
Discovers text-capable models available to the locally signed-in Loomy Desktop account and adds them to DeepSeek Harness.
Mechanism evidence ↗Shows sign-in state, a masked phone number, credits, and available-model details in Plugin Settings.
Mechanism evidence ↗Before you choose it
This DeepSeek Harness bundle registers a Loomy provider in the web profile and discovers text-output models available to your Loomy Desktop account. Its Plugin Settings card can show account status, masked phone number, credits, and model details such as multipliers and context windows.
Best for
DeepSeek Harness users who already have Loomy Desktop installed and signed in on the same computer.
Common tasks
- Add Loomy text models to the DeepSeek Harness model picker.
- Check the locally available Loomy model list, multipliers, and context windows.
- View Loomy sign-in status and locally cached credit information in Plugin Settings.
Permissions and data
Reads local Loomy files to discover the account session, model list, and optionally cached credit information.
Permissions- Read access to Loomy login-state, model-configuration, and local-storage paths.
- Registers a Loomy provider in the DeepSeek Harness web profile.
- The README states that login state and model data are read-only: they are not copied, uploaded, or rewritten.
- The README states that the Loomy session token is read from disk on demand and is not retained by DSH.
- Uses Loomy client interfaces to obtain available-model information; the README says these are not an official public API.
- No separate API key is described.
- Requires a Loomy Desktop installation that has been signed in at least once.
Limitations
- Requires DeepSeek Harness >=0.1.5-rc.1 and Node.js >=22.
- Loomy-side model changes require restarting DSH to refresh the list.
- If local credit cache data is unavailable, the card omits credits rather than showing zero.
- On Windows, nonstandard login-state paths may require `LOOMY_AUTH_FILE`.
- The project states it is for personal learning and research, and is unaffiliated with Loomy, iFlytek, or DeepSeek.
What DSHub checked
- Pinned Git source and bundle structure were verified.
- The package declares a web-profile patch that inserts the `llm-loomy` provider.
- The README documents GitHub installation and configuration-dump verification.
What DSHub did not check
- Actual installation and startup were not executed.
- Model discovery, account display, credit display, and request routing were not runtime-tested.
- Registry distribution for package version 0.1.9 was not found.
Pinned install
Install DSH Loomy Connect
This plugin bundle does not have a DSH Plugin install action. Use its source documentation for the delivery method.
Maintainer source
Project README
DSH Loomy Connect
简体中文 | English
将 Loomy 桌面应用内置的文本模型接入 DeepSeek Harness(DSH),无需 API Key。
插件以只读方式读取 Loomy 落盘的登录态与模型清单,不复制、不上传、不改写任何文件。
| 能力 | 位置 | 说明 |
|---|---|---|
| 模型 Provider | 宿主端 | 注册 loomy provider,模型列表在启动时从 Loomy 发现 |
| 设置卡片 | 浏览器端 | 设置 → 插件配置 下分「账户」「模型」两个标签页:账户展示登录态、脱敏手机号与积分余额;模型列出名称、类型、倍率与上下文窗口 |
目录
功能
- 零配置:安装启用后,Loomy 的模型直接出现在 DSH 的模型选择器里。
- 模型自动发现:启动时拉取当前账号可用的模型清单,只纳入支持文本输出的模型。
- 倍率与优惠:设置卡片的「模型」标签页列出全部模型及各自的积分倍率(如
x3.0、限时免费),数据随 Loomy 侧调整而变化。 - 账号与积分:卡片顶部状态行显示当前登录账号(脱敏手机号),「积分」标签页显示永久积分与每日赠送积分——数值取自 Loomy 自身展示所依赖的同一份数据。
- 模型明细:设置卡片的「模型」标签页列出每个模型的名称、类型(对话 / 图像)、积分倍率以及上下文窗口大小(若 Loomy 的清单提供了该字段)。
- 中英双语:卡片文案跟随 DSH 界面语言。
安装
| Loomy 桌面应用 | 已安装,且至少登录过一次 |
| DeepSeek Harness | >= 0.1.5-rc.1 |
| Node.js | >= 22 |
从 GitHub 安装:
dsh plugin --profile web add github:gdrpzym/dsh-loomy-connect
dsh web
从本地目录安装(开发时推荐,无需发布步骤):
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 顺序探测,取第一个存在的:
| 平台 | 登录态 | 模型清单 | 积分缓存 |
|---|---|---|---|
| Windows | %APPDATA%/loomy/auth-session.json |
%APPDATA%/loomy-opencode/opencode.json |
%APPDATA%/loomy/Local Storage/leveldb |
安全边界
| 边界 | 机制 |
|---|---|
| 网络暴露面 | 网关仅绑定 127.0.0.1 |
| 客户端鉴权 | 进程内随机密钥,timingSafeEqual 比较 |
| DNS 重绑定 | Host 必须为 loopback |
| 跨站简单请求 | 携带 Origin 时须为 loopback;请求体须为 application/json |
| Token 保管 | Loomy session token 仅在网关内按需从磁盘读取,DSH 不持有 |
威胁模型:防御本机其他进程与浏览器中运行的网页;不防御以同一用户身份运行的代码——其可读取插件所读的同样文件。
已知限制
- 依赖 Loomy 的客户端接口(非官方开放 API),Loomy 更新后插件可能需要随之调整。
- 模型清单与倍率取自 Loomy 的接口;接口不可达时回落到 Loomy 生成的配置文件,两者都不可用时才使用内置快照。
- 积分读自 Loomy 的本地缓存,Loomy 未公开积分接口;缓存不存在时卡片不显示积分,而非显示 0。
- 模型清单在启动时读取,Loomy 侧增删模型后需重启 DSH 才会同步。
- Windows 下若登录态路径未被探测到,需通过
LOOMY_AUTH_FILE手动指定。
故障排查
| 现象 | 原因 |
|---|---|
| 「插件配置」下始终无卡片 | 宿主端未注册命名空间,见 docs/internals.md 第 4 项 |
| 插件列表有条目但无卡片 | 同上——「插件」tab 反映已安装条目,非已提供命名空间 |
启动时报 Cannot read properties of undefined (reading 'authFile') |
缺少运行时 Config 导出,见 docs/internals.md |
| Loomy 已登录,卡片显示未登录 | 登录态路径未探测到,设置 LOOMY_AUTH_FILE |
每次对话请求均 502 |
网关读不到有效 session,多为登录态路径问题 |
| 模型列表陈旧 | 重启 DSH 或触发一次配置变更 |
| 积分为空 | Loomy 尚未缓存积分摘要,或 LOOMY_LOCAL_STORAGE_DIR 配置有误 |
深入文档
架构、网关、浏览器卡片的实现约束与踩坑记录见 docs/internals.md(英文版 docs/internals.en.md)。
许可
免责声明
- 本项目仅供个人学习和研究使用,仅驱动使用者本人的 Loomy 账号在本机调用,请勿用于商业用途或超出个人合理使用的场景。
- 使用者须遵守 Loomy 服务条款;因使用本项目产生的一切后果(包括但不限于账号被限制、额度被清空、服务中断)由使用者自行承担。
- 作者不对因使用或滥用本项目导致的任何直接或间接损失负责。
- 本项目与 Loomy、讯飞(iFlytek)、DeepSeek 均无关联,未获其授权或认可;文中名称仅用于描述兼容关系,商标权利归各自所有者。
致谢
DSH provider 架构参考 dsh-workbuddy-connect(MIT)。
Operate deliberately
Install and manage
Prerequisites and target Profile
Target: Web Profile
Delivery: Dsh Bundle Git — gdrpzym/dsh-loomy-connect#6d25d561a60962b5883bc0141c54b9ababbb7d72。
Verify, update, and remove
Show lifecycle commands
dsh plugin --profile web listCompatibility and access
Requires Loomy Desktop, DSH >=0.1.5 Rc.1, and Node.js >=22: >= 0.1.5-rc.1。
Review compatibility evidence ↗
Risk facts
Reads Loomy login state and local cached account/model data
Evidence ↗Relies on Loomy client interfaces that may change
Evidence ↗Documents a local gateway bound to loopback only
Evidence ↗Evidence and editorial reviewManifest, Bundle patch, distribution and freshness
Immutable evidence
Review status and source activity
Use the immutable Git source path. Review Loomy's terms and your local-file access expectations before installing.
AI reviewed Sep 11, 2026, 2:19 PM UTC。GitHub facts last checked Sep 11, 2026, 2:19 PM UTC。
No material source change has been recorded since this evidence baseline.