@lovrabet/rabetbase-cli 2.4.3 → 2.4.4-beta.1

package/skills/rabetbase/knowledge/page-schema/LrSmartEcharts.md

@@ -1,291 +0,0 @@
----
-name: LrSmartEcharts
-description: LrSmartEcharts 图表组件完整配置
-tags: [echarts, chart, page-schema]
----
-
-# LrSmartEcharts
-
-图表组件，用于数据可视化。
-
----
-
-## 禁止事项
-
-| 禁止 | 说明 |
-|------|------|
-| 中文别名 | SQL 字段名和 AS 别名必须使用英文 |
-| 编造字段 | 只能使用数据集字段列表里的 `code` |
-| 无 LIMIT | SQL 必须包含 `LIMIT 1000` |
-| 无 GROUP BY | 有聚合函数时必须 GROUP BY 所有非聚合字段 |
-
----
-
-## 数据源配置
-
-图表数据需要在 `page.dataSource.list` 中定义，组件通过 JSExpression 绑定：
-
-```json
-// Page 层：dataSource.list 配置（source/method/isCors/timeout 等平台自动补全，无需手写）
-{
-  "id": "chart_data_<nodeId>",
-  "type": "fetch",
-  "isInit": true,
-  "options": {
-    "uri": "/api/custom/execPreparedSql",
-    "params": {
-      "dbId": "<dbId>",
-      "sqlContent": "SELECT source, COUNT(*) as customer_count FROM <tableName> WHERE 1=1 GROUP BY source LIMIT 1000",
-      "params": {}
-    }
-  }
-}
-
-// Component 层：绑定 state
-{
-  "dataSource": {"type": "JSExpression", "value": "this.state.chart_data_<nodeId>"}
-}
-```
-
-> `<dbId>` 从 dataset_detail_tool 获取，`<tableName>` 为数据集对应的物理表名，`<nodeId>` 为组件节点 ID。
-
----
-
-## Props 属性
-
-### Agent 生成边界
-
-`LrSmartEcharts` 运行时消费 `cardItem`，组件内部会固定 `cardItem.display_type = "echarts"` 后透传给 `LrSmartChart`。
-
-Agent 生成 / 更新规则：
-
-- 可维护已有的稳定 `cardItem` 结构。
-- 只有在已有 dataset、字段 code、SQL 证据充分时，才生成或修改 `query_config`、`echarts_config`。
-- 不编造字段、表名、SQL 聚合语义。
-
-```json
-{
-  "dataSource": {"type": "JSExpression", "value": "this.state.chart_data_<nodeId>"},
-  "cardItem": {
-    "title": "图表标题",
-    "query_config": {"sqlContent": "...", "datasetId": "<datasetId>"},
-    "echarts_config": {
-      "chartType": "bar",
-      "dataMapping": {...},
-      "option": {...},
-      "theme": "default"
-    }
-  }
-}
-```
-
----
-
-## 图表类型
-
-| chartType | 用途 | dataMapping 要求 |
-|-----------|------|------------------|
-| bar | 对比、排行 | dimension + metrics |
-| line | 趋势分析 | dimension + metrics |
-| pie | 占比、构成 | dimension + metrics（单个） |
-| bar-horizontal | 横向对比 | dimension + metrics |
-| gauge | 单值 KPI | metrics（单个，无 dimension） |
-| funnel | 转化漏斗 | dimension + metrics |
-| radar | 多维评估 | dimension + metrics（多个） |
-| scatter | 相关性分析 | metrics（1-2 个） |
-
----
-
-## dataMapping 配置
-
-```json
-{
-  "dimension": {"field": "source", "alias": "客户来源"},
-  "metrics": [
-    {"field": "customer_count", "alias": "客户数量", "type": "bar", "axis": "left", "stack": "total", "smooth": true, "area": true, "formatter": "(v) => v", "styleFunction": "(v) => {}"}
-  ]
-}
-```
-
-| 属性 | 说明 |
-|------|------|
-| dimension.field | 维度字段（X 轴/分组） |
-| dimension.alias | 显示名称 |
-| metrics[].field | 指标字段（Y 轴/数值） |
-| metrics[].alias | 显示名称 |
-| metrics[].type | 混合图表：`bar` / `line` |
-| metrics[].axis | 双 Y 轴：`left` / `right` |
-| metrics[].stack | 堆叠分组名 |
-| metrics[].smooth | 平滑曲线（line） |
-| metrics[].area | 面积图（line） |
-| metrics[].formatter | 格式化函数：`(value) => string` |
-| metrics[].styleFunction | 条件样式：`(value) => {color: 'red'}` |
-
----
-
-## SQL 规范
-
-```sql
-SELECT {维度}, {聚合函数 AS 度量}
-FROM {tableName}
-WHERE 1=1
-  [AND ...]
-[GROUP BY {维度}]
-ORDER BY {排序} {ASC|DESC}
-LIMIT 1000
-```
-
-**硬性要求**：
-1. 字段名使用数据集字段的 `code`
-2. AS 别名必须英文
-3. `WHERE 1=1` 必须保留
-4. `LIMIT 1000` 必须存在
-5. 有聚合函数时必须 GROUP BY
-
-```sql
--- 示例
-SELECT source, COUNT(*) as customer_count
-FROM customer
-WHERE 1=1
-GROUP BY source
-ORDER BY customer_count DESC
-LIMIT 1000
-```
-
----
-
-## 主题
-
-| theme | 匹配关键词 |
-|-------|-----------|
-| default | 默认、专业、蓝色 |
-| colorful | 丰富、鲜艳、多彩 |
-| ocean | 清新、柔和、蓝绿 |
-| royal | 高端、紫色、金色 |
-| sunset | 暖色、橙色 |
-| forest | 绿色、自然 |
-| midnight | 深色、大屏 |
-| alert | 红色、告警 |
-| everyday | 朴素、简约 |
-| trendy | 潮流、炫酷 |
-| dreamy | 柔和、粉色 |
-
----
-
-## 常见配置
-
-### 柱状图
-
-```json
-{
-  "chartType": "bar",
-  "dataMapping": {
-    "dimension": {"field": "source", "alias": "客户来源"},
-    "metrics": [{"field": "customer_count", "alias": "数量"}]
-  },
-  "option": {"xAxis": {"type": "category"}, "yAxis": {"type": "value"}}
-}
-```
-
-### 饼图（环形）
-
-```json
-{
-  "chartType": "pie",
-  "dataMapping": {"dimension": {"field": "level_name", "alias": "等级"}, "metrics": [{"field": "count", "alias": "数量"}]},
-  "option": {"series": [{"radius": ["45%", "70%"]}]}
-}
-```
-
-### 混合图表（柱+线）
-
-```json
-{
-  "chartType": "bar",
-  "dataMapping": {
-    "dimension": {"field": "month", "alias": "月份"},
-    "metrics": [
-      {"field": "sales", "alias": "销售额", "type": "bar"},
-      {"field": "rate", "alias": "增长率", "type": "line", "axis": "right"}
-    ]
-  }
-}
-```
-
-### 仪表盘
-
-```json
-{
-  "chartType": "gauge",
-  "dataMapping": {"metrics": [{"field": "completion_rate", "alias": "完成率"}]},
-  "option": {"series": [{"progress": {"show": true}, "axisLine": {"lineStyle": {"width": 18}}}]}
-}
-```
-
-### 堆叠图表
-
-```json
-{
-  "chartType": "bar",
-  "dataMapping": {
-    "dimension": {"field": "month", "alias": "月份"},
-    "metrics": [
-      {"field": "product_a", "alias": "产品A", "stack": "total"},
-      {"field": "product_b", "alias": "产品B", "stack": "total"}
-    ]
-  }
-}
-```
-
-### 格式化
-
-```json
-{"metrics": [{"field": "amount", "alias": "金额", "formatter": "(v) => `¥${v.toLocaleString()}`}]}
-{"metrics": [{"field": "rate", "alias": "比率", "formatter": "(v) => `${v}%`"}]}
-```
-
-### 条件样式
-
-```json
-{"metrics": [{"field": "profit", "alias": "利润", "styleFunction": "(v) => v < 0 ? {color:'red'} : {}"}]}
-```
-
----
-
-## 常见问题
-
-| 问题 | 原因 | 解决方案 |
-|------|------|----------|
-| 图表不显示 | SQL 错误 | 检查 SQL 语法和字段名 |
-| 数据不对 | GROUP BY 缺失 | 添加 GROUP BY |
-| 字段名错误 | 使用了中文别名 | 使用英文 AS 别名 |
-| 查询超时 | 无 LIMIT | 添加 LIMIT 1000 |
-
----
-
-## 完整示例
-
-```json
-{
-  "componentName": "LrSmartEcharts",
-  "props": {
-    "dataSource": {"type": "JSExpression", "value": "this.state.chart_data_<nodeId>"},
-    "cardItem": {
-      "title": "客户来源分布",
-      "query_config": {
-        "sqlContent": "SELECT source, COUNT(*) as customer_count FROM <tableName> WHERE 1=1 GROUP BY source ORDER BY customer_count DESC LIMIT 1000",
-        "datasetId": "<datasetId>"
-      },
-      "echarts_config": {
-        "chartType": "bar",
-        "dataMapping": {
-          "dimension": {"field": "source", "alias": "客户来源"},
-          "metrics": [{"field": "customer_count", "alias": "客户数量"}]
-        },
-        "option": {"title": {"text": "客户来源分布"}, "xAxis": {"type": "category"}, "yAxis": {"type": "value"}},
-        "theme": "default"
-      }
-    }
-  }
-}
-```

