ai-engineering-init 1.4.3 → 1.6.0

package/src/skills/code-patterns/SKILL.md

@@ -0,0 +1,280 @@
+---
+name: code-patterns
+description: |
+  后端代码禁令和编码规范速查。本项目是纯后端项目，前端代码在分离的项目中开发。
+
+  触发场景：
+  - 查看项目禁止事项（后端代码）
+  - 命名规范速查
+  - Git 提交规范
+  - 代码风格检查
+  - 避免过度工程
+
+  触发词：规范、禁止、命名、Git提交、代码风格、不能用、不允许、包名、架构
+
+  注意：后端 CRUD 开发规范请激活 crud-development，API 开发规范请激活 api-development，数据库设计规范请激活 database-ops。
+---
+
+# 代码规范速查
+
+## 后端禁令速查表
+
+| # | 禁止项 | 错误写法 | 正确写法 |
+|---|--------|---------|---------|
+| 1 | 包名 | `com.ruoyi.*` / `plus.ruoyi.*` | `org.dromara.*` |
+| 2 | 完整引用 | `org.dromara.xxx.Xxx` 内联 | `import` + 短类名 |
+| 3 | 数据返回 | `Map<String, Object>` | 创建 VO 类 |
+| 4 | Service设计 | `extends ServiceImpl<>` | `implements IXxxService` |
+| 5 | 查询构建 | Controller 层 | **Service 层** `buildQueryWrapper()` |
+| 6 | 接口路径 | `/pageXxxs`, `/getXxx/{id}` | `/list`, `/{id}`, `/` |
+| 7 | 对象转换 | `BeanUtil.copyProperties()` | `MapstructUtils.convert()` |
+| 8 | 主键 | `AUTO_INCREMENT` | 雪花ID（不指定type） |
+| 9 | R.ok(string) | `R.ok(token)` | `R.ok(null, token)` |
+| 10 | Entity基类 | 无基类 | `extends TenantEntity` / `BaseEntity` |
+| 11 | @Cacheable | 返回 `List.of()`/`Set.of()` | `new ArrayList<>(List.of())` |
+| 12 | Mapper注解 | 单目标用 `@AutoMappers` | 单目标用 `@AutoMapper` |
+| 13 | 注释语言 | 英文注释 | **中文注释** |
+| 14 | SQL COMMENT | `COMMENT 'user name'` | `COMMENT '用户名'` |
+
+---
+
+## 禁令详解
+
+### 1-2. 包名与引用
+
+```java
+// ✅
+package org.dromara.system.service;
+import org.dromara.common.core.domain.R;
+public R<XxxVo> getXxx(Long id) { ... }
+
+// ❌
+package com.ruoyi.system.service;
+public org.dromara.common.core.domain.R<XxxVo> getXxx(Long id) { ... }
+```
+
+### 3. 禁止 Map 传业务数据
+
+```java
+// ✅ 创建 VO 类
+public XxxVo getXxx(Long id) {
+    return MapstructUtils.convert(entity, XxxVo.class);
+}
+
+// ❌
+public Map<String, Object> getXxx(Long id) { ... }
+```
+
+### 4-5. Service 架构
+
+```java
+// ✅ 三层架构：不继承 ServiceImpl，直接注入 Mapper
+@Service
+public class XxxServiceImpl implements IXxxService {
+    private final XxxMapper baseMapper;
+
+    private LambdaQueryWrapper<Xxx> buildQueryWrapper(XxxBo bo) {
+        LambdaQueryWrapper<Xxx> lqw = Wrappers.lambdaQuery();
+        lqw.eq(bo.getStatus() != null, Xxx::getStatus, bo.getStatus());
+        lqw.like(StringUtils.isNotBlank(bo.getName()), Xxx::getName, bo.getName());
+        return lqw;
+    }
+}
+
+// ❌
+public class XxxServiceImpl extends ServiceImpl<XxxMapper, Xxx> { }
+```
+
+### 6. RESTful 路径
+
+```java
+// ✅
+@GetMapping("/list")     @GetMapping("/{id}")
+@PostMapping             @PutMapping
+@DeleteMapping("/{ids}") @PostMapping("/export")
+
+// ❌
+@GetMapping("/pageAds")  @GetMapping("/getAd/{id}")
+@PostMapping("/addAd")   @PutMapping("/updateAd")
+```
+
+### 7. 对象转换
+
+```java
+// ✅ MapstructUtils
+XxxVo vo = MapstructUtils.convert(entity, XxxVo.class);
+List<XxxVo> voList = MapstructUtils.convert(entityList, XxxVo.class);
+
+// ❌ BeanUtil
+BeanUtil.copyProperties(entity, vo);
+```
+
+### 8. 主键策略
+
+```sql
+-- ✅ 雪花ID
+id BIGINT(20) NOT NULL COMMENT '主键ID'
+
+-- ❌
+id BIGINT(20) AUTO_INCREMENT
+```
+
+### 9. R.ok() 返回 String 陷阱
+
+```java
+// ❌ 匹配 R.ok(String msg)，字符串进入 msg 而非 data
+return R.ok(token);  // {code:200, msg:"xxx", data:null}
+
+// ✅ 明确指定
+return R.ok(null, token);        // data=token, msg=null
+return R.ok("获取成功", token);  // 都有值
+```
+
+### 10. Entity 基类
+
+```java
+// ✅ 业务表（需多租户隔离）
+public class Xxx extends TenantEntity {
+    @TableId(value = "id")
+    private Long id;
+}
+
+// ✅ 系统表（不需多租户）
+public class SysClient extends BaseEntity { }
+
+// ❌ 不继承基类
+public class Xxx { }
+```
+
+### 11. @Cacheable 不可变集合
+
+```java
+// ❌ Redis 反序列化失败
+@Cacheable(value = "xxx")
+public List<String> listXxx() { return List.of("1", "2"); }
+
+// ✅ 可变集合包装
+@Cacheable(value = "xxx")
+public List<String> listXxx() { return new ArrayList<>(List.of("1", "2")); }
+```
+
+> **原因**：Jackson DefaultTyping.NON_FINAL 会为 `ImmutableCollections$List12` 添加类型信息，反序列化时导致 `ClassNotFoundException`。
+
+### 12. BO 映射注解
+
+```java
+// ✅ 单目标：@AutoMapper
+@AutoMapper(target = Xxx.class, reverseConvertGenerate = false)
+public class XxxBo { }
+
+// ✅ 多目标：@AutoMappers
+@AutoMappers({
+    @AutoMapper(target = SysOperLog.class, reverseConvertGenerate = false),
+    @AutoMapper(target = OperLogEvent.class)
+})
+public class SysOperLogBo { }
+```
+
+### 13-14. 中文注释与 SQL COMMENT
+
+```java
+// ✅ 中文注释
+/** 根据 ID 查询用户信息 */
+public SysUserVo queryById(Long id) {
+    // 查询用户基本信息
+    return baseMapper.selectVoById(id);
+}
+
+// ❌ 英文注释
+/** Query user info by ID */
+```
+
+```sql
+-- ✅
+`user_name` VARCHAR(50) NOT NULL COMMENT '用户名',
+) ENGINE=InnoDB COMMENT='用户信息表';
+
+-- ❌
+`user_name` VARCHAR(50) NOT NULL COMMENT 'user name',
+```
+
+---
+
+## 命名后缀规范
+
+| 类型 | 后缀 | 示例 |
+|------|------|------|
+| 实体类 | 无/Sys前缀 | `SysUser`, `TestDemo` |
+| 业务对象 | Bo | `SysUserBo` |
+| 视图对象 | Vo | `SysUserVo` |
+| 服务接口 | IXxxService | `ISysUserService` |
+| 服务实现 | XxxServiceImpl | `SysUserServiceImpl` |
+| 控制器 | XxxController | `SysUserController` |
+| Mapper | XxxMapper | `SysUserMapper` |
+
+> 本项目是三层架构，没有 DAO 层。Service 直接注入 Mapper。
+
+## 方法命名
+
+| 操作 | Service 方法 | Controller URL |
+|------|-------------|----------------|
+| 分页查询 | `queryPageList(bo, pageQuery)` | `GET /list` |
+| 查询单个 | `queryById(id)` | `GET /{id}` |
+| 新增 | `insertByBo(bo)` | `POST /` |
+| 修改 | `updateByBo(bo)` | `PUT /` |
+| 删除 | `deleteWithValidByIds(ids)` | `DELETE /{ids}` |
+| 导出 | `queryList(bo)` + ExcelUtil | `POST /export` |
+
+---
+
+## Git 提交规范
+
+```
+<type>(<scope>): <description>
+```
+
+| type | 说明 | 示例 |
+|------|------|------|
+| `feat` | 新功能 | `feat(system): 新增用户反馈功能` |
+| `fix` | 修复 | `fix(demo): 修复订单状态显示错误` |
+| `refactor` | 重构 | `refactor(common): 重构分页查询工具类` |
+| `perf` | 性能 | `perf(system): 优化用户列表查询性能` |
+| `docs` | 文档 | `docs(readme): 更新安装说明` |
+| `style` | 格式 | `chore` 构建/工具 | `test` 测试 |
+
+---
+
+## 多项目适配
+
+| 特征 | RuoYi-Vue-Plus | leniu-tengyun-core |
+|------|----------------|-------------------|
+| 包名 | `org.dromara.*` | `net.xnzn.core.*` |
+| JDK | 17 | 21 |
+| 对象转换 | `MapstructUtils.convert()` | `BeanUtil.copyProperties()` |
+| 分页 | `TableDataInfo<T>` | `Page<T>` |
+| 异常 | `ServiceException` | `LeException` |
+| 工具库 | 自定义工具类 | Hutool |
+
+### leniu-tengyun-core 专用
+
+```java
+// 国际化
+throw new LeException(I18n.getMessage("user.not.exists"));
+
+// 租户上下文
+Long tenantId = TenantContextHolder.getTenantId();
+
+// 分页
+PageMethod.startPage(param.getPage().getPageNum(), param.getPage().getPageSize());
+```
+
+---
+
+## 相关 Skill
+
+| 需要了解 | 激活 Skill |
+|---------|-----------|
+| 后端 CRUD 开发 | `crud-development` |
+| API 开发 | `api-development` |
+| 数据库设计 | `database-ops` |
+| 系统架构 | `architecture-design` |

