玲珑应用商店 Agent Skill

目的与范围

提供面向玲珑应用商店的完整操作流程与约束，覆盖在线应用搜索、应用详情、安装与升级、更新检查、统计上报与意见反馈。依赖 Web API 获取在线数据，依赖 ll-cli 完成安装与升级。

使用时机

在用户提出以下需求时触发：

•搜索、筛选、浏览应用或分类
•查看应用详情、版本或架构
•安装、卸载、升级应用
•检查更新、批量升级
•提交意见反馈

操作原则

•使用 Web API 获取在线应用列表与搜索结果，禁止使用 ll-cli search。
•所有后端接口尽量用 curl 调用，保持 0 依赖。
•默认 arch 为 x86_64，用户明确指定时再覆盖。
•多版本、多架构、多模块存在时，先展示并要求用户确认。
•安装或卸载完成后，调用统计上报接口。
•安装失败时记录 ll-cli 输出摘要，并参考 GUI 商店实现的错误映射或提示逻辑（路径：/home/han/linglong-store/rust-linglong-store）。

集成实现要点

•优先读取 GUI 商店对 /app/saveInstalledRecord 的字段定义并保持一致。
•构造请求体时使用最小必要字段起步，再补齐 GUI 商店的扩展字段。
•统一封装 curl 调用，确保输出可解析并保留 HTTP 状态码与响应体。
•ll-cli 命令输出需要截取关键失败摘要并保留原始日志用于排障。
•交互流程中如需展示结果列表，固定输出 appId 供用户确认。

工作流

1) 搜索与发现

•解析用户关键词、分类、语言、架构、分页等条件。
•调用 /visit/getSearchAppList 时必须传 arch 与 repoName，否则会返回空列表；默认 arch=x86_64、repoName=stable。
•
若用户指定“分类/类目”：
- •调用分类列表接口（/web/categories 或 /visit/getDisCategoryList）获取 categoryId。
- •可选调用 /web/getCategoryAppCount 获取分类应用数量并提示分页。
- •使用 categoryId 作为过滤条件调用 /visit/getSearchAppList。
•若用户指定关键词：使用 name/zhName 作为条件调用 /visit/getSearchAppList。
•返回候选列表后，展示：名称、appId、版本、架构、描述。
•若无结果，提示更换关键词或减少筛选条件。

参考：references/api.md 的 /web/categories、/visit/getDisCategoryList、/web/getCategoryAppCount、/visit/getSearchAppList。

2) 查看应用详情

•用户给出 appId 或从搜索结果中选择。
•调用详情接口（优先新版 /app/getAppDetail）。
•返回关键字段：截图、标签、描述、版本、架构、运行时等。

参考：references/api.md 的 /app/getAppDetail。

3) 安装应用

•先通过搜索接口确认 appId，若有多个候选先让用户选择。
•
组装安装命令：
- •基本安装：ll-cli install <appid>
- •指定版本：ll-cli install <appid/version>
- •指定模块：ll-cli install <appid> --module=<module>
- •指定仓库：ll-cli install <appid> --repo=<repo>
- •强制指定版本：ll-cli install <appid> --force
- •自动确认：ll-cli install <appid> -y
- •文件安装：ll-cli install <path>.uab 或 ll-cli install <path>.layer
•执行安装后读取结果摘要，给出成功或失败原因。
•安装完成后调用安装统计上报。

参考：references/cli.md 与 references/telemetry.md。

4) 更新检查与升级

•使用 ll-cli list 获取已安装应用列表。
•优先运行脚本 scripts/linglong_update_checker.py 完整检查并生成报告。
•若需自行调用接口，按 references/api.md 的 /app/appCheckUpdate 组织请求体。
•列出可更新应用，询问用户升级全部或指定应用。
•执行升级：ll-cli upgrade 或 ll-cli upgrade <appid>。

快速示例（仅输出可更新应用ID）：

bash

python3 .agents/skills/linglong-store/scripts/linglong_update_checker.py --action ids

参考：references/api.md、references/cli.md、references/update-checker.md。

5) 卸载应用

•使用 ll-cli uninstall <appid>（若需，先确认安装列表）。
•卸载完成后调用统计上报，字段与 GUI 商店一致。

参考：references/telemetry.md。

6) 意见反馈

•直接使用 Web 反馈接口提交用户内容。