DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-plugin-loomy

d

dsh-plugin-loomy

Manifest valid

Loomy Gateway DSH Plugin: Add loomy2api models as optional models in DSH, manage account pools via the left sidebar panel, and support per-model enable/disable toggles

UI (client)hasBundlePatch

dsh-plugin-loomy

仓库:https://github.com/Sladewww/dsh-plugin-loomy · 标签:dsh-plugin dsh-plugins dsh-plugin-market · 许可:MIT

把 loomy2api(MIT)改造为一个带左侧栏入口的 DSH 插件:

  • 添加模型到 DSH:从网关 /v1/models 拉目录,按启用清单写进 @deepseek-ai/dsh-llm-pi-ai 的自定义路由,模型出现在输入框的模型选择器里。
  • 逐个模型启用开关:面板里每行一个 role="switch" 开关,也可「全部启用 / 全部停用」。启用清单持久化在本插件的 Config(profile 的 cordis.patch.yml),用户不需要去「设置 → 模型」手动改。
  • 设置账号池:增删账号、启停、强制续期、查看额度、切换路由策略。
  • 客户端登录态扫描导入:扫描 Loomy 桌面客户端的 auth-session.json,勾选后一键导入为账号池里的持久账号(写入 accounts.json)。扫描结果脱敏,完整 session 只在 Host 内存里;支持自定义扫描根目录。

⚠️ 客户端只保留最后登录的那个账号:登录第二个会覆盖 auth-session.json。要导入多个账号,请逐个登录并分别扫描导入;已导入的持久账号不会因覆盖而丢失,扫描列表会把它们标为「已导入」并禁用勾选。

  • 内置网关:Python 源码随插件打包,Host 自动按需启动/停止,无需手工部署。
  • 跟随宿主明暗主题:全部颜色走 --dsw-alias-* token,亮色/暗色宿主下自动适配。

组成

