cloudcc-cli 2.3.1 → 2.3.3

package/src/triggers/docs/devguide.md

@@ -0,0 +1,442 @@
+# CloudCC 触发器使用总结
+
+> 基于 25 个生产环境触发器实例分析。
+> 文档版本：v1.0
+> 更新时间：2026-03-24
+
+---
+
+## CLI 与本地文件（必读）
+
+本仓库中的触发器源码通过 **cloudcc-cli** 与平台同步，本地目录为 **`triggers/<对象 API 名小写>/<触发器名>/`**（内含 `*.java`、`config.json`），源码中的 `// @SOURCE_CONTENT_START` … `// @SOURCE_CONTENT_END` 与发布、拉取逻辑一致。**必须通过下列命令** 完成新建、发布、拉取与删除；不要手工拼目录、不要整包复制其他项目的触发器、不要私自篡改 `config.json` 中的 `id`、`apiname` 等字段。
+
+**允许的做法**：在 CLI 已生成的主类中，仅在上述 SOURCE 标记之间编写业务逻辑；与云端列表、详情、拉取、删除、发布相关的操作一律走命令。
+
+执行命令前请确认：已完成 `cc doc project devguide` 中的环境初始化，项目根目录配置可用且包含 `accessToken`。创建触发器前通常需要先通过 `cc get object ...` 等拿到目标对象的 `schemetableName`、`targetObjectId`（见下文物「创建」示例）。
+
+### 命令总览（以代码实现为准）
+
+```bash
+cc create triggers <encodedCreateJson>
+cc publish triggers <namePath>
+cc pull triggers <namePath>
+cc get triggers <listQueryJson> [projectPath]
+cc detail triggers <namePath>
+cc detail triggers "" <id>
+cc pullList triggers <id> <projectPath>
+cc delete triggers <namePathOrId> [projectPath]
+cc doc triggers <introduction|devguide>
+```
+
+参数约定：
+
+- `encodedCreateJson`：`encodeURI(JSON.stringify({ ... }))`，其中至少包含：
+  - `schemetableName`：目标对象 API 名（如 `Account`）
+  - `targetObjectId`：目标对象 ID
+  - `triggerTime`：触发时机（如 `beforeInsert`、`beforeUpsert` 等，以平台为准）
+  - `name`：触发器类名（目录名）
+  - `apiname`：触发器 API 名（全局唯一）
+- `namePath`：**对象目录/触发器名**，与本地路径一致，例如 `account/MyTrigger`（`schemetableName` 小写 + `/` + `name`）。`publish`、`pull`、`delete`（按路径删除时）均使用该形式。
+- `listQueryJson`：列表查询 JSON，经 `encodeURI(JSON.stringify(...))` 编码后传入（**必填**，实现上无默认空查询）。
+- `projectPath`：项目根路径，可选。
+- `id`：线上触发器 ID。`detail` 仅查服务器：`cc detail triggers "" <id>`。
+- `namePathOrId`：可为 `对象小写/触发器名` 形式的路径；若本地 `config.json` 含 `id`，删除时优先用该 ID。
+
+### 命令作用摘要
+
+| 命令 | 作用 |
+|------|------|
+| `create` | 在 `triggers/<对象小写>/<name>/` 生成继承 `CCTrigger` 的 Java 与 `config.json` |
+| `publish` | 提交 SOURCE 区域等到服务器；首次成功后可写回 `config.json` 的 `id`、`apiname` 等 |
+| `pull` | 按本地已发布 `id` 拉取远端源码，覆盖 SOURCE 区域 |
+| `get` | 按条件查询线上触发器列表（JSON 输出） |
+| `detail` | 按 `namePath` 优先读本地；或仅按 `id` 读服务器 |
+| `pullList` | 按触发器 `id` 还原到指定项目的 `triggers/...` |
+| `delete` | 删除服务器上的触发器 |
+| `doc` | 输出模块文档；`devguide` 含附录后端 Java SDK 速查 |
+
+### 创建示例（需先准备对象信息）
+
+先构造对象（字段与平台约定一致），再整段做 `encodeURI(JSON.stringify(...))`，作为 `cc create triggers` 的**唯一参数**：
+
+```json
+{
+  "schemetableName": "Account",
+  "targetObjectId": "<目标对象 ID>",
+  "triggerTime": "beforeInsert",
+  "name": "MyTrigger",
+  "apiname": "NTrigger_unique_api_name"
+}
+```
+
+在 Node 中生成编码后参数示例：
+
+```bash
+node -p "encodeURI(JSON.stringify({schemetableName:'Account',targetObjectId:'<对象ID>',triggerTime:'beforeInsert',name:'MyTrigger',apiname:'NTrigger_xxx'}))"
+```
+
+将命令输出的**一整行**传给：`cc create triggers '<粘贴>'`。
+
+### 推荐操作顺序
+
+```bash
+# 1) 查询自定义对象，取得 schemetableName、targetObjectId（示例）
+cc get object . custom
+
+# 2) 创建本地触发器目录与模板（encodedCreateJson 见上文）
+cc create triggers '<encodedCreateJson>'
+
+# 3) 编辑 triggers/<对象小写>/<name>/<name>.java 中 SOURCE 后发布
+cc publish triggers account/MyTrigger
+
+# 4) 与服务器对齐
+cc pull triggers account/MyTrigger
+
+# 5) 列表（查询 JSON 需 encodeURI）
+cc get triggers '<listQueryJson>' .
+
+# 6) 按线上 ID 拉到指定项目
+cc pullList triggers <线上触发器ID> <projectPath>
+
+# 7) 删除
+cc delete triggers account/MyTrigger
+```
+
+### 文档子命令
+
+```bash
+cc doc triggers introduction
+cc doc triggers devguide
+```
+
+仅支持 `introduction` 与 `devguide`。
+
+---
+
+## 一、什么是触发器
+
+CloudCC 触发器是完全符合 Java 语法规范的代码，在特定业务事件发生时自动执行，实现业务逻辑自动化处理。
+
+触发器本质：
+- 一段 Java 代码，运行在 CloudCC 平台沙箱环境中
+- 使用 CCService、CCObject 等平台提供的 API 类
+- 在数据变更的特定时刻（前/后）自动触发执行
+
+## 二、触发器能干什么
+
+### 2.1 核心能力
+
+| 能力 | 说明 | 示例 |
+|------|------|------|
+| 自动赋值 | 在记录保存前自动计算并填充字段 | 个人业绩/部门业绩自动赋值 |
+| 数据校验 | 阻止不符合业务规则的数据保存 | 预算金额校验、审批金额验证 |
+| 关联更新 | 修改一条记录时自动更新关联记录 | 回款明细汇总到收款计划 |
+| 自动生成 | 根据业务规则自动创建新记录 | 审批通过后自动生成回款记录 |
+| 权限控制 | 自动设置数据共享权限 | 按部门/人员自动共享 |
+| 状态同步 | 审批状态变更后同步更新相关字段 | 预算审批状态回写 |
+| 汇总计算 | 实时汇总明细数据到主记录 | 部门业绩字段汇总 |
+
+### 2.2 技术能力（基于 CCService API）
+
+```java
+// 1. 新增记录
+CCObject opp = new CCObject("Opportunity");
+opp.put("name", "value");
+cs.insert(opp);
+
+// 2. 查询记录（指定字段）
+List<CCObject> opps1 = cs.cqueryByFields(
+  "Opportunity",
+  "khmc__c='" + record_new.get("id") + "'",
+  "id,name,createdate"
+);
+
+// 3. 查询记录（全部字段）
+List<CCObject> opps2 = cs.cquery(
+  "Opportunity",
+  "khmc__c='" + record_new.get("id") + "'"
+);
+
+// 4. 复杂查询
+List<CCObject> ccobjs = cs.cqlQuery(
+  "Opportunity",
+  "select sum(amount) as sumAmount from Opportunity where khmc='0012001238ytwuiw'"
+);
+
+// 5. 修改/删除
+cs.update(opp);
+cs.delete(opp);
+
+// 6. 发送邮件通知
+SendEmail sendEmail = new SendEmail(userInfo);
+sendEmail.sendMailFromSystem(toAddress, ccAddress, bccAddress, subject, content, isText);
+```
+
+---
+
+## 三、触发器的触发时机详解
+
+### 3.1 beforeUpsert（创建或更新前）
+- 执行时机：记录保存之前，数据尚未写入数据库
+- 典型用途：自动计算字段、数据格式校验、阻止非法数据保存、自动填充默认值
+- 生产实例：个人业绩/部门业绩赋值、计算产研成本/净业绩、生成部门/个人业绩
+
+```java
+// beforeUpsert 示例
+CCObject record = (CCObject) data.get("record");
+BigDecimal income = record.getBigDecimal("ysr");
+BigDecimal cost = record.getBigDecimal("cycb");
+BigDecimal net = income.subtract(cost);
+record.put("jyj", net);
+if (net.compareTo(BigDecimal.ZERO) < 0) {
+  throw new Exception("毛利不能为负数！");
+}
+```
+
+### 3.2 afterInsert（创建后）
+- 执行时机：记录创建成功后（可获取 ID）
+- 典型用途：基于新记录 ID 创建关联记录、发送创建通知、初始化关联数据
+- 生产实例：根据净业绩拆分生成净业绩拆分回款
+
+```java
+// afterInsert 示例
+CCObject newRecord = (CCObject) data.get("record");
+String recordId = newRecord.getString("id");
+CCObject hkRecord = new CCObject("Huikuan");
+hkRecord.put("mingxi__c", recordId);
+hkRecord.put("je", newRecord.get("je"));
+cs.insert(hkRecord);
+```
+
+### 3.3 afterUpsert（创建或更新后）
+- 执行时机：记录保存成功后（新增或修改）
+- 典型用途：汇总数据到父记录、触发下游流程、更新关联记录状态
+- 生产实例：金额汇总到收款计划、更新部门业绩字段、更新回款明细
+
+```java
+// afterUpsert 示例 - 汇总金额到父记录
+CCObject detail = (CCObject) data.get("record");
+String planId = detail.getString("skjh__c");
+List<CCObject> plans = cs.cqueryByFields(
+  "ShoukuanJihua",
+  "id='" + planId + "'",
+  "id,shyjje,yishouje"
+);
+if (!plans.isEmpty()) {
+  CCObject plan = plans.get(0);
+  BigDecimal current = plan.getBigDecimal("yishouje");
+  BigDecimal detailAmount = detail.getBigDecimal("je");
+  plan.put("yishouje", current.add(detailAmount));
+  cs.update(plan);
+}
+```
+
+### 3.4 afterDelete（删除后）
+- 执行时机：记录删除成功后
+- 典型用途：清理关联数据、反向汇总更新
+- 生产实例：回款明细删除后重新计算回款金额
+
+### 3.5 approval（审批时）
+- 执行时机：记录提交审批或审批通过时
+- 典型用途：审批前校验、审批通过后执行业务操作
+- 生产实例：更新拆分审批状态、订单审批判断、审批通过计算剩余欠款
+
+---
+
+## 四、为什么要用触发器
+
+### 4.1 解决的核心问题
+
+| 问题 | 传统方案 | 触发器方案 |
+|------|----------|------------|
+| 数据一致性 | 依赖用户手动操作，容易遗漏 | 自动执行，保证数据准确 |
+| 业务规则执行 | 前端校验可绕过 | 统一在平台层执行，无法绕过 |
+| 跨对象联动 | 需要多次手动操作 | 自动关联更新 |
+| 审批复杂逻辑 | 审批流配置难以承载 | Java 代码可实现复杂逻辑 |
+| 实时性要求 | 定时任务有延迟 | 实时触发，立即执行 |
+
+### 4.2 与其他方案对比
+
+| 方案 | 优点 | 缺点 | 适用场景 |
+|------|------|------|----------|
+| 触发器 | 实时、自动、无法绕过 | 需要 Java 开发能力 | 核心业务逻辑 |
+| 审批流 | 配置简单、可视化 | 逻辑能力有限 | 简单审批流程 |
+| 工作流 | 可视化编排 | 复杂逻辑实现困难 | 跨系统流程编排 |
+| 定时任务 | 适合批量处理 | 有延迟 | 数据同步、报表生成 |
+
+---
+
+## 五、典型业务场景
+
+### 5.1 财务业绩管理（核心场景）
+
+```text
+订单 (Order)
+  └─ approval：审批判断
+预算 (Budget)
+  ├─ beforeUpsert：计算产研成本/净业绩
+  └─ afterUpsert：自动拆分/生成回款
+净业绩拆分 (jyjcf)
+  ├─ beforeUpsert：生成部门/个人业绩
+  └─ afterUpsert：校验金额累计是否超预算
+部门业绩 (bmyj)
+  ├─ afterUpsert：更新部门业绩字段
+  └─ afterUpdate：汇总部门资金池
+回款明细 (cloudccproceeddetail)
+  ├─ afterInsert：生成净业绩拆分回款
+  ├─ afterUpsert：金额汇总到收款计划
+  ├─ afterUpsert：更新回款明细
+  └─ afterDelete：回款明细删除
+```
+
+### 5.2 费用报销管理
+
+```text
+费用报销提交
+  -> approval 触发器：验证审批时校验预算（报销金额 <= 预算余额）
+审批通过
+  -> approval 触发器：计算剩余欠款（借款 - 报销）
+```
+
+### 5.3 借款还款管理
+
+| 触发器 | 对象 | 时机 | 作用 |
+|--------|------|------|------|
+| 借款单触发器 | 借款单 | beforeUpsert | 借款前校验、自动计算 |
+| 还款记录审批通过更新借款单 | 还款记录 | approval | 审批后回写借款单 |
+
+---
+
+## 六、触发器开发最佳实践
+
+### 6.1 代码规范
+
+```java
+try {
+  CCObject record = (CCObject) data.get("record");
+  cs.update(record);
+} catch (Exception e) {
+  System.out.println("触发器执行失败：" + e.getMessage());
+  throw new Exception("业务校验失败：" + e.getMessage());
+}
+```
+
+### 6.2 性能优化
+
+```java
+// 推荐：字段过滤，只查询需要的字段
+List<CCObject> records = cs.cqueryByFields(
+  "Object__c",
+  "status__c='active'",
+  "id,name,amount__c"
+);
+
+// 推荐：批量更新，降低递归风险
+cs.updateLt(records);
+```
+
+### 6.3 避免递归触发
+
+```java
+// 方法 1：使用 updateLt
+cs.updateLt(records);
+
+// 方法 2：增加标志位（示例）
+if ("true".equals(System.getProperty("trigger.running"))) {
+  return;
+}
+System.setProperty("trigger.running", "true");
+cs.update(record);
+System.setProperty("trigger.running", "false");
+```
+
+---
+
+## 七、触发器调试与监控
+
+### 7.1 日志记录
+
+```java
+System.out.println("=== 触发器开始执行 ===");
+System.out.println("对象：" + record.getSObjectName());
+System.out.println("操作：" + data.get("action"));
+System.out.println("记录 ID：" + record.get("id"));
+```
+
+### 7.2 常见问题排查
+
+| 问题 | 可能原因 | 解决方案 |
+|------|----------|----------|
+| 触发器不执行 | 未激活、触发时机不对 | 检查状态与配置 |
+| 递归触发 | 更新操作再次触发触发器 | 使用 `updateLt` 或增加条件判断 |
+| 性能问题 | 查询数据量过大 | 增加查询条件、字段过滤 |
+| 数据不一致 | 触发器执行失败 | 增加异常处理与关键日志 |
+
+---
+
+## 八、总结
+
+### 8.1 触发器价值
+1. 自动化：减少人工操作，降低出错率
+2. 一致性：保证数据准确与规则统一执行
+3. 实时性：业务变更立即响应
+4. 灵活性：Java 代码可承载复杂逻辑
+
+### 8.2 适用与不适用场景
+
+**适合使用触发器：**
+- 需要实时数据联动
+- 核心业务规则校验
+- 跨对象数据同步
+- 审批流程复杂逻辑
+- 自动创建或更新关联记录
+
+**不适合使用触发器：**
+- 简单字段默认值（优先配置化能力）
+- 大批量离线数据处理
+- 跨系统集成调用
+- 强交互型前端界面逻辑
+
+### 8.3 触发器开发 Checklist
+
+- [ ] 本地 `triggers/` 目录仅通过 `cc create` / `cc pull` / `cc pullList` / `cc publish` / `cc delete` 等命令维护，不手造路径、不手改 `config.json` 的 `id`
+- [ ] 明确触发时机（before/after/approval）
+- [ ] 评估并规避递归触发风险
+- [ ] 添加异常处理与关键日志
+- [ ] 覆盖边界条件测试
+- [ ] 完成大数据量场景性能测试
+
+---
+
+## 附录：25 个生产触发器清单
+
+| # | 名称 | 对象 | 时机 | 状态 |
+|---|------|------|------|------|
+| 1 | 个人业绩/部门业绩赋值 | 对外付款 | beforeUpsert | ✅ |
+| 2 | 个人业绩/部门业绩赋值 | 费用报销 | beforeUpsert | ❌ |
+| 3 | 本部业绩统计 | 本部业绩统计 | beforeUpsert | ✅ |
+| 4 | 更新拆分审批状态 | 预算 | approval | ✅ |
+| 5 | 订单审批判断 | 订单 | approval | ✅ |
+| 6 | 根据净业绩拆分生成净业绩拆分回款 | 回款明细 | afterInsert | ✅ |
+| 7 | 金额汇总到收款计划 | 回款明细 | afterUpsert | ✅ |
+| 8 | 回款明细删除 | 回款明细 | afterDelete | ❌ |
+| 9 | 计算产研成本/净业绩 | 预算 | beforeUpsert | ✅ |
+| 10 | 保证金回款记录 | 概算 | afterUpdate | ✅ |
+| 11 | 校验金额累计是否超预算 | 净业绩拆分 | afterUpsert | ✅ |
+| 12 | 更新部门业绩字段 | 部门业绩 | afterUpsert | ✅ |
+| 13 | 汇总部门资金池 | 部门业绩 | afterUpdate | ✅ |
+| 14 | 编辑更新部门业绩 | 净业绩拆分回款 | beforeUpsert | ✅ |
+| 15 | 生成部门/个人业绩 | 净业绩拆分 | beforeUpsert | ✅ |
+| 16 | 更新回款明细 | 回款明细 | afterUpsert | ✅ |
+| 17 | 新建自动拆分/审批通过自动生成回款 | 预算 | afterUpsert | ✅ |
+| 18 | 提交审批验证金额 | 对外付款 | approval | ❌ |
+| 19 | 还款记录审批通过更新借款单 | 还款记录 | approval | ✅ |
+| 20 | 审批通过计算剩余欠款 | 费用报销 | approval | ✅ |
+| 21 | 借款单触发器 | 借款单 | beforeUpsert | ✅ |
+| 22 | 创建编辑项目任务时判断 | 项目任务 | beforeUpsert | ✅ |
+| 23 | 任务派工工时限制 | 项目任务 | afterUpsert | ✅ |
+| 24 | 测试 AI 代码生成 | 客户 | beforeInsert | ❌ |
+| 25 | 验证审批时校验预算 | 费用报销 | approval | ❌ |
+
+文档生成时间：2026-03-24
+基于 CloudCC 生产环境 25 个触发器实例分析

