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

package/skills/rabetbase/references/rabetbase-page-react-publish.md

@@ -4,7 +4,7 @@
 
 ```bash
 rabetbase page react-publish --id <pageId> --dry-run --format compress
-rabetbase page react-publish --id <pageId> --remark "发布说明" --yes
+rabetbase page react-publish --id <pageId> --remark "发布说明"
 ```
 
 ## 参数
@@ -19,5 +19,5 @@ rabetbase page react-publish --id <pageId> --remark "发布说明" --yes
 1. 先使用 `page react-detail` 检查 `status` 和页面版本
 2. `status` 为 `FORMAL` 时表示当前内容已经发布，跳过发布，继续查看已发布页面或后续流程
 3. `status` 不是 `FORMAL` 时，使用 `--dry-run` 确认目标页面和发布备注
-4. 用户明确确认后，使用相同参数加 `--yes` 执行发布
+4. 审阅预览后，使用相同参数移除 `--dry-run` 执行发布
 5. 命令发布后回读确认 `data.after.status` 为 `FORMAL`；`data.runtimePageUrl` 查看最近一次已发布内容，`data.pageUrl` 查看最新保存内容（包含尚未发布的修改），`data.editPageUrl` 用于打开页面编辑器。

package/skills/rabetbase/references/rabetbase-project-create.md

@@ -38,6 +38,9 @@ rabetbase project create my-project --appcode <code> --env production
 
 - `--name` 和位置参数二选一，`--name` 优先
 - 非交互模式下缺少项目名会报错
+- 项目名只接受字母、数字、`-`、`_`，不能传绝对路径、`../`、子目录路径或 Windows 保留名称
+- 交互与非交互模式使用同一创建流程，都会安装依赖、格式化代码并写入项目配置
+- 项目模板从 CDN 下载并校验 SHA-256；CDN 不可用、模板不兼容或校验失败时命令停止，修复后重试
 - 新项目中的 `.rabetbase.json` **只继承**全局中的少量偏好（如 `cookie`、`accessKey`、`locale`、`format`、`riskLevel`），**不会**把全局的 `apps` / `defaultApp` 复制进新项目
 
 ## 参考

package/skills/rabetbase/references/rabetbase-run.md

@@ -2,7 +2,7 @@
 
 执行 `package.json` 中定义的脚本。
 
-> **风险等级：high-risk-write** — 任意 package script 都可能修改本地文件、调用远端服务或执行发布动作。独立 CLI 需要人工提升顶层 `riskLevel`，正式执行还需交互确认或显式传 `--yes`；嵌入式 Rabetbase 工具暂不开放 `run`。
+> **风险等级：write** — 任意 package script 都可能修改本地文件、调用远端服务或执行发布动作。执行前必须先审阅 `package.json` 中对应脚本；嵌入式 Rabetbase 工具暂不开放 `run`。
 
 ## 命令
 

package/skills/rabetbase/references/rabetbase-sql-create.md

@@ -33,7 +33,7 @@ rabetbase sql create --name getUserMapper --db-id 10001 --mode mybatisXml --form
 ## 提示
 
 - 团队长期维护 SQL 时，用 `sql create` 建立本地同步资产
-- 生成后通常继续执行：编辑本地文件 → `sql validate --file ...` → `sql status` → `sql push --sqlcode ... --dry-run` → `sql push --sqlcode ... --yes`
+- 生成后通常继续执行：编辑本地文件 → `sql validate --file ...` → `sql status` → `sql push --sqlcode ... --dry-run` → `sql push --sqlcode ...`
 
 ## 参考
 

package/skills/rabetbase/references/rabetbase-sql-push.md

@@ -2,15 +2,15 @@
 
 将本地同步目录中的 SQL 文件上传到远端，并刷新 `.rabetbase/sql.lock.json`。
 