package/src/skills/code-patterns/references/leniu-code-patterns.md

@@ -0,0 +1,87 @@
+# leniu-tengyun-core 代码模式详解
+
+## Hutool 工具类完整用法
+
+```java
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.hutool.core.bean.BeanUtil;
+
+// 1. 集合操作
+if (CollUtil.isEmpty(list)) {
+    throw new LeException("列表不能为空");
+}
+if (CollUtil.isNotEmpty(list)) {
+    // 处理列表
+}
+
+// 2. 对象判空
+if (ObjectUtil.isNull(user)) {
+    throw new LeException("用户不存在");
+}
+
+// 3. 字符串操作
+if (StrUtil.isBlank(name)) {
+    throw new LeException("名称不能为空");
+}
+String trimmed = StrUtil.trim(name);
+String joined = StrUtil.join(",", list);
+
+// 4. 对象拷贝
+TargetDTO target = BeanUtil.copyProperties(source, TargetDTO.class);
+List<TargetDTO> targets = BeanUtil.copyToList(sources, TargetDTO.class);
+
+// 5. 集合创建
+List<String> list = CollUtil.newArrayList("a", "b", "c");
+Map<String, Object> map = CollUtil.newHashMap();
+```
+
+## 国际化消息
+
+```java
+import net.xnzn.core.common.i18n.I18n;
+
+// RuoYi-Vue-Plus 风格
+throw new ServiceException(MessageUtils.message("user.not.exists"));
+
+// leniu-tengyun-core 风格
+throw new LeException(I18n.getMessage("user.not.exists"));
+
+// 带参数
+throw new LeException(I18n.getMessage("user.password.retry.limit.exceed", maxRetryCount));
+```
+
+## 租户上下文
+
+```java
+import net.xnzn.core.context.TenantContextHolder;
+
+Long tenantId = TenantContextHolder.getTenantId();
+TenantContextHolder.setTenantId(tenantId);
+TenantContextHolder.clear();
+```
+
+## 分页参数处理
+
+```java
+@Data
+public class XxxQueryParam implements Serializable {
+    @ApiModelProperty(value = "分页参数", required = true)
+    @NotNull(message = "分页参数不能为空")
+    private PageDTO page;
+
+    @ApiModelProperty("关键字")
+    private String keyword;
+
+    @ApiModelProperty("状态")
+    private Integer status;
+}
+
+// Service 层
+public Page<XxxVO> pageList(XxxQueryParam param) {
+    PageMethod.startPage(param.getPage().getPageNum(), param.getPage().getPageSize());
+    List<XxxEntity> list = xxxMapper.selectList(buildWrapper(param));
+    return new Page<>(list);
+}
+```