package/skills/rabetbase/knowledge/page-schema/LrSmartStatistic.md

@@ -1,223 +0,0 @@
----
-name: LrSmartStatistic
-description: LrSmartStatistic 统计卡片组件完整配置
-tags: [statistic, page-schema]
----
-
-# LrSmartStatistic
-
-统计卡片组件，用于展示单值 KPI。
-
----
-
-## 数据源配置
-
-统计数据需要在 `page.dataSource.list` 中定义，组件通过 JSExpression 绑定：
-
-```json
-// Page 层：dataSource.list 配置（source/method/isCors/timeout 等平台自动补全，无需手写）
-{
-  "id": "chart_data_<nodeId>",
-  "type": "fetch",
-  "isInit": true,
-  "options": {
-    "uri": "/api/custom/execPreparedSql",
-    "params": {
-      "dbId": "<dbId>",
-      "sqlContent": "SELECT COUNT(*) AS value FROM <tableName> WHERE 1=1 LIMIT 1000",
-      "params": {}
-    }
-  }
-}
-
-// Component 层：绑定 state
-{
-  "dataSource": {"type": "JSExpression", "value": "this.state.chart_data_<nodeId>"}
-}
-```
-
-> `<dbId>` 从 dataset_detail_tool 获取，`<tableName>` 为数据集对应的物理表名，`<nodeId>` 为组件节点 ID。
-
----
-
-## Props 属性
-
-### Agent 生成边界
-
-`LrSmartStatistic` 运行时消费 `cardItem`，组件内部会固定 `cardItem.display_type = "statistic"` 后透传给 `LrSmartChart`。
-
-Agent 生成 / 更新规则：
-
-- 可维护已有的稳定 `cardItem` 结构。
-- 只有在已有 dataset、字段 code、SQL 证据充分时，才生成或修改 `query_config`、`statistic_config`。
-- 统计卡 SQL 必须返回单行单列并使用 `AS value`。
-
-```json
-{
-  "dataSource": {"type": "JSExpression", "value": "this.state.chart_data_<nodeId>"},
-  "cardItem": {
-    "title": "客户总数",
-    "display_type": "statistic",
-    "query_config": {"sqlContent": "...", "datasetId": "<datasetId>"},
-    "statistic_config": {
-      "value": "value",
-      "prefix": "¥",
-      "suffix": "个",
-      "precision": 2,
-      "groupSeparator": ",",
-      "theme": "default",
-      "formatter": "(v) => v"
-    }
-  }
-}
-```
-
----
-
-## 禁止事项
-
-| 禁止 | 说明 |
-|------|------|
-| 修改 `id` | 会丢失数据接口绑定 |
-| 修改 `statistic_config.value` | 必须为 "value" |
-| `meta.handleProps` | 使用纯 JSON |
-| SQL 返回多行多列 | 必须单行单列 |
-| SQL 不使用 `AS value` | 列名必须为 value |
-
----
-
-## SQL 规范
-
-**必须满足**：
-1. 返回单行单列，列名为 `value`
-2. 使用 `WHERE 1=1`
-3. 保留 `LIMIT 1000`
-4. 字段名使用数据集字段的 `code`
-
-```sql
-SELECT {聚合函数} AS value FROM <tableName> WHERE 1=1 [AND ...] LIMIT 1000
-```
-
-**常用聚合**：`COUNT(*)` / `SUM(field)` / `AVG(field)` / `MAX(field)` / `MIN(field)`
-
-**示例**：
-```sql
-SELECT COUNT(*) AS value FROM <tableName> WHERE 1=1 LIMIT 1000
-SELECT SUM(amount) AS value FROM <tableName> WHERE 1=1 AND status=2 LIMIT 1000
-SELECT AVG(score) AS value FROM <tableName> WHERE 1=1 LIMIT 1000
-```
-
----
-
-## statistic_config 属性
-
-| 属性 | 类型 | 说明 |
-|------|------|------|
-| value | string | 固定 `"value"` |
-| prefix | string | 前缀（如 `¥`） |
-| suffix | string | 后缀（如 `个`） |
-| precision | number | 小数位：计数类=0，金额类=2 |
-| groupSeparator | string | 千分位分隔符：`,` |
-| theme | string | 主题（见下表） |
-| formatter | string | 自定义格式化：`(value) => string` |
-| valueStyle | object | 自定义样式（仅 theme 不满足时使用） |
-
----
-
-## 主题
-
-| theme | 匹配关键词 |
-|-------|-----------|
-| default | 默认、专业、蓝色 |
-| colorful | 丰富、鲜艳、多彩 |
-| ocean | 清新、柔和、蓝绿 |
-| royal | 高端、紫色、金色 |
-| sunset | 暖色、橙色 |
-| forest | 绿色、自然 |
-| midnight | 深色、大屏 |
-| alert | 红色、告警 |
-| everyday | 朴素、简约 |
-| trendy | 潮流、炫酷 |
-| dreamy | 柔和、粉色 |
-
----
-
-## formatter 自定义格式化
-
-用于大数字转换（万/亿）、百分比等场景：
-
-```json
-// 大数字转万
-{"formatter": "(value) => value >= 10000 ? `${(value/10000).toFixed(1)}万` : `${value}`"}
-
-// 自动转换单位
-{"formatter": "(value) => { if (value >= 100000000) return `${(value/100000000).toFixed(2)}亿`; if (value >= 10000) return `${(value/10000).toFixed(1)}万`; return `${value}`; }"}
-
-// 百分比
-{"formatter": "(value) => `${(value * 100).toFixed(1)}%`"}
-```
-
-**注意**：使用 formatter 时，`prefix`/`suffix`/`precision` 可能不生效
-
----
-
-## 常见场景
-
-### 计数类
-
-```json
-{
-  "title": "客户总数",
-  "query_config": {"sqlContent": "SELECT COUNT(*) AS value FROM <tableName> WHERE 1=1 LIMIT 1000", "datasetId": "<datasetId>"},
-  "statistic_config": {"value": "value", "suffix": "个", "precision": 0, "groupSeparator": ","}
-}
-```
-
-### 金额类
-
-```json
-{
-  "title": "销售总额",
-  "query_config": {"sqlContent": "SELECT SUM(amount) AS value FROM <tableName> WHERE 1=1 LIMIT 1000", "datasetId": "<datasetId>"},
-  "statistic_config": {"value": "value", "prefix": "¥", "precision": 2, "groupSeparator": ","}
-}
-```
-
-### 时间范围
-
-```json
-// 本月
-{"sqlContent": "SELECT SUM(amount) AS value FROM <tableName> WHERE 1=1 AND YEAR(create_time)=YEAR(CURDATE()) AND MONTH(create_time)=MONTH(CURDATE()) LIMIT 1000"}
-
-// 最近30天
-{"sqlContent": "SELECT COUNT(*) AS value FROM <tableName> WHERE 1=1 AND create_time >= DATE_SUB(CURDATE(), INTERVAL 30 DAY) LIMIT 1000"}
-```
-
----
-
-## 完整示例
-
-```json
-{
-  "componentName": "LrSmartStatistic",
-  "props": {
-    "dataSource": {"type": "JSExpression", "value": "this.state.chart_data_<nodeId>"},
-    "cardItem": {
-      "title": "本月销售总额",
-      "display_type": "statistic",
-      "query_config": {
-        "sqlContent": "SELECT SUM(amount) AS value FROM <tableName> WHERE 1=1 AND YEAR(create_time)=YEAR(CURDATE()) AND MONTH(create_time)=MONTH(CURDATE()) LIMIT 1000",
-        "datasetId": "<datasetId>"
-      },
-      "statistic_config": {
-        "value": "value",
-        "theme": "sunset",
-        "prefix": "¥",
-        "precision": 2,
-        "groupSeparator": ",",
-        "formatter": "(value) => value >= 10000 ? `${(value/10000).toFixed(1)}万` : `${value}`"
-      }
-    }
-  }
-}
-```

