@microi.net/cli 5.5.8 → 5.6.0

package/skills/print-engine/SKILL.md

@@ -1,36 +1,36 @@
 ---
 name: print-engine
-description: 生成和审查 Microi 打印引擎 Print Engine 模板 JSON。用于创建 mic_print 模板、PageObj 布局、PrintObj 数据绑定、可打印报告、标签或合同；蓝牙 TSPL/CPCL/ESC-POS、GP-M322 或 CC4 需求转交 v8-frontend-events 蓝牙参考。
+description: 生成和审查 Microi 打印引擎 Print Engine 模板 JSON。用于创建 mic_print 模板、PageObj 布局、PrintObj 数据绑定、可打印报告、标签或合同；蓝牙 TSPL/CPCL/ESC-POS、GP-M322 或 CC4 需求转交 v8-frontend-events 蓝牙参考。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
-# Microi 打印引擎（Print Engine）模板 JSON 生成
-
-你正在为 Microi 吾码平台生成打印引擎模板的 JSON 数据。打印模板包含 PageObj（模板定义）和 PrintObj（打印数据）。
-
-## 设计器源码事件
-
-扩展打印设计器源码时，可通过 `EventBus.on('savePrintJson', handler)` 接收
-保存后的模板 JSON，并在组件卸载时调用 `EventBus.off('savePrintJson')`。
-这是设计器内部生命周期接口，不属于运行时打印模板 JSON，也不能替代模板的
-服务端保存与回读。
-
-## 与蓝牙直连打印的边界
-
-本 Skill 负责 `mic_print`、`PageObj`、`PrintObj`、浏览器预览和模板化纸张输出。
-如果需求明确是蓝牙标签机/小票机、TSC/TSPL、CPCL、ESC/POS、佳博 GP-M322、
-ZICOX CC4、BLE/SPP 或
-`V8.Print.prepareSend`，应同时读取
-`../v8-frontend-events/references/bluetooth-print.md`：
-
-- Print Engine 决定“页面/模板如何排版”，适合 A4、PDF、浏览器打印和统一模板。
-- `V8.Print` 生成/适配打印机原生命令并通过 BLE 或 Android SPP 写入，适合标签和热敏小票；GP-M322 保持 TSPL 原字节，CC4 可自动生成 CPCL。
-- MicroService 不能跨 iframe 访问父页面打印组件；普通打印使用 `microi.host.v1` 的
-  `openPlatformPrint`，只传当前租户 `mic_print.Id` 和同源 `/apiengine/` 数据地址。该动作
-  不是蓝牙代理，不发送 BLE/SPP 字节。详见 `../microi-microservice/references/runtime-delivery.md`。
-- 两者可以由同一个按钮按设备能力选择，但不能把 `PageObj` 直接交给
-  `V8.Print.prepareSend`，也不能把 TSPL/CPCL/ESC-POS 字节当作 Print Engine JSON。
+# Microi 打印引擎（Print Engine）模板 JSON 生成
+
+你正在为 Microi 吾码平台生成打印引擎模板的 JSON 数据。打印模板包含 PageObj（模板定义）和 PrintObj（打印数据）。
+
+## 设计器源码事件
+
+扩展打印设计器源码时，可通过 `EventBus.on('savePrintJson', handler)` 接收
+保存后的模板 JSON，并在组件卸载时调用 `EventBus.off('savePrintJson')`。
+这是设计器内部生命周期接口，不属于运行时打印模板 JSON，也不能替代模板的
+服务端保存与回读。
+
+## 与蓝牙直连打印的边界
+
+本 Skill 负责 `mic_print`、`PageObj`、`PrintObj`、浏览器预览和模板化纸张输出。
+如果需求明确是蓝牙标签机/小票机、TSC/TSPL、CPCL、ESC/POS、佳博 GP-M322、
+ZICOX CC4、BLE/SPP 或
+`V8.Print.prepareSend`，应同时读取
+`../v8-frontend-events/references/bluetooth-print.md`：
+
+- Print Engine 决定“页面/模板如何排版”，适合 A4、PDF、浏览器打印和统一模板。
+- `V8.Print` 生成/适配打印机原生命令并通过 BLE 或 Android SPP 写入，适合标签和热敏小票；GP-M322 保持 TSPL 原字节，CC4 可自动生成 CPCL。
+- MicroService 不能跨 iframe 访问父页面打印组件；普通打印使用 `microi.host.v1` 的
+  `openPlatformPrint`，只传当前租户 `mic_print.Id` 和同源 `/apiengine/` 数据地址。该动作
+  不是蓝牙代理，不发送 BLE/SPP 字节。详见 `../microi-microservice/references/runtime-delivery.md`。
+- 两者可以由同一个按钮按设备能力选择，但不能把 `PageObj` 直接交给
+  `V8.Print.prepareSend`，也不能把 TSPL/CPCL/ESC-POS 字节当作 Print Engine JSON。
 
 ## 数据模型
 
