cloudcc-cli 2.2.6 → 2.2.8

package/.cloudcc-cache.json

@@ -1,34 +1,38 @@
 {
+  "version_check": {
+    "timestamp": 1773991959371
+  },
+  "Je6yZ0TRyQFtpcH1gVKctqNhL": {
+    "username": "admin@testuat.com",
+    "baseUrl": "https://uat-one.cloudcc.cn/ccdomaingateway",
+    "orgId": "org28e02f50c6d727bbc",
+    "clientId": "MkZxyFscNEjHjQfR6lK4ZG8Ac",
+    "version": "public",
+    "openSecretKey": "ae62146f-e8d8-4cba-a60c-0d1e0cb80375",
+    "safetyMark": "Je6yZ0TRyQFtpcH1gVKctqNhL",
+    "CloudCCDev": "",
+    "apiSvc": "https://uat-one.cloudcc.cn/ccdomaingateway/apisvc",
+    "setupSvc": "https://uat-one.cloudcc.cn/ccdomaingateway/setup",
+    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYWRtaW5AdGVzdHVhdC5jb20iLCJiaW5kaW5nIjoiYzQ2MTFjMmYtZGYyNS00NTQ5LTkxZTktZDkzY2YyMGFjOWIzIiwiQ2xpZW50SWQiOiJNa1p4eUZzY05FakhqUWZSNmxLNFpHOEFjIiwiZXhwIjoxNzczODk5MzM1LCJvcmdJZCI6Im9yZzI4ZTAyZjUwYzZkNzI3YmJjIn0._cpwUjyBbaHYGphZ5pGAksySYeG_ErHx8mEc3r03mns",
+    "secretKey": "40e68c50d21f41a1a583d7a7d55da3",
+    "pluginToken": "unified20269eec2d32c",
+    "timestamp": 1773812935285
+  },
   "QVOllKTKhnm5oHp49tCsSHvHg": {
     "username": "appstore@cloudcc.cn",
     "baseUrl": "https://yundong.lightning.cloudcc.cn/ccdomaingateway",
+    "setupSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/setup",
     "orgId": "org9697882320dc71f28",
     "clientId": "bIA1IXRHl28hBkaQdiwQ63hZZ",
     "version": "public",
     "openSecretKey": "15bba2de-e6e7-42dc-9d7c-f9b157cd0ddb",
     "CloudCCDev": "",
     "safetyMark": "QVOllKTKhnm5oHp49tCsSHvHg",
+    "buildVersion": "v2",
     "apiSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/apisvc",
-    "setupSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/setup",
-    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYXBwc3RvcmVAY2xvdWRjYy5jbiIsImJpbmRpbmciOiJkYTY1NWYwOS02NmVmLTQ0NTktOTU5Ny05MmI3YWI1MTkzNTciLCJDbGllbnRJZCI6ImJJQTFJWFJIbDI4aEJrYVFkaXdRNjNoWloiLCJleHAiOjE3Njk3NjQ5NzYsIm9yZ0lkIjoib3JnOTY5Nzg4MjMyMGRjNzFmMjgifQ.Md2bT3oZKT-WHMLmEBdKw-sA9Hh2FC61qKTZffXHOJc",
+    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYXBwc3RvcmVAY2xvdWRjYy5jbiIsImJpbmRpbmciOiJhZDRmYWE4Ny0yNzZkLTRkNjQtYTcxZi0yZjdmZWUwNmExYTIiLCJDbGllbnRJZCI6ImJJQTFJWFJIbDI4aEJrYVFkaXdRNjNoWloiLCJleHAiOjE3NzQxNjQ3NjEsIm9yZ0lkIjoib3JnOTY5Nzg4MjMyMGRjNzFmMjgifQ.x2NLnkbHtx9J1qKMBG04PWVjoplNJFR6dpDNZLz28m0",
     "secretKey": "d99313b4298544bc8ca1ee7459227b",
-    "pluginToken": "unified202648c3bd21f",
-    "timestamp": 1769592177005
-  },
-  "9lTJpVZ7Gz6Q7Uu8KuO2BT4ED": {
-    "username": "cloudcc008@126.com",
-    "baseUrl": "https://cnbh01.cloudcc.cn/ccdomaingateway",
-    "setupSvc": "https://cnbh01.cloudcc.cn/ccdomaingateway/setup",
-    "orgId": "orgc481843971a8faa9a",
-    "clientId": "mruqXvHCsu1Mp6ZiFN30ddocZ",
-    "version": "public",
-    "openSecretKey": "88d38e16-3d07-49de-9de4-16bace67eaa6",
-    "safetyMark": "9lTJpVZ7Gz6Q7Uu8KuO2BT4ED",
-    "CloudCCDev": "",
-    "apiSvc": "https://cnbh01.cloudcc.cn/ccdomaingateway/apisvc",
-    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiY2xvdWRjYzAwOEAxMjYuY29tIiwiYmluZGluZyI6IjMzMDk1MmUxLTY2NTgtNGUzNS04M2ZkLTRkYjRmMTE2NGM0YyIsIkNsaWVudElkIjoibXJ1cVh2SENzdTFNcDZaaUZOMzBkZG9jWiIsImV4cCI6MTc2OTc3MjU0OCwib3JnSWQiOiJvcmdjNDgxODQzOTcxYThmYWE5YSJ9.sdMAQfcYG7zdAokg5eXU0dNbHas7wmK-l2S4YREProo",
-    "secretKey": "52f3abb9f50a4cc392dbf9549e158d",
-    "pluginToken": "unified20265de00f22d",
-    "timestamp": 1769599748664
+    "pluginToken": "unified2026624c45632",
+    "timestamp": 1773991961909
   }
 }

