@zeyue0329/xiaoma-cli 1.20.0 → 1.22.0

package/src/zqyl-skills/xiaoma-zqyl-ui-spec/design-tokens.md

@@ -0,0 +1,167 @@
+# 云链 Design Tokens 速查
+
+数据来源：`src/utils/tokens.js`。
+
+## 维护方式
+
+- **三端分块维护**：后台 / 中台 / 前台各一节；有差异时只改对应端的「覆盖项」，不必动其他端。
+- **当前状态**：前台与后台一致；**中台**卡片间距 `8px 8px 0`（`spacingBase` 8px）。
+- **代码侧**：`tokens.js` 中 `backendTokens` 为基准；`frontTokenOverrides` 为空；`midTokenOverrides` 覆盖卡片间距。
+
+---
+
+## 后台 backend（基准 · zqyl-manager）
+
+### Colors
+
+| Token | 值 | 用途 |
+| --- | --- | --- |
+| primary | `#288CE9` | 品牌色、链接、Tab 下划线等 |
+| buttonPrimary | `#179CFF` | **实心主按钮**（`type="primary"`） |
+| buttonPrimaryHover | `#45B0FF` | 主按钮 hover |
+| success | `#67C23A` | 成功状态 |
+| warning | `#E6A23C` | 警告 |
+| danger | `#F56C6C` | 错误/删除 |
+| textPrimary | `#303133` | 标题、表头 |
+| textBody | `#606266` | 正文 |
+| textMinor | `#909399` | 次要文字 |
+| textTips | `#C0C4CC` | 占位、禁用 |
+| border | `#DCDFE6` | 输入框边框 |
+| tableBorder | `#EBEEF5` | 表格边框 |
+| tableLine | `#E8E8E8` | 表格分割线 |
+| bgSplit | `#FAFAFA` | 斑马/分割背景 |
+| bgContainer | `#F5F7FA` | 页面背景 |
+| bgCard | `#FFFFFF` | 卡片背景 |
+| menuBg | `#1E222D` | 侧栏背景 |
+| lightAccent | `#FF5800` | 高亮强调 |
+
+### Spacing
+
+| Token | 值 | 说明 |
+| --- | --- | --- |
+| cardMargin | `16px 16px 0` | 卡片外边距 |
+| cardPadding | 24px | 卡片内边距 |
+| formItemGapRight | 24px | 表单项水平间距 |
+| formItemGapBottom | 16px | 表单项垂直间距 |
+| formContentWidth | 240px | 查询/表单控件默认宽度 |
+| formContentCascaderWidth | 360px | 级联选择宽度 |
+| btnGap | 8px | 按钮间距 |
+| searchFormMarginBottom | -16px | 查询区与下方内容叠边距 |
+| dialogPadding | 24px | 弹窗内容区内边距 |
+| containerPaddingX | 24px | 页面容器水平内边距 |
+| tableCellPaddingX | 16px | 表格单元格水平内边距 |
+
+### Typography
+
+| 字号 | 用途 |
+| --- | --- |
+| 12px | 辅助说明 |
+| 14px | 正文、表格、按钮（默认） |
+| 16px | 小标题 |
+| 20px / 24px / 30px / 38px | 大标题、统计数字 |
+
+字重：normal 400 / medium 500 / bold 700
+
+### Layout
+
+| Token | 值 | 说明 |
+| --- | --- | --- |
+| titleBarHeight | 56px | 页面标题栏高度 |
+| titleBarPaddingX | 24px | 标题栏水平内边距 |
+| tabsHeight | 36px | Tab 栏高度 |
+| tableHeaderHeight | 23px | 表头行高 |
+| tableRowPaddingY | 12px | 表格行垂直内边距 |
+| tableCellLineHeight | 22px | 表格单元格行高 |
+| searchFormItemHeight | 32px | 查询表单项高度 |
+| buttonPadding | `8px 15px` | 按钮内边距 |
+| buttonFontSize | 14px | 按钮字号 |
+| dialogHeaderPadding | 24px | 弹窗头部内边距 |
+| dialogBodyPadding | `0 24px` | 弹窗内容区内边距 |
+| dialogFooterPadding | 24px | 弹窗底部内边距 |
+| scrollbarWidth | 8px | 滚动条宽度 |
+| subheadingLineHeight | 32px | 卡片小标题行高 |
+| subheadingPaddingLeft | 20px | 小标题左内边距 |
+| subheadingMarginBottom | 24px | 小标题下间距 |
+| subheadingIndicatorWidth | 4px | 小标题左侧指示条宽度 |
+| subheadingIndicatorHeight | 24px | 小标题左侧指示条高度 |
+
+### 规范常量 Spec Constants
+
+与 Spacing / Layout 互补；对应 CSS 变量或组件行为规则。
+
+| Token | 值 | 说明 |
+| --- | --- | --- |
+| spacingBase | 16px | 通用区块间距（与 cardMargin 一致） |
+| formInputMaxWidth | 480px | 表单框体最大宽度 |
+| formLabelMaxChars | 8 | 多列表单/查询标题建议最多字数；**单列表单不限，完整展示** |
+| formConditionThreshold | 3 | 查询条件 ≥3 时显示「重置」 |
+| dialogMaxHeight | 550px | 弹窗内容区最大高度 |
+| dialogMinHeight | 200px | 弹窗最小高度 |
+| tablePageSizeDefault | 20 | 表格默认每页条数 |
+| tablePageSizes | 20, 50, 100 | 可选分页条数 |
+| tableEmptyFill | - | 空单元格占位符 |
+| tableHeaderDescInlineMax | 40 | 表头说明行内展示最大字数 |
+| tipsMinHeight | 46px | ylTips 最小高度 |
+| tipsPaddingX | 16px | ylTips 左右内边距 |
+| tableOperateWidth | 120px | 表格行内操作列默认宽度 |
+
+### Shadows & Radius
+
+| 项 | 值 |
+| --- | --- |
+| card shadow | `0 0 5px 0 rgba(0,0,0,0.09)` |
+| message shadow | `0px 4px 16px 0px rgba(0,0,0,0.10)` |
+| borderRadius default/button | 3px |
+| borderRadius dialog | 2px |
+| borderRadius card | 4px |
+
+---
+
+## 中台 mid（mps-main）
+
+> 默认继承**后台**全部 Token。下表仅列出与后台**不同**的项；空白表示当前无差异。
+
+### 覆盖项（midTokenOverrides）
+
+| 分组 | Token | 值 | 说明 |
+| --- | --- | --- | --- |
+| spacing | cardMargin | `8px 8px 0` | 卡片外边距 |
+| spacing | searchFormMarginBottom | -8px | 查询区与下方内容叠边距 |
+| specConstants | spacingBase | 8px | 通用区块间距 |
+
+---
+
+## 前台 front（zqyl-crclopen）
+
+> 默认继承**后台**全部 Token。下表仅列出与后台**不同**的项；空白表示当前无差异。
+
+### 覆盖项（frontTokenOverrides）
+
+| 分组 | Token | 值 | 说明 |
+| --- | --- | --- | --- |
+| — | — | — | **当前无覆盖，与后台一致** |
+
+---
+
+## 三端差异（组件选型，非 Token）
+
+| 维度 | 后台 | 中台 | 前台 |
+| --- | --- | --- | --- |
+| 标题组件 | ylTitle / ylManagerTitle | ylManagerTitle | ylTitle |
+| 表格组件 | ylTableSimple | ylMpsTable | ylTableSimple |
+| 列表页骨架 | ylTitle + 可选 Tab | ylManagerTitle + ylMpsTable | ylTitle + ylTableSimple |
+
+---
+
+## 后续有差异时怎么改
+
+**代码**（`src/utils/tokens.js`）：
+
+```javascript
+const midTokenOverrides = {
+  borderRadius: { card: 4 },
+  spacing: { cardPadding: 14 },
+};
+```
+
+**文档**：在对应平台的「覆盖项」表中追加一行，并更新 `SKILL.md` 平台对照表（如有视觉规则变化）。

