fix: 首装核验复用原始资料并消除 manage 示例误导 (#13)

This commit is contained in:
2026-09-19 12:46:59 +08:00
committed by GitHub
parent bd4bf36bce
commit 779ef2712d
4 changed files with 35 additions and 29 deletions

View File

@@ -1,7 +1,7 @@
---
name: 应用安装管理
description: 安装、升级、卸载或检查应用;读取固定资料,复用执行工具核验后记录结果。处理 ApplicationManagement 请求;旧服务 RegistryCatalogAcquisition 请求按需读取兼容指南。
version: "1.5.0"
version: "1.5.1"
requiredClientVersion: "10.0.170"
type: procedural
risk_level: high
@@ -12,7 +12,7 @@ provides:
tags: [installation, registry, app-management]
metadata:
author: desirecore
updated_at: "2026-09-18"
updated_at: "2026-09-19"
---
# 应用安装管理
@@ -34,6 +34,6 @@ Agent 理解环境并执行;已有工具提供能力;Agent Service 只可靠
3. 复用 Read、HttpRequest、Bash/PowerShell 等当前已授权工具。`provides.tools` 仅提示按需披露,不授予权限;没有可靠授权通道时停止,不能读取管理 token 或改用本机文件绕过。
4. 可以依据环境适配命令;版本、来源、设备和影响范围变化需要重新确认。固定制品先校验摘要;凭据不进入聊天、指南、日志或核验记录。
5. 超时、断线和结果不明时先观察,不重放有副作用的命令;同一安装同时存在其他修改任务时不并发执行。核验只说明实际检查过的能力。
6. 结果明确后提交一次带时间的观察,不预写 installing/reinstalling/uninstalling,不拼装 pending 状态或完整收据,不直接编辑 installed-entries.json。版本必须与本次固定资料一致;发现不同版本应先确认正确资料,不能伪报核验成功。
6. 结果明确后提交一次带时间的观察,material 必须原样复用成功 resolve 的 data.material(包括 action 与 snapshot);首装结束也不能改成 manage。不预写 installing/reinstalling/uninstalling,不拼装 pending 状态或完整收据,不直接编辑 installed-entries.json。版本必须与本次固定资料一致;发现不同版本应先确认正确资料,不能伪报核验成功。
7. 记账失败只重读并处理记录,不重复安装/卸载。记录修订冲突要重新观察,不能只换 expectedRevision。异常时按需读取 [恢复原则](references/recovery.md)。
8. 最后说明软件的实际结果与记录是否提交成功;二者可能不同。进度留在当前会话/既有任务;不得承诺无人执行的后续修复或“所有失败都已回滚”。