-> **风险等级：high-risk-write** — 建议先 `--dry-run` 预览；正式执行需 `--yes` 或交互确认。
+> **风险等级：write** — 建议先 `--dry-run` 预览。
 
 ## 命令
 
 ```bash
 rabetbase sql push --format json
 rabetbase sql push --sqlcode 2305f915-dd48cd4c --dry-run --format json
-rabetbase sql push --sqlcode 2305f915-dd48cd4c --yes --format json
-rabetbase sql push --sqlcode 2305f915-dd48cd4c --force --yes --format json
+rabetbase sql push --sqlcode 2305f915-dd48cd4c --format json
+rabetbase sql push --sqlcode 2305f915-dd48cd4c --force --format json
 ```
 
 ## 参数
@@ -20,7 +20,6 @@ rabetbase sql push --sqlcode 2305f915-dd48cd4c --force --yes --format json
 | `--sqlcode <code>` | string | 否 | — | 仅推指定 SQL；不传则扫描当前应用同步目录下的全部 SQL |
 | `--force` | boolean | 否 | — | 即使本地 hash 与 lock 一致也强制推送 |
 | `--dry-run` | boolean | 否 | — | 仅预览会推哪些 SQL |
-| `--yes` | boolean | 否 | — | 跳过高风险确认 |
 | `--format <fmt>` | string | 否 | `compress` | 输出格式 |
 
 ## 行为说明

package/skills/rabetbase/references/rabetbase-user-account.md

@@ -18,7 +18,6 @@ rabetbase user-account dingding-sandbox-bind \
 ```bash
 rabetbase user-account dingding-sandbox-bind \
   --ding-talk-user-id <id> \
-  --yes \
   --format compress
 ```
 

package/skills/rabetbase.manifest.json

@@ -2,8 +2,8 @@
   "schemaVersion": 1,
   "name": "rabetbase",
   "packageName": "@lovrabet/rabetbase-cli",
-  "packageVersion": "2.4.3-beta.1",
-  "skillVersion": "2.4.3-beta.1",
+  "packageVersion": "2.4.4-beta.1",
+  "skillVersion": "2.4.4-beta.1",
   "files": [
     "SKILL.md",
     "guides/backend-function.md",
@@ -24,10 +24,8 @@
     "guides/typescript-sdk.md",
     "knowledge/page-schema/LrSmartCreate.md",
     "knowledge/page-schema/LrSmartDetail.md",
-    "knowledge/page-schema/LrSmartEcharts.md",
     "knowledge/page-schema/LrSmartFilter.md",
     "knowledge/page-schema/LrSmartJsx.md",
-    "knowledge/page-schema/LrSmartStatistic.md",
     "knowledge/page-schema/LrSmartTable.md",
     "knowledge/page-schema/YtPage.md",
     "knowledge/page-schema/dataset-relations.md",
@@ -72,6 +70,7 @@
     "references/rabetbase-db-create.md",
     "references/rabetbase-db-delete.md",
     "references/rabetbase-db-detail.md",
+    "references/rabetbase-db-diff-refresh.md",
     "references/rabetbase-db-diff.md",
     "references/rabetbase-db-list.md",
     "references/rabetbase-db-tables.md",
@@ -94,6 +93,7 @@
     "references/rabetbase-menu-rename.md",
     "references/rabetbase-menu-sync.md",
     "references/rabetbase-notification-config-list.md",
+    "references/rabetbase-notification-config-mutations.md",
     "references/rabetbase-ocr.md",
     "references/rabetbase-page-generate-start.md",
     "references/rabetbase-page-generate-status.md",
@@ -133,5 +133,5 @@
     "references/rabetbase-user-account.md",
     "references/rabetbase-workspace.md"
   ],
-  "digest": "f30134f8a767c5ef6dba460110d38e8f8212c5e41b2bd24338f4a7909c6b3ccf"
+  "digest": "6169fd253d752d93e8f6528a2a2068e146360bbf8916bfe0434e6a8ee67b049a"
 }

package/templates/README.md

@@ -20,7 +20,7 @@ templates/
 
 ### 远程模板同步
 
-`projects/sub-app-react-demo/` 目录是从模板真源仓同步来的快照：
+`projects/sub-app-react-demo/` 目录是从模板真源仓同步来的 CDN 构建源：
 **仓库地址**: https://github.com/lovrabet/sub-app-react-demo
 
 #### 开发者：同步模板
