neo-cmp-cli 1.13.13 → 1.13.16

package/template/neo-bi-cmps/docs/neo-backend-dev/references/PaaS/345/271/263/345/217/260/345/274/200/345/217/221/346/211/213/345/206/214/350/247/243/350/257/273.md

@@ -1,313 +0,0 @@
-# PaaS 平台开发手册解读
-
-## 一、手册总览
-
-本手册是销售易（Xiaoshouyi）PaaS 平台的开发指南，面向需要在销售易 CRM 系统上进行二次开发的开发者。手册共 5 大章节、约 500 页，涵盖业务逻辑开发、页面开发、功能限制和常见问题。
-
-### 手册结构
-
-| 章节 | 内容 | 页码范围 |
-|------|------|----------|
-| 1. 开发平台简介 | 平台能力概述 | 1 |
-| 2. 业务逻辑开发 | Trigger、流程扩展、SDK 接口、计划作业、自定义 API 等 | 2-432 |
-| 3. 页面开发 | 页面类型、第三方页面集成、自定义页面、JS SDK 2.0 | 433-478 |
-| 4. 开发平台功能限制 | 各版本（专业/企业/旗舰）的资源限制 | 479-483 |
-| 5. 常见问题 | Trigger、计划作业、SDK、页面、日志等 FAQ | 484-497 |
-
----
-
-## 二、开发平台能力
-
-销售易 PaaS 平台提供四大开发能力：
-
-1. **业务逻辑开发** — 使用 Java 编写自定义业务逻辑代码，集成到 CRM 系统
-2. **页面开发** — 集成第三方页面或自定义开发页面
-3. **开放 API（Open API）** — 系统提供的标准 API 接口
-4. **自定义 API** — 根据业务需求封装的自定义接口
-
-### 前提条件
-
-- 销售易系统必须是**旗舰版**
-- 开发人员需具备 **Java 开发能力**
-- 建议基于 **JDK 1.8** 运行
-- 需获取 **SDK JAR 包**（sdk.jar）并添加到 Build Path
-
----
-
-## 三、业务逻辑开发（核心）
-
-### 3.1 业务逻辑代码概念
-
-业务逻辑代码是运行在多租户共享运行时环境上的 Java 可编程脚本，完全托管在销售易系统上，无需维护基础设施。
-
-### 3.2 业务逻辑扩展点（12 种）
-
-| 序号 | 扩展点 | 说明 |
-|------|--------|------|
-| 1 | **Trigger（触发器）** | 数据操作前/后增加自定义逻辑 |
-| 2 | **新版审批流扩展** | 审批流程各节点的自定义逻辑 |
-| 3 | **自动流扩展** | 自动流程中的自定义逻辑 |
-| 4 | **工作流扩展** | 工作流各节点的自定义逻辑 |
-| 5 | **可视化流扩展** | 可视化流程阶段节点的自定义逻辑 |
-| 6 | **触发规则扩展** | 触发规则中的自定义逻辑 |
-| 7 | **定时调度扩展** | 定时调度任务的自定义逻辑 |
-| 8 | **用户扩展** | 用户操作（分配职能/角色/授权）的扩展 |
-| 9 | **计划作业** | 定时执行的批量任务 |
-| 10 | **Bulk API 回调** | 批量 API 完成后的回调处理 |
-| 11 | **自定义 API** | 封装自定义的 REST API |
-| 12 | **新公海业务扩展** | 公海业务操作的前置/后置扩展 |
-
-### 3.3 Trigger 开发详解
-
-#### 接口定义
-
-```java
-public class ClassName implements Trigger {
-    @Override
-    public TriggerResponse execute(TriggerRequest request) throws ScriptBusinessException {
-        // 业务逻辑
-        return new TriggerResponse(Boolean success, String message, List dataList);
-    }
-}
-```
-
-#### TriggerRequest 方法
-
-| 方法 | 返回类型 | 说明 |
-|------|----------|------|
-| getPartialSuccess() | Boolean | 是否为部分成功 |
-| getPosition() | String | 获取指定位置（before/after） |
-| getOperate() | String | 获取指定操作（add/update/delete 等） |
-| getDataList() | List\<XObject\> | 获取数据列表 |
-| getUserId() | Long | 获取当前用户 ID |
-| getTriggerContext() | TriggerContext | 获取上下文（用于 before/after 间传参） |
-
-#### TriggerResponse 构造
-
-| 参数 | 类型 | 说明 |
-|------|------|------|
-| success | Boolean | 是否成功 |
-| message | String | 操作信息 |
-| dataList | List\<DataResult\> | 数据结果（数量必须与请求数据量一致） |
-
-#### 配置文件 scriptTrigger.xml
-
-```xml
-<?xml version="1.0" encoding="utf-8"?>
-<configs>
-  <config>
-    <trigger>
-      <object>customEntity1__c</object>    <!-- 对象 API Key -->
-      <operate>add</operate>               <!-- 操作：add/delete/update/transfer/lock/unlock/recover -->
-      <position>before</position>           <!-- 时机：before/after -->
-      <order>1</order>                      <!-- 执行顺序（升序） -->
-      <class>other.xsy.doc.trigger.Demo</class>  <!-- 完整类名 -->
-    </trigger>
-  </config>
-</configs>
-```
-
-#### 注意事项
-
-- Java 类名**不能以 "test" 结尾**
-- Java 文件必须以 **UTF-8 无 BOM** 格式编码
-- Package 名称必须**三级且以 other 开始**（如 `other.xsy.demo`）
-- Package 名称中**不能包含 ".sh"**
-
-### 3.4 自定义 API 开发
-
-使用注解 `@RestApi` 和 `@RestMapping` 定义自定义 API：
-
-```java
-@RestApi(baseUrl = "/custom")
-public class CustomApiDemo {
-    @RestMapping(value = "/getObjectList", method = RequestMethod.GET)
-    public String handleGet() throws ApiEntityServiceException {
-        // 业务逻辑
-        return result;
-    }
-}
-```
-
-### 3.5 计划作业
-
-计划作业用于执行定时批量任务，配置步骤：
-1. 编写实现 `ScheduleJob` 接口的 Java 类
-2. 在 scriptTrigger.xml 中配置
-3. 上传代码包并启用
-4. 在系统后台配置计划作业的执行时间和频率
-
----
-
-## 四、SDK 接口说明
-
-### 4.1 开发资源获取
-
-| 资源 | 说明 |
-|------|------|
-| **sdk.jar** | 开发 SDK，包含所有接口定义 |
-| **model.jar** | 数据模型 JAR，包含租户自定义对象的模型类 |
-
-### 4.2 工具类接口一览
-
-| 接口 | 类名 | 说明 |
-|------|------|------|
-| 日志接口 | Logger | 日志输出 |
-| 数据操作接口 | XObjectService | 数据 CRUD 操作 |
-| 内部 HTTP 请求 | RkhdHttpClient | 向销售易系统发起 HTTP 请求 |
-| 外部 HTTP 请求 | CommonHttpClient | 向外部系统发起 HTTP 请求 |
-| XOQL 查询 | XoqlService | 快速查询接口 |
-| 批量数据处理 | BatchJobService | 批量数据处理 |
-| 异步脚本 | FutureTask | 异步任务执行 |
-| 租户级缓存 | CacheService | 缓存读写 |
-| 环境信息 | ScriptRuntimeContext | 获取运行时环境信息 |
-| Webservice 调用 | CommonHttpSoapClient | SOAP 接口调用 |
-| 数据加解密 | SymmetricCryptoUtil | AES 加解密 |
-| 自定义配置 | CustomConfigService | 读取自定义配置项 |
-| 发送邮件 | EmailService | 邮件发送 |
-| 分布式锁 | LockService | 分布式锁操作 |
-
-### 4.3 XObjectService 核心方法
-
-数据操作接口，用于对销售易系统中的对象数据进行 CRUD 操作：
-
-- `query(String sql)` — 查询数据
-- `insert(XObject xObject)` — 插入数据
-- `update(XObject xObject)` — 更新数据
-- `delete(XObject xObject)` — 删除数据
-
-### 4.4 CommonHttpClient 核心方法
-
-向外部系统发起 HTTP 请求：
-
-```java
-CommonHttpClient commonHttpClient = CommonHttpClient.instance();
-CommonData commonData = CommonData.newBuilder()
-    .callType("POST")
-    .header("Authorization", "token")
-    .header("Content-Type", "application/json")
-    .callString("https://external-api.com/endpoint")
-    .body(jsonString)
-    .build();
-HttpResult result = commonHttpClient.execute(commonData);
-```
-
-### 4.5 RkhdHttpClient 核心方法
-
-向销售易系统内部发起 HTTP 请求：
-
-```java
-RkhdHttpClient rkhdHttpClient = RkhdHttpClient.instance();
-RkhdHttpData rkhdHttpData = RkhdHttpData.newBuilder()
-    .callString("/rest/data/v2/query")
-    .callType("POST")
-    .build();
-```
-
----
-
-## 五、页面开发
-
-### 5.1 页面类型
-
-- **第三方应用页面** — 集成已有的外部页面
-- **自定义开发页面** — 使用 HTML/JS/CSS 开发的自定义页面
-
-### 5.2 JS SDK 2.0 API
-
-| API | 说明 |
-|-----|------|
-| `ctx.api.openCreateForm()` | 打开标准新建表单页 |
-| `ctx.api.openEditForm()` | 打开标准编辑表单页 |
-| `ctx.api.openCopyForm()` | 打开标准复制表单页 |
-| `ctx.api.openListPage()` | 打开标准对象列表页 |
-| `ctx.api.openDetailPage()` | 打开标准数据详情页 |
-| `ctx.ui.refreshPage()` | 刷新当前列表或详情页 |
-| `ctx.ui.closeIframe()` | 关闭当前弹窗页面 |
-| `ctx.ui.goBack()` | 回退页面（移动端） |
-
-### 5.3 页面代码请求（NeoLappSdk.js）
-
-```html
-<script type="text/javascript" src="/js/jssdk/neoLapp.js"></script>
-<script>
-lapp.connection.invoke({
-    url: url,
-    method: method,           // GET/POST/PUT/DELETE
-    contentType: contentType, // application/json 等
-    headers: headers,
-    params: params,
-    data: data
-}).then(
-    res => { console.log(res); },
-    err => { console.log(err); }
-)
-</script>
-```
-
-### 5.4 页面入口地址格式
-
-```
-https://lapp-{环境}.xiaoshouyi.com/service/lapp/page/{页面代码 API 名称}
-```
-
----
-
-## 六、开发平台功能限制（关键数据）
-
-### 业务逻辑代码限制
-
-| 限制项 | 专业版 | 企业版 | 旗舰版 |
-|--------|--------|--------|--------|
-| 最大 Class 个数 | 5/租户 | 10/租户 | 500/租户 |
-| 单个 Class 最大字节数 | 409,600 | 409,600 | 409,600 |
-| commonHttpClient 调用 API 最大次数 | 50 次/脚本 | 50 次/脚本 | 50 次/脚本 |
-| 同步脚本最大运行时长 | 15 秒 | 15 秒 | 15 秒 |
-| 异步脚本最大运行时长 | 90 秒 | 90 秒 | 90 秒 |
-| 脚本最大内存使用量 | 512 MB | 512 MB | 512 MB |
-| 单次 DML 最大数据量 | 10,000 条 | 10,000 条 | 10,000 条 |
-| 单次 query 最大数据量 | 10,000 条 | 10,000 条 | 10,000 条 |
-
-### 计划作业限制
-
-| 限制项 | 值 |
-|--------|-----|
-| 最多同时启用 | 30 个/租户 |
-| 自定义类型最多启用 | 5 个/租户 |
-| 最小执行间隔 | 15 分钟 |
-
-### CacheService 限制
-
-| 限制项 | 值 |
-|--------|-----|
-| 最大缓存大小 | 200 KB |
-| 最大缓存 key 数量 | 64 个 |
-| 同步脚本调用次数 | 50 次 |
-| 异步脚本调用次数 | 100 次 |
-
-### API 调用限制
-
-| 限制项 | 专业版 | 企业版 | 旗舰版 |
-|--------|--------|--------|--------|
-| 外部并发（用户级） | 15 次/秒 | 15 次/秒 | 15 次/秒 |
-| 外部并发（租户级） | 50 次/秒 | 50 次/秒 | 50 次/秒 |
-| 每日 API 调用次数 | License×250 | License×500 | License×1000 |
-| 查询接口单次最大返回 | 300 条 | 300 条 | 300 条 |
-
----
-
-## 七、代码包开发流程总结
-
-```
-1. 创建代码包（系统后台 → 开发 → 业务逻辑代码 → 代码包 → 新建代码包）
-       ↓
-2. 编写 Java 业务逻辑代码（实现 Trigger/ScheduleJob/BulkApiCallBack 等接口）
-       ↓
-3. 编写配置文件 scriptTrigger.xml（定义扩展点绑定关系）
-       ↓
-4. 打包上传（将 src/other 文件夹 + scriptTrigger.xml 压缩为 ZIP）
-       ↓
-5. 启用代码包（安装状态列点击启用）
-       ↓
-6. 测试验证
-```

