用途:这是一份 weapp-ide-cli 的命令治理与自动化实践手册,重心是命令路由、CLI 用户体验、配置持久化与跨包 CLI 契约,尤其是与 weapp-vite 的集成。适用于新增或重构命令、暴露命令元数据供外部 CLI 调度、改进开发者工具自动化、截图或 automator 子命令、语言切换与配置持久化,以及 weapp-vite 委托调用等场景。
主要能力:维护明确的命令分层,包括微信官方透传命令、automator 增强命令、config 命令与 minidev 命名空间透传;导出顶层命令目录供外部复用,并提供判定命令支持的函数;先解析全局语言选项再路由,minidev 与 automator 命令先于通用透传;帮助命令对 automator 子命令保持确定性;调用外部 CLI 前先校验关键参数。
使用方式:先判断改动类型(命令新增、校验、i18n/配置或调度契约),先改命令源再改解析/调度器,补充路由与错误测试,同步 README、官网包页与面向 AI 的说明。默认语言为中文,支持命令级临时语言覆盖与持久配置语言,配置写入用户目录配置文件,并通过 config 子命令读写、导出、导入。上游 CLI 应先执行自身命令表,仅当 isWeappIdeTopLevelCommand(command) 为真时委托,未知命令不得盲目透传。验证集中在 packages/weapp-ide-cli/test/.test.ts,涉及调度契约时加 packages/weapp-vite/src/cli/.test.ts。
限制:与 weapp-vite 构建/分包、Vue SFC 宏兼容、运行时生命周期状态架构相关的问题不属于本技能,应分别使用对应实践。不要在多包中重复维护命令清单,不要新增未做 i18n 包装的用户可见文本,不要在参数校验前耦合业务副作用。