package/templates/projects/sub-app-react-demo/.prettierrc

@@ -1 +0,0 @@
-{}

package/templates/projects/sub-app-react-demo/CHANGELOG.md

@@ -1,67 +0,0 @@
-# 更新记录
-
-## 2026-06-30
-
-### 更新初始化项目说明
-
-同步刷新 README 和快速开始文档，使初始化后的项目介绍与当前模板代码一致。
-
-**变更**：
-
-- 移除旧 `/hello-world`、`/chart-fetch`、`/intro` 实操路径，改为当前 `src/pages` 自动路由页面。
-- 统一本地启动、构建、预览命令为 `rabetbase run start/build/preview`。
-- 补充 `rabetbase project create`、`rabetbase config set appcode`、`rabetbase workspace init`、`rabetbase api pull` 的使用时机。
-- 补充 SDK 配置、微前端接入、CDN 产物和 Lovrabet 主应用页面配置说明。
-- 重做首页为 Prompt 开发入口，展示 AppCode 状态、Agent 场景示例、飞书文库导航、内置页面入口和主应用接入检查清单。
-
-## 2025-11-30
-
-### 📝 完善项目文档
-
-全面更新 README.md，使其准确反映当前项目状态。
-
-**变更**：
-
-- **项目结构更新**：更新为当时目录结构，包含页面示例和数据展示页面
-- **功能特性完善**：分为核心功能和技术特性两部分，详细描述各页面功能
-- **SDK 使用指南**：更新为实际的 SDK 调用方式（filter、getOne、create、update、delete），添加动态获取模型列表说明
-- **路由说明更新**：更新为当前实际的路由映射，补充布局系统说明
-- **部署指南完善**：添加 CDN 部署的两种方式（标准部署和版本化部署），补充主应用集成步骤
-- **新增开发注意事项**：添加环境要求、常见问题、代码规范等章节
-- **添加相关资源链接**：补充 Lovrabet 开放平台和相关文档链接
-
-## 2025-09-14
-
-### 🔧 实现自动路由生成
-
-引入 `vite-plugin-pages` 插件，基于文件系统自动生成路由配置。
-
-**变更**：
-
-- 新增 `vite-plugin-pages` 依赖
-- 路由配置改用虚拟模块 `~react-pages`
-- `HelloWorld.tsx` → `index.tsx` 作为默认首页
-
-**使用**：
-
-- `src/pages/index.tsx` → `/`
-- `src/pages/table-display.tsx` → `/table-display`
-- `src/pages/chart-fetch/index.tsx` → `/chart-fetch` (目录结构)
-
-支持文件和目录两种结构，新增页面只需在 `src/pages/` 下创建文件，无需手动配置路由。
-
-## 2025-09-12
-
-### 全面切换www.lovrabet.com域名
-
-Lovrabet启用新品牌域名 Lovrabet.com，并为了简化API架构，我们将原有的 `smartapi/dbapi` 双调用方式统一为单一 api 接口，同时迁移域名并简化URL路径结构。
-
-快速替换指南：
-
-将所有的
-`https://api.yuntooai.com/smartapi/runtime/[tenantCode]/`
-`https://api.yuntooai.com/dbapi/runtime/[tenantCode]/`
-批量替换为
-`https://runtime.lovrabet.com/api/`
-
-详情可查看 [Lovrabet API 地址规则变更通知](./docs/API_RULE_CHANGE.md)