package/src/skills/codex-code-review/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: codex-code-review
+description: |
+  Codex 代码审查工作流。在代码实现或 Bug 修复完成后，调用 Codex CLI 进行代码审查，展示审查结果，用户确认后自动修复问题。
+
+  触发场景：
+  - /dev 或 /crud 命令完成代码生成后
+  - Bug 修复完成后
+  - 用户说"审查代码"、"review"、"代码审查"、"codex审查"
+  - 用户说"检查一下刚写的代码"
+
+  触发词：codex审查、代码审查、review代码、审查代码、codex review、代码review
+---
+
+# Codex 代码审查工作流
+
+> 依赖 `collaborating-with-codex` skill 的 `codex_bridge.py` 脚本。
+
+## 工作流
+
+### Phase 1: 收集变更范围
+
+```bash
+# 获取当前未提交的变更文件
+git diff --name-only HEAD
+git diff --cached --name-only
+```
+
+如果没有变更文件，提示用户"没有检测到代码变更"并终止。
+
+将变更文件按类型分组：
+- **Java 文件**：Controller / Business / Service / Mapper / Entity / VO / DTO
+- **XML 文件**：Mapper XML
+- **SQL 文件**：建表/变更脚本
+- **其他**：配置文件等
+
+### Phase 2: 调用 Codex 审查
+
+针对变更的 Java 文件，构造审查 PROMPT：
+
+```bash
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd . \
+  --sandbox read-only \
+  --PROMPT "Review the following changed files for code quality issues:
+
+FILES TO REVIEW:
+{变更文件列表，含相对路径}
+
+REVIEW CHECKLIST:
+1. Bug risks: null pointer, off-by-one, resource leaks, concurrency issues
+2. Security: SQL injection, XSS, missing auth checks, sensitive data exposure
+3. Architecture: layer violations (Controller calling Mapper directly), missing Business layer for complex logic
+4. Code quality: duplicate code, overly complex methods, missing error handling
+5. Project conventions: wrong package name (must be net.xnzn.core.*), wrong audit fields (must use crby/crtime/upby/uptime), javax.validation (must use jakarta.validation)
+
+OUTPUT FORMAT:
+For each issue found, output:
+- [SEVERITY] CRITICAL / WARNING / SUGGESTION
+- [FILE] filepath:line_number
+- [ISSUE] Brief description
+- [FIX] Recommended fix
+
+If no issues found, output: ALL CLEAR - No issues detected.
+
+IMPORTANT LANGUAGE RULES:
+- All review comments MUST be in Chinese
+- File paths and code snippets remain in English"
+```
+
+**关键约束**：
+- 始终使用 `--sandbox read-only`，Codex 不直接修改文件
+- 变更文件过多时（>10 个），按模块分批审查
+- 使用 `run_in_background` 避免阻塞
+
+### Phase 3: 展示审查结果
+
+解析 Codex 返回的 JSON，提取 `agent_messages`，按严重程度分组展示：
+
+```
+## Codex 审查结果
+
+### 🔴 严重问题 (CRITICAL)
+- `OrderInfoService.java:42` — 未做空值检查，可能 NPE
+  建议：添加 ObjectUtil.isNull() 判断
+
+### 🟡 警告 (WARNING)
+- `OrderWebController.java:15` — 缺少 @RequiresAuthentication 注解
+  建议：添加认证注解
+
+### 🔵 建议 (SUGGESTION)
+- `OrderDTO.java:8` — 字段命名可优化
+  建议：使用更具描述性的名称
+
+---
+是否需要修复以上问题？
+```
+
+如果结果为 `ALL CLEAR`，展示"审查通过，未发现问题"并终止。
+
+### Phase 4: 用户确认后修复
+
+等待用户确认。用户可能：
+- **全部修复**："修复所有问题" → 逐个修复所有 CRITICAL + WARNING
+- **选择性修复**："只修复严重问题" → 仅修复 CRITICAL
+- **跳过**："不需要修复" → 终止
+
+修复时：
+1. 按文件逐个修复，使用 Edit 工具
+2. 每修复一个文件，简要说明改动
+3. SUGGESTION 级别的问题默认跳过，除非用户明确要求
+4. 修复完成后运行 `git diff` 展示所有变更
+
+### Phase 5: 可选二次审查
+
+修复完成后询问："是否需要再次审查确认？"
+- 如果用户同意 → 回到 Phase 2 重新审查
+- 如果用户拒绝 → 终止
+
+## 审查重点（leniu 项目特有）
+
+Codex PROMPT 中追加项目特有检查项：
+
+```
+PROJECT-SPECIFIC CHECKS:
+- Package must be net.xnzn.core.* (NOT org.dromara.*)
+- Audit fields: crby/crtime/upby/uptime (NOT createBy/createTime)
+- del_flag: 1=deleted, 2=normal (NOT 0=normal)
+- Use LeException (NOT ServiceException)
+- Use BeanUtil.copyProperties() (NOT MapstructUtils)
+- Use jakarta.validation.* (NOT javax.validation.*)
+- No tenant_id field in Entity (dual-database physical isolation)
+- Architecture: Controller → Business → Service → Mapper (4-layer)
+- No Map for business data transfer (use VO/DTO)
+```