package/src/zqyl-skills/xiaoma-zqyl-ui-spec/reference.md

@@ -0,0 +1,385 @@
+# 云链交互规范 — 完整参考
+
+本文件供 SKILL.md 未覆盖的细节查阅。
+
+---
+
+## 1. 布局
+
+### 1.1 基础布局（侧导航 + 内容区）
+
+- 顶部导航位于最上层，导航下方阴影位于页面标题之上
+- 边距、卡片间距：前台/后台 **16px**，中台 **8px**
+- 侧导航 + 右侧内容区结构
+
+### 1.2 通栏布局（无侧导航）
+
+- 内容页只能通过顶部导航访问或不在侧导航索引范围内时使用
+- 卡片四边间距：前台/后台 16px，中台 8px；卡片有阴影
+
+### 1.3 鼠标指针
+
+- 悬浮在可点击、下拉可点击的内容上时，`cursor: pointer`
+
+---
+
+## 2. 页面标题
+
+### 2.1 一级标题
+
+- 位于顶部导航下方，与顶部导航相连无间隙
+- 顶部导航位于页面标题上层，阴影覆盖在页面标题上
+
+### 2.2 标题带标签页
+
+- 页面内容需按维度切换时使用
+- 可统计数据：标签文字后括号标注数量，如 `标签名(12)`
+- 需用户确认或推进流程：相应标签右上角红点
+
+### 2.3 二级标题
+
+- 用于二级及以下页面
+- **返回按钮（需求未说明位置时）**：
+  - **前台 / 中台**：`ylTitle` **左侧**（`:disabledBack="false"`，带返回标题组件）
+  - **后台**：`ylTitle` **右侧插槽**（`:disabledBack="true"` 隐藏左侧返回）
+- 标题右侧放针对当前页面的全局操作按钮（保存/提交/确认等；后台含返回）
+- 可带标签页
+
+### 2.4 特殊标题
+
+- 特殊场景（带统计、多级面包屑等）
+
+---
+
+## 3. 查询表格
+
+### 3.1 查询条件
+
+- 输入框宽度固定；标题建议 ≤8 字
+- 查询条件间距固定
+- 按页面宽度排列，不足换行
+- **< 3 个**：只保留查询按钮
+- **≥ 3 个**：查询 + 重置
+- 查询按钮与条件左对齐
+- 条件少时可与表格同卡片
+
+### 3.2 快捷查询
+
+- 快捷筛选标签，点击即筛选
+
+### 3.3 表格操作
+
+**整体操作**
+
+- 针对整体或多条：新增、批量导入、批量导出等
+- 表格上方，与表格右对齐；最重要操作在最右
+- 主按钮 + 次要按钮；不改变表格数据的操作用文字链接
+- 频繁/引导操作 = primary，**最多 1 个**
+
+**单行操作顺序**
+
+1. 流程类：申请、支付、还款、邀请、上传
+2. 常规类：查看、编辑
+3. 低频类：下载、导出
+4. 删除：最后
+
+**按钮样式**
+
+- 仅 1 个按钮：建议 primary（编辑/删除/下载导出除外）
+- 多个按钮：最多 1 个 primary；有新增时新增为 primary
+- 跳转其他页面/网站：文字链接 + 前置图标
+
+### 3.4 分页
+
+- 默认 20 条/页；可选 20、50、100
+
+---
+
+## 4. 表格基础规则
+
+### 4.1 对齐
+
+- 以左对齐为主
+- 小写金额、数量等右对齐；大写金额左对齐
+- 列宽 = 内容区 + 两侧固定边距
+
+### 4.2 自适应
+
+**最小宽度建议**
+
+| 字段类型 | 最小宽度 |
+| --- | --- |
+| 编号类 | ~200px |
+| 公司名 | ~180px |
+| 金额 | ~120px |
+| 时间 | ~110px |
+| 人员姓名 | ~80px |
+| 状态/枚举 | ~80px |
+
+**溢出**
+
+- 文字超出：`…` + hover Tooltip
+- 各列达最小宽仍超出：水平滚动；标题列 + 操作列固定
+
+### 4.3 填写
+
+- 空值用 `-`，不可留空
+- 流程中暂空、审核后才有数据的单元格可为空
+
+### 4.4 特殊状态/标识
+
+- 按场景提供不同强调等级
+- 可单独标识或附加在其他列后
+
+### 4.5 排序
+
+- 点击排序图标升序/降序
+
+### 4.6 无数据
+
+- 「暂无数据」占位
+
+### 4.7 悬停
+
+- `…` 文字：Tooltip 全文
+- 表头说明图标：显示说明
+- 文字后提示图标：详细释义
+
+### 4.0 表格组件选型
+
+- **全页数据表格优先 `ylTableSimple`**（列表、表单详情、弹窗、抽屉、反馈页等）
+- **中台列表页**主表格默认 **`ylMpsTable`**
+- **禁止**默认手写 `el-table`；仅 `ylTableSimple` 无法满足且需求明确要求原生特性时才降级
+
+### 4.8 降级 el-table 时的边框
+
+- 极少数降级使用 Element UI **`el-table`** 时，需求**未明确要求**表格边框 → **不要**添加 `border` 属性
+- 默认依赖平台/卡片内表格样式（如 `el-card.yl-tabs-table` 下的表格线），保持与 `ylTableSimple` 视觉一致
+- 仅当需求/原型**明确**要求边框，或合并单元格等场景需竖线区分区域时，才写 `border` 或等价样式
+
+---
+
+## 5. 表格样式变体
+
+### 5.1 基础表格
+
+- 表头过长可折行，最多 2 行
+- 合并单元格时增加竖线
+
+### 5.2 多选表格
+
+- 全选框在首列前
+- 部分行可置灰不可选
+- 勾选后表头显示「已选 N 条」
+- 未全选：半选 indeterminate
+
+### 5.3 可展开表格
+
+**子表格类**：嵌套子表格，数据可控；子表格无分页
+
+**文字信息类**：展开更多字段；收纳低重要度字段；常用字段不放此处
+
+### 5.4 可编辑表格
+
+- 默认普通态，点击编辑进入单行编辑
+- 新增：小标题行右侧按钮（需求未说明位置时）
+- 使用 **`ylTableSimple`**（`:isTableForm="true"` 或自定义 `slot` 列）承载行内编辑/动态行
+
+### 5.5 表格变体场景
+
+| 变体 | 说明 |
+| --- | --- |
+| 基础查询表格 | 标准查询 + 表格；含页级 Tab 时见 `xiaoma-zqyl-list-page-{平台}` |
+| 表格带标签 | Tab 切换；改查询各 Tab 同步 |
+| 双重标签 | 页级 Tab + 表格内 Tab 带查询（二级标签支持查询） |
+| 统计 | 标题下大数字 + 标签 |
+| 极简查询 | 查询项少；操作按钮与查询同一行（`rightBtn`） |
+
+---
+
+## 6. 表单
+
+### 6.1 表单标题
+
+- 与卡片标题样式一致
+
+### 6.2 适配
+
+- 复合表单：按列均分，每列左对齐
+- 标题宽度固定；框体等比缩放，**最大 480px**
+
+### 6.3–6.5 列布局
+
+- 单列：单卡片居中；提交在表单项最下方；**不加** `el-card-padding-bottom0`；`label-width="auto"`，表单项标题完整展示（取消组件库 label `ellipsis`）
+- 双列/三列：等宽；`ylFormEditor` 在 `layout="double"` 时字段默认半行（`span: 12`），勿因日期区间等较宽控件擅自 `span: 24`；独占整行须原型明确（见 `xiaoma-zqyl-form-editor-{平台}` span 选型）
+
+### 6.6 只读
+
+- 内容跟随标题左对齐；标题不折行、内容折行
+- 三列长项独占一行
+- 无必填 `*`、无填写提示；理解性提示可保留
+
+### 6.7 复合表单
+
+- 单列表单与多列表单/表格同页：单列表单左对齐
+- 全只读卡片 → **`ylFormView`**
+- **只读 + 待填（同卡混排）→ 单个 `ylFormEditor`**；只读项 `disabled: true`；**禁止**同卡 `ylFormView` + `ylFormEditor` 拆分
+
+### 6.8 文件上传
+
+见 SKILL.md「文件上传」；组件 `yl-file-upload`。
+
+---
+
+## 7. 表单模板
+
+### 7.1 操作按钮位置
+
+- **返回（需求未说明）**：**前台/中台** → `ylTitle` **左侧**（`:disabledBack="false"`）；**后台** → `ylTitle` **右侧插槽**（`:disabledBack="true"`）
+- **其他页面级**（需求未说明）：保存/取消/确认/提交等 → **`ylTitle` 右侧插槽**；**不要**使用 `ylContainerFoot`
+- **卡片小标题 class（强制）**
+  - **后台 backend**：`yl_manager_subheading`（加粗 16px + 左侧蓝色竖条）
+  - **中台 mid / 前台 front**：`yl-title-sub`（14px，无竖条）
+  - **禁止跨端混用**；中台/前台**不得**因 legacy 页或后台 showcase 示例而使用 `yl_manager_subheading`
+- **卡片模块级**（需求未说明）：某卡片内操作（如「添加」行、「导入一行」）→ **小标题同一行右侧**（`el-row.mb16` + 左 **按平台选用上表 class** + 右 `text-right`）；**勿**默认放在表格下方或内容区最底部
+- **置底**（需求明确要求）：多卡片表单且需求写明「底部置底 / 底栏固定 / 页面底部按钮」时，使用 `ylContainerFoot`
+- **置底按钮居中（强制）**：`ylContainerFoot` 主操作按钮**默认居中**，须放 **`#center` 插槽**；协议/Ukey 等辅助文案放 **`#left`**；**禁止**默认插槽 + `justify-content: space-between` 将按钮顶到右侧（详见 `xiaoma-zqyl-container-foot-{平台}` skill）
+
+### 7.2 分步表单
+
+- 冗长或不熟悉任务分步；注意信息分类与页面层级
+
+---
+
+## 8. 弹窗
+
+### 8.1 类型
+
+| 类型 | 说明 |
+| --- | --- |
+| 基础表格弹窗 | 仅查看；不展示底部操作按钮；内容区保留 24px 底边距；分页与列表页一致 |
+| 单选表格弹窗 | 未选时按钮置灰 |
+| 多选表格弹窗 | 未选时按钮置灰；多选与表格一致 |
+
+### 8.2 说明引导
+
+- 标题右侧：弹窗整体说明
+- 表格上方：表格相关信息
+- 弹窗底部：附加提示（重要性次之）
+
+### 8.3 弹窗表单
+
+- 不支持三列；内容区高度 200px ~ 550px；不建议复杂流程
+
+### 8.4 滚动
+
+- 单行查询：查询 + 表头置顶，只滚表格；分页与列表页一致
+- 多行查询：查询与表格同滚；默认 20 条
+- 合计行一般置底；分页展示与列表页一致
+
+### 8.5 表格组件
+
+- **全页数据表格优先 `ylTableSimple`**，不使用 `el-table`
+- 中台列表页主表格默认 `ylMpsTable`
+- 行内操作（下载/删除/预览等）用 `attr.type: 'handle'`
+- 须设置 `data.attributes.height`，仅表格体滚动
+
+### 8.6 支持功能
+
+- 查询、合计、多标签
+
+### 8.7 图片弹窗
+
+- 尺寸视业务；首图位置上传；最新在首图右侧
+
+### 8.8 附件弹窗
+
+- 表格用 **`ylTableSimple`**；文件名 + 下载/预览/删除（`attr.type: 'handle'`）；可上传
+
+### 8.9 多层级
+
+- 弹窗上再弹窗
+
+---
+
+## 9. 抽屉
+
+- 自屏幕边缘划出；比弹窗纵向空间更大
+- 适用于详情或较大操作空间
+- **标题**：颜色 `#303133`、加粗；距下方内容区 **24px**
+
+---
+
+## 10. 提示
+
+### 10.1 警告提示 Alert
+
+**警示类**：权限等，加载校验，常显；标准/简略/极简
+
+**信息类**：操作前须知，可关闭；标准/简略/极简
+
+### 10.2 位置
+
+| 位置 | 说明 |
+| --- | --- |
+| 全局 | 页面顶部或标题下方 |
+| 卡片 | 卡片内，标题下方 |
+| 表单项 | 框体下方 |
+
+---
+
+## 11. 文字说明
+
+### 11.1 操作说明
+
+- 弱于警示；标题下方，简短
+- 表单：子标题 + 说明在标题下
+- 表格：≤40 字可与按钮同行；超出整行；重要信息警示色
+
+### 11.2 注释说明
+
+- 低优先级；表单/表格底部
+- 跳转用文字链接
+
+---
+
+## 12. 气泡提示 Popover
+
+- 需特别关注的位置；可带「知道了」
+
+---
+
+## 13. 反馈
+
+| 类型 | 场景 |
+| --- | --- |
+| 表单校验 | 输入框标红 + 下方错误文案 |
+| 可编辑表格校验 | 框体下方及时反馈 |
+| 提示说明 | 框体下方左对齐；重要时可改颜色 |
+| Message | 操作成功，自动消失 |
+| MessageBox | 打断操作，引导下一步；不传 `type`，无左侧图标 |
+| 弹窗提示 | 复杂反馈 |
+| 结果页 | 操作完成跳转 |
+| 数据异常页 | 无数据/崩溃 + 引导 |
+| 弹窗无数据 | 保留标题/表头 |
+
+---
+
+## 组件行为速查
+
+| 组件/场景 | 规则 |
+| --- | --- |
+| 表格空值 | `-` |
+| 文字溢出 | ellipsis + hover Tooltip |
+| 表格对齐 | 左对齐；金额/数量右对齐 |
+| 操作排列 | 流程 > 常规 > 低频 > 删除 |
+| 主按钮 | 整体操作最多 1 个 |
+| 分页 | 20 / 50 / 100 |
+| 查询 | <3 仅查询；≥3 查询+重置 |
+| 表单框体 | 最大 480px |
+| 只读表单 | 无 `*` 与填写提示 |
+| 弹窗表单 | 无三列；200px ~ 550px |
+| 文件上传 | yl-file-upload |
+| 鼠标 | pointer |
+| 表头折行 | 最多 2 行 |
+| 子表格 | 无分页 |