@@ -31,9 +31,20 @@ templates/
 npm run sync-template
 ```
 
+模板同步完成后，更新模板自身的 `package.json#version`，再生成待发布的 CDN 资产：
+
+```bash
+npm run sync:cdn
+```
+
+该命令会在 `dist/rabetbase-cli/templates/projects/` 下生成
+`sub-app-react-demo.zip`，并把版本、文件名、大小和 SHA-256 写入现有
+`dist/rabetbase-cli/config/index.json`。ZIP 使用固定地址，每次发布直接覆盖。
+
 ### 模板结构
 
 项目模板应维护以下结构：
+
 - 标准的 React + Vite 设置
 - Ant Design 集成
 - icestark 微前端配置
@@ -51,7 +62,8 @@ npm run sync-template
 ## 注意事项
 
 - `templates/projects/sub-app-react-demo/` 是项目模板快照，不是独立 Git 仓
-- `rabetbase project create` 会复制项目模板，并更新 `package.json` 与 `.rabetbase.json`
+- `rabetbase project create` 从 CDN 下载 ZIP，然后更新 `package.json` 与 `.rabetbase.json`；此仓库模板不进入 npm 发布包
+- 模板文件名必须兼容 Windows、macOS 和 Linux；禁止符号链接、大小写冲突路径和 Windows 保留名称
 - 有 AppCode 时，CLI 会重新生成 `src/api/api.ts` 和 `src/api/client.ts`
 - 项目模板中不要保留真实 AppCode、真实数据集模型、`.git`、`node_modules`、`dist` 或个人配置
 - CLI 使用 `TemplateReplacer` 工具处理 `.tpl` 类模板

package/lib/commands/project/create/non-interactive.d.ts

@@ -1,9 +0,0 @@
-/**
- * 非交互模式的项目创建逻辑
- *
- * 用于 CI/CD 环境或没有 TTY 的场景
- */
-/**
- * 非交互模式创建项目
- */
-export declare function createProjectNonInteractive(projectName: string, env?: string, appCode?: string, cookie?: string): Promise<void>;

package/lib/commands/project/create/non-interactive.js

