EP-Hub-Skill/.agents/skills/dingtalk-misc/references/dev/app.md

应用基础操作

操作的是「应用」容器本体（见 devapp.md 概念地图）；启停/删除改的是应用 appStatus，不是版本 versionStatus。

应用列表查询、详情、创建、修改、生命周期启停和删除。参数用对应命令的 --help 查询。

应用定位

写操作与多数单应用命令统一用 --unified-app-id（全树主键）定位。dev app get 额外支持只读按 --app-key（=clientId）查详情；--name 仍只在 dev app list 作列表过滤。拿到 appKey 时可先 app get --app-key 核验并拿回 unifiedAppId；写操作必须由用户或上游结果提供明确 unifiedAppId。

应用状态 appStatus

app get 的 appStatus 是字符串，取值如 normal、published。app list 不回这个字段（恒 null），看应用状态以 app get 为准。应用状态 appStatus 和版本状态 versionStatus 是两套，别混。遇到没见过的 appStatus 值原样展示。

app create、app update 不返回状态字段；版本状态由 version create 返回的 status（值如 INIT）表达，见 version.md。

要点

• get 主要用于定位核验；若返回里带 appSecret，脱敏处理，不复制到回答；主动读凭证走 credentials get。
• disable/enable 成功返回 {disabled:true} / {enabled:true} + message，不回 appStatus；以这个布尔判操作成败。要确认最终生效态再 get 看 appStatus 字符串值。
• delete 前必须展示应用摘要；删除是异步，成功后延迟从列表消失。

错误处理

情况	处理
多应用命中	展示候选，停止写操作
ServiceResult.success=false	透传 errorCode/errorMsg

发现命令

调用任何方法前先查清楚再敲：

# 浏览命令组下的子命令与 flag
dws dev app --help

# 查某方法的必填参数、类型、默认值
dws dev <command-path> --help

按 --help 输出构造 flag；不要凭旧 schema 名称猜参数。