package/README.md

@@ -22,6 +22,30 @@ sudo npm i -g cloudcc-cli
 }
 ```
 
+# ReleaseV2.2.8
+
+#### Release Date: 2026-3-24
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Optimization
+  - Adjusted custom component `publish` and `pull`
+  - Fixed the issue where publishing components writes back the ID
+
+# ReleaseV2.2.7
+
+#### Release Date: 2026-3-20
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Optimization
+  - Standardized MCP usage: the `cc` command must be used
+  - Added a skill for accessing the `cc` command
+
 # ReleaseV2.2.6
 
 #### Release Date: 2026-2-25

package/bin/cc.js

@@ -27,6 +27,13 @@ if (!type) {
 }
 const cc = require("./index")
 try {
+    if (action === "doc") {
+        if (!cc[type]) {
+            throw new Error(`doc 不支持的类型: ${type}`);
+        }
+        cc[type]("doc", argvs);
+        return;
+    }
     cc[argvs[1]](argvs[0], argvs);
 } catch (e) {
     console.error()

package/cloudcc-cli-dev/BACKEND_CODE.md

@@ -0,0 +1,114 @@
+## 覆盖范围
+
+本篇聚焦 CloudCC 后端 Java 侧二开资产（通过 `cc` 命令）：
+
+- 自定义类（Class）
+- 定时类（Scheduled Class / Timer）
+- 触发器（Trigger）
+
+并给出“创建 → 拉取 → 编辑 → 发布”的闭环流程。
+
+---
+
+## 目录结构（以本仓库约定为准）
+
+创建后通常会生成在以下目录（项目根下）：
+
+- `classes/{ClassName}/...`
+- `schedule/{ScheduleName}/...`
+- `triggers/{objectName}/{triggerName}/...`
+
+---
+
+## 源码同步边界（必须理解）
+
+该项目使用“片段同步”策略：
+
+- **自定义类 / 定时类 / 触发器**：只会拉取/发布 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的内容。
+
+这意味着：
+
+- 你可以在片段外保留模板、import、类结构等；真正可同步的业务逻辑写在片段内。
+- 拉取会覆盖片段区域，因此片段内不要放本地专用逻辑（如临时调试代码）。
+
+---
+
+## 自定义类（Class）
+
+### 创建
+
+```bash
+# 在项目根目录执行
+cc create classes <ClassName>
+```
+
+### 拉取 / 发布（片段同步）
+
+```bash
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
+
+---
+
+## 定时类（Scheduled Class）
+
+### 创建
+
+```bash
+# 在项目根目录执行
+cc create schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+```
+
+---
+
+## 触发器（Trigger）
+
+### 创建（关键入参）
+
+触发器的 CLI 创建参数是一个 JSON 对象（需要 `encodeURI` 后作为单参传入）：
+
+```bash
+cc create triggers <encodedJson>
+```
+
+JSON 字段（示例）：
+
+- `name`: 触发器名（Java 命名规范）
+- `schemetableName`: 对象表名（如从对象列表拿到）
+- `targetObjectId`: 目标对象 ID
+- `triggerTime`: 触发时机（beforeInsert/afterUpdate/.../approval 等）
+
+示例（macOS/zsh，注意引号与编码）：
+
+```bash
+cc create triggers "$(node -e 'console.log(encodeURI(JSON.stringify({name:\"MyTrigger\",schemetableName:\"account\",targetObjectId:\"a01...\",triggerTime:\"beforeInsert\"})))')"
+```
+
+### 拉取 / 发布
+
+```bash
+# namePath 形如：objectName/triggerName（注意 objectName 通常为小写目录）
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+```
+
+> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
+
+---
+
+## 推荐工作流（AI 执行顺序）
+
+当需求涉及后端逻辑时，建议 AI 按以下顺序执行：
+
+1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
+2. 创建类/触发器/定时器骨架（create_*）
+3. 拉取线上版本（pull_*）对齐基线（如是增量改造）
+4. 编写片段内业务逻辑（注意批量与幂等）
+5. 发布（publish_*）
+6. 回归验证：单条、批量、权限、异常分支
+