文件作用
index.jsHost 半侧:Config、Python 子进程、/__loomy/v2/api/* HTTP 路由、模型启用同步
client.jsClient 半侧:sidebar.panellist 图标 + main 主面板(React,主题自适应)
gateway/内置 loomy2api 纯 Python 源码 + dsh_serve.py 启动包装
cordis.patch.ymlbundle 的 insert 行(默认 enabledModels: [])
locale/, icon.svg显示元数据

模型启用机制(重点)

面板点开关 ──POST /modelToggle──> Host
                                   ├── configEditor.edit(本插件 entry)
                                   │      └─> 写 cordis.patch.yml 的
                                   │          - id: loomy-gateway
                                   │            config:
                                   │              enabledModels: [...]
                                   └── configEditor.edit(llm-pi-ai entry)
                                          └─> 写 providers.loomy.models
                                              (只含启用项;全停则删该路由)
  • apply(ctx, config) 读取 config.enabledModels;configEditor.edit 会重启本插件,新 fiber 自动拿到新清单。
  • 「同步模型到 DSH」首次会默认全启用,之后保留用户手动调过的清单,只补进上游新增模型。
  • 全部停用时 providers.loomy 被整体移除(pi-ai 不允许空 models)。
  • 用户无需、也不应去「设置 → 模型」改这个路由——那里会被本插件的下一次开关操作覆盖。

网关生命周期

  • 重启后自动启动:autoStart 默认为 true。插件启用时探测 /health,已有 loomy2api 就认领(adopted),否则直接 spawn 新进程。可在面板「设置」里关掉;设置保存在 ~/.dsh/loomy/state.json,不存在时按默认 true 生效。
  • HTTP 路由重试注册:webServer 由 @deepseek-ai/dsh-host-webserver 提供,本插件 fiber 可能先于它激活(DSH 重启后加载顺序不保证)。一次性 ctx.get('webServer') 会拿到 undefined 且不再重试,导致面板所有接口 404。实现改为 500ms 间隔、最多 15 秒的有限重试,服务就绪即注册;ctx.effect 在卸载时清理定时器与路由。
  • configEditor.edit 会重启本插件,因此网关进程不能挂在 effect cleanup 上(否则切个开关就断服务)。故采用「存活即接管」而非 cleanup 杀进程。显式「停止」按钮仍会 kill(含接管来的进程,按端口查 PID)。

外观

面板跟随宿主明暗主题:所有颜色都走宿主的 --dsw-alias-* token(bg-base / bg-layer-1 / bg-layer-2 / label-primary / label-secondary / border-l1/l2 / brand-primary / 状态色等)。这些 token 在宿主切换明暗时自动换值,插件不写任何固定深/浅色,也不强制 color-scheme,因此亮色宿主下是亮色面板、暗色宿主下是暗色面板,原生控件(滚动条、placeholder、自动填充、select option)也一并跟随。

组件级 CSS 仅用于处理内联样式表达不了的原生控件细节,通过 styles.insert 注入(data-loomy-panel 作用域),同样只用 token,随插件卸载自动移除。

数据流

面板 ── fetch /__loomy/v2/api/* ──> Host 路由 ── HTTP 127.0.0.1:port ──> Python 网关 ──> 讯飞上游
                                       │
                                       └── configEditor.edit() ──> 两处 Config

静态 bundle 的 Client 没有 host.call,通信走同源 HTTP 路由(与官方 dsh-plugin-codegraph-panel 一致)。Host 路由校验 Origin 只允许 loopback。

状态位置

文件内容
~/.dsh/loomy/state.json插件设置(端口/Python/策略/默认模型/路由 ID/自动启动)
~/.dsh/loomy/config.json网关配置,由 Host 生成,含本地占位 key 与绝对路径
~/.dsh/loomy/accounts.json账号池,含明文密码/session
~/.dsh/loomy/logs/网关日志
profile 的 cordis.patch.yml模型启用清单(本插件那一行)+ pi-ai 路由配置

网关只绑 127.0.0.1,本地 API key 是固定占位值(非真实 secret)。账号文件按上游设计是明文,请保护该目录,仅用于你自己的账号。

安装

在 DSH 里安装本插件(三选一):

  • 插件市场 / Discover:搜索 dsh-plugin-loomy(若索引已收录)。
  • 本地目录:把本仓库 clone 到任意目录,在 DSH 插件管理里用 install_bundle 指向该目录,或直接让 Agent 执行 plugin_manager install_bundle 传绝对路径。
  • Git 依赖:在 profile 的 package.json 加 "dsh-plugin-loomy": "github:Sladewww/dsh-plugin-loomy",并在 dsh.profile.bundles 里加入包名,重启 DSH。

依赖:Python 3.9+(仅标准库,无需 pip install)、DSH >= 0.2.0。

使用

  1. 安装并启用 dsh-plugin-loomy;左侧栏出现「Loomy 网关」图标。
  2. 打开面板 →「服务」→「启动」。若 Python 未找到,去「设置」填 Python 3.9+ 的绝对路径。
  3. 「账号池」→「添加账号」:手机号 + 讯飞账号中心设置的密码(或粘贴 32 位 session)。
  4. 「模型」→「同步模型到 DSH」→ 用开关挑要启用的模型。
  5. 去输入框的模型选择器选 loomy 路由下的模型;「测试对话」可确认链路(消耗点数)。

故障排查

现象处理
端口不可用 / WSAEACCESWindows 有系统预留端口段,在「设置」里换端口(如 17891)
找不到 Python在「设置」里填绝对路径
同步模型报「pi-ai 条目不可编辑」检查「设置」里的诊断信息,确认 llm-pi-ai 在 configEditor.entries() 里
模型目录为空确认账号池至少有一个可用账号;无账号时上游会返回内置兜底清单
切开关后网关断了本版本已修(存活即接管);若仍遇到,点「启动」会接管现有进程
重启 DSH 后面板接口 404旧版本一次性取 webServer,启动顺序晚到就永久不注册;本版本已改为有限重试。若仍 404,看「设置 → 诊断」,或 set_plugin 关→开一次
重启后网关没起来确认 autoStart 为 true(默认);state.json 里若曾被设为 false 会尊重该值
WSL 下扫描不到登录态 / 导入报失败本版本会按平台自动探测根目录:WSL 走 /mnt/c/Users/Public/Loomy,Windows 走 C:\Users\Public\Loomy。客户端装在其他盘时在「账号池」填路径并点「保存为默认目录」(写入 state.json)。若 WSL 里 loomyad.xunfei.cn:443 直连 TLS 握手超时,在「设置 → 上游代理」填系统代理(如 http://127.0.0.1:7890);额度查询超时默认 5 秒且改为后台执行,不会再让 add_account 挂满 30 秒。出现「报失败但账号其实已导入」时重扫一次看「已导入」标记即可

上游与许可

  • 本项目(Host / Client / 启动包装 / 文档):MIT,见 LICENSE,Copyright (c) 2026 Sladewww。
  • 内置 gateway/loomy2api/ 源码来自 Patrick130306/loomy2api,同样为 MIT;其原始许可文本逐字保留在 LICENSES/loomy2api-LICENSE,第三方声明见 NOTICE。未改动上游 Python 逻辑,只增加了 gateway/dsh_serve.py 启动包装,把 config.json / accounts.json / 日志重定向到用户数据目录,避免写进插件包。

本插件与科大讯飞 / Loomy 无关联,仅供自有账号的互操作使用。请勿用于滥用、转售或压测上游服务。

Comments

Loading…