dsh-loomy-connect
无需配置，即可在 DeepSeek Harness 中使用 Loomy 桌面应用附带的模型。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gdrpzym/dsh-loomy-connect#436ea57d7dab6ca60eaa280018edc00dfb20fc7aLoomy Connect 以 dsh-loomy-connect 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 | English
将 Loomy 桌面应用内置的文本模型接入 DeepSeek Harness（DSH），无需 API Key。
插件以只读方式读取 Loomy 落盘的登录态与模型清单，不复制、不上传、不改写任何文件。
| 能力 | 位置 | 说明 |
|---|---|---|
| 模型 Provider | 宿主端 | 注册 loomy provider，模型列表在启动时从 Loomy 发现 |
| 设置卡片 | 浏览器端 | 设置 → 插件配置 下分「账户」「模型」两个标签页：账户展示登录态、脱敏手机号与积分余额；模型以表格列出名称、上下文窗口与倍率，图像模型排在最后 |
x3.0、限时免费），数据随 Loomy 侧调整而变化。| 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_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）。
DSH provider 架构参考 dsh-workbuddy-connect（MIT）。