常见问题

先在这里找答案,找不到再去社区提 Issues 或 Discussions。

插件详情页下载数不动?

下载数来自 GitHub 下载统计,每小时更新一次,不是实时计数。刚发布的版本
等一小时再看。

插件安装失败?

按顺序查:

1. 作者的 release 是不是正式版——draft 或 prerelease 不会被 releases/latest
   命中,特征是连版本探测都失败。
2. 三个资产齐不齐(<id>-<version>.zip、<id>.zip、manifest.json),缺一
   个都装不上。
3. 报错 integrity 不符 = 下载的字节和 manifest 对不上,换个网络重试,排除
   代理篡改。
4. 钉版本条目(tag + sha256)报错 = 字节和钉住的哈希对不上,联系作者确认。

应用打不开 / 白屏?

• 先确认安装包和系统匹配(Apple 芯片下 Intel 包、反之亦然都可能起不来),
  下载页每张卡片都标了架构。
• 未签名拦截不是 bug,按新手入门的放行步骤操作。
• 离线本身不影响本地功能,但市场、版本探测、模型请求都要网,先查网络。

登录/邮件问题?

统一见账号与登录最后一节:垃圾箱、限流等待、
链接过期重发。

模型任务失败?

• 先看服务商返回的原文:401/403 查 key 和余额,429 降并发等一会儿。
• 再看路由:当前任务有没有启用的模型,详见
  模型与服务商配置。
• 本地模型(Ollama 类)先确认本地服务在跑,地址填对。

Windows 和 macOS 有差异吗?

有三处:未签名放行位置不同、深链协议注册方式不同(生产版由安装程序写入,
开发版需手动注册)、路径分隔符不同(插件作者才需要关心)。功能层面没有差异。