neo-cmp-cli 1.13.15 → 1.13.16

package/template/neo-bi-cmps/docs/gartner-pipeline-prd.md

@@ -1,389 +0,0 @@
-> **更新时间**：2026-03-31
-> **模块**：商机Pipeline管理
-> **状态**：初步设计
-> **原型参考**：`docs/htmls/forecasting-prototype.html` — Pipeline Tab
-
----
-
-# 商机Pipeline管理 — 产品需求文档
-
----
-
-# 引言：业务场景与价值
-
-在B2B销售管理中，销售团队面临两个核心挑战：
-
-1. **Pipeline管理缺乏全局视角**：商机散落在列表和详情页中，无法一屏回答"漏斗形态是否健康？哪些阶段在堆积？哪些商机在恶化？"
-2. **Forecast预测依赖主观判断**：销售承诺(Commit)往往基于个人感觉而非数据，管理层难以评估预测的可信度，也缺乏工具来识别预测与实际之间的Gap并采取行动
-
-**Seller Workspace** 正是为解决这两个问题而设计的统一工作台，通过Pipeline和Forecast两个Tab覆盖"看清现状 → 预判未来 → 驱动行动"的完整闭环：
-
-| Tab | 解决的问题 | 核心能力 |
-|-----|-----------|---------|
-| **Pipeline** | 漏斗健康度不可见、商机风险难感知 | 漏斗可视化、阶段停滞预警、AI商机评分与赢率预测 |
-| **Forecast** | 预测不准确、Gap无抓手 | 人机预测对比（Commit vs AI Forecast）、预测调整与审计、AI Gap Closer智能推荐 |
-
-不同角色在Seller Workspace中获得差异化价值：
-
-| 角色 | Pipeline场景 | Forecast场景 |
-|------|-------------|-------------|
-| 销售主管 / 团队Leader | 周会Review漏斗全貌，定位停滞阶段和风险商机 | 审视团队预测与AI预测的偏差，追责或辅导 |
-| 一线销售 | 自检个人Pipeline分布和推进速度 | 提交Commit预测，参考AI建议调整预测策略 |
-| 销售运营 | 分析阶段停留时间，发现流程瓶颈 | 追踪预测准确度趋势，优化预测方法论 |
-
-整体设计理念是**"从全局到细节的渐进式下钻"**——Pipeline Tab先通过漏斗图和阶段汇总建立全局认知，再下钻到单笔商机借助AI辅助判断；Forecast Tab先通过KPI和BI看板把握目标达成态势，再通过预测矩阵和商机列表执行预测调整和Gap关闭动作。
-
----
-
-# 〇、页面入口与整体结构
-
-## 0.1 页面入口
-
-用户从**商机列表页(Opportunity List)**右上角点击 **「Seller Workspace」** 按钮进入本页面。该按钮通过列表页的**自定义列表普通按钮**能力实现。
-
-| 项目 | 说明 |
-|------|------|
-| 入口位置 | 商机列表页右上角 |
-| 按钮文案 | Seller Workspace |
-| 跳转方式 | 打开新的浏览器标签页 |
-| 权限控制 | 自定义按钮配置：全部人员可见 |
-
-## 0.2 页面Tab结构
-
-Seller Workspace页面采用**Tab切换**架构，包含两个核心Tab：
-
-| Tab | 名称 | 定位 | 默认状态 |
-|-----|------|------|---------|
-| Tab 1 | **Pipeline** | 审视商机漏斗健康度和单个商机状态 | 默认选中 |
-| Tab 2 | **Forecast** | 对比AI预测与销售承诺，执行预测调整 | 非默认 |
-
-**页面头部信息**：
-- 页面标题：`Seller Workspace`
-- 副标题：根据当前Tab动态切换
-  - Pipeline Tab：`Pipeline: Review your opportunity funnel and deal health`
-  - Forecast Tab：`Forecast: Monitor quota attainment, review team forecasts, and uncover risks`
-
-**Tab切换交互**：
-- 点击Tab按钮切换，当前Tab高亮（底部紫色下划线）
-- 切换Tab时，副标题同步更新
-- 两个Tab的筛选条件相互独立，互不影响
-
-## 0.3 Pipeline Tab 组件概览
-
-> 以下为 **Pipeline Tab** 的详细功能设计。Forecast Tab详见 `prd-forecasting.md`。
-
-Pipeline Tab由上至下包含以下三大组件：
-
-| 序号 | 组件 | 定位 | 说明 |
-|------|------|------|------|
-| 1 | **全局筛选栏（Filter Bar）** | 数据筛选 | 为下方所有组件提供统一的筛选条件（结单日期、Opportunity Owner、业务类型、变动基准时间） |
-| 2 | **Pipeline看板区** | 全局洞察 | 左右并列两张卡片：Pipeline Funnel（漏斗图）展示各阶段金额分布，Avg. Time in Stage（阶段停留时间）展示推进效率与基准对比 |
-| 3 | **商机列表（Opportunity List）** | 明细下钻 | 顶部为阶段快捷筛选区（Stage Tabs），下方为商机明细表格，集成AI评分和赢率预测，支持变动追踪 |
-
-**三个组件的数据流向**：筛选栏驱动看板区和商机列表刷新，看板区的阶段点击联动商机列表的阶段快捷筛选区，形成"筛选 → 全局 → 明细"的渐进式下钻体验。
-
-```mermaid
-graph TD
-    A[全局筛选栏] -->|筛选条件变更| B[Pipeline Funnel]
-    A -->|筛选条件变更| C[Avg. Time in Stage]
-    A -->|筛选条件变更| D[Stage Tabs]
-    A -->|筛选条件变更| E[Opportunity List]
-    D -->|点击阶段卡片| E
-    B -->|点击漏斗层| D
-    B -->|点击漏斗层| E
-    C -->|点击阶段条形| D
-    C -->|点击阶段条形| E
-    E -->|点击商机名称| F[商机详情页]
-```
-
-**联动规则**：
-1. 全局筛选栏变更 → 所有板块数据刷新
-2. 阶段切换区点击 → 商机列表按该阶段筛选
-3. 漏斗图层点击 → 阶段切换区高亮对应阶段 + 商机列表按该阶段筛选
-4. 阶段停留时间条形点击 → 阶段切换区高亮对应阶段 + 商机列表按该阶段筛选
-5. 商机名称点击 → 跳转至商机详情页
-
----
-
-# 一、全局筛选栏（Filter Bar）
-
-## 1.1 功能说明
-
-全局筛选栏位于Pipeline Tab顶部，为下方所有板块（漏斗图、阶段停留时间、阶段切换区、商机列表）提供统一的数据筛选条件。筛选条件变更后，所有板块数据联动刷新。Close Date、Opportunity Owner、Business Type三项影响基础数据范围；Changes Since仅影响变动类数据的展示，不影响基础数据。
-
-## 1.2 筛选项说明
-
-| 筛选项 | 类型 | 选项 | 默认值 | 展示与交互 | 业务逻辑 |
-|--------|------|------|--------|-----------|---------|
-| Close Date | 下拉选择 | This Week / This Month / This Quarter / Custom | This Quarter | 选择Custom时弹出双日历面板，选择开始/结束日期后点击OK确认；未完成选择时自动恢复上一选项；确认后下拉旁展示日期范围文案 | 按商机结单日期过滤基础数据 |
-| Opportunity Owner | 选人选部门组件（多选） | Current User / [人员列表] / [部门列表] | Current User | 点击展开下拉面板，含搜索框、Departments列表（🏢+复选框）、People列表（👤+复选框），选择部门时自动勾选部门下所有成员；选择后展示：单人显示姓名，多人显示"首个姓名 +N" | 根据选择的人员ID列表，按商机所有人过滤基础数据 |
-| Business Type | 下拉选择 | New Business / Renewal / Expansion | New Business | 标准下拉 | 按商机业务类型过滤基础数据 |
-| Changes Since | 下拉选择 | Start of the Period / Custom | Start of the Period | 标签旁带问号图标，Hover提示："Sets the baseline date for tracking changes in close date, amount, stage, etc."；选择Custom时弹出单月历面板，选定日期后点击OK确认；未完成选择时恢复为Start of the Period | 仅影响变动类数据（阶段切换区变动摘要、商机列表变动箭头），不影响基础数据范围。Start of the Period取当前Close Date周期起始日 |
-
-
-# 二、Pipeline看板区
-
-看板区由左右两个并列卡片组成：左侧为**Pipeline Funnel（商机漏斗图）**，右侧为**Avg. Time in Stage（阶段平均停留时间）**。
-
-## 2.1 Pipeline Funnel（商机漏斗图）
-
-### 2.1.1 功能说明
-
-以漏斗图形式可视化展示当前Pipeline中各阶段的商机金额分布，帮助销售管理者快速判断漏斗形态是否健康（如是否头重脚轻、某阶段是否堆积过多）。
-
-### 2.1.2 页面展示
-
-页面自上而下包含以下区域：
-
-1. **顶部销售金额**：居中展示"Sales Amount"标签及Pipeline总金额数值
-2. **漏斗图（居中）**：漏斗从上到下按商机阶段排列，**每层高度按该阶段金额占比缩放，宽度按该阶段商机数量占比缩放**，形成漏斗形态。每层内居中展示阶段名称。阶段颜色根据视图随机分配
-3. **左侧转化率**：漏斗每层左侧展示该阶段的整体转化率，第一阶段不展示（即为100%基准）
-4. **右侧金额/数量**：漏斗每层右侧展示该阶段的商机金额和商机数量，格式：`{金额}/{数量}`
-5. **底部图例**：以颜色圆点+阶段名称的形式横向排列，标识各层颜色与阶段的对应关系
-
-### 2.1.3 交互说明
-
-1. 漏斗图每层图形可点击，点击后联动下方阶段快捷筛选区高亮对应阶段，并刷新商机列表
-2. 点击右上角✨按钮，弹出AI Insight分析弹窗，展示漏斗形态的智能解读文本，弹窗可关闭
-
-### 2.1.4 业务逻辑
-
-1. **数据范围**
-   - 基础数据范围受当前登录用户的数据权限控制，仅展示用户有权查看的商机
-   - 在用户数据权限基础上，进一步受全局筛选栏条件过滤（Close Date、Opportunity Owner、Business Type）
-   - 漏斗层级与系统中配置相关业务类型的商机阶段(Stage)一一对应，阶段名称和数量由后台配置自动获取
-   - 漏斗展示进行中及赢单(Closed Won)阶段，**不包含输单(Closed Lost)阶段**——漏斗的形状本身用于展示"留存"下来的商机，输单商机已退出漏斗，不应参与漏斗形态的计算和展示
-
-2. **整体转化率**
-   - 计算公式：`整体转化率 = 该阶段商机数量 / 第一阶段商机数量 × 100%`
-   - 含义：到达当前阶段的商机数量占初始总商机数量的百分比，用于衡量从漏斗顶部到各阶段的留存效率
-
-3. **漏斗图尺寸计算**
-   - **高度计算**：每层高度按该阶段金额占所有阶段总金额的比例缩放
-     - 计算公式：`阶段高度 = (该阶段金额 / 所有阶段总金额) × 漏斗总高度`
-   - **宽度计算**：每层宽度按该阶段商机数量占所有阶段总商机数量的比例缩放
-     - 计算公式：`阶段宽度 = (该阶段商机数量 / 所有阶段总商机数量) × 漏斗最大宽度`
-   - **设计意图**：通过高度展示金额维度（金额越大，阶段越"高"），通过宽度展示数量维度（商机越多，阶段越"宽"），实现金额与数量的双维度可视化
-
----
-
-## 2.2 Avg. Time in Stage（阶段平均停留时间）
-
-### 2.2.1 功能说明
-
-以水平条形图展示各阶段商机的平均停留天数，并叠加Target（基准值）和Limit（保底值）标记，帮助管理者识别哪些阶段存在商机停滞风险。
-
-### 2.2.2 页面展示
-
-1. **图例**：图表上方展示三项图例
-   - 绿色条形 = Actual（实际平均停留时间）
-   - 紫色三角标记 = Target（基准值，期望的停留时间上限）
-   - 红色三角标记 = Limit（保底值，可接受的停留时间上限）
-
-2. **每行展示**：每个阶段占一行，包含以下元素
-
-   | 展示项 | 说明 |
-   |--------|------|
-   | 阶段名称 | 左侧标签 |
-   | 平均停留时间 | 右侧数值标签，格式为"X天Y时"（如"12天6时"） |
-   | 条形长度 | 按实际天数与最大刻度的比例绘制 |
-   | Target标记 | 紫色三角形标记在条形上方，标注基准停留天数 |
-   | Limit标记 | 红色三角形标记在条形上方，标注保底停留天数，位于Target右侧 |
-
-3. **颜色规则**：条形和数值颜色根据实际值与Target/Limit的关系动态变化
-
-   | 条件 | 条形颜色 | 数值颜色 | 说明 |
-   |------|---------|---------|------|
-   | 实际 ≤ Target | 绿色 | 默认黑色 | 正常范围，在基准值以内 |
-   | Target < 实际 ≤ Limit | 黄色 | 黄色 | 超过基准但未超保底，需关注 |
-   | 实际 > Limit | 红色 | 红色 | 超过保底值，严重超标，需干预 |
-
-### 2.2.3 交互说明
-
-1. 点击某阶段条形，联动下方阶段快捷筛选区高亮对应阶段，并刷新商机列表
-2. 点击右上角✨按钮，弹出AI分析弹窗，展示停留时间的智能解读文本，弹窗可关闭
-
-### 2.2.4 业务逻辑
-
-1. **数据范围**
-   - 基础数据范围受当前登录用户的数据权限控制，仅展示用户有权查看的商机
-   - 在用户数据权限基础上，进一步受全局筛选栏条件过滤（Close Date、Opportunity Owner、Business Type）
-   - 仅统计进行中的商机阶段，**不包含赢单(Closed Won)和输单(Closed Lost)阶段**
-
-2. **平均停留时间计算**
-   - 统计该阶段下所有商机在当前阶段的停留时长，取平均值
-   - 停留时长 = 当前时间 − 进入该阶段的时间
-
-3. **Target与Limit**
-   - Target（基准值）：期望的停留时间上限，由系统配置或历史数据计算得出
-   - Limit（保底值）：可接受的停留时间上限，由系统配置
-
----
-
-# 三、商机列表（Opportunity List）
-
-本组件由**阶段快捷筛选区（Stage Tabs）**和**商机明细表格**上下组合而成，是Pipeline Tab的核心数据组件。阶段快捷筛选区作为表格的内置筛选器，点击即可按阶段过滤商机列表。列表中集成了AI能力（AI Score、AI Win Rate），并通过变动箭头和Hover卡片展示商机的近期变化。
-
-## 3.1 阶段快捷筛选区（Stage Tabs）
-
-### 3.1.1 功能说明
-
-位于商机列表顶部，以横向卡片组形式展示各商机阶段的汇总数据，作为列表的快捷阶段筛选器。
-
-### 3.1.2 页面展示
-
-所有阶段卡片等宽横向排列，占满容器宽度。每个卡片展示：
-
-| 序号 | 展示项 | 说明 |
-|------|--------|------|
-| 1 | 阶段名称 | 卡片顶部小字标签，如"Prospecting" |
-| 2 | 阶段金额 | 该阶段所有商机金额小计，大号加粗数字 |
-| 3 | 商机数量 | 金额右侧括号内展示，如"(15)" |
-| 4 | 变动摘要 | 卡片底部，金额变动和数量变动分两项独立展示，各自带红绿箭头 |
-
-变动摘要格式示例：
-- `↑ $280K` `↑ 3` — 金额增加（绿色），数量增加（绿色）
-- `↓ $120K` `↑ 1` — 金额减少（红色），数量增加（绿色）
-
-选中状态：阶段名称变为紫色加粗，卡片顶部出现紫色指示条。
-
-### 3.1.3 交互说明
-
-1. 默认选中第一个阶段，对应卡片顶部显示紫色高亮条
-2. 点击任一阶段卡片：该卡片高亮，下方商机表格筛选至该阶段，列表标题和汇总信息同步更新
-3. 漏斗图或阶段停留时间的阶段点击也会联动此处的选中状态
-
-### 3.1.4 业务逻辑
-
-1. **数据范围**
-   - 基础数据范围受用户数据权限和全局筛选栏条件控制
-   - 阶段卡片包含已选择的业务类型商机的所有阶段（含Closed Won和Closed Lost），按照阶段序号从小到大，从左到右依次展示
-
-2. **变动摘要计算**
-   - 基于商机快照机制，根据Changes Since基准日期与当前数据比对
-   - 金额变动 = 当前阶段金额小计 − 基准快照金额小计
-   - 数量变动 = 当前阶段商机数 − 基准快照商机数
-   - 箭头颜色：↑绿色（正向）/ ↓红色（负向）
-
-## 3.2 商机明细表格
-
-### 3.2.1 功能说明
-
-展示符合当前筛选条件的所有商机明细，支持排序、筛选和内联编辑。
-
-### 3.2.2 页面展示
-
-1. **列表头部**
-
-   | 展示项 | 说明 |
-   |--------|------|
-   | 列表标题 | 动态标题，格式："Opportunity List — {筛选条件}" |
-   | 汇总信息 | 右侧展示：`Total: ${总金额} · {商机数} opportunities` |
-   | 筛选排序状态栏 | 标题下方展示：`Sorted by {字段} · Filtered by {条件1}, {条件2}, ...`，无排序或筛选时不展示 |
-
-2. **表格列定义**
-
-   | 列名 | 对齐 | 排序 | 筛选 | 说明 |
-   |------|------|------|------|------|
-   | Opportunity Name | 左对齐 | 支持 | 支持（文本模糊搜索） | 蓝色文字可点击跳转商机详情页，支持内联编辑（✏️） |
-   | Amount | 右对齐 | 支持（默认降序） | 支持（金额范围） | 带变动箭头，支持内联编辑（✏️） |
-   | Close Date | 居中 | 支持 | 支持（日期范围） | 带变动箭头，支持内联编辑（✏️） |
-   | Stage | 居中 | 支持（按阶段顺序） | 支持（多选枚举） | 带变动箭头 |
-   | ✨ AI Score | 居中 | 支持 | 支持（多选枚举：High/Medium/Low） | 彩色圆角标签 |
-   | ✨ AI Win Rate | 居中 | 支持 | 支持（百分比范围） | 百分比数字 |
-   | Last Activity | 居中 | 支持 | 支持（日期范围） | 最近活动时间 |
-
-3. **变动箭头**：Amount、Close Date、Stage三列数据后展示变动箭头
-
-   | 字段 | ↑ 绿色 | ↓ 红色 | 无箭头 |
-   |------|--------|--------|--------|
-   | Amount | 金额增加 | 金额减少 | 无变动 |
-   | Close Date | 结单日提前 | 结单日推迟 | 无变动 |
-   | Stage | 阶段前进 | 阶段回退 | 无变动 |
-
-4. **AI Score**：以彩色圆角标签展示评分等级（High绿色 / Medium橙色 / Low红色）
-
-5. **AI Win Rate**：百分比数字展示
-
-### 3.2.3 交互说明
-
-1. **排序**：点击列头排序图标（⇅），首次点击降序，再次升序，第三次取消。当前排序列显示方向图标
-2. **筛选**：点击列头筛选图标（▽），弹出对应类型的筛选面板（文本搜索/多选枚举/范围选择）
-3. **内联编辑**：Opportunity Name、Amount、Close Date三列数据后显示✏️图标，点击进入编辑模式
-4. **商机名称点击**：蓝色文字可点击，跳转至商机详情页
-5. **变动箭头Hover**：鼠标悬停弹出变动详情卡片，包含：
-
-   | 卡片字段 | 说明 |
-   |----------|------|
-   | 变动标题 | 增长使用"increased"，下降使用"decreased" |
-   | 变动前后值 | 格式：`{旧值} → {新值}`，新值高亮 |
-   | 变动日期 | 格式：`Changed on {日期}` |
-
-6. **AI Score Hover**：展示商机健康度评估卡片，为标准功能，此处不再赘述
-7. **AI Win Rate Hover**：展示赢率计算分解卡片，包含：
-
-   | 卡片区域 | 说明 |
-   |----------|------|
-   | Baseline Probability | 基线概率，基于历史同类商机统计赢率 |
-   | Positive Factors | 正向因素列表，每项标注贡献值（如"+6%"），绿色文字 |
-   | Negative Factors | 负向因素列表，每项标注影响值（如"-4%"），红色文字 |
-   | AI Win Rate | 最终赢率 = Baseline + Σ正向 + Σ负向 |
-
-### 3.2.4 业务逻辑
-
-1. **数据范围**
-   - 基础数据范围受用户数据权限和全局筛选栏条件控制
-   - 进一步受阶段快捷筛选区的选中阶段过滤，未选中阶段时返回所有阶段商机
-
-2. **变动数据**
-   - 基于商机快照机制，根据Changes Since基准日期与当前数据逐字段比对
-   - 变动标题统一规则：增长为"{字段} increased"，下降为"{字段} decreased"
-
-3. **AI Win Rate计算**
-   - AI Win Rate = Baseline Probability + Σ Positive Factors − Σ Negative Factors
-   - 因素类型（非固定值）：正向如金额持续上升、历史赢单记录、互动频率高；负向如推进速度慢、无高管参与、活动记录稀疏
-
----
-
-# 四、商机快照机制
-
-以下为设计思路，直接采取Datacloud的历史快照功能实现即可
-
-## 4.1 背景
-
-Pipeline中的变动数据（如阶段切换区的金额/数量变动、商机列表的变动箭头）依赖于历史数据的对比。为支持"Changes Since"筛选项按任意基准时间点进行变动比对，需要对商机数据进行每日快照留存。
-
-## 4.2 快照规则
-
-| 项目 | 说明 |
-|------|------|
-| 触发时间 | 每天0:00（服务器时间）自动执行 |
-| 快照范围 | 所有商机记录（不区分阶段和状态），仅对快照字段有变更的商机生成新快照；商机创建时记录一条初始快照 |
-| 存储策略 | 每次快照以快照日期为标识。查询某日期的商机状态时，取该商机在该日期之前（含）的最近一条快照 |
-
-## 4.3 快照字段
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| snapshotDate | Date | 快照日期（即当天0:00的日期） |
-| opportunityId | String | 商机ID |
-| opportunityName | String | 商机名称 |
-| accountName | String | 客户名称 |
-| amount | Number | 销售金额 |
-| stageName | String | 商机阶段 |
-| closeDate | Date | 结单日期 |
-| ownerUserId | String | 所有人（商机负责人用户ID） |
-| ownerDeptId | String | 所属部门（商机负责人所在部门ID） |
-| createdTime | DateTime | 商机创建时间 |
-
-## 4.4 使用场景
-
-变动对比时，系统根据"Changes Since"选定的基准时间，查询该日期的快照数据，与当前实时数据进行逐字段比对，计算出金额变动、阶段变动、数量变动等差异，驱动页面上所有变动类展示（箭头、变动摘要、变动详情卡片）。
-
-## 4.5 当日变动处理
-
-由于快照仅在每天凌晨生成，当日发生的变更尚无对应快照。此时变动对比逻辑如下：
-
-1. 取该商机最新一条快照记录，与当前商机实时数据逐字段比对
-2. 若一致（无差异）：说明当日未发生变更，变动时间取最新快照日期，数值取快照值
-3. 若不一致（存在差异）：说明当日已发生变更，变动时间取当天日期，变动前值取最新快照值，变动后值取当前实时值