package/src/triggers/get.js

@@ -1,9 +1,13 @@
 const { getPackageJson } = require("../../utils/config")
 const { postClass } = require("../../utils/http")
 
-async function get(args, isMcp = false) {
-    let body = JSON.parse(decodeURI(args[2]))
-    let config = await getPackageJson(args[3]);
+/**
+ * cc get triggers <listQueryJson> [projectPath]
+ * @param {string[]} argvs
+ */
+async function get(argvs, isMcp = false) {
+    let body = JSON.parse(decodeURI(argvs[2]))
+    let config = await getPackageJson(argvs[3]);
     let res = await postClass(config.setupSvc + "/api/triggerSetup/getTriggerByCondition", body, config.accessToken)
     if (res.result) {
         const simpleList = (res.data.list || []).map(item => ({

package/src/triggers/index.js

@@ -7,11 +7,8 @@ cc.pullList = require("./pullList")
 cc.detail = require("./detail")
 cc.doc = require("./doc")
 cc.delete = require("./delete")
+
 function Classes(action, argvs) {
-  if (action === "detail") {
-    cc[action](argvs[2], argvs[3]);
-    return;
-  }
   cc[action](argvs)
 }
 

package/src/triggers/pullList.js

@@ -7,19 +7,19 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * 批量拉取触发器详情并生成本地文件
- * @param trigger id
+ * cc pullList triggers <id> <projectPath>
+ * @param {string[]} argvs
  */
-async function pullList(args, isMcp = false) {
-    const body = { id: args[2] };
-    let config = await getPackageJson(args[3]);
+async function pullList(argvs, isMcp = false) {
+    const body = { id: argvs[2] };
+    let config = await getPackageJson(argvs[3]);
     const res = await postClass(config.setupSvc + "/api/trigger/newobjtrigger", body, config.accessToken);
     try {
         const data = res.data;
         const targetObj = data.targetObj;
         const trigger = data.trigger;
         const triggerName = trigger.name;
-        const folderPath = path.join(args[3], `triggers/${targetObj.schemetableName.toLowerCase()}/${trigger.name}`);
+        const folderPath = path.join(argvs[3], `triggers/${targetObj.schemetableName.toLowerCase()}/${trigger.name}`);
         if (!fs.existsSync(folderPath)) {
             fs.mkdirSync(folderPath, { recursive: true });
         }
@@ -41,7 +41,7 @@ async function pullList(args, isMcp = false) {
             console.log("true");
         }
     } catch (e) {
-        console.error(`Error occurred while processing trigger id: ${args[2]}, message: ${e.message}${JSON.stringify(res)}}`);
+        console.error(`Error occurred while processing trigger id: ${argvs[2]}, message: ${e.message}${JSON.stringify(res)}}`);
     }
 }
 

package/src/user/create.js

@@ -0,0 +1,50 @@
+const chalk = require('chalk');
+
+/**
+ * 创建用户
+ * 用法：cc create user <path> <userName> <profileId> [email]
+ * @param {Array} argvs - 命令行参数数组
+ * @returns {Promise<Object>} 创建结果
+ */
+async function create(argvs) {
+    try {
+        // 命令行参数格式：cc create user <path> <userName> <profileId> [email]
+        const projectPath = argvs[2] || process.cwd();
+        const userName = argvs[3];
+        const profileId = argvs[4];
+        const email = argvs[5] || '';
+
+        if (!userName) {
+            console.error();
+            console.error(chalk.red('Error: 缺少用户名称'));
+            console.error('用法: cc create user <path> <userName> <profileId> [email]');
+            console.error('示例:');
+            console.error('  cc create user . "张三" a0I9D000000XXXXUAI');
+            console.error('  cc create user . "李四" a0I9D000000XXXXUAI "lisi@example.com"');
+            console.error();
+            throw new Error('缺少必需参数: userName');
+        }
+
+        if (!profileId) {
+            console.error();
+            console.error(chalk.red('Error: 缺少简档 ID'));
+            console.error('用法: cc create user <path> <userName> <profileId> [email]');
+            console.error();
+            throw new Error('缺少必需参数: profileId');
+        }
+
+        console.error();
+        console.error(chalk.green(`Creating user (${userName}), please wait...`));
+        console.error();
+
+        // TODO: 实现创建用户的 API 调用
+        console.error(chalk.yellow('创建用户功能待实现'));
+
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("用户创建失败:"), error);
+        throw error;
+    }
+}
+
+module.exports = create;

package/src/user/delete.js

@@ -0,0 +1,59 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 删除用户
+ * 用法：cc delete user <projectPath> <userId>
+ */
+async function remove(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const userId = argvs[3];
+
+        if (!userId) {
+            console.error();
+            console.error(chalk.red("Error: 缺少用户 ID"));
+            console.error(chalk.yellow("用法: cc delete user <projectPath> <userId>"));
+            console.error();
+            throw new Error("缺少必需参数: userId");
+        }
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green(`Deleting user (${userId}), please wait...`));
+        console.error();
+
+        const result = await postClass(
+            config.setupSvc + "/api/user/deleteUser",
+            { id: userId },
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            console.error();
+            console.error(chalk.green("Success! User deleted."));
+            console.error();
+            return result;
+        }
+
+        const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+        console.error();
+        console.error(chalk.red("Error: " + msg));
+        console.error();
+        throw new Error("Delete User Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("用户删除失败:"), error);
+        throw error;
+    }
+}
+
+module.exports = remove;

package/src/user/doc.js

@@ -0,0 +1,46 @@
+/**
+ * user 文档入口：正文均在 `docs/` 目录。
+ */
+const fs = require("fs");
+const path = require("path");
+
+const DOCS_DIR = path.join(__dirname, "docs");
+
+function readDocFile(basename) {
+    return fs.readFileSync(path.join(DOCS_DIR, `${basename}.md`), "utf8");
+}
+
+/** 介绍文档：用户能力、类型与入口 */
+function getIntroductionDoc() {
+    return readDocFile("introduction");
+}
+
+/** 开发指导：CLI 创建/查询/删除等 */
+function getDevGuideDoc() {
+    return readDocFile("devguide");
+}
+
+/**
+ * cc doc user <introduction|devguide>
+ * @param {string[]} argvs [doc, type, introduction|devguide, ...]
+ */
+function doc(argvs) {
+    const subType = argvs[2];
+    const key = String(subType || "").trim().toLowerCase();
+    if (!key) {
+        throw new Error("cc doc user 需要子命令：introduction 或 devguide");
+    }
+    if (key === "introduction") {
+        const content = getIntroductionDoc();
+        console.log(content);
+        return content;
+    }
+    if (key === "devguide") {
+        const content = getDevGuideDoc();
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`);
+}
+
+module.exports = doc;