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

2026-10-17

让命令与版本保持一致

用一份迁移工作表,比较 Linglong 不同文档世代的工作流程。

本页目录把版本写在命令旁边修改前留下清单一次比较一个任务一个可执行的比较结构
清单: 程序版本、应用与用户数据; 比较: 对应参考文档与本地 --help; 测试: 在隔离环境验证一个任务; 记录: 实际结果与回退方案
玲珑编辑制作的流程示意图,四个阶段的操作详见正文。

把版本写在命令旁边

本站保留 1.5.0 与 1.6.3 文档,并提供 1.14.x 当前参考。2023 年文章中的命令能执行,不代表其中的选项、runtime ID 或软件源地址今天仍然适用。请先检查已安装程序的版本与帮助。

ll-cli --version
ll-cli run --help
ll-builder --version
ll-builder build --help

修改前留下清单

使用 ll-cli list 和 ll-cli ps 记录已安装应用与运行实例。为清单文件保留版本记录或本地副本,并写明 base/runtime ID 的来源。用适合该应用的方法备份重要数据;软件包列表并不是用户数据备份。

一次比较一个任务

  1. 打开已安装版本的参考。
  2. 明确任务:搜索、安装、运行、构建或导出。
  3. 阅读目标版本里对应的页面。
  4. 逐项比较参数名称、输出格式、运行时与软件源要求。
  5. 在隔离测试环境里运行最小例子,记录真实结果。

一个可执行的比较结构

例如,任务是“运行已经安装的应用”。保持应用 ID 不变,对照不同版本的 run 文档与本机 --help 输出,填写该版本真正需要的参数。不要把旧文档里的选项与新版本的运行时 ID 拼成混合命令。

任务:运行已安装应用
当前程序版本:
当前命令与帮助来源:
目标文档版本:
发生变化的参数:
运行时、基础环境或软件源变化:
测试环境:
真实观察结果:
回退与数据保护方案:

版本导航只连接已经取得的对应文档,缺失页面不会被伪装成完整翻译或制造成等价页面。

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