package/template/neo-bi-cmps/docs/neo-backend-dev/SKILL.md

@@ -1,188 +0,0 @@
----
-name: neo-backend-dev
-description: Neo 后端 PaaS 开发技能，辅助在 NeoCRM 平台上进行 Java 后端开发。当用户需要：(1) 创建项目并配置后端开发环境，(2) 开发 Trigger 触发器，(3) 开发自定义 REST API，(4) 开发计划作业（定时任务），(5) 开发流程扩展（审批流/工作流），(6) 使用 SDK 工具类（数据操作、HTTP请求、缓存、异步），(7) 打包上传/下载/卸载后端代码包，(8) 获取和查询实体模型，(9) 更新 model.jar 时，使用此技能。
----
-
-# Neo 后端 PaaS 开发
-
-辅助完成 NeoCRM PaaS 平台 Java 后端开发全流程。
-
-## 前置条件
-
-- 已全局安装 neo-cmp-cli：`npm i -g neo-cmp-cli`（用于项目创建和登录认证）
-- Node.js 环境
-- JDK 1.8（后端代码编译）
-
-## 重要约定
-
-- `neo login -e production` 默认登录生产环境。执行登录前必须询问用户要登录到哪个环境。环境参数：`production`、`gray`、`sandbox`、`cd`、`tencentuat`、`custom`
-- `neo login` 执行后自动打开浏览器授权，轮询 `.neo-cli/token.json` 确认登录成功
-- 执行平台操作时直接执行，未登录失败后再询问环境并登录重试
-- Java 包路径必须三级且以 `other` 开头（如 `other.xsy.account`），不能生成 4 级或以上
-- 仅支持第三方包：fastJson + commons-lang
-
-## 核心工作流
-
-### 1. 创建项目
-
-如果用户未指定项目名称，先询问。未指定路径则告知默认位置并询问是否修改。
-
-```bash
-neo create project -n <项目名称>
-```
-
-项目创建后将 `neo.config.js` 中 `neoConfig` 改为正式环境：
-```javascript
-neoConfig: {
-  neoBaseURL: 'https://crm.xiaoshouyi.com',
-  loginURL: 'https://login.xiaoshouyi.com/auc/oauth2/auth',
-  tokenURL: 'https://login.xiaoshouyi.com/auc/oauth2/token',
-},
-```
-
-### 2. 登录租户
-
-项目创建后，先询问用户要登录到哪个环境（默认 production），执行登录：
-```bash
-neo login -e <env>
-```
-轮询 `.neo-cli/token.json` 确认登录成功。
-
-### 3. 安装前端依赖（仅开发前端组件时需要）
-
-后端代码开发和部署不需要执行 `npm install`，仅在需要开发前端组件时才执行：
-```bash
-cd <项目目录>
-npm install
-```
-
-### 4. 后端代码开发
-
-后端代码统一放在 `src/server-scripts/` 下，按代码包组织：
-
-```
-<项目>/src/server-scripts/
-  <代码包简称>/
-    other/
-      <company>/
-        <module>/                # 三级包名，如 other/xsy/account
-          XxxTrigger.java
-          XxxApi.java
-    scriptTrigger.xml            # Trigger 配置
-    apiUrl.xml                   # 自定义 API 路由配置
-```
-
-### 后端开发参考文档
-
-根据需求选择对应参考：
-
-- Trigger 触发器 → [references/01-Trigger开发.md](references/01-Trigger开发.md)
-- 自定义 REST API → [references/02-自定义API开发.md](references/02-自定义API开发.md)
-- SDK 工具类 → [references/03-SDK工具类接口.md](references/03-SDK工具类接口.md)
-- 计划作业 → [references/04-计划作业开发.md](references/04-计划作业开发.md)
-- 页面开发 → [references/05-页面开发.md](references/05-页面开发.md)
-- 流程扩展 → [references/06-流程扩展开发.md](references/06-流程扩展开发.md)
-- 平台能力概览 → [references/PaaS平台开发手册解读.md](references/PaaS平台开发手册解读.md)
-
-### 关键限制
-
-| 限制项 | 值 |
-|--------|-----|
-| 同步脚本最大运行时长 | 15 秒 |
-| 异步脚本最大运行时长 | 90 秒 |
-| 脚本最大内存 | 512 MB |
-| 单次 DML 最大数据量 | 10,000 条 |
-| commonHttpClient 最大调用次数 | 50 次/脚本 |
-| 缓存最大大小 | 200 KB |
-
-## 部署后端代码包
-
-```bash
-python3 scripts/deploy_server_script.py <项目目录> <代码包简称> <Java包名>
-```
-
-示例：`python3 scripts/deploy_server_script.py NEOTrail 客户管理 other.xsy.account`
-
-脚本自动：打包 ZIP → 检查/创建代码包 → 上传 → 安装 → 清理临时文件。
-
-## 下载服务端代码包
-
-如果用户未指定代码包名称（Java 包名），必须先询问。
-
-```bash
-python3 scripts/download_server_script.py <项目目录> <Java包名> [代码包简称]
-```
-
-本地已存在同名目录时会覆盖更新。
-
-## 创建计划作业
-
-代码包部署后，需要在 NeoCRM 系统后台手动创建计划作业任务（此接口需要浏览器 session 认证，无法通过 OAuth API 自动化）：
-
-1. 登录 NeoCRM 平台
-2. 进入系统后台 → 开发 → 计划作业
-3. 新建计划作业，填写以下信息：
-   - 任务名称
-   - 选择代码包和对应的 ScheduleJob 类
-   - 执行类型：自定义循环周期（executeType=3）
-   - 执行间隔：小时数（0-24）+ 分钟数（仅支持 5 的倍数：0,5,10,15...55）
-   - 生效时间范围
-4. 启用计划作业
-
-提示用户完成上述手动操作后继续。
-
-## 更新 model.jar
-
-```bash
-python3 scripts/update_model_jar.py <项目目录>
-```
-
-## 卸载代码包
-
-```bash
-python3 scripts/uninstall_server_script.py <项目目录> <Java包名> [--force]
-```
-
-## 获取实体模型
-
-### 生成实体字典
-```bash
-python3 scripts/gen_entitylist.py <项目目录>
-```
-
-### 查询实体字段
-1. 在 `src/entity-model/entitylist.md` 中查找匹配实体
-2. 检查 `src/entity-model/<apiKey>.md` 是否存在
-3. 不存在则运行：`python3 scripts/gen_entity_desc.py <项目目录> <apiKey>`
-
-## 平台 API 参考
-
-所有 API 携带 `Authorization: Bearer <access_token>`（上传文件接口），其他接口直接传 `access_token`。
-
-- 获取 model.jar：`GET /rest/metadata/v2.0/scripts/packages/model/jar/url`
-- 更新 model.jar：`POST /rest/metadata/v2.0/scripts/packages/model/jar`
-- 获取实体列表：`GET /rest/metadata/v2.0/xobjects/filter?custom=<true|false>&active=true`
-- 获取实体字段：`GET /rest/metadata/v2.0/xobjects/<apiKey>/items`
-- 获取业务类型列表：`GET /rest/data/v2.0/xobjects/<xObjectApiKey>/busiType`
-- 下载代码包：`GET /rest/metadata/v2.0/scripts/packages?packageName=<包名>`
-- 创建代码包：`POST /rest/metadata/v2.0/scripts/packages`
-- 上传代码包：`POST /rest/metadata/v2.0/scripts/packages/files?packageName=<包名>`
-- 安装代码包：`POST /rest/metadata/v2.0/scripts/packages/installations`
-- 卸载代码包：`DELETE /rest/metadata/v2.0/scripts/packages/installations/<包名>?force=<bool>`
-- 创建计划作业：`POST /rest/metadata/v2.0/dx/logic/jobDetail`
-- 更新计划作业：`PATCH /rest/metadata/v2.0/dx/logic/jobDetail/<jobId>`
-
-## 注意事项
-
-- Java 类名不能以 "test" 结尾
-- Java 文件必须 UTF-8 无 BOM 编码
-- Trigger 的 DataResult 数量必须与 TriggerRequest 数据量一致
-- Package 名称必须三级且以 other 开始
-- API 调用默认不触发 Trigger
-- `getAttribute()` 返回 Object 类型，不能直接强转 String，必须用 `obj != null ? obj.toString() : ""`
-- CRM 查询 SQL 不支持 `WHERE 1=1`，应使用 `WHERE id > 0` 作为基础条件
-- `RkhdHttpClient.execute()` 需要 `ResponseBodyHandler` 第二参数，且沙箱禁止 `System.getProperty()`
-- 内部平台 API（如获取商机阶段）建议由前端直接调用，后端 SDK 调用内部 API 存在限制
-- 自定义 API 的实际调用路径是 `/rest/data/v2.0/scripts/api/{baseUrl}/{path}`，不是 `/rest/custom/v2.0/`
-- 开发涉及业务对象的功能前，必须先通过 `gen_entity_desc.py` 获取实体的真实字段模型，避免字段名错误
-- 授权配置详见 [references/auth-config.md](references/auth-config.md)