把故障变成可复现的问题

找到第一个失败的边界

命令不存在、软件源下载失败、构建失败、应用没有出现窗口，是不同的问题。从最早失败的步骤开始。反复重装无关依赖，可能把最有用的现场证据一起改变。

先收集最小基线

ll-cli --version
ll-cli list
ll-cli ps

构建问题还需记录 ll-builder --version 与相关清单。添加参数前检查对应版本的帮助。记录发行版、版本与架构即可，不必公开机器主机名或无关个人信息。

缩小问题范围

1. 保留一个应用 ID、一份清单和一条命令。
2. 复制完整错误，包含最后一行失败消息前的相关内容。
3. 分别说明预期行为和真实结果。
4. 比较同一个包从命令行和桌面入口启动的结果。
5. 只附上复现问题必需的最小文件。

怎样描述一个真实例子

“应用坏了”不足以定位问题。更有帮助的描述是：“应用 ID X 安装完成；执行命令 Y 返回错误 Z，没有出现窗口；ll-cli 版本是 V。”X、Y、Z、V 都应填写真实输出，并不是本文提供的测试结论。如果命令行启动正常而桌面入口失败，应先检查桌面集成，不能直接认定下载的软件包损坏。

分享前检查敏感信息

去掉令牌、私有软件源地址、个人目录名、文档正文和无关进程信息。检查截图里是否有账户资料，不要直接发布完整环境变量转储。本站工具不会收集或上传你的诊断数据。

可复制的问题报告

问题摘要：
发行版、版本与架构：
ll-cli / ll-builder 版本：
应用 ID 与软件包版本：
完整命令：
最小复现步骤：
预期行为：
实际行为与错误：
经过脱敏的相关日志：
问题出现前的改动：

提交新问题前，先搜索相同错误与版本。已有 issue 可以作为线索，但旧的解决方法不一定适用于新版本。

查看 Linyaps 项目问题列表