快速了解
它能做什么
无需单独 API Key，将本机已登录 Loomy Desktop 的模型接入 DeepSeek Harness。
本站提供的是中文说明，不代表该项目或 Plugin 自身提供中文界面；语言支持请以上游文档为准。
Web Profile
>= 0.1.5-rc.1
证据已验证
核对日期 2026/9/11 UTC 14:18
选择前先看
该 DeepSeek Harness Bundle 会在 web 配置中注册 Loomy 提供方，并发现你的 Loomy Desktop 账号可用的文本输出模型。“插件配置”卡片可显示账号状态、脱敏手机号、积分以及模型倍率和上下文窗口等信息。
适合谁
已在同一台电脑安装并登录 Loomy Desktop 的 DeepSeek Harness 用户。
常见任务
- 把 Loomy 文本模型加入 DeepSeek Harness 的模型选择器。
- 查看本机可用 Loomy 模型、积分倍率和上下文窗口。
- 在“插件配置”中查看 Loomy 登录状态及本地缓存的积分信息。
权限与数据
读取本地 Loomy 文件以发现账号会话、模型清单，以及可选的本地缓存积分信息。
权限- 读取 Loomy 登录状态、模型配置和本地存储路径。
- 在 DeepSeek Harness 的 web 配置中注册 Loomy 提供方。
- README 声明登录状态和模型数据均为只读：不会复制、上传或改写。
- README 声明 Loomy 会话令牌仅按需从磁盘读取，DSH 不会持有该令牌。
- 通过 Loomy 客户端接口获取可用模型信息；README 说明这不是官方公开 API。
- 未描述需要单独 API Key。
- 需要已至少登录过一次的 Loomy Desktop。
局限
- 需要 DeepSeek Harness >=0.1.5-rc.1 和 Node.js >=22。
- Loomy 侧模型变化后，需要重启 DSH 才会刷新模型列表。
- 本地没有积分缓存时，卡片会省略积分，而不是显示为 0。
- Windows 上未探测到登录状态路径时，可能需要设置 `LOOMY_AUTH_FILE`。
- 项目声明仅供个人学习和研究使用，且与 Loomy、讯飞和 DeepSeek 无关联。
DSHub 已核对
- 已验证固定 Git 源和 Bundle 结构。
- 包声明了向配置插入 `llm-loomy` 提供方的 web 配置补丁。
- README 提供了 GitHub 安装和配置导出验证方式。
DSHub 未核对
- 尚未实际执行安装或启动。
- 尚未运行时测试模型发现、账号展示、积分展示或请求路由。
- 未找到版本 0.1.9 的 npm 注册表分发。
固定版本安装
安装 DSH Loomy Connect
这个Plugin Bundle没有 DSH Plugin 安装操作，请根据源码文档使用真实交付方式。
维护者原文
项目 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）。
有意识地管理
安装与管理
前置条件与目标 Profile
目标： Web Profile
交付方式： Git Bundle — gdrpzym/dsh-loomy-connect#6d25d561a60962b5883bc0141c54b9ababbb7d72。
验证、更新与移除
显示生命周期命令
dsh plugin --profile web list兼容性与访问范围
Requires Loomy Desktop, DSH >=0.1.5-rc.1, and Node.js >=22： >= 0.1.5-rc.1。
风险事实
证据与编辑审查Manifest、Bundle patch、分发与新鲜度
不可变证据
审查状态与源码活动
建议使用固定的 Git 源路径安装；安装前请自行确认 Loomy 服务条款及本地文件访问是否符合你的预期。
AI 审查于 2026/9/11 UTC 14:19。GitHub 事实核对日期： 2026/9/11 UTC 14:19。
自当前证据基线以来，没有记录到重要源码变化。