浏览实践手册文档实践指南社区搜索商店博客

2026-10-17

诊断商店空白与安装失败

先分清目录请求、仓库检查、安装和启动,再选择修复方式。

本页目录从失败边界开始依次回答四个问题完整例子:仓库读取失败让别人可以复现的问题报告来源与下一步
先定位失败的位置;完整步骤与结果见下文。
玲珑编辑原创图示,依据已取得的 3.7.0 发布文件与版本化项目文档;下文提供完整文字说明。

从失败边界开始

浏览器目录与本机运行环境可以分别失败。此次恢复中,旧镜像 API 返回 HTTP 200,但 list 为 null、total 为 0;新的公开商店 API 能返回记录。这只能证明旧服务返回空数据,不能证明生态没有软件,也不能证明访问者的机器出了问题。

依次回答四个问题

  1. 目录请求返回有效记录、明确的空结果、超时,还是错误?
  2. 本机是否存在命令,安装的具体版本是什么?
  3. 本机包管理器能否读取仓库配置?
  4. 是安装失败,还是安装完成后无法打开应用?
ll-cli --version
ll-cli --help
ll-cli --json repo show

最后一条命令来自 3.7.0 商店环境检测的源码文档。如果本机版本不支持,应停止并查对应版本手册。记录输出和退出码,不要把空白界面直接当作诊断结论。

完整例子:仓库读取失败

源码描述了 ll-cli 已安装、但包管理器系统服务不可用,导致仓库检查失败的情形。这与未配置仓库不同。客户端恢复需要用户明确操作与本地授权;本站不会重启服务,也不提供通用 root 修复脚本。

让别人可以复现的问题报告

商店版本:
发行版与处理器:
ll-cli 版本:
任务:浏览 / 检查仓库 / 安装 / 启动
应用 ID 与仓库:
失败的完整命令或 URL:
退出码与原始错误:
预期结果:
实际结果:
复现步骤:
已移除的敏感信息:

源码区分原始机器错误与翻译后的提示。复现时保留原始错误,分享前检查令牌、个人路径与标识符。修复进程成功结束后,仍需重新尝试最初失败的任务。

玲珑商店 3.7.0 发布原始配图
原始配图来源:Deepin / Linyaps Simple Store SIG, 2026-10.

来源与下一步

版本化项目参考 · 3.7.0 release · 打开恢复后的商店

玲珑编辑 · 2026 年 10 月 17 日。这里提供可复用的流程与工作表,不宣称完成了安装测试或性能测试。