Skill: androidxhm/cloudcc-cli-dev (version 1.0.1)

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

path: CLI_CHEATSHEET.md
content: ## 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>
```



path: VUE_CUSTOM_COMPONENT.md
content: ## 覆盖范围

本篇聚焦 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 复杂度上升时，再升级为组件方案。



Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)