package/tools/installer/core/manifest.js

@@ -5,6 +5,7 @@ const { promisify } = require('node:util');
 const fs = require('../fs-native');
 const crypto = require('node:crypto');
 const { resolveModuleVersion } = require('../modules/version-resolver');
+const { BUILTIN_MODULE_CODES } = require('../project-root');
 const prompts = require('../prompts');
 
 const execFileAsync = promisify(execFile);
@@ -36,8 +37,8 @@ class Manifest {
     const moduleDetails = [];
     if (data.modules && Array.isArray(data.modules)) {
       for (const moduleName of data.modules) {
-        // Core, XMC, and XPM modules use the XiaoMa version (built-in)
-        const isBuiltIn = moduleName === 'core' || moduleName === 'xmc' || moduleName === 'xpm';
+        // Built-in modules (src/<code>-skills) use the XiaoMa version
+        const isBuiltIn = BUILTIN_MODULE_CODES.includes(moduleName);
         const moduleVersion = isBuiltIn ? xiaomaVersion : null;
         const now = data.installDate || new Date().toISOString();
 
@@ -281,7 +282,7 @@ class Manifest {
    */
   async getModuleVersionInfo(moduleName, xiaomaDir, moduleSourcePath = null) {
     // Resolve source type first, then read version with the correct path context
-    if (['core', 'xmc', 'xpm'].includes(moduleName)) {
+    if (BUILTIN_MODULE_CODES.includes(moduleName)) {
       const versionInfo = await resolveModuleVersion(moduleName, { moduleSourcePath });
       return {
         version: versionInfo.version,

package/tools/installer/list-options.js

@@ -1,7 +1,7 @@
 const path = require('node:path');
 const fs = require('./fs-native');
 const yaml = require('yaml');
-const { getProjectRoot, getModulePath, getExternalModuleCachePath } = require('./project-root');
+const { BUILTIN_MODULE_CODES, getProjectRoot, getModulePath, getExternalModuleCachePath } = require('./project-root');
 
 /**
  * Read a module.yaml and return its declared `code:` field, or null if missing/unparseable.
@@ -54,7 +54,7 @@ async function discoverOfficialModuleYamls() {
   };
 
   // Built-ins.
-  for (const code of ['core', 'xmc', 'xpm']) {
+  for (const code of BUILTIN_MODULE_CODES) {
     const yamlPath = path.join(getModulePath(code), 'module.yaml');
     if (await fs.pathExists(yamlPath)) {
       // Built-ins use their well-known short codes regardless of what the

package/tools/installer/modules/official-modules.js

@@ -2,7 +2,7 @@ const path = require('node:path');
 const fs = require('../fs-native');
 const yaml = require('yaml');
 const prompts = require('../prompts');
-const { getProjectRoot, getSourcePath, getModulePath } = require('../project-root');
+const { BUILTIN_MODULE_CODES, getProjectRoot, getSourcePath, getModulePath } = require('../project-root');
 const { CLIUtils } = require('../cli-utils');
 const { ExternalModuleManager } = require('./external-manager');
 
@@ -103,37 +103,21 @@ class OfficialModules {
   }
 
   /**
-   * List all available built-in modules (core and xmc).
+   * List all available built-in modules (BUILTIN_MODULE_CODES, each at src/<code>-skills).
+   * Pre-selection is driven by each module.yaml's `default_selected`, so opt-in
+   * packs (xpm, zqyl) surface in the prompt unchecked.
    * All other modules come from external-official-modules.yaml
    * @returns {Object} Object with modules array
    */
   async listAvailable() {
     const modules = [];
 
-    // Add built-in core module (directly under src/core-skills)
-    const corePath = getSourcePath('core-skills');
-    if (await fs.pathExists(corePath)) {
-      const coreInfo = await this.getModuleInfo(corePath, 'core', 'src/core-skills');
-      if (coreInfo) {
-        modules.push(coreInfo);
-      }
-    }
-
-    // Add built-in xmc module (directly under src/xmc-skills)
-    const xmcPath = getSourcePath('xmc-skills');
-    if (await fs.pathExists(xmcPath)) {
-      const xmcInfo = await this.getModuleInfo(xmcPath, 'xmc', 'src/xmc-skills');
-      if (xmcInfo) {
-        modules.push(xmcInfo);
-      }
-    }
-
-    // Add built-in xpm module (directly under src/xpm-skills) — opt-in (default_selected: false)
-    const xpmPath = getSourcePath('xpm-skills');
-    if (await fs.pathExists(xpmPath)) {
-      const xpmInfo = await this.getModuleInfo(xpmPath, 'xpm', 'src/xpm-skills');
-      if (xpmInfo) {
-        modules.push(xpmInfo);
+    for (const code of BUILTIN_MODULE_CODES) {
+      const modulePath = getSourcePath(`${code}-skills`);
+      if (!(await fs.pathExists(modulePath))) continue;
+      const info = await this.getModuleInfo(modulePath, code, `src/${code}-skills`);
+      if (info) {
+        modules.push(info);
       }
     }
 
@@ -218,27 +202,11 @@ class OfficialModules {
     }
     const projectRoot = getProjectRoot();
 
-    // Check for core module (directly under src/core-skills)
-    if (moduleCode === 'core') {
-      const corePath = getSourcePath('core-skills');
-      if (await fs.pathExists(corePath)) {
-        return corePath;
-      }
-    }
-
-    // Check for built-in xmc module (directly under src/xmc-skills)
-    if (moduleCode === 'xmc') {
-      const xmcPath = getSourcePath('xmc-skills');
-      if (await fs.pathExists(xmcPath)) {
-        return xmcPath;
-      }
-    }
-
-    // Check for built-in xpm module (directly under src/xpm-skills)
-    if (moduleCode === 'xpm') {
-      const xpmPath = getSourcePath('xpm-skills');
-      if (await fs.pathExists(xpmPath)) {
-        return xpmPath;
+    // Check for built-in modules (directly under src/<code>-skills)
+    if (BUILTIN_MODULE_CODES.includes(moduleCode)) {
+      const builtInPath = getSourcePath(`${moduleCode}-skills`);
+      if (await fs.pathExists(builtInPath)) {
+        return builtInPath;
       }
     }