package/cloudcc-cli-dev/CLI_CHEATSHEET.md

@@ -0,0 +1,90 @@
+## CLI 入口速查（本仓库已定义）
+
+`package.json` 中定义的 bin：
+
+- `cc`：主入口（支持 `create` / `get` / `pull` / `publish` / `doc` 等）
+- `cloudccCreate`：创建模板项目（内部调用 `src/project/create.js`）
+- `cloudccBuild`：组件发布/构建相关（内部调用 `src/plugin/publish.js`）
+
+---
+
+## 常用 CLI 命令速查（按开发流程分组）
+
+### 项目与文档
+
+```bash
+# 版本
+cc -v
+
+# 创建模板项目
+cc create project <projectName>
+
+# 输出项目文档（纯 CLI 文档）
+cc doc project overview
+cc doc project key-guide
+```
+
+### 对象与字段
+
+```bash
+# 创建自定义对象
+cc create object <projectPath> <label>
+
+# 查询对象列表（输出 JSON）
+# type 可选：standard / custom / both（默认：both）
+cc get object <projectPath> [type]
+
+# 查询对象字段（输出 JSON）
+cc get fields <projectPath> <objprefix>
+
+# 创建字段（字段类型决定参数个数）
+cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
+```
+
+### 菜单与应用
+
+```bash
+# 创建菜单（标签页）
+cc create menu <type> <projectPath> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+
+# 创建应用
+cc create application <projectPath> <appName> <appCode> [menuIds]
+```
+
+### 自定义类（classes）
+
+```bash
+cc create classes <ClassName>
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+### 定时类（schedule）
+
+```bash
+cc create schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+```
+
+### 触发器（triggers）
+
+```bash
+# 创建：参数是一个 JSON（需 encodeURI 后作为单个参数传入）
+cc create triggers <encodedJson>
+
+# 拉取/发布：namePath 形如 objectName/triggerName
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+```
+
+### 自定义组件（plugin / plugins）
+
+```bash
+# 创建（生成到 plugins/<pluginName>/）
+cc create plugin <pluginName>
+
+# 发布（编译并上传）
+cc publish plugin <pluginName>
+```
+

package/cloudcc-cli-dev/INSTALL_AND_BOOTSTRAP.md

@@ -0,0 +1,59 @@
+## 目标
+
+让开发者（或 AI）在一台新机器上，完成 `cloudcc-cli` 的安装、模板项目创建、开发密钥配置，并能通过 `cc` 命令进行开发与发布。
+
+---
+
+## 安装 cloudcc-cli
+
+### 全局安装
+
+```bash
+# Windows
+npm i -g cloudcc-cli
+
+# macOS（通常需要 sudo）
+sudo npm i -g cloudcc-cli
+```
+
+### 验证版本
+
+```bash
+cc -v
+```
+
+> 说明：`cc` 是该 CLI 的统一入口命令之一（见本仓库 `package.json` 的 bin 配置）。
+
+---
+
+## 创建 CloudCC 模板项目
+
+在你的工作目录下执行：
+
+```bash
+cc create project demo1
+cd demo1
+npm i
+npm run serve
+```
+
+如果能在本地启动并访问页面，说明前端开发链路可用。
+
+---
+
+## 配置开发者密钥与安全标记
+
+### 在 CloudCC CRM 后台获取
+
+你需要一个具备“代码管理/开发者权限”的账号。
+
+- **开发者密钥（CloudCCDev）**：在 CRM 后台「连接的应用程序」中新建后获取并复制。
+- **安全标记（safetyMark）**：在个人设置中重置安全标记后，通过邮箱获取。
+
+### 写入项目的 `cloudcc-cli.config.js`
+
+模板项目根目录通常会有 `cloudcc-cli.config.js`（或你们约定的同名配置文件），核心原则：
+
+- **多环境**：用 `use` 字段选择当前环境（如 `dev/uat/prod`）。
+- **不要提交真实密钥到 Git**：建议 `.gitignore` 忽略配置文件，或用本地私密文件方式管理。
+

package/cloudcc-cli-dev/OBJECTS_AND_FIELDS.md

@@ -0,0 +1,120 @@
+## 覆盖范围
+
+本篇聚焦用 `cloudcc-cli` 的 `cc` 命令完成：
+
+- 创建自定义对象（Custom Object）
+- 查询对象列表
+- 查询对象字段
+- 为对象创建字段（支持多字段类型）
+-（可选）创建菜单、创建应用（把对象挂到导航中）
+
+---
+
+## 自定义对象（Custom Object）
+
+### 你需要准备什么信息
+
+- **对象显示标签（label）**：例如“客户”“合同”“付款计划”
+- **项目路径（projectPath）**：模板项目根目录
+
+### CLI 命令（项目已有实现）
+
+```bash
+cc create object <projectPath> <label>
+```
+
+示例：
+
+```bash
+cc create object . 客户
+```
+
+---
+
+## 查询对象列表
+
+### CLI 命令（输出 JSON）
+
+```bash
+# type 可选：standard / custom / both（默认：both）
+cc get object <projectPath> [type]
+```
+
+示例：
+
+```bash
+cc get object . both
+```
+
+用途：
+
+- 获取对象 `objprefix` / 对象 `id`（后续创建字段、触发器会用到）
+
+---
+
+## 查询对象字段列表
+
+### CLI 命令（输出 JSON）
+
+```bash
+cc get fields <projectPath> <objprefix>
+```
+
+示例：
+
+```bash
+cc get fields . a01
+```
+
+用途：
+
+- 在创建字段前，先确认是否已存在同名/同含义字段，避免重复与冲突。
+
+---
+
+## 创建字段（Field）
+
+### CLI 命令形态（项目已有实现）
+
+字段创建命令由工具根据字段类型拼装，典型形态：
+
+```bash
+cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
+```
+
+### 字段类型选择建议（常用）
+
+- **S**：文本（最常用）
+- **N**：数字
+- **D / F**：日期 / 日期时间
+- **B**：复选框
+- **L / Q**：选项列表（单选/多选）
+- **Y / MR / M**：关系字段（查找/查找多选/主详）
+- **E / H / U**：邮箱/电话/URL
+
+---
+
+## 菜单与应用（让对象可访问）
+
+### 创建菜单（CLI）
+
+```bash
+cc create menu <type> <projectPath> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+```
+
+示例：
+
+```bash
+cc create menu object . <objectId> "我的对象菜单"
+```
+
+### 创建应用（CLI）
+
+```bash
+cc create application <projectPath> <appName> <appCode> [menuIds]
+```
+
+说明：
+
+- `menuIds`：可选，多个用逗号分隔；系统会确保默认菜单 `acf000001` 被包含。
+

package/cloudcc-cli-dev/REQUIREMENTS_BREAKDOWN.md

@@ -0,0 +1,98 @@
+## 目标
+
+把业务需求翻译成 CloudCC CRM 二开落地项，并选择“应该做什么组件”：自定义对象/字段/菜单/应用/自定义类/定时器/触发器/自定义组件/客户端脚本。
+
+---
+
+## 需求拆解模板（AI 必须输出）
+
+拿到需求后，先输出以下结构（缺信息则显式标注“待确认”）：
+
+- **背景与目标**：要解决什么问题，成功标准是什么。
+- **角色与权限**：涉及哪些用户/简档/权限集，是否需要后台权限调整。
+- **对象与数据模型**：
+  - 需要哪些**自定义对象**（表）？
+  - 需要哪些**字段**（类型、必填/唯一、默认值、选项、查找/主详关系）？
+  - 是否涉及**记录类型**、**布局**、**验证规则**（若 CLI 不覆盖，需在 CRM 配置）？
+- **业务流程**：
+  - 触发时机：保存前/保存后/提交审批/批处理/定时等
+  - 需要哪些自动化：校验、自动赋值、联动更新、异步任务、定时任务
+- **界面与交互**：
+  - 是否需要自定义页面或嵌入式 UI？
+  - 是否需要列表/详情/编辑页的前端交互（客户端脚本 / 自定义组件）？
+- **集成与外部依赖**：第三方接口、鉴权方式、重试/限流、日志与审计。
+- **风险与回滚**：数据迁移、权限影响、性能与批量场景、灰度与回滚方案。
+- **交付物清单**：最终要产出哪些 CloudCC 资产（对象/字段/菜单/应用/类/触发器/定时器/组件/脚本）。
+
+---
+
+## 方案选型决策表（怎么判断用什么）
+
+### 自定义对象（Custom Object）
+
+当出现以下需求时，优先考虑创建自定义对象：
+
+- 需要一个新的业务实体（类似新表），有独立的字段、权限、页面与列表
+- 需要与现有对象建立查找/主详关系
+- 需要支持审批、报表、共享规则等平台能力（通常都围绕对象展开）
+
+### 自定义字段（Field）
+
+当需求是“给已有对象补充数据结构”时：
+
+- 新增文本/数值/日期/选项/查找关系等字段
+- 需要字段级校验、默认值、必填等（部分能力可能需在 CRM 配置完成）
+
+### 触发器（Trigger）
+
+当需求是“数据写入前后做强一致业务逻辑”时：
+
+- 保存前校验/自动赋值/阻止不合法写入（before*）
+- 保存后联动更新、写日志、创建子记录（after*）
+- 批量/审批/提交后回调等特定时机（approval/batch/commitBatch 等）
+
+> 注意：触发器要考虑**批量**、幂等、递归、性能与异常处理。
+
+### 自定义类（Class）
+
+当需求是“可复用的服务逻辑/复杂计算/对外接口封装”时：
+
+- 作为触发器/定时器/页面调用的后端服务类
+- 抽取通用能力（查询封装、校验器、集成适配器）
+
+### 定时类（Scheduled Class / Timer）
+
+当需求是“按时间周期跑任务”时：
+
+- 夜间同步、定时报表、到期提醒、批量修复数据
+- 需要可控的调度表达式与运行日志
+
+### 自定义组件（Vue Custom Component）
+
+当需求是“在 CloudCC UI 中提供复杂交互 UI”时：
+
+- 自定义表单、复杂联动、可视化、批量操作 UI
+- 需要前端框架能力（Vue2.x）与更强的用户体验
+
+### 客户端脚本（Client Script）
+
+当需求是“页面级轻量交互/字段联动/保存前校验”时：
+
+- 列表/详情/编辑/新建页生命周期钩子
+- 字段变更联动、提示、轻量校验
+
+> 客户端脚本更轻量；交互复杂或需要组件化复用，建议升级为自定义组件。
+
+---
+
+## 推荐落地流程（AI 执行顺序）
+
+一般建议按以下顺序落地（从“数据结构”到“业务逻辑”再到“界面”）：
+
+1. **对象与字段**：先把数据模型搭好（对象、字段、关系）
+2. **菜单与应用**：让用户能访问（菜单/应用）
+3. **后端逻辑**：自定义类 / 触发器 / 定时器
+4. **前端交互**：客户端脚本 / 自定义组件
+5. **联调与回归**：核心路径 + 批量场景 + 权限场景
+6. **发布与回滚准备**：版本记录、灰度、回滚策略
+

package/cloudcc-cli-dev/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: cloudcc-cli-dev
+description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案选型，并通过 cloudcc-cli（cc 命令）创建/拉取/发布自定义对象、字段、菜单/应用、自定义类、定时器、触发器与 Vue 自定义组件等资产。用户提到 CloudCC、cloudcc-cli、cc 命令、对象/字段/触发器/定时器/自定义组件 时应优先使用。
+---
+
+# CloudCC CLI Development Skill
+
+## cloudcc-cli
+- 需要检查全局是否安装了cloudcc-cli npm包，如果没有请先安装。
+
+## 工作目录
+- 在openclaw环境中，需要在agent的workspace中创建code文件夹，然后在code文件中使用cc create project xxx，创建一个模版项目。
+
+## 使用方式（AI 必须遵循）
+
+- 先阅读 `REQUIREMENTS_BREAKDOWN.md`，输出需求拆解与交付物清单，再进入落地步骤。
+- 需要环境/密钥 配置时，阅读 `INSTALL_AND_BOOTSTRAP.md`。
+- 需要建模时（对象/字段/菜单/应用），阅读 `OBJECTS_AND_FIELDS.md`。
+- 需要后端逻辑时（类/定时器/触发器），阅读 `BACKEND_CODE.md`。
+- 需要自定义组件时，阅读 `VUE_CUSTOM_COMPONENT.md`。
+- 需要快速对照命令与参数时，阅读 `CLI_CHEATSHEET.md`。
+
+## 强制安全边界
+
+- 不要在输出/代码/提交中包含真实密钥（`CloudCCDev`、`safetyMark`、`secretKey`、`openSecretKey`、token
+  等）。
+- 后端类/触发器/定时器遵守片段同步：仅在
+  `@SOURCE_CONTENT_START`~`@SOURCE_CONTENT_END` 内编写可发布逻辑。
+- 客户端脚本遵守片段同步：仅在 `function main($CCDK, obj) { ... }`
+  的函数体内编写可发布逻辑。
+
+## 快速入口
+
+- 安装与初始化：`INSTALL_AND_BOOTSTRAP.md`
+- 需求拆解与方案选择：`REQUIREMENTS_BREAKDOWN.md`
+- 自定义对象与字段：`OBJECTS_AND_FIELDS.md`
+- 自定义类/定时器/触发器：`BACKEND_CODE.md`
+- Vue 自定义组件：`VUE_CUSTOM_COMPONENT.md`
+- CLI 速查：`CLI_CHEATSHEET.md`

package/cloudcc-cli-dev/VUE_CUSTOM_COMPONENT.md

@@ -0,0 +1,50 @@
+## 覆盖范围
+
+本篇聚焦 CloudCC Vue2.x 自定义组件（Custom Component）：
+
+- 创建组件骨架
+- 编辑与最佳实践入口
+- 编译与发布到服务器
+
+---
+
+## 创建自定义组件
+
+### CLI 命令
+
+```bash
+# 在项目根目录执行（会生成到 plugins/<pluginName>/）
+cc create plugin <pluginName>
+```
+
+创建后会生成组件主文件、子组件目录与配置文件（以项目模板为准）。
+
+---
+
+## 发布组件
+
+```bash
+cc publish plugin <pluginName>
+```
+
+> 发布会执行编译/打包/上传；如果组件依赖复杂，注意依赖收集与发布策略。
+
+---
+
+## 编辑要点（CLI 项目约束）
+
+- 组件目录通常为 `plugins/<pluginName>/`
+- 确保所有 `<style>` 标签带 `scoped`，避免全局样式污染
+- 发布通过 `cc publish plugin <pluginName>` 执行编译与上传
+
+---
+
+## 选型建议（组件 vs 客户端脚本）
+
+- **自定义组件**：复杂交互、强 UI、可复用组件化、需要更完整工程化能力。
+- **客户端脚本**：轻量联动、页面钩子逻辑、少量 UI 提示与校验。
+
+一般建议：
+
+- 先用脚本满足基础联动；当逻辑与 UI 复杂度上升时，再升级为组件方案。
+