@@ -1 +0,0 @@
-(function(_0x3f7c52,_0x493fda){const _0x43e60e=a163_0x20aa,_0x57f4c0=_0x3f7c52();while(!![]){try{const _0x155cab=-parseInt(_0x43e60e(0x1eb))/0x1+-parseInt(_0x43e60e(0x1f7))/0x2+parseInt(_0x43e60e(0x1f0))/0x3*(-parseInt(_0x43e60e(0x209))/0x4)+parseInt(_0x43e60e(0x204))/0x5+-parseInt(_0x43e60e(0x1f9))/0x6*(parseInt(_0x43e60e(0x20b))/0x7)+-parseInt(_0x43e60e(0x210))/0x8*(parseInt(_0x43e60e(0x203))/0x9)+parseInt(_0x43e60e(0x1ec))/0xa;if(_0x155cab===_0x493fda)break;else _0x57f4c0['push'](_0x57f4c0['shift']());}catch(_0x1ee2e3){_0x57f4c0['push'](_0x57f4c0['shift']());}}}(a163_0x199d,0x9cd3a));import a163_0x5a6aad from'path';import a163_0x475b38 from'fs/promises';import{existsSync}from'fs';import{CLI_BIN_NAME}from'../../../constant/cli.js';import{DEFAULT_API_DIR}from'../../../constant/paths.js';import{exec,execSync}from'child_process';import{copyDirectory}from'../../../utils/copy-directory.js';import{promisify}from'util';import{assertCliVersionSupported,checkCliVersion,printCliUpgradeWarning}from'../../../utils/cli-version-check.js';import{writeConfigFile,NEW_CONFIG_NAME}from'../../../context.js';import{readConfig}from'../../../utils/config.js';import{getCliVersion}from'../../../utils/version.js';import{CliErrors}from'../../../errors.js';function a163_0x20aa(_0x6fbbf,_0x4bb98d){_0x6fbbf=_0x6fbbf-0x1e1;const _0x199d82=a163_0x199d();let _0x20aa4a=_0x199d82[_0x6fbbf];return _0x20aa4a;}import{fetchModelList}from'../../../core/api-client.js';import{generateApiFile}from'../../../api/generate-api-file.js';import{initEnv}from'../../../constant/env.js';import{getSubAppReactDemoTemplateDir}from'../../../commands/project/create/project-template-path.js';import{PROJECT_CREATE_INHERITABLE_KEYS,buildCanonicalProjectConfig}from'../../../config/schema.js';const execAsync=promisify(exec);export async function createProjectNonInteractive(_0x2498af,_0x631198,_0x2745aa,_0x4c5c9d){const _0x11c6af=a163_0x20aa,_0x17526b=await checkCliVersion();(_0x17526b[_0x11c6af(0x206)]||_0x17526b['belowMinimum'])&&(printCliUpgradeWarning(_0x17526b),assertCliVersionSupported(_0x17526b));if(!_0x2498af||_0x2498af[_0x11c6af(0x1e2)]()==='')throw CliErrors['validation'](_0x11c6af(0x205));const _0x7eddaf=/[<>:"|?*\x00-\x1f\x7f]/;if(_0x7eddaf[_0x11c6af(0x21b)](_0x2498af))throw CliErrors[_0x11c6af(0x1e9)](_0x11c6af(0x20c),_0x11c6af(0x1fd));if(_0x2498af['length']>0x64)throw CliErrors[_0x11c6af(0x1e9)](_0x11c6af(0x1ee));const _0x1f97ef=a163_0x5a6aad[_0x11c6af(0x218)](process[_0x11c6af(0x207)](),_0x2498af);if(existsSync(_0x1f97ef))throw CliErrors[_0x11c6af(0x1e9)](_0x11c6af(0x20f)+_0x2498af+_0x11c6af(0x1f2),_0x11c6af(0x21a));try{const _0x3b7bc1=a163_0x5a6aad['dirname'](_0x1f97ef);await a163_0x475b38['access'](_0x3b7bc1,a163_0x475b38['constants'][_0x11c6af(0x1f4)]);}catch{throw CliErrors[_0x11c6af(0x1e9)](_0x11c6af(0x219),_0x11c6af(0x1fe));}try{console[_0x11c6af(0x200)](_0x11c6af(0x1ef)+_0x2498af+'...');const _0x24f015=getSubAppReactDemoTemplateDir();await copyDirectory(_0x24f015,_0x1f97ef),console[_0x11c6af(0x200)](_0x11c6af(0x1e6)),await updatePackageJsonName(_0x2498af),console[_0x11c6af(0x200)](_0x11c6af(0x20a)),console['log'](_0x11c6af(0x1fa)),console['log'](_0x11c6af(0x1ff)),await formatCode(_0x1f97ef),console[_0x11c6af(0x200)](_0x11c6af(0x1e4)),await configureProject(_0x2498af,_0x2745aa,_0x631198),console[_0x11c6af(0x200)](_0x11c6af(0x212)),_0x2745aa&&await pullApiConfig(_0x1f97ef,_0x2745aa,_0x631198,_0x4c5c9d),console[_0x11c6af(0x200)](_0x11c6af(0x202)+_0x2498af+_0x11c6af(0x1f3)),console[_0x11c6af(0x200)]('\x0a\x20\x20cd\x20'+_0x2498af),console[_0x11c6af(0x200)](_0x11c6af(0x1e5));}catch(_0x4aa41a){try{existsSync(_0x1f97ef)&&await a163_0x475b38['rm'](_0x1f97ef,{'recursive':!![],'force':!![]});}catch{}throw _0x4aa41a;}}async function updatePackageJsonName(_0x4bc149){const _0x3c4e85=a163_0x20aa,_0x487df0=a163_0x5a6aad[_0x3c4e85(0x218)](process['cwd'](),_0x4bc149),_0x5b621f=a163_0x5a6aad[_0x3c4e85(0x1e7)](_0x487df0,_0x3c4e85(0x20e)),_0xa1ce46=await a163_0x475b38[_0x3c4e85(0x1f1)](_0x5b621f,_0x3c4e85(0x1ea)),_0x5b1f0e=JSON[_0x3c4e85(0x1f5)](_0xa1ce46);_0x5b1f0e[_0x3c4e85(0x211)]=_0x4bc149,_0x5b1f0e[_0x3c4e85(0x1e8)]=_0x3c4e85(0x1f6),await a163_0x475b38[_0x3c4e85(0x215)](_0x5b621f,JSON['stringify'](_0x5b1f0e,null,0x2)+'\x0a');}function detectPackageManager(){const _0x3cfc21=a163_0x20aa;try{return execSync(_0x3cfc21(0x21c),{'stdio':'ignore'}),'bun';}catch{return _0x3cfc21(0x1e1);}}async function formatCode(_0x4ce4df){const _0x512fe6=a163_0x20aa;try{await execAsync(_0x512fe6(0x216),{'cwd':_0x4ce4df});}catch{}}function a163_0x199d(){const _0x4d6a4a=['description','validation','utf-8','1117103zsigrb','42663330flYiFN','\x20\x20√\x20Pulled\x20','Project\x20name\x20is\x20too\x20long,\x20maximum\x20100\x20characters.','*\x20Creating\x20project\x20','877407oHKiAK','readFile','\x22\x20already\x20exists.','\x20created\x20successfully!','W_OK','parse','A\x20project\x20created\x20with\x20Lovrabet\x20CLI','2455866AwDkhb','chdir','4475358NjvHtb','\x20\x20Installing\x20dependencies...','toLocaleString','\x20dataset(s),\x20generated\x20','Not\x20allowed:\x20<\x20>\x20:\x20\x22\x20|\x20?\x20*\x20and\x20control\x20characters','Check\x20directory\x20permissions.','\x20\x20√\x20Dependency\x20install\x20skipped\x20(non-interactive)','log','\x20\x20!\x20API\x20pull\x20failed,\x20run\x20`','\x0a√\x20Project\x20','1359jCQpVz','1156510rcwwKH','Project\x20name\x20cannot\x20be\x20empty.','needsUpgrade','cwd','env','4helaEz','\x20\x20√\x20package.json\x20updated','7uhWeTh','Project\x20name\x20contains\x20invalid\x20characters.','length','package.json','Project\x20directory\x20\x22','25000yYPQnJ','name','\x20\x20√\x20Configuration\x20file\x20created','\x20model(s)','\x20\x20Pulling\x20API\x20configuration...','writeFile','bun\x20run\x20format','production','resolve','Cannot\x20create\x20project\x20in\x20current\x20directory.','Use\x20a\x20different\x20project\x20name.','test','bun\x20--version','npm','trim','string','\x20\x20√\x20Code\x20formatted','\x20\x20rabetbase\x20run\x20start\x0a','\x20\x20√\x20Project\x20template\x20created','join'];a163_0x199d=function(){return _0x4d6a4a;};return a163_0x199d();}async function configureProject(_0x32d805,_0x439782,_0x4e2236){const _0x4a1ab4=a163_0x20aa,_0x5730e3=a163_0x5a6aad['resolve'](process[_0x4a1ab4(0x207)](),_0x32d805),_0x91a148=a163_0x5a6aad['join'](_0x5730e3,NEW_CONFIG_NAME),_0x356f33=readConfig(),_0xe82ac=typeof _0x356f33[_0x4a1ab4(0x208)]===_0x4a1ab4(0x1e3)?_0x356f33['env']:undefined,_0x5aa5b1={};for(const _0x34051a of PROJECT_CREATE_INHERITABLE_KEYS){if(_0x356f33[_0x34051a]!=null)_0x5aa5b1[_0x34051a]=_0x356f33[_0x34051a];}const _0x5d531e=buildCanonicalProjectConfig(_0x5aa5b1,{'appCodes':_0x439782?[_0x439782]:[],'env':_0x4e2236||_0xe82ac||'production','metadata':{'createdAt':new Date()[_0x4a1ab4(0x1fb)](),'version':getCliVersion()}});writeConfigFile(_0x91a148,_0x5d531e);}async function pullApiConfig(_0xa8faf,_0x57a58b,_0x1318d2,_0x3cf271){const _0x2efdc=a163_0x20aa,_0x22d15c=process['cwd']();try{process[_0x2efdc(0x1f8)](_0xa8faf);const _0x891139=_0x1318d2||_0x2efdc(0x217);initEnv(_0x891139),console['log'](_0x2efdc(0x214));const {configArray:_0x515f70}=await fetchModelList(_0x57a58b,_0x3cf271||''),_0x51e770=await generateApiFile(_0x515f70,'',_0x57a58b,!![],_0x891139,DEFAULT_API_DIR);console['log'](_0x2efdc(0x1ed)+_0x515f70[_0x2efdc(0x20d)]+_0x2efdc(0x1fc)+_0x51e770['modelCount']+_0x2efdc(0x213));}catch(_0x4e594d){console[_0x2efdc(0x200)](_0x2efdc(0x201)+CLI_BIN_NAME+'\x20api\x20pull`\x20manually\x20later.');}finally{process[_0x2efdc(0x1f8)](_0x22d15c);}}

package/lib/utils/copy-directory.d.ts

@@ -1 +0,0 @@
-export declare function copyDirectory(src: string, dest: string): Promise<void>;

package/lib/utils/copy-directory.js

@@ -1 +0,0 @@
-(function(_0x522e80,_0x5e4e24){const _0x47ba8a=a278_0x1d19,_0x4d60d4=_0x522e80();while(!![]){try{const _0x4c3f42=parseInt(_0x47ba8a(0x121))/0x1+parseInt(_0x47ba8a(0x11b))/0x2+parseInt(_0x47ba8a(0x127))/0x3*(parseInt(_0x47ba8a(0x126))/0x4)+-parseInt(_0x47ba8a(0x11c))/0x5*(parseInt(_0x47ba8a(0x11e))/0x6)+parseInt(_0x47ba8a(0x120))/0x7+parseInt(_0x47ba8a(0x12c))/0x8*(-parseInt(_0x47ba8a(0x122))/0x9)+-parseInt(_0x47ba8a(0x11d))/0xa*(parseInt(_0x47ba8a(0x12b))/0xb);if(_0x4c3f42===_0x5e4e24)break;else _0x4d60d4['push'](_0x4d60d4['shift']());}catch(_0x20c10d){_0x4d60d4['push'](_0x4d60d4['shift']());}}}(a278_0x401a,0xa6f48));function a278_0x1d19(_0x37547b,_0x18fd68){_0x37547b=_0x37547b-0x11a;const _0x401a06=a278_0x401a();let _0x1d1985=_0x401a06[_0x37547b];return _0x1d1985;}function a278_0x401a(){const _0x2def31=['12vvPUpT','readdirSync','3838968zuLEuc','255166oRrANd','9NUrpjF','error','isDirectory','join','4XeCsWk','2228034xPnPtH','复制目录时出错:','copyFileSync','mkdirSync','12837ETRlGU','4689208dDTzVZ','name','821070uxZMbL','1051820tsUzgT','2280vAOpEf'];a278_0x401a=function(){return _0x2def31;};return a278_0x401a();}import a278_0x19f5e2 from'node:path';import a278_0x3d7510 from'node:fs';export async function copyDirectory(_0x1666e3,_0xdbd30a){const _0x53585f=a278_0x1d19;try{const _0x3629c3=a278_0x3d7510[_0x53585f(0x11f)](_0x1666e3,{'withFileTypes':!![]});a278_0x3d7510[_0x53585f(0x12a)](_0xdbd30a,{'recursive':!![]});for(const _0x16d038 of _0x3629c3){const _0x2f1c43=a278_0x19f5e2[_0x53585f(0x125)](_0x1666e3,_0x16d038['name']),_0x4069d0=a278_0x19f5e2[_0x53585f(0x125)](_0xdbd30a,_0x16d038[_0x53585f(0x11a)]);_0x16d038[_0x53585f(0x124)]()?await copyDirectory(_0x2f1c43,_0x4069d0):a278_0x3d7510[_0x53585f(0x129)](_0x2f1c43,_0x4069d0);}}catch(_0x6e55e){console[_0x53585f(0x123)](_0x53585f(0x128),_0x6e55e);}}

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"
-      }
-    }
-  }
-}
-```