package/template/neo-bi-cmps/docs/neo-backend-dev/references/auth-config.md

@@ -1,77 +0,0 @@
-# 授权配置
-
-与 NeoCRM 平台交互（push/pull/delete）前需配置授权。
-
-## 方式一：OAuth2 登录授权（推荐）
-
-```bash
-neo login
-```
-
-执行流程：
-1. 自动打开浏览器访问授权页面（如未自动打开，命令行会输出 URL，手动复制到浏览器）
-2. 输入 NeoCRM 账号密码并选择租户（此处选择的租户即为后续 push/pull/delete 的目标租户）
-3. 授权成功后自动跳转回本地
-4. Token 自动保存到项目目录的 `.neo-cli/token.json`
-
-> 此步骤需要用户在浏览器中手动完成，AI 无法自动执行。
-
-Token 有效期：
-- access_token：2 小时（过期前 5 分钟自动刷新）
-- refresh_token：30 天（过期需重新 `neo login`）
-
-登出：`neo logout`（清除本地 token）
-
-### 自定义环境配置
-
-在 `neo.config.js` 中配置（`neo login` 选择「自定义环境」时生效）：
-
-```javascript
-module.exports = {
-  neoConfig: {
-    neoBaseURL: 'https://crm-xx.xiaoshouyi.com',
-    loginURL: 'https://login-xx.xiaoshouyi.com/auc/oauth2/auth',
-    tokenURL: 'https://login-xx.xiaoshouyi.com/auc/oauth2/token',
-  },
-}
-```
-
-> 注意：Token 接口字段名在不同 CLI 版本中可能为 `tokenAPI` 或 `tokenURL`，两者等价。`neo init` 生成的模板中使用 `tokenURL`。
-
-## 方式二：密码授权
-
-在 `neo.config.js` 中配置：
-
-```javascript
-module.exports = {
-  neoConfig: {
-    neoBaseURL: 'https://crm-cd.xiaoshouyi.com',
-    tokenAPI: 'https://login-cd.xiaoshouyi.com/auc/oauth2/token',
-    authType: 'password',
-    auth: {
-      client_id: '<从连接器客户端信息获取>',
-      client_secret: '<从连接器客户端信息获取>',
-      username: '<销售易系统用户名>',
-      password: '<账号密码 + 8位安全令牌，直接拼接>'
-    },
-  },
-}
-```
-
-获取方式：
-- client_id / client_secret：通过 [销售易文档中心](https://doc.xiaoshouyi.com) 创建连接器获取
-- 安全令牌：销售易文档中心 → OAuth安全认证 → 密码模式 → 获取令牌
-
-## 两种模式对比
-
-| 特性 | OAuth2 | 密码模式 |
-|------|--------|---------|
-| 安全性 | 高（无需存储密码） | 较低 |
-| Token 有效期 | 2 小时（自动刷新） | 永不过期 |
-| 推荐程度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
-
-## 常见问题
-
-- 浏览器无法自动打开：命令行会输出授权 URL，手动复制到浏览器
-- Token 刷新失败：refresh_token 过期（30 天），重新 `neo login`
-- 授权后未跳回 redirect_uri：可能被浏览器插件（如 Neo UI Extension）影响，关闭后重试

package/template/neo-bi-cmps/docs/neo-backend-dev/scripts/deploy_server_script.py

@@ -1,118 +0,0 @@
-#!/usr/bin/env python3
-"""
-打包并上传后端代码包到 NeoCRM 平台。
-用法: python3 deploy_server_script.py <项目目录> <代码包简称> <Java包名>
-示例: python3 deploy_server_script.py NEOTrail 客户管理 other.xsy.account
-"""
-import zipfile, os, json, urllib.request, urllib.error, io, sys
-
-if len(sys.argv) < 4:
-    print("用法: python3 deploy_server_script.py <项目目录> <代码包简称> <Java包名>")
-    print("示例: python3 deploy_server_script.py NEOTrail 客户管理 other.xsy.account")
-    sys.exit(1)
-
-project_dir = sys.argv[1]
-display_name = sys.argv[2]
-java_package = sys.argv[3]
-package_dir = os.path.join(project_dir, 'src/server-scripts', display_name)
-zip_path = os.path.join(project_dir, display_name + '.zip')
-token_path = os.path.join(project_dir, '.neo-cli/token.json')
-
-if not os.path.exists(package_dir):
-    print("错误: 代码包目录不存在: %s" % package_dir)
-    sys.exit(1)
-
-if not os.path.exists(token_path):
-    print("错误: 未找到 %s，请先执行 neo login" % token_path)
-    sys.exit(1)
-
-token = json.load(open(token_path))
-access_token = token['access_token']
-base_url = token['instance_uri'].rstrip('/')
-
-# 1. 打包 ZIP
-print("打包 %s ..." % package_dir)
-with zipfile.ZipFile(zip_path, 'w', zipfile.ZIP_DEFLATED) as zf:
-    for root, dirs, files in os.walk(package_dir):
-        for f in files:
-            full_path = os.path.join(root, f)
-            arc_name = os.path.relpath(full_path, package_dir)
-            zf.write(full_path, arc_name)
-            print("  添加: %s" % arc_name)
-print("ZIP: %s (%d bytes)" % (zip_path, os.path.getsize(zip_path)))
-
-def api_call(method, path, data=None, headers=None):
-    url = base_url + path
-    req = urllib.request.Request(url, data=data, method=method)
-    req.add_header('Authorization', access_token)
-    if headers:
-        for k, v in headers.items():
-            req.add_header(k, v)
-    try:
-        resp = urllib.request.urlopen(req)
-        return json.loads(resp.read().decode('utf-8'))
-    except urllib.error.HTTPError as e:
-        body = e.read().decode('utf-8')[:500]
-        try:
-            return json.loads(body)
-        except:
-            return {"code": str(e.code), "msg": body}
-
-# 2. 检查代码包是否存在，不存在则创建
-print("\n检查代码包 ...")
-r = api_call('GET', '/rest/metadata/v2.0/scripts/packages?packageName=' + urllib.request.quote(java_package))
-exists = r.get('code') == '200' and r.get('data', {}).get('records')
-
-if not exists:
-    print("创建代码包 %s ..." % java_package)
-    body = json.dumps({"packageName": java_package, "name": display_name, "content": display_name}).encode()
-    r2 = api_call('POST', '/rest/metadata/v2.0/scripts/packages', data=body, headers={'Content-Type': 'application/json'})
-    if r2.get('code') != '200':
-        print("创建失败: %s" % r2.get('msg', ''))
-        os.remove(zip_path)
-        sys.exit(1)
-    print("创建成功")
-else:
-    print("代码包已存在")
-
-# 3. 上传文件
-print("\n上传文件 ...")
-boundary = '----PythonBoundary7MA4YWxk'
-body = io.BytesIO()
-body.write(('--%s\r\n' % boundary).encode())
-body.write(('Content-Disposition: form-data; name="file"; filename="%s.zip"\r\n' % display_name).encode())
-body.write(b'Content-Type: application/zip\r\n\r\n')
-with open(zip_path, 'rb') as f:
-    body.write(f.read())
-body.write(('\r\n--%s--\r\n' % boundary).encode())
-
-upload_url = base_url + '/rest/metadata/v2.0/scripts/packages/files?packageName=' + urllib.request.quote(java_package)
-req = urllib.request.Request(upload_url, data=body.getvalue(), method='POST')
-req.add_header('Authorization', 'Bearer ' + access_token)
-req.add_header('Content-Type', 'multipart/form-data; boundary=%s' % boundary)
-
-try:
-    resp = urllib.request.urlopen(req)
-    result = json.loads(resp.read().decode('utf-8'))
-except urllib.error.HTTPError as e:
-    result = {"code": str(e.code), "msg": e.read().decode('utf-8')[:500]}
-
-if result.get('code') != '200':
-    print("上传失败: %s" % result.get('msg', ''))
-    os.remove(zip_path)
-    sys.exit(1)
-print("上传成功")
-
-# 4. 安装代码包
-print("\n安装代码包 ...")
-install_body = json.dumps({"packageName": java_package}).encode()
-r4 = api_call('POST', '/rest/metadata/v2.0/scripts/packages/installations', data=install_body, headers={'Content-Type': 'application/json'})
-if r4.get('code') == '200':
-    print("安装成功")
-else:
-    print("安装失败: %s" % r4.get('msg', ''))
-
-# 5. 清理临时 ZIP
-os.remove(zip_path)
-print("\n已清理临时文件: %s" % zip_path)
-print("\n完成!")

package/template/neo-bi-cmps/docs/neo-backend-dev/scripts/download_server_script.py

@@ -1,74 +0,0 @@
-#!/usr/bin/env python3
-"""
-下载服务端代码包到本地 src/server-scripts/ 目录。
-如果本地已存在同名目录，会清空后重新下载（更新本地包）。
-用法: python3 download_server_script.py <项目目录> <Java包名> [代码包简称]
-示例: python3 download_server_script.py NEOTrail other.xsy.account 客户管理
-"""
-import os, json, zipfile, shutil, urllib.request, urllib.error, sys
-
-if len(sys.argv) < 3:
-    print("用法: python3 download_server_script.py <项目目录> <Java包名> [代码包简称]")
-    sys.exit(1)
-
-project_dir = sys.argv[1]
-java_package = sys.argv[2]
-display_name = sys.argv[3] if len(sys.argv) > 3 else java_package.split('.')[-1]
-token_path = os.path.join(project_dir, '.neo-cli/token.json')
-output_dir = os.path.join(project_dir, 'src/server-scripts', display_name)
-
-if not os.path.exists(token_path):
-    print("错误: 未找到 %s，请先执行 neo login" % token_path)
-    sys.exit(1)
-
-token = json.load(open(token_path))
-access_token = token['access_token']
-base_url = token['instance_uri'].rstrip('/')
-
-# 1. 检查本地是否已存在
-if os.path.exists(output_dir):
-    print("本地已存在: %s，将更新覆盖" % output_dir)
-    shutil.rmtree(output_dir)
-
-# 2. 获取代码包信息和下载地址
-print("获取代码包信息: %s ..." % java_package)
-url = base_url + '/rest/metadata/v2.0/scripts/packages?packageName=' + urllib.request.quote(java_package)
-req = urllib.request.Request(url, method='GET')
-req.add_header('Authorization', access_token)
-
-try:
-    resp = urllib.request.urlopen(req)
-    data = json.loads(resp.read().decode('utf-8'))
-except urllib.error.HTTPError as e:
-    print("请求失败 HTTP %d: %s" % (e.code, e.read().decode('utf-8')[:500]))
-    sys.exit(1)
-
-if data.get('code') != '200' or not data.get('data', {}).get('records'):
-    print("错误: 代码包不存在或无权限 (%s)" % data.get('msg', data.get('code', '')))
-    sys.exit(1)
-
-records = data['data']['records']
-download_url = records.get('uploadFile', '')
-if not download_url:
-    print("错误: 未找到下载地址")
-    sys.exit(1)
-
-print("版本: %s" % records.get('version', ''))
-
-# 3. 下载 ZIP
-zip_path = os.path.join(project_dir, display_name + '_download.zip')
-print("下载代码包 ...")
-urllib.request.urlretrieve(download_url, zip_path)
-print("已下载: %d bytes" % os.path.getsize(zip_path))
-
-# 4. 解压到 src/server-scripts/<display_name>/
-print("解压到 %s ..." % output_dir)
-os.makedirs(output_dir, exist_ok=True)
-with zipfile.ZipFile(zip_path, 'r') as zf:
-    zf.extractall(output_dir)
-    for name in zf.namelist():
-        print("  %s" % name)
-
-# 5. 清理临时 ZIP
-os.remove(zip_path)
-print("\n完成: 代码包已下载到 %s" % output_dir)

package/template/neo-bi-cmps/docs/neo-backend-dev/scripts/gen_entity_desc.py

@@ -1,69 +0,0 @@
-#!/usr/bin/env python3
-"""
-生成实体字段描述：通过 API 获取指定实体的字段信息，输出 <apiKey>.md
-用法: python3 gen_entity_desc.py <项目目录> <实体apiKey>
-示例: python3 gen_entity_desc.py NEOTrail investment__c
-"""
-import sys, os, json, urllib.request
-
-if len(sys.argv) < 3:
-    print("用法: python3 gen_entity_desc.py <项目目录> <实体apiKey>")
-    sys.exit(1)
-
-project_dir = sys.argv[1]
-api_key = sys.argv[2]
-token_path = os.path.join(project_dir, '.neo-cli/token.json')
-output_dir = os.path.join(project_dir, 'src/entity-model')
-
-if not os.path.exists(token_path):
-    print("错误: 未找到 %s，请先执行 neo login" % token_path)
-    sys.exit(1)
-
-token = json.load(open(token_path))
-access_token = token['access_token']
-base_url = token['instance_uri'].rstrip('/')
-headers = {'Authorization': 'Bearer ' + access_token, 'Content-Type': 'application/json'}
-
-def api_get(path):
-    req = urllib.request.Request(base_url + path, method='GET')
-    for k, v in headers.items():
-        req.add_header(k, v)
-    return json.loads(urllib.request.urlopen(req).read().decode('utf-8'))
-
-# 1. 获取实体信息
-print("获取实体信息: %s ..." % api_key)
-try:
-    entity_data = api_get('/rest/metadata/v2.0/xobjects/' + api_key)
-    entity = entity_data.get('data', {}).get('records', {})
-    entity_label = entity.get('label', api_key)
-except Exception as e:
-    print("错误: 获取实体信息失败: %s" % e)
-    entity_label = api_key
-
-# 2. 获取字段列表
-print("获取字段列表 ...")
-try:
-    fields_data = api_get('/rest/metadata/v2.0/xobjects/' + api_key + '/items')
-    fields = fields_data.get('data', {}).get('records', [])
-except Exception as e:
-    print("错误: 获取字段列表失败: %s" % e)
-    sys.exit(1)
-
-# 3. 生成 <apiKey>.md
-os.makedirs(output_dir, exist_ok=True)
-
-lines = ['# %s (%s)' % (entity_label, api_key), '',
-    '| 字段名称 | API Key | 字段类型 | 是否标准字段 |',
-    '|----------|---------|----------|------------|']
-for f in fields:
-    fk = f.get('apiKey', '')
-    label = f.get('label', '')
-    ftype = f.get('type', '')
-    is_std = '是' if not fk.endswith('__c') else '否'
-    lines.append('| %s | %s | %s | %s |' % (label, fk, ftype, is_std))
-
-output_path = os.path.join(output_dir, api_key + '.md')
-with open(output_path, 'w', encoding='utf-8') as f:
-    f.write('\n'.join(lines))
-
-print("完成: %s (%s, %d 个字段)" % (output_path, entity_label, len(fields)))