概览
dsh-workbuddy-connect
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **本版验证环境**:Windows + DSH Web。已验证真实登录(国内版与国际版都能取到授权链接,轮询状态正确)、`workbuddy.json` 导入、两版账号与积分各自独立读取;设置卡片在折叠/悬停/展开各状态下与 DSH 内置卡片逐属性样式一致。其余平台未在本版复跑。 - 要求 DSH `0.1.5-rc.1`+、Node 22+;TUI 需终端界面插件 `0.10.0-beta.5` 及以上(见安装章节)。凭据由插件自己登录获得,与 WorkBuddy 桌面 App 是否安装、装在哪里都无关。 - **国际版登录在部分网络下不可达**:`www.workbuddy.ai` 在国内部分网络无法访问,此时国际版登录会失败并报出原因,国内版不受影响。 - **国际版的模型目录来自 App 界面接口**:服务端按 User-Agent 分流下发,属私有实现,上游改动可能使其失效。届时插件按「本账号上次成功目录 → 内置目录」降级,并在卡片上标明来源(实时 / 已保存 / 内置)、更新时间与失败原因,但不能保证长期兼容。国内版目录走官方 CLI 同款接口,不受此影响。 - **国际版目录的 User-Agent 版本**:Windows / WSL / Linux 下读不到国际版 App 的版本,会退回最近保存的版本或内置值;这与登录无关,登录不依赖桌面 App。 - **无凭据时的行为**:某一版从未登录过时,该版模型分组不显示——此时该版没有可用凭据,列出模型只会让每一次调用都失败。登录后分组立即出现。 - **侧栏额度展示的请求节流**:额度卡片与明细页共享同一份数据并按设定的间隔节流——间隔内重开页面或面板直接复用缓存,不会重复请求计费接口;点击明细页的「刷新」可跳过间隔强制获取。刷新间隔过短会显著增加对计费接口的请求频率,请酌情设置。 - **企业账号积分目前仅覆盖国内版**:国际版企业账号的计费接口尚未验证,仍按个人版接口读取;待有实测结论后再扩展。企业账号分支在本机无法自测(开发机为个人账号),依据官方 App 的接口契约实现,欢迎企业账号用户反馈实测结果。 - 依赖 WorkBuddy 客户端接口(非官方开放 API),WorkBuddy 更新后插件可能需要随之调整。