@@ -40,15 +40,15 @@ ZICOX CC4、BLE/SPP 或
 |------|------|
 | PageObj | 页面模板定义（面板 + 元素布局） |
 | PrintObj | 打印数据（运行时填充到模板中） |
-| DataApi | 关联的接口引擎 Id（动态数据） |
-
-### `mic_print` 权限边界
-
-- `mic_print` 是按角色管理的运行资源，不是只能由 `Level >= 9999` 读取的控制面表。打印渲染器通过 FormEngine 读取模板时，当前角色必须拥有菜单权限或高级表权限中的 `Read`；否则应明确返回 `NoAuth`，不能为兼容改成匿名读取。
-- 模板新增、修改、删除分别要求明确的 `Add`、`Edit`、`Del`。只需要打印的业务角色通常只授予 `Read`，不要顺带授予设计权限。
-- 角色授权界面只负责展示服务端策略。角色增删改接口必须从主库复核当前操作者确为活动平台管理员，不能相信 Postman 请求体中的 `_IsAdmin`、`Level`、`RoleIds` 或 `OsClient`。
-
-## PageObj 模板结构
+| DataApi | 关联的接口引擎 Id（动态数据） |
+
+### `mic_print` 权限边界
+
+- `mic_print` 是按角色管理的运行资源，不是只能由 `Level >= 9999` 读取的控制面表。打印渲染器通过 FormEngine 读取模板时，当前角色必须拥有菜单权限或高级表权限中的 `Read`；否则应明确返回 `NoAuth`，不能为兼容改成匿名读取。
+- 模板新增、修改、删除分别要求明确的 `Add`、`Edit`、`Del`。只需要打印的业务角色通常只授予 `Read`，不要顺带授予设计权限。
+- 角色授权界面只负责展示服务端策略。角色增删改接口必须从主库复核当前操作者确为活动平台管理员，不能相信 Postman 请求体中的 `_IsAdmin`、`Level`、`RoleIds` 或 `OsClient`。
+
+## PageObj 模板结构
 
 ```json
 {

package/skills/production-readonly-audit/SKILL.md

@@ -1,41 +1,41 @@
----
-name: production-readonly-audit
-description: Microi 正式环境只读业务巡检规范。用于在不改动线上数据的前提下，检查会员、余额、订单、库存卡、奖励、积分、兑换金额、日志和结算正确性等生产业务数据。
----
-
-> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
-
-# Microi 正式环境只读业务巡检
-
-## 核心边界
-
-- 正式环境已有真实用户、余额、订单、卡券或收益数据时，线上巡检默认是只读任务。
-- 优先使用目标租户 MCP 的读表、查结构、查日志工具；不得调用新增、更新、删除、清库、重算、补发、扣减接口。
-- 如果用户要求“检查是否正常”，先输出异常证据、影响范围、建议修复方式和回读验证方式；没有明确授权前，不修线上业务数据。
-- MCP 不可用时，可使用官方后台登录 token + FormEngine `getTableData` 做只读兜底，但必须在结果中说明“非 MCP，只读 API 兜底”；不得调用 `add/upt/del/run` 维护接口。
-- 任何资金/资产异常即使明显，也只能先报告。获得修复授权后，必须小范围条件更新，并在方案文档留下 SQL/接口说明、执行时间、影响行数和回读结果。
-
-## 商城类固定巡检表
-
-- 会员与团队：`mall_member`
-- 提货卡与挂单：`mall_stock_card`、`mall_stock_card_listing`
-- 抢购/约单/商品订单：`mall_buy_order`、`mall_appointment_order`、`mall_redeem_order`
-- 积分/兑换金/奖励：`mall_point_log`、`mall_redeem_money_log`、`mall_reward_log`
-- 上架服务费：`mall_storage_fee_order`
-- 提货卡扣除/流转：`mall_stock_card_redeem`、`mall_stock_card_history`
-- 规则配置：`mall_system_config`
-
-## 固定检查项
-
-- 提货卡：`CardNo` 必须为 6 位大写字母+数字；金额不得为负；`OwnerId` 必须存在；同一卡只能有一条活跃挂单；状态机必须和挂单/订单一致。
-- 抢购订单：`PendingPay` 必须有关联锁定卡与付款截止时间；`Paid` 必须有支付凭证和付款时间；`Confirmed/Completed` 必须确认卡 OwnerId 已转为 BuyerId，并有对应流转历史。
-- 上架服务费：服务费应等于持有价 × `PlatformServiceRate`；已支付服务费必须有对应负数积分流水。
-- 推荐奖励：`Amount = BaseAmount × Rate / 100`；直推、间推、品牌补贴合计不得超过 `MaxPerformanceCommissionRate`；`Pending` 不得生成积分流水或增加余额；`Settled` 必须有积分流水并真实到账。
-- 商品支付：提货卡专区订单必须生成 `mall_stock_card_redeem` 并扣卡余额；兑换金专区订单必须生成负数 `mall_redeem_money_log` 并扣兑换金。
-- 会员资产：会员页展示的提货卡资产应以当前名下有效提货卡 `HoldPrice/StockValue` 汇总为准；如 `mall_member.StockValue` 是冗余字段，必须与实际资产保持一致。
-
-## 输出要求
-
-- 报告必须区分“硬错误”和“风险警告”。
-- 不输出密码、token、支付凭证图片原文、完整身份证等敏感信息。
-- 报告需包含巡检通道、读取表数量、状态分布、异常数量、核心异常证据、未覆盖范围。
+---
+name: production-readonly-audit
+description: Microi 正式环境只读业务巡检规范。用于在不改动线上数据的前提下，检查会员、余额、订单、库存卡、奖励、积分、兑换金额、日志和结算正确性等生产业务数据。
+---
+
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
+
+# Microi 正式环境只读业务巡检
+
+## 核心边界
+
+- 正式环境已有真实用户、余额、订单、卡券或收益数据时，线上巡检默认是只读任务。
+- 优先使用目标租户 MCP 的读表、查结构、查日志工具；不得调用新增、更新、删除、清库、重算、补发、扣减接口。
+- 如果用户要求“检查是否正常”，先输出异常证据、影响范围、建议修复方式和回读验证方式；没有明确授权前，不修线上业务数据。
+- MCP 不可用时，可使用官方后台登录 token + FormEngine `getTableData` 做只读兜底，但必须在结果中说明“非 MCP，只读 API 兜底”；不得调用 `add/upt/del/run` 维护接口。
+- 任何资金/资产异常即使明显，也只能先报告。获得修复授权后，必须小范围条件更新，并在方案文档留下 SQL/接口说明、执行时间、影响行数和回读结果。
+
+## 商城类固定巡检表
+
+- 会员与团队：`mall_member`
+- 提货卡与挂单：`mall_stock_card`、`mall_stock_card_listing`
+- 抢购/约单/商品订单：`mall_buy_order`、`mall_appointment_order`、`mall_redeem_order`
+- 积分/兑换金/奖励：`mall_point_log`、`mall_redeem_money_log`、`mall_reward_log`
+- 上架服务费：`mall_storage_fee_order`
+- 提货卡扣除/流转：`mall_stock_card_redeem`、`mall_stock_card_history`
+- 规则配置：`mall_system_config`
+
+## 固定检查项
+
+- 提货卡：`CardNo` 必须为 6 位大写字母+数字；金额不得为负；`OwnerId` 必须存在；同一卡只能有一条活跃挂单；状态机必须和挂单/订单一致。
+- 抢购订单：`PendingPay` 必须有关联锁定卡与付款截止时间；`Paid` 必须有支付凭证和付款时间；`Confirmed/Completed` 必须确认卡 OwnerId 已转为 BuyerId，并有对应流转历史。
+- 上架服务费：服务费应等于持有价 × `PlatformServiceRate`；已支付服务费必须有对应负数积分流水。
+- 推荐奖励：`Amount = BaseAmount × Rate / 100`；直推、间推、品牌补贴合计不得超过 `MaxPerformanceCommissionRate`；`Pending` 不得生成积分流水或增加余额；`Settled` 必须有积分流水并真实到账。
+- 商品支付：提货卡专区订单必须生成 `mall_stock_card_redeem` 并扣卡余额；兑换金专区订单必须生成负数 `mall_redeem_money_log` 并扣兑换金。
+- 会员资产：会员页展示的提货卡资产应以当前名下有效提货卡 `HoldPrice/StockValue` 汇总为准；如 `mall_member.StockValue` 是冗余字段，必须与实际资产保持一致。
+
+## 输出要求
+
+- 报告必须区分“硬错误”和“风险警告”。
+- 不输出密码、token、支付凭证图片原文、完整身份证等敏感信息。
+- 报告需包含巡检通道、读取表数量、状态分布、异常数量、核心异常证据、未覆盖范围。

package/skills/report-engine/SKILL.md

@@ -1,71 +1,71 @@
----
-name: report-engine
-description: Microi 报表引擎设计与验收规范。用于 Rpt_Report 虚拟表格、数据源、报表字段、查询/增删改接口替换、统计聚合、导出、行级权限和界面引擎图表。
----
-
-> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
-
-# Microi 报表引擎
-
-## 定位
-
-报表引擎以 `Rpt_Report`、报表字段配置和数据源引擎组成虚拟表格。表格展示使用报表引擎；ECharts 图表和仪表盘使用界面引擎。报表字段是虚拟字段，不能假设存在同名物理表列。
-
-## 建模顺序
-
-1. 明确指标口径、时间粒度、维度、权限和导出上限。
-2. 创建只读数据源（SQL/V8/JSON），使用稳定 `DataSourceKey`。
-3. 创建报表并绑定数据源。
-4. 配置字段 `Name/Label/Component`、查询列、排序、格式和表内编辑。
-5. 如需写操作，为查询/新增/修改/删除分别绑定专用接口引擎。
-6. 菜单只暴露用户需要的报表入口，配置数据范围。
-
-## 权限与 SQL
-
-- 报表数据源必须应用当前租户和服务端用户数据范围。菜单权限不会自动保护任意聚合 SQL。
-- 聚合结果也可能泄露敏感信息；小样本、人员薪资、客户金额等需最小分组阈值或字段脱敏。
-- SQL 动态值参数化，维度/排序/指标使用白名单映射，不接收原始 SQL、列名或 `GROUP BY`。
-- 管理员专用平台表不能作为普通用户报表数据源；只读委托表只有获得真实 `Read` 授权后才能查询，`mic_page/mic_print` 继续按角色权限处理。
-
-## 写入型报表
-
-统计报表通常来自多表。新增、修改、删除必须调用接口引擎，在一个事务中完成校验与写入：
-
-```js
-var result = await V8.ApiEngine.Run('report_adjust_inventory', {
-  RowId: V8.Form.Id,
-  ExpectedVersion: V8.Form.Version,
-  Quantity: Number(V8.Form.Quantity || 0)
-});
-```
-
-接口引擎重新校验角色、记录范围、当前版本和业务状态。前端隐藏按钮、只读字段或报表行数据不能作为授权。
-
-## 性能
-
-- 默认分页，限制最大页数/每页行数/导出行数。
-- 大聚合在数据库建立合适索引或使用预聚合表；不要每次全表扫描。
-- 缓存 Key 包含 `OsClient + ReportId + 权限主体/授权版本 + 查询参数哈希`。
-- 导出走后台任务；生成文件放私有桶并绑定菜单、记录和字段访问上下文。
-
-## MCP 工作流
-
-1. `microi_get_db_schema` 读取 `Rpt_Report`、数据源、字段、菜单和业务表。
-2. `microi_save_data_source` 保存数据源并回读。
-3. 创建/更新报表及字段；复杂写操作先创建接口引擎。
-4. 设置菜单与角色权限。
-5. 用真实普通角色验收列表、筛选、汇总、详情、编辑与导出。
-
-## 图表
-
-界面引擎图表应调用返回稳定 `{Code, Data}` 的统计接口引擎，不在前端下载明细再聚合。统计接口设置时间范围、维度和最大点数，返回空数据时保持稳定结构。
-
-## 验收清单
-
-- [ ] 指标口径、时区和小数精度明确
-- [ ] 当前租户与行级范围在数据库查询中生效
-- [ ] 虚拟字段与物理字段没有混用
-- [ ] 写操作走事务接口引擎并校验并发版本
-- [ ] 分页、聚合、导出均有资源上限
-- [ ] 缓存按租户和权限隔离
-- [ ] 普通角色、无权限角色、跨租户负向测试通过
+---
+name: report-engine
+description: Microi 报表引擎设计与验收规范。用于 Rpt_Report 虚拟表格、数据源、报表字段、查询/增删改接口替换、统计聚合、导出、行级权限和界面引擎图表。
+---
+
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
+
+# Microi 报表引擎
+
+## 定位
+
+报表引擎以 `Rpt_Report`、报表字段配置和数据源引擎组成虚拟表格。表格展示使用报表引擎；ECharts 图表和仪表盘使用界面引擎。报表字段是虚拟字段，不能假设存在同名物理表列。
+
+## 建模顺序
+
+1. 明确指标口径、时间粒度、维度、权限和导出上限。
+2. 创建只读数据源（SQL/V8/JSON），使用稳定 `DataSourceKey`。
+3. 创建报表并绑定数据源。
+4. 配置字段 `Name/Label/Component`、查询列、排序、格式和表内编辑。
+5. 如需写操作，为查询/新增/修改/删除分别绑定专用接口引擎。
+6. 菜单只暴露用户需要的报表入口，配置数据范围。
+
+## 权限与 SQL
+
+- 报表数据源必须应用当前租户和服务端用户数据范围。菜单权限不会自动保护任意聚合 SQL。
+- 聚合结果也可能泄露敏感信息；小样本、人员薪资、客户金额等需最小分组阈值或字段脱敏。
+- SQL 动态值参数化，维度/排序/指标使用白名单映射，不接收原始 SQL、列名或 `GROUP BY`。
+- 管理员专用平台表不能作为普通用户报表数据源；只读委托表只有获得真实 `Read` 授权后才能查询，`mic_page/mic_print` 继续按角色权限处理。
+
+## 写入型报表
+
+统计报表通常来自多表。新增、修改、删除必须调用接口引擎，在一个事务中完成校验与写入：
+
+```js
+var result = await V8.ApiEngine.Run('report_adjust_inventory', {
+  RowId: V8.Form.Id,
+  ExpectedVersion: V8.Form.Version,
+  Quantity: Number(V8.Form.Quantity || 0)
+});
+```
+
+接口引擎重新校验角色、记录范围、当前版本和业务状态。前端隐藏按钮、只读字段或报表行数据不能作为授权。
+
+## 性能
+
+- 默认分页，限制最大页数/每页行数/导出行数。
+- 大聚合在数据库建立合适索引或使用预聚合表；不要每次全表扫描。
+- 缓存 Key 包含 `OsClient + ReportId + 权限主体/授权版本 + 查询参数哈希`。
+- 导出走后台任务；生成文件放私有桶并绑定菜单、记录和字段访问上下文。
+
+## MCP 工作流
+
+1. `microi_get_db_schema` 读取 `Rpt_Report`、数据源、字段、菜单和业务表。
+2. `microi_save_data_source` 保存数据源并回读。
+3. 创建/更新报表及字段；复杂写操作先创建接口引擎。
+4. 设置菜单与角色权限。
+5. 用真实普通角色验收列表、筛选、汇总、详情、编辑与导出。
+
+## 图表
+
+界面引擎图表应调用返回稳定 `{Code, Data}` 的统计接口引擎，不在前端下载明细再聚合。统计接口设置时间范围、维度和最大点数，返回空数据时保持稳定结构。
+
+## 验收清单
+
+- [ ] 指标口径、时区和小数精度明确
+- [ ] 当前租户与行级范围在数据库查询中生效
+- [ ] 虚拟字段与物理字段没有混用
+- [ ] 写操作走事务接口引擎并校验并发版本
+- [ ] 分页、聚合、导出均有资源上限
+- [ ] 缓存按租户和权限隔离
+- [ ] 普通角色、无权限角色、跨租户负向测试通过