package/src/skills/collaborating-with-codex/SKILL.md

@@ -0,0 +1,174 @@
+---
+name: collaborating-with-codex
+description: |
+  与 OpenAI Codex CLI 协同开发。将编码任务委托给 Codex 进行原型开发、调试分析和代码审查。
+
+  触发场景：
+  - 需要算法实现或复杂逻辑分析
+  - 需要代码审查和 Bug 分析
+  - 需要生成 Unified Diff 补丁
+  - 用户明确要求使用 Codex 协作
+  - 复杂后端逻辑的原型设计
+
+  触发词：Codex、协作、多模型、原型、Diff、算法分析、代码审查、codex协同
+
+  前置要求：
+  - 已安装 Codex CLI (npm install -g @openai/codex)
+  - 已配置 OpenAI API Key
+---
+
+# 与 Codex CLI 协同开发
+
+> 通过 Python 桥接脚本调用 Codex CLI，获取算法实现和代码审查建议。
+
+## 快速开始
+
+```bash
+# 相对路径（推荐，在项目根目录执行）
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py --cd . --PROMPT "Your task"
+```
+
+**输出**: JSON 格式，包含 `success`、`SESSION_ID`、`agent_messages` 和可选的 `error`。
+
+## 参数说明
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `--PROMPT` | str | ✅ | - | 发送给 Codex 的任务指令（使用英语） |
+| `--cd` | Path | ✅ | - | 工作目录根路径 |
+| `--sandbox` | Literal | ❌ | `read-only` | 沙箱策略：`read-only`/`workspace-write`/`danger-full-access` |
+| `--SESSION_ID` | UUID | ❌ | `None` | 会话 ID（继续之前的对话） |
+| `--skip-git-repo-check` | bool | ❌ | `True` | 允许在非 Git 仓库运行 |
+| `--return-all-messages` | bool | ❌ | `False` | 返回完整推理信息 |
+| `--image` | List[Path] | ❌ | `None` | 附加图片文件到提示词 |
+| `--model` | str | ❌ | `None` | 指定模型（仅用户明确要求时使用） |
+| `--yolo` | bool | ❌ | `False` | 跳过所有审批与沙箱限制（危险） |
+
+## 使用模式
+
+### 1. 基础调用（只读模式）
+
+```bash
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd . \
+  --PROMPT "Analyze the authentication flow in the login module"
+```
+
+### 2. 多轮会话
+
+**始终保存 SESSION_ID** 用于后续对话：
+
+```bash
+# 第一轮：分析代码
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd "/project" \
+  --PROMPT "Analyze the AdServiceImpl class"
+
+# 后续轮次：使用 SESSION_ID 继续
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd "/project" \
+  --SESSION_ID "uuid-from-previous-response" \
+  --PROMPT "Now write unit tests for the add method"
+```
+
+### 3. 获取 Unified Diff 补丁
+
+```bash
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd "/project" \
+  --PROMPT "Generate a unified diff to add logging to AdServiceImpl. OUTPUT: Unified Diff Patch ONLY."
+```
+
+### 4. 调试模式（返回完整信息）
+
+```bash
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd "/project" \
+  --PROMPT "Debug this error: NullPointerException in line 42" \
+  --return-all-messages
+```
+
+## 返回值结构
+
+**成功时：**
+```json
+{
+  "success": true,
+  "SESSION_ID": "550e8400-e29b-41d4-a716-446655440000",
+  "agent_messages": "模型回复内容..."
+}
+```
+
+**失败时：**
+```json
+{
+  "success": false,
+  "error": "错误信息描述"
+}
+```
+
+## 协作工作流
+
+### 推荐场景
+
+| 场景 | 说明 |
+|------|------|
+| **后端逻辑分析** | Codex 擅长复杂算法和后端逻辑 |
+| **代码审查** | 获取代码质量和潜在问题的反馈 |
+| **Debug 分析** | 利用其强大的调试能力定位问题 |
+| **原型设计** | 快速获取实现思路（返回 Diff 而非直接修改） |
+
+### 重要约束
+
+1. **只读模式**: 始终使用 `--sandbox read-only`，禁止 Codex 直接修改文件
+2. **英语交互**: 与 Codex 交互时使用英语，获得更好效果
+3. **中文输出强制**: Codex 倾向于输出英文，必须在每次 PROMPT 末尾追加以下约束：
+   ```
+   IMPORTANT LANGUAGE RULES:
+   - All SQL COMMENT values MUST be in Chinese (e.g., COMMENT '用户名' NOT COMMENT 'username')
+   - All Java/code comments (Javadoc, inline //, block /* */) MUST be in Chinese
+   - All field descriptions, table descriptions MUST be in Chinese
+   - Variable names and class names remain in English (camelCase/PascalCase)
+   ```
+4. **Diff 输出**: 在 PROMPT 中明确要求 `OUTPUT: Unified Diff Patch ONLY`
+5. **重构代码**: 将 Codex 的输出视为"脏原型"，由 Claude 重构为生产代码（**特别检查注释和 COMMENT 是否为中文，不是则修正**）
+6. **后台运行**: 对于长时间任务，使用 `Run in the background`
+
+## 与本项目的集成
+
+### 典型用例：后端模块分析
+
+```bash
+# 分析 Service 层实现
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd . \
+  --PROMPT "Analyze the three-layer architecture (Controller -> Service -> Mapper) in ruoyi-modules/ruoyi-system. Focus on how buildQueryWrapper is implemented in Service layer."
+```
+
+### 典型用例：代码审查
+
+```bash
+# 审查新增的业务模块
+python .claude/skills/collaborating-with-codex/scripts/codex_bridge.py \
+  --cd "/project" \
+  --PROMPT "Review the XxxServiceImpl.java for potential bugs, security issues, and adherence to the project's three-layer architecture pattern (Controller -> Service -> Mapper, NO DAO layer). OUTPUT: Review comments with specific line numbers."
+```
+
+## 安装前置
+
+```bash
+# 安装 Codex CLI
+npm install -g @openai/codex
+
+# 配置 API Key（可选，如果未设置环境变量）
+codex auth login
+```
+
+## 故障排除
+
+| 问题 | 解决方案 |
+|------|---------|
+| `codex: command not found` | 确保已安装并添加到 PATH |
+| `SESSION_ID` 获取失败 | 检查网络连接和 API Key |
+| 输出被截断 | 使用 `--return-all-messages` 获取完整信息 |
+| Windows 路径问题 | 使用正斜杠 `/` 或双反斜杠 `\\` |