@ohos-cpf/3rdloop 0.0.1

package/vendor/Server/Skills/flutter-interface/references/GIT_CLONE_GUIDE.md

@@ -0,0 +1,190 @@
+# Git Clone 指南
+
+本文档详细说明从远程 Git 仓库克隆代码的 URL 解析规则和操作步骤。
+
+---
+
+## URL 格式解析规则
+
+支持从 Web 页面 URL 直接复制使用，自动解析以下格式：
+
+### 格式 1：仅分支
+
+```
+https://gitcode.com/openharmony-sig/flutter_inappwebview/tree/br_v6.1.5_ohos_dev
+```
+
+解析为：
+- 仓库地址：`https://gitcode.com/openharmony-sig/flutter_inappwebview.git`
+- 分支：`br_v6.1.5_ohos_dev`
+- 子路径：无（分析整个仓库）
+
+### 格式 2：分支 + 子路径
+
+```
+https://gitcode.com/openharmony-sig/kmptpc_compose_sample/tree/cmp192_for_ohos/harmonyApp
+```
+
+解析为：
+- 仓库地址：`https://gitcode.com/openharmony-sig/kmptpc_compose_sample.git`
+- 分支：`cmp192_for_ohos`
+- 子路径：`harmonyApp`（只分析这个文件夹）
+
+### 格式 3：标准 Git URL（支持扩展参数）
+
+```
+https://github.com/org/repo.git#branch=develop
+https://github.com/org/repo.git#subpath=packages/core
+https://github.com/org/repo.git#branch=develop&subpath=packages/core
+```
+
+---
+
+## 解析步骤
+
+### 1. 提取仓库基础 URL
+
+- 如果 URL 包含 `/tree/`，提取 `https://域名/组织/仓库` 部分
+- 添加 `.git` 后缀（如果尚未包含）
+
+示例：
+- `https://gitcode.com/org/repo/tree/branch` → `https://gitcode.com/org/repo.git`
+- `https://gitcode.com/org/repo/tree/branch/subpath` → `https://gitcode.com/org/repo.git`
+
+### 2. 提取分支名称
+
+从 `/tree/` 后的第一个路径段提取分支名：
+- `/tree/br_v6.1.5_ohos_dev` → 分支：`br_v6.1.5_ohos_dev`
+- `/tree/cmp192_for_ohos/harmonyApp` → 分支：`cmp192_for_ohos`
+
+### 3. 提取子路径
+
+从分支名称后的路径段提取子路径（如果有）：
+- `/tree/cmp192_for_ohos/harmonyApp` → 子路径：`harmonyApp`
+- `/tree/main/packages/core` → 子路径：`packages/core`
+
+### 4. 解析标准 Git URL 参数
+
+如果 URL 包含 `#branch=` 或 `#subpath=` 参数，提取对应值：
+- `repo.git#branch=develop` → 分支：`develop`
+- `repo.git#branch=develop&subpath=packages/core` → 分支：`develop`，子路径：`packages/core`
+
+---
+
+## 克隆操作
+
+### 检查 Git 环境
+
+```bash
+git --version
+```
+
+确认 Git 已安装且版本 ≥ 2.25.0（支持 Sparse Checkout）。
+
+### 情况 A：无子路径（完整克隆）
+
+```bash
+# 克隆整个仓库
+git clone <baseUrl> <outputDir>/source
+
+# 切换到指定分支（如果有）
+cd <outputDir>/source
+git checkout <branch>
+```
+
+### 情况 B：有子路径（稀疏检出 - Sparse Checkout）
+
+> 优势：只下载指定文件夹，节省时间和磁盘空间
+
+```bash
+# 1. 初始化空仓库
+mkdir -p <outputDir>/source
+cd <outputDir>/source
+git init
+
+# 2. 启用稀疏检出
+git sparse-checkout init --cone
+
+# 3. 设置远程仓库
+git remote add origin <baseUrl>
+
+# 4. 指定要检出的子路径
+git sparse-checkout set <subpath>
+
+# 5. 拉取指定分支的代码
+git fetch origin <branch> --depth=1
+
+# 6. 检出代码
+git checkout <branch>
+```
+
+### 示例
+
+```bash
+# 示例：只克隆 harmonyApp 文件夹
+mkdir -p /tmp/analysis/kmptpc/source
+cd /tmp/analysis/kmptpc/source
+git init
+git sparse-checkout init --cone
+git remote add origin https://gitcode.com/openharmony-sig/kmptpc_compose_sample.git
+git sparse-checkout set harmonyApp
+git fetch origin cmp192_for_ohos --depth=1
+git checkout cmp192_for_ohos
+```
+
+---
+
+## 验证克隆结果
+
+检查 `<outputDir>/source` 目录：
+- 如果有子路径，检查 `<outputDir>/source/<subpath>` 是否存在
+- 确认目录包含源代码文件（`.dart`、`.ets`、`.ts`、`.js` 等）
+
+---
+
+## 记录克隆信息
+
+将以下信息写入 `<outputDir>/clone-info.json`：
+
+```json
+{
+  "baseUrl": "https://gitcode.com/openharmony-sig/kmptpc_compose_sample.git",
+  "branch": "cmp192_for_ohos",
+  "subpath": "harmonyApp",
+  "sparseCheckout": true,
+  "cloneTime": "2026-05-09T10:30:00Z",
+  "commitHash": "abc123def456",
+  "originalUrl": "https://gitcode.com/openharmony-sig/kmptpc_compose_sample/tree/cmp192_for_ohos/harmonyApp"
+}
+```
+
+---
+
+## 确定最终分析路径
+
+- 如果有子路径：`analysisRoot = <outputDir>/source/<subpath>`
+- 如果无子路径：`analysisRoot = <outputDir>/source`
+
+后续 Phase 2 的脚本提取基于 `analysisRoot` 目录进行。
+
+---
+
+## 克隆失败处理
+
+| 错误类型 | 可能原因 | 解决方案 |
+|----------|----------|----------|
+| 认证失败 | 私有仓库或权限不足 | 提示用户配置 SSH 密钥或 HTTPS Token |
+| 分支不存在 | 分支名称错误 | 列出远程分支：`git branch -r`，提示用户选择正确分支 |
+| 子路径不存在 | 路径错误或分支中无此目录 | 列出仓库根目录内容，提示用户确认路径 |
+| 网络超时 | 网络问题 | 提示用户检查网络或使用镜像站点 |
+| Sparse Checkout 失败 | Git 版本过低 | 提示升级 Git 到 2.25+ 或使用完整克隆 |
+
+### 旧版本 Git 替代方案
+
+如果 Git 版本 < 2.25，使用以下替代方案：
+
+```bash
+git config core.sparseCheckout true
+echo "<subpath>/*" >> .git/info/sparse-checkout
+git pull origin <branch>
+```

package/vendor/Server/Skills/flutter-interface/references/SCRIPT_REFERENCE.md

@@ -0,0 +1,258 @@
+# 脚本使用参考
+
+本文档详细说明 `flutter-extract-interfaces.cjs` 和 `flutter-render-spec-doc.cjs` 两个共享脚本（位于仓库 `MCP/scripts/` 目录，本 SKILL 通过相对路径 `{{skillDir}}/../../../MCP/scripts/` 引用，不保存副本）的参数、输出格式和故障排查。
+
+> `{{skillDir}}` = 本 SKILL 的 SKILL.md 所在目录（任务 prompt 中“SKILL 目录”下发的绝对路径）。
+
+---
+
+## flutter-extract-interfaces.cjs
+
+### 功能
+
+从 Flutter 三方库源码目录提取接口规格。基于 Dart 正则解析，提取类/枚举/mixin/extension/函数/变量的公开接口，输出 JSON。
+
+### 脚本核心策略
+
+1. `pubspec.yaml` → 包名 → `lib/<package>.dart` 入口定位
+2. export 链递归追踪（`src/` 相对路径 + `package:` 跨包路径）
+3. export hide/show 过滤
+4. 预处理移除字符串/注释（保留行号），大括号块匹配提取类体
+5. 正则解析类/枚举/mixin/extension 成员 + 顶层函数/变量/typedef
+6. `///` 文档注释提取
+7. `_` 前缀私有成员过滤
+8. monorepo 多子包支持
+
+### 用法
+
+```bash
+# CLI 模式
+node "{{skillDir}}/../../../MCP/scripts/flutter-extract-interfaces.cjs" --repoDir <库源码目录> --output <interface-spec.json>
+
+# 不指定 output 则输出 JSON 到 stdout
+node "{{skillDir}}/../../../MCP/scripts/flutter-extract-interfaces.cjs" --repoDir /path/to/flutter_lib
+```
+
+### 参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--repoDir` | string | ✅ | 库源码根目录路径（包含 `lib/` 子目录和 `pubspec.yaml`） |
+| `--output` | string | ❌ | 输出 JSON 文件路径（不指定则输出到 stdout） |
+
+> `--libroot` 是 `--repoDir` 的别名，两者等价。
+
+### 库源码目录结构约定
+
+```
+/path/to/lib/
+├── <package>.dart          ← 入口文件
+├── src/                     ← 库源码
+└── constants.dart
+```
+
+**monorepo（如 flutter_inappwebview）**：
+
+```
+/path/to/flutter_inappwebview/
+├── flutter_inappwebview/        ← 主包
+│   ├── lib/
+│   └── pubspec.yaml
+└── flutter_inappwebview_platform_interface/
+    └── lib/
+```
+
+脚本自动检测 monorepo 结构并定位主包。
+
+### 输出 JSON 结构
+
+```json
+{
+  "libraryName": "包名",
+  "entryFile": "./lib/xxx.dart",
+  "nativeDPath": null,
+  "extractedAt": "2026-08-15T12:00:00.000Z",
+  "summary": {
+    "S": 10,           // 类/接口/枚举总数
+    "N": 50,            // 方法/属性/字段总数
+    "M": 0,
+    "methods": 30,
+    "properties": 10,
+    "fields": 5,
+    "constants": 5
+  },
+  "sources": [
+    "./lib/xxx.dart",
+    "./lib/src/yyy.dart"
+  ],
+  "interfaces": [
+    {
+      "className": "ClassName",
+      "memberName": "methodName",
+      "fullName": "ClassName.methodName",
+      "kind": "method",
+      "isStatic": false,
+      "isReadonly": false,
+      "isOptional": false,
+      "isEvent": false,
+      "type": "class",
+      "signature": "ReturnType methodName(params)",
+      "params": [
+        {
+          "name": "paramName",
+          "type": "String",
+          "optional": false,
+          "description": "-"
+        }
+      ],
+      "returnType": "void",
+      "description": "/// 文档注释内容",
+      "source": "./lib/src/xxx.dart",
+      "startLine": 42
+    }
+  ]
+}
+```
+
+### 接口 kind 分类
+
+| kind | 说明 | 对应 Dart 语法 |
+|------|------|----------------|
+| `method` | 类方法 | `ReturnType methodName(params) { }` |
+| `property` | getter 属性 | `ReturnType get name` |
+| `field` | 类字段 | `final Type field` 或 `Type field` |
+| `constant` | 常量 | `const Type name` |
+| `constructor` | 构造函数 | `ClassName(params)` 或 `factory ClassName.name(params)` |
+| `enumValue` | 枚举值 | `enum Name { value1, value2 }` |
+| `function` | 顶层函数 | `ReturnType functionName(params)` |
+| `variable` | 顶层变量 | `var name = value` |
+| `type` | 类型别名 | `typedef Name = Type` |
+
+### 接口 type 分类（声明类型）
+
+| type | 说明 |
+|------|------|
+| `class` | 普通类 |
+| `abstract_class` | 抽象类 |
+| `mixin` | mixin 声明 |
+| `mixin_class` | mixin class（Dart 3） |
+| `enum` | 枚举 |
+| `extension` | 扩展 |
+| `function` | 顶层函数 |
+| `variable` | 顶层变量 |
+| `typedef` | 类型别名 |
+
+---
+
+## flutter-render-spec-doc.cjs
+
+### 功能
+
+将接口规格 JSON 渲染为 Markdown 格式的接口规格说明书文档。
+
+### 用法
+
+```bash
+# 方式一：读 JSON 中间件（推荐，可复用 JSON）
+node "{{skillDir}}/../../../MCP/scripts/flutter-render-spec-doc.cjs" --spec <interface-spec.json> --output <spec.md>
+
+# 方式二：直接从源码提取并渲染（一步到位）
+node "{{skillDir}}/../../../MCP/scripts/flutter-render-spec-doc.cjs" --libroot <库源码目录> --output <spec.md>
+```
+
+### 参数
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `--spec` | string | 二选一 | 已有的 `interface-spec.json` 路径 |
+| `--libroot` | string | 二选一 | 库源码根目录路径（直接从源码提取） |
+| `--output` | string | ❌ | 输出 Markdown 文件路径（不指定则输出到 stdout） |
+
+> `--repoDir` 是 `--libroot` 的别名，两者等价。
+
+### 生成的文档结构
+
+```
+# [库名] 接口规格说明书
+
+## 基本信息（库名、入口文件、生成时间、源文件数）
+## 接口统计（类数、方法数、属性数等）
+## 1. [类名]（每个类/枚举/mixin 一个章节）
+  ### 构造函数（表格）
+  ### 方法（表格：方法名、事件、静态、参数、返回类型、说明）
+  ### 属性（表格）
+  ### 字段（表格）
+  ### 常量（表格）
+  ### 枚举值（表格）
+  ### 函数（表格）
+  ### 变量/常量（表格）
+  ### 类型别名（表格）
+  ### 事件方法汇总（表格）
+## 2. [下一个类名]
+  ...
+## 源文件列表
+```
+
+---
+
+## 模块化调用（编程方式）
+
+两个脚本也可作为 Node.js 模块 `require` 使用：
+
+```javascript
+// 提取接口
+const { generateSpec } = require('./flutter-extract-interfaces.cjs');
+const spec = generateSpec('/path/to/flutter_lib');
+// spec 是 JSON 对象，可直接使用或写入文件
+
+// 渲染文档需要通过 CLI 调用
+// 或自行实现渲染逻辑
+```
+
+---
+
+## 故障排查
+
+### 提取结果为空（interfaces 数组为空）
+
+| 可能原因 | 排查方法 | 解决方案 |
+|----------|----------|----------|
+| 入口文件未找到 | 检查 `lib/<package>.dart` 是否存在 | 确认 `pubspec.yaml` 的 `name` 字段与入口文件名匹配 |
+| 源文件无 export | 检查入口文件是否使用 `export` 语句导出 | 脚本同时收集 `lib/` 下所有 `.dart` 文件作为 fallback |
+| 所有成员都是私有 | 检查成员是否以 `_` 开头 | 私有成员被自动过滤，属于正常行为 |
+| 目录结构异常 | 检查 `analysisRoot` 是否正确 | 确认路径指向包含 `lib/` 的目录 |
+
+### monorepo 主包定位错误
+
+脚本自动检测 monorepo 主包，优先级：
+1. 与根目录名完全匹配的子目录
+2. 去掉 `fluttertpc_` 前缀后匹配的子目录
+3. 排除 `platform_interface`/`_android`/`_ios` 等辅助包后按名称排序的第一个
+
+如果定位错误，可手动指定主包路径直接传入：
+```bash
+node "{{skillDir}}/../../../MCP/scripts/flutter-extract-interfaces.cjs" --repoDir /path/to/monorepo/main_package
+```
+
+### export 链追踪不完整
+
+脚本递归追踪 `export` 语句，但以下情况可能遗漏：
+- 动态 export（条件 export）
+- 通过 `part`/`part of` 拆分的文件（已支持但可能有边缘情况）
+
+排查方法：检查输出 JSON 的 `sources` 数组，确认关键源文件是否被包含。
+
+### 文档注释未提取
+
+脚本提取 `///` 格式的文档注释。以下格式不被提取：
+- `//` 单行注释（非文档注释）
+- `/* */` 块注释（非文档注释）
+- `/** */` JSDoc 风格（仅提取紧邻声明上方的 `*` 行）
+
+---
+
+## 性能说明
+
+- 脚本基于正则解析，不依赖 Dart SDK 或 analyzer，适合 CI/CD 环境
+- 大型库（如 `flutter_inappwebview`，数百个源文件）提取时间通常 < 5 秒
+- 内存占用与源文件总大小成正比，无特殊内存优化需求

package/vendor/Server/Skills/flutter-interface/references/TEMPLATE.md

@@ -0,0 +1,254 @@
+# Library Interface Analyzer - 文档模板
+
+本模板可用于手动创建接口规格说明文档。
+
+---
+
+# [库名]接口规格说明
+
+## 1. 三方库概述
+
+[在此填写库的功能介绍，包括主要特性、适用场景等，3-5 句话即可]
+
+示例：
+> XXX 是一个轻量级的 JavaScript 工具库，提供了常用的字符串、数组和对象操作函数。它支持 ES6+ 语法，可在浏览器和 Node.js 环境中使用。主要特性包括：链式调用、按需引入、零依赖。
+
+---
+
+## 2. 对外导出的类
+
+> 如果没有导出类，可以省略此章节
+
+### 2.1 [类名1]
+
+| 序号 | 类名/成员 | 方法/属性 | 功能描述 |
+|------|-----------|-----------|----------|
+| 1    | [类名1] | constructor([参数列表]) | [构造函数的功能描述] |
+| 2    |         | [方法名1]([参数列表]): [返回值类型] | [方法的功能描述] |
+| 3    |         | [方法名2]([参数列表]): [返回值类型] | [方法的功能描述] |
+| 4    |         | [属性名1]: [属性类型] | [属性的功能描述] |
+| 5    |         | [属性名2]: [属性类型] | [属性的功能描述] |
+
+### 2.2 [类名2]
+
+| 序号 | 类名/成员 | 方法/属性 | 功能描述 |
+|------|-----------|-----------|----------|
+| 1    | [类名2] | constructor([参数列表]) | [构造函数的功能描述] |
+| ...  | ...     | ...       | ...      |
+
+> 如果有更多类，继续添加表格
+
+---
+
+## 3. 对外导出的接口/类型（TypeScript）
+
+> 仅 TypeScript 库适用；如果没有导出接口/类型，可以省略此章节
+
+### 3.1 [接口名1]
+
+| 序号 | 接口/类型名 | 字段 | 类型 | 必填 | 描述 |
+|------|------------|------|------|------|------|
+| 1    | [接口名1] | [字段名1] | [类型] | 是 | [字段描述] |
+| 2    |            | [字段名2?] | [类型] | 否 | [可选字段描述] |
+| ...  | ...        | ...   | ...  | ...  | ...  |
+
+### 3.2 [类型别名1]
+
+> `type` 别名可直接描述其等价类型
+
+| 序号 | 类型名 | 等价类型 | 功能描述 |
+|------|--------|----------|----------|
+| 1    | [类型名1] | [等价类型] | [类型的功能描述] |
+
+---
+
+## 4. 对外导出的枚举
+
+> 如果没有导出枚举，可以省略此章节
+
+| 序号 | 枚举名称 | 成员名 | 值 | 功能描述 |
+|------|----------|--------|-----|----------|
+| 1    | [枚举名1] | [成员名1] | [值] | [枚举整体描述] |
+| 2    |          | [成员名2] | [值] | [成员描述] |
+| 3    | [枚举名2] | [成员名1] | [值] | [枚举整体描述] |
+
+---
+
+## 5. 对外导出的函数
+
+> 如果没有导出函数，可以省略此章节
+
+| 序号 | 函数名称 | 返回值 | 参数列表 | 功能描述 |
+|------|----------|--------|----------|----------|
+| 1    | [函数名1] | [返回值类型] | [参数1: 类型1, 参数2: 类型2, ...] | [函数的功能描述] |
+| 2    | [函数名2] | [返回值类型] | [参数列表] | [函数的功能描述] |
+| 3    | [函数名3] | [返回值类型] | [参数列表] | [函数的功能描述] |
+
+---
+
+## 6. 对外导出的变量
+
+> 如果没有导出变量，可以省略此章节
+
+| 序号 | 变量名称 | 变量类型 | 功能描述 |
+|------|----------|----------|----------|
+| 1    | [变量名1] | [变量类型] | [变量的功能描述] |
+| 2    | [变量名2] | [变量类型] | [变量的功能描述] |
+
+---
+
+## 7. 注意事项
+
+> 如果没有特殊注意事项，可以省略此章节
+
+- [注意事项1：例如使用限制、兼容性问题等]
+- [注意事项2：例如依赖的环境、需要的配置等]
+- [注意事项3：例如性能考虑、已知问题等]
+
+示例：
+- 本库依赖 ES6+ 环境，不支持 IE11 及更早版本
+- 部分函数使用了 Node.js 内置模块，不能在浏览器环境中使用
+- 深拷贝函数不支持循环引用的对象
+- 异步函数均返回 Promise，需要注意错误处理
+
+---
+
+## 填写说明
+
+### 类（Classes）
+每个类一个表格，包含：
+- **构造函数**: 第一行，展示如何创建实例
+- **方法**: 按重要性排序，包含参数和返回值类型；**静态方法需标注 `static`**
+- **属性**: 公开可访问的属性；`private`/`protected` 成员不包含
+
+**示例**:
+```
+| 序号 | 类名/成员 | 方法/属性 | 功能描述 |
+|------|-----------|-----------|----------|
+| 1    | HttpClient | constructor(baseURL: string, timeout?: number) | 创建 HTTP 客户端实例 |
+| 2    |           | get(url: string, options?: RequestOptions): Promise<Response> | 发送 GET 请求 |
+| 3    |           | static create(baseURL: string): HttpClient | 静态工厂方法 |
+| 4    |           | timeout: number | 请求超时时间（毫秒） |
+```
+
+### 接口/类型（Interfaces/Types）
+导出的 `interface` 或 `type` 别名：
+- **必填字段**: 无 `?` 修饰符
+- **可选字段**: 字段名带 `?`，展示为 `field?`
+- **注意**: TypeScript 库的 `.d.ts` 文件是最权威的来源
+
+**示例**:
+```
+| 序号 | 接口/类型名 | 字段 | 类型 | 必填 | 描述 |
+|------|------------|------|------|------|------|
+| 1    | RequestOptions | timeout? | number | 否 | 请求超时时间 |
+| 2    |                | headers? | Record<string, string> | 否 | 自定义请求头 |
+```
+
+### 枚举（Enums）
+导出的枚举应列出所有成员及对应值：
+- 同一枚举的所有成员在表格中共用一个枚举名单元格，其余为空
+
+**示例**:
+```
+| 序号 | 枚举名称 | 成员名 | 值 | 功能描述 |
+|------|----------|--------|-----|----------|
+| 1    | HttpMethod | GET | 'get' | HTTP GET 方法 |
+| 2    |            | POST | 'post' | HTTP POST 方法 |
+```
+
+### 函数（Functions）
+所有导出的独立函数：
+- **函数名称**: 准确的函数名
+- **返回值**: 返回值的类型
+- **参数列表**: 包含参数名和类型，可选参数用 `?` 标记
+- **功能描述**: 简短的功能说明
+
+**示例**:
+```
+| 序号 | 函数名称 | 返回值 | 参数列表 | 功能描述 |
+|------|----------|--------|----------|----------|
+| 1    | debounce | Function | fn: Function, delay: number | 函数防抖，延迟执行 |
+```
+
+### 变量（Variables）
+导出的常量或配置对象：
+- **变量名称**: 通常使用大写和下划线
+- **变量类型**: 基本类型或对象类型
+- **功能描述**: 变量的用途
+
+**示例**:
+```
+| 序号 | 变量名称 | 变量类型 | 功能描述 |
+|------|----------|----------|----------|
+| 1    | VERSION | string | 库的版本号 |
+| 2    | DEFAULT_CONFIG | object | 默认配置对象 |
+```
+
+### 注意事项
+包括但不限于：
+- 环境要求（浏览器、Node.js 版本等）
+- 使用限制（不支持的特性、边界情况等）
+- 依赖关系（需要的外部库或工具）
+- 性能考虑（大数据量的处理、内存占用等）
+- 已知问题（bug、待完善的功能等）
+- 最佳实践（推荐的使用方式）
+
+---
+
+## 参数表示法
+
+### TypeScript 风格
+```
+参数名: 类型
+可选参数?: 类型
+默认参数: 类型 = 默认值
+```
+
+示例：
+- `url: string`
+- `timeout?: number`
+- `method: 'GET' | 'POST' = 'GET'`
+
+### JavaScript 风格（JSDoc）
+```
+参数名: 类型
+可选参数 (可选)
+```
+
+示例：
+- `url: String`
+- `timeout: Number (可选)`
+
+### Python 风格
+```
+参数名: 类型
+可选参数: 类型 = 默认值
+```
+
+示例：
+- `text: str`
+- `encoding: str = 'utf-8'`
+
+---
+
+## 类型表示法
+
+常见类型：
+- **基本类型**: string, number, boolean, null, undefined
+- **对象类型**: object, Object, any
+- **数组类型**: Array, Array<T>, T[]
+- **函数类型**: Function, (args) => returnType
+- **联合类型**: string | number
+- **泛型**: T, <T>
+
+---
+
+## 保存文件
+
+文件名格式: `[库名]接口规格说明.md`
+
+例如：
+- `lodash接口规格说明.md`
+- `axios接口规格说明.md`
+- `react接口规格说明.md`