@ohos-cpf/3rdloop 0.0.7 → 0.0.9

package/vendor/MCP/src/types.js

@@ -0,0 +1,115 @@
+/**
+ * MCP Gateway 类型定义
+ *
+ * 使用 JSDoc @typedef 定义所有共享类型，保持 JS 项目的类型安全。
+ * 各模块通过 @import 或 @type 引用这些类型。
+ */
+
+/**
+ * 下游 MCP Server 配置（stdio 类型）。
+ * @typedef {Object} StdioServerConfig
+ * @property {'stdio'} type        - 传输类型，固定为 'stdio'
+ * @property {string} command          - 启动命令（如 'npx'、'node'、'python3'）
+ * @property {string[]} args           - 命令参数
+ * @property {Object<string, string>} [env] - 环境变量
+ * @property {boolean} [enabled]       - 是否启用，默认 true
+ */
+
+/**
+ * 下游 MCP Server 配置（remote 类型）。
+ * @typedef {Object} RemoteServerConfig
+ * @property {'remote'} type       - 传输类型，固定为 'remote'
+ * @property {string} url          - 远程 MCP Server URL（如 'https://example.com/mcp'）
+ * @property {Object<string, string>} [headers] - 自定义 HTTP 请求头（如 Authorization）
+ * @property {boolean} [enabled]   - 是否启用，默认 true
+ */
+
+/**
+ * 下游 MCP Server 配置（联合类型）。
+ * @typedef {StdioServerConfig | RemoteServerConfig} DownstreamServerConfig
+ */
+
+/**
+ * 脚本功能配置。
+ * @typedef {Object} ScriptsConfig
+ * @property {boolean} enabled              - 是否启用脚本功能
+ * @property {boolean} hotReload            - 是否热加载脚本
+ * @property {number} timeout               - 脚本执行超时（ms）
+ * @property {string[]} allowedExtensions   - 允许的脚本扩展名
+ */
+
+/**
+ * 知识库 catalog 配置（与 Archive CatalogConfig 对应）。
+ * @typedef {Object} KBCatalogConfig
+ * @property {string} id            - 目录标识，如 'guides'
+ * @property {string} title         - 目录中文名
+ * @property {number} [searchBoost] - 搜索权重倍数（>1 提升）
+ * @property {boolean} [tailInGlobalSearch] - 全局搜索时是否排到尾部
+ */
+
+/**
+ * 知识库配置。
+ * @typedef {Object} KnowledgeBaseConfig
+ * @property {boolean} enabled          - 是否启用知识库工具
+ * @property {string} enginePath       - Archive 引擎入口路径（ESM import 路径）
+ * @property {string} dataDir          - 知识库数据根目录（文档 + 索引）
+ * @property {KBCatalogConfig[]} [catalogs] - 目录配置（不传使用 Archive 默认）
+ */
+
+/**
+ * Gateway 总配置。
+ * @typedef {Object} GatewayConfig
+ * @property {Object<string, DownstreamServerConfig>} downstreamServers - 下游 Server 配置
+ * @property {string} scriptsDir        - 脚本目录路径
+ * @property {ScriptsConfig} scripts    - 脚本功能配置
+ * @property {KnowledgeBaseConfig} [knowledgeBase] - 知识库配置（可选）
+ * @property {{ name: string, version: string, transport: 'stdio' }} gateway - Gateway 元信息
+ */
+
+/**
+ * 脚本参数定义。
+ * @typedef {Object} ScriptParam
+ * @property {string} name          - 参数名
+ * @property {'string'|'number'|'boolean'} type - 参数类型
+ * @property {string} description   - 参数描述
+ * @property {boolean} required     - 是否必填
+ */
+
+/**
+ * 脚本元数据（从头部 @tool 注释解析）。
+ * @typedef {Object} ScriptMeta
+ * @property {string} toolName      - 注册的工具名（含 'script_' 前缀）
+ * @property {string} rawName       - 原始工具名（去掉前缀）
+ * @property {string} description   - 工具描述
+ * @property {string} filePath      - 脚本文件绝对路径
+ * @property {string} extension     - 文件扩展名（如 '.sh'）
+ * @property {ScriptParam[]} params - 参数列表
+ */
+
+/**
+ * 聚合工具来源类型。
+ * @typedef {'downstream'|'script'|'builtin'} ToolSource
+ */
+
+/**
+ * 聚合工具条目。
+ * @typedef {Object} AggregatedTool
+ * @property {string} name              - 聚合后的工具名（含前缀）
+ * @property {ToolSource} source        - 来源类型
+ * @property {string} [sourceServer]    - 下游来源 Server 名（source='downstream' 时）
+ * @property {string} [originalName]    - 下游原始工具名（source='downstream' 时）
+ * @property {string} description       - 工具描述
+ * @property {Object} inputSchema       - JSON Schema 输入定义
+ */
+
+/**
+ * 下游 Server 连接状态。
+ * @typedef {Object} ServerConnectionStatus
+ * @property {string} name          - Server 名称
+ * @property {boolean} connected    - 是否已连接
+ * @property {number} toolCount     - 已注册工具数
+ * @property {string} [error]       - 错误信息
+ * @property {number} [processPid]  - 子进程 PID
+ */
+
+export {};

package/vendor/Server/CLI/cli.js

@@ -21,7 +21,7 @@ try {
  * 封装 AI 编程助手 CLI（opencode / deveco-code），对外暴露统一的 Session 管理接口。
  *
  * 默认 CLI 类型可在 Server/.env 中配置 CLI_TYPE=opencode|deveco-code，
- * 也可通过 shell 环境变量 CLI_TYPE 指定（优先级高于 .env），均未设置时默认 'opencode'。
+ * 也可通过 shell 环境变量 CLI_TYPE 指定（优先级高于 .env），均未设置时默认 'deveco-code'。
  * 显式传入 type 参数优先级最高。
  *
  * 连接配置同样支持 .env：OPENCODE_HOST/OPENCODE_PORT、DEVECO_HOST/DEVECO_PORT。
@@ -44,7 +44,7 @@ try {
 class CLIController {
     /**
      * @param {'opencode'|'deveco-code'} [type] - CLI 类型，缺省时取环境变量 CLI_TYPE
-     *   （shell 环境变量 > Server/.env），仍未设置则 'opencode'
+     *   （shell 环境变量 > Server/.env），仍未设置则 'deveco-code'
      * @param {object} [options={}]       - 传递给对应适配器的配置项
      *
      * opencode 选项：
@@ -61,7 +61,7 @@ class CLIController {
      * 公共选项：
      *   options.archive    - MessageArchive 实例（消息存档与卡死检测），不传则适配器内部自建
      */
-    constructor(type = process.env.CLI_TYPE || 'opencode', options = {}) {
+    constructor(type = process.env.CLI_TYPE || 'deveco-code', options = {}) {
         this.type = type;
 
         switch (type) {

package/vendor/Server/Routes/server.js

@@ -38,7 +38,7 @@ import KnowledgeImportController from './controllers/KnowledgeImportController.j
  * 创建并启动 HTTP 服务
  * @param {object} [options]
  * @param {number} [options.port=3000]          - 监听端口
- * @param {string} [options.cliType]            - CLI 类型，缺省时取环境变量 CLI_TYPE，仍未设置则 'opencode'
+ * @param {string} [options.cliType]            - CLI 类型，缺省时取环境变量 CLI_TYPE，仍未设置则 'deveco-code'
  * @param {object} [options.cliOptions={}]      - CLI 适配器配置
  * @param {CLIController} [options.cli]         - 已存在的 CLI 实例（优先于 cliType/cliOptions）
  * @returns {Promise<http.Server>}
@@ -46,7 +46,7 @@ import KnowledgeImportController from './controllers/KnowledgeImportController.j
 export async function createServer(options = {}) {
     const {
         port = 3000,
-        cliType = process.env.CLI_TYPE || 'opencode',
+        cliType = process.env.CLI_TYPE || 'deveco-code',
         cliOptions = {},
         cli = null
     } = options;
@@ -192,7 +192,7 @@ if (import.meta.url === pathToFileURL(process.argv[1]).href) {
     const portIdx = args.indexOf('--port');
     const typeIdx = args.indexOf('--type');
     const port = portIdx !== -1 ? Number(args[portIdx + 1]) : 3000;
-    const cliType = typeIdx !== -1 ? args[typeIdx + 1] : (process.env.CLI_TYPE || 'opencode');
+    const cliType = typeIdx !== -1 ? args[typeIdx + 1] : (process.env.CLI_TYPE || 'deveco-code');
 
     createServer({ port, cliType }).catch(err => {
         console.error('[Server] 启动失败:', err);

package/vendor/Server/Skills/arkts-library-test-coverage-check/references/MCP_TOOL_USAGE.md

@@ -2,6 +2,8 @@
 
 本文档说明本 SKILL 可复用的 MCP 脚本工具，用于接口覆盖率分析和测试文件扫描，避免重复造轮子。
 
+> `{{skillDir}}` = 本 SKILL 目录；脚本统一位于 SKILL 目录向上三级的 `MCP/scripts/`（仓库开发态与 npm 安装态路径一致）。
+
 ---
 
 ## 可用 MCP 脚本工具
@@ -17,7 +19,7 @@
 **调用方式**：
 
 ```bash
-node "{{workspaceRoot}}/MCP/scripts/analyze-demo-coverage.cjs" \
+node "{{skillDir}}/../../../MCP/scripts/analyze-demo-coverage.cjs" \
   --libroot "{{libroot}}" \
   --output "{{outputDir}}/demo-coverage-report.md"
 ```
@@ -49,7 +51,7 @@ node "{{workspaceRoot}}/MCP/scripts/analyze-demo-coverage.cjs" \
 **调用方式**：
 
 ```bash
-node "{{workspaceRoot}}/MCP/scripts/analyze-xts-coverage.cjs" \
+node "{{skillDir}}/../../../MCP/scripts/analyze-xts-coverage.cjs" \
   --libroot "{{libroot}}" \
   --output "{{outputDir}}/xts-coverage-report.md"
 ```

package/vendor/Server/Skills/arkts-library-xts-coverage/SKILL.md

@@ -35,16 +35,16 @@ metadata:
 ## 执行命令
 
 ```bash
-node "{{workspaceRoot}}/MCP/scripts/analyze-xts-coverage.cjs" --libroot "{{libroot}}" [--output "{{output}}"] [--title "{{title}}"] [--mode auto|ast|regex] [--lib "{{库名}}"]
+node "{{skillDir}}/../../../MCP/scripts/analyze-xts-coverage.cjs" --libroot "{{libroot}}" [--output "{{output}}"] [--title "{{title}}"] [--mode auto|ast|regex] [--lib "{{库名}}"]
 ```
 
 或从已有 interface-spec.json 生成：
 
 ```bash
-node "{{workspaceRoot}}/MCP/scripts/analyze-xts-coverage.cjs" --spec "{{spec}}" --libroot "{{libroot}}" [--output "{{output}}"]
+node "{{skillDir}}/../../../MCP/scripts/analyze-xts-coverage.cjs" --spec "{{spec}}" --libroot "{{libroot}}" [--output "{{output}}"]
 ```
 
-其中 `{{workspaceRoot}}` = `3rdLibraryLoop` 工作区根目录。
+其中 `{{skillDir}}` = SKILL.md 所在目录；脚本位于 SKILL 目录向上三级的 `MCP/scripts/`（仓库开发态与 npm 安装态路径一致）。
 
 ---
 

package/vendor/Server/Skills/knowledge-import/SKILL.md

@@ -305,7 +305,7 @@ experiences/{知识总结}
 | 参数 | 值 |
 |------|-----|
 | `issueList` | 4.5.1 构造的 JSON 数组 |
-| `knowledgeDir` | `BadCase/rn` 的绝对路径（相对 3rdLibraryLoop 仓库根解析） |
+| `knowledgeDir` | `BadCase/rn` 绝对路径。探测顺序：① `~/.3lib/3rdloop/BadCase/rn`（npm 安装态用户副本，`3rdloop mcp install` 生成）② `{{skillDir}}/../../../BadCase/rn`（仓库开发态） |
 
 ### 4.5.3 记录泛化产出
 

package/vendor/Server/Skills/knowledge-import/references/MCP_TOOL_USAGE.md

@@ -37,22 +37,30 @@
 
 ### 0.3 MCP Gateway 配置方法
 
-若 MCP Gateway 未配置，需在 `~/.config/opencode/opencode.json` 的 `mcp` 节点中添加：
+若 MCP Gateway 未配置，**优先执行一条命令自动注册**（npm 安装态与仓库开发态通用）：
+
+```bash
+3rdloop mcp install
+```
+
+该命令会生成用户级 Gateway 配置（`~/.3lib/3rdloop/mcp/config.json`，知识库数据落在 `~/.3lib/3rdloop/kb-data`，跨版本更新不丢失），并把 `mcp-gateway` 注册到 `~/.config/opencode/opencode.json` 与 `~/.config/deveco/deveco.jsonc`。
+
+手动配置（备用）：在 `~/.config/opencode/opencode.json` 的 `mcp` 节点中添加（路径替换为实际 Gateway 位置，npm 安装态为包内 `vendor/MCP/`，仓库开发态为仓库 `MCP/`）：
 
 ```json
 "mcp-gateway": {
   "command": [
     "node",
-    "/Users/lalhan/Desktop/3rdLibraryLoop/3rdLibraryLoop/MCP/src/index.js",
+    "<Gateway根目录>/MCP/src/index.js",
     "--config",
-    "/Users/lalhan/Desktop/3rdLibraryLoop/3rdLibraryLoop/MCP/config.json"
+    "~/.3lib/3rdloop/mcp/config.json"
   ],
   "enabled": true,
   "type": "local"
 }
 ```
 
-配置后需**重启 opencode** 才能让 AI 会话发现并调用 MCP 工具。
+配置后需**重启 opencode/deveco serve** 才能让 AI 会话发现并调用 MCP 工具。
 
 ---
 

package/vendor/Server/Skills/ohos-lib-pr-push/SKILL.md

@@ -2,7 +2,7 @@
 name: ohos-lib-pr-push
 description: 'GitCode 三方库自动提 PR 工具。工作区为 fork 仓库克隆：在代码修改完成后复用当前分支提交推送，自动总结修改点、在源仓库（上游）创建 Issue、必要时同步更新 CHANGELOG（条目附 Issue 链接）、从 fork 向源仓库创建绑定 Issue 的 PR、评论 Start build 触发 CI。USE FOR: 三方库适配/修复/用例补充等本地修改完成后，从 fork 向 GitCode 源仓库（如 CPF-RN 组织仓库）自动提交 PR。'
 license: Apache-2.0
-compatibility: 需要 Node.js 18+（执行 scripts/gitcode-api.cjs），需要 git 命令行，需要 GitCode API Token（默认读取 3rdLibraryLoop/Server/.env 的 GIT_TOKEN）
+compatibility: 需要 Node.js 18+（执行 scripts/gitcode-api.cjs），需要 git 命令行，需要 GitCode API Token（优先取环境变量 GIT_TOKEN，可用 3rdloop config set GIT_TOKEN 配置；仓库开发态回退读取 3rdLibraryLoop/Server/.env）
 metadata:
   author: LoopEngine
   version: "1.5.0"
@@ -23,7 +23,7 @@ metadata:
 |------|------|------|------|
 | `workspaceDir` | string | ✅ | 本地工作区（git 仓库根目录）绝对路径，修改已在该目录完成 |
 | `upstreamUrl` | string | ❌ | 源仓库（上游）URL（如 `https://gitcode.com/CPF-RN/rntpc_react-native-image-crop-picker`）。不提供时按 Phase 1.1 的上游推断规则确定 |
-| `token` | string | ❌ | GitCode Token。不提供时读取 `3rdLibraryLoop/Server/.env` 的 `GIT_TOKEN`（见 Phase 1） |
+| `token` | string | ❌ | GitCode Token。不提供时按优先级取：环境变量 `GIT_TOKEN`（`3rdloop config set GIT_TOKEN <token>`）→ `3rdLibraryLoop/Server/.env`（仓库开发态）（见 Phase 1） |
 | `baseBranch` | string | ❌ | PR 目标（上游）分支。默认为上游与当前分支同名的分支（见 Phase 1.5） |
 | `branchName` | string | ❌ | **已废弃自动生成新分支**：默认使用当前分支。仅当用户明确要求指定分支名时才生效，且仍不得切换已有工作分支 |
 | `commitMessage` | string | ❌ | 提交信息。默认由修改点总结自动生成 |
@@ -89,8 +89,9 @@ Phase 8: 生成报告
 按优先级取值：
 
 1. 用户显式传入的 `token` 参数
-2. 读取 `{3rdLibraryLoop根目录}/3rdLibraryLoop/Server/.env` 中的 `GIT_TOKEN`（该目录通常是 `/Users/lalhan/Desktop/3rdLibraryLoop/3rdLibraryLoop/Server/.env`，亦可从本 SKILL 目录向上回溯：`SKILL 目录 = Server/Skills/ohos-lib-pr-push`，故 `.env` 位于 `../../../.env`）
-3. 都没有 → **终止并提示用户提供 Token**
+2. 环境变量 `GIT_TOKEN`（`3rdloop config set GIT_TOKEN <token>` 写入 `~/.3lib/.env` 后即注入环境，npm 安装态与仓库开发态通用）
+3. 读取 `{3rdLibraryLoop根目录}/3rdLibraryLoop/Server/.env` 中的 `GIT_TOKEN`（仅仓库开发态；亦可从本 SKILL 目录向上回溯：`SKILL 目录 = Server/Skills/ohos-lib-pr-push`，故 `.env` 位于 `../../../.env`）
+4. 都没有 → **终止并提示用户提供 Token（推荐 `3rdloop config set GIT_TOKEN <token>`）**
 
 ### 1.3 获取 Token 用户信息
 

package/vendor/Server/Skills/rn-library-issue-generalizer/SKILL.md

@@ -27,7 +27,7 @@ metadata:
 | 参数 | 必填 | 说明 |
 |------|------|------|
 | `issueList` | ✅ | 案例清单。三种格式任选：① JSON 数组 `[{"description": "...", "prUrl": "..."}]` ② 清单文件路径（每行一条：`问题描述 <空格/Tab> PR链接`，兼容 Markdown 链接 `[描述](url)` 与裸 URL） ③ 多行文本（同②格式） |
-| `knowledgeDir` | ✅ | 知识库根目录绝对路径（如 `BadCase/rn`）。目录无 `INDEX.md` 时视为**冷启动**，自动初始化分级结构；已有 `INDEX.md` 时读取现有规则执行归类比对（Phase 4） |
+| `knowledgeDir` | ✅ | 知识库根目录**可写**绝对路径。默认探测顺序：① `~/.3lib/3rdloop/BadCase/rn`（npm 安装态用户副本，`3rdloop mcp install` 生成）② `{{skillDir}}/../../../BadCase/rn`（仓库开发态）。目录无 `INDEX.md` 时视为**冷启动**，自动初始化分级结构；已有 `INDEX.md` 时读取现有规则执行归类比对（Phase 4） |
 | `gitcodeToken` | ❌ | GitCode API Token。访问私有仓库或遇速率限制时使用 |
 
 ---
@@ -45,7 +45,7 @@ metadata:
 > ⚠️ **所有新增/修改文件**都必须存放在 `{knowledgeDir}` 内。知识库采用**分级结构**（一级索引 + 二级知识）：
 
 ```
-{knowledgeDir}/                       # 通常为 BadCase/rn/
+{knowledgeDir}/                       # 默认 ~/.3lib/3rdloop/BadCase/rn（npm 态）或仓库 BadCase/rn（开发态）
 ├── INDEX.md                          # 一级：分类 + 规则/案例索引（不含具体知识）
 ├── rules/                            # 二级：规则知识
 │   └── R-{XX}-{规则名}.md            #   检查点/特征 + 案例索引行

package/vendor/Server/Skills/rn-library-known-issue-check/SKILL.md

@@ -29,7 +29,7 @@ metadata:
 | `outputDir` | string | ✅ | 输出目录绝对路径 |
 | `interfaceDocPath` | string | ✅ | 接口规格说明文档路径 |
 | `repoName` | string | ✅ | 仓库名称 |
-| `knowledgeDir` | string | ❌ | 已知问题知识库根目录绝对路径，默认 `BadCase/rn`（相对 3rdLibraryLoop 仓库根） |
+| `knowledgeDir` | string | ❌ | 已知问题知识库根目录绝对路径。默认按以下顺序探测第一个存在的路径：① `~/.3lib/3rdloop/BadCase/rn`（npm 安装态用户副本，`3rdloop mcp install` 生成）② `{{skillDir}}/../../../BadCase/rn`（仓库开发态） |
 
 ---
 
@@ -38,7 +38,7 @@ metadata:
 - **前置 SKILL**: `rn-library-interface-analyzer`（阶段 1 已生成接口规格说明文档）
 - **输入文件**: `接口规格说明.md`（位于 outputDir）
 - **仓库源码**: 已克隆到 `{outputDir}/source/ohos/`（鸿蒙化）+ `{outputDir}/source/RN/`（上游原库）
-- **知识库**: `{knowledgeDir}`（默认 `BadCase/rn`），结构如下：
+- **知识库**: `{knowledgeDir}`（默认探测顺序：`~/.3lib/3rdloop/BadCase/rn` → `{{skillDir}}/../../../BadCase/rn`），结构如下：
 
 ```
 {knowledgeDir}/

package/vendor/Server/Skills/rnoh-lib-demo-coverage/SKILL.md

@@ -68,9 +68,8 @@ node "{{skillDir}}/../../../MCP/scripts/rn-analyze-demo-coverage.cjs" \
 ```
 
 其中：
-- `{{skillDir}}` = SKILL.md 所在目录
+- `{{skillDir}}` = SKILL.md 所在目录（脚本位于其向上三级的 `MCP/scripts/`）
 - `{{libroot}}` = RN 三方库的鸿蒙化仓库根目录
-- `{{workspaceRoot}}` = `3rdLibraryLoop` 工作区根目录
 
 ---
 

package/vendor/Server/Skills/rnoh-lib-test-align/references/port-test-demo-guide.md

@@ -83,7 +83,7 @@
 ./scripts/port-test-demo.sh \
   --git-url https://github.com/lottie-react-native/lottie-react-native \
   --branch v7.4.0 \
-  --template-dir /Users/lalhan/Desktop/RNOH/RN3rdTemplate/0.84
+  --template-dir <本地RN3rdTemplate模板目录，如 ~/RNOH/RN3rdTemplate/0.84>
 ```
 
 ### 手动指定 demo 目录

package/vendor/Server/Skills/rnoh-lib-xts-coverage/SKILL.md

@@ -68,9 +68,8 @@ node "{{skillDir}}/../../../MCP/scripts/rn-analyze-test-coverage.cjs" \
 ```
 
 其中：
-- `{{skillDir}}` = SKILL.md 所在目录
+- `{{skillDir}}` = SKILL.md 所在目录（脚本位于其向上三级的 `MCP/scripts/`）
 - `{{libroot}}` = RN 三方库的鸿蒙化仓库根目录
-- `{{workspaceRoot}}` = `3rdLibraryLoop` 工作区根目录
 
 ---
 

package/vendor/Server/package.json

@@ -8,10 +8,14 @@
     "test:selector": "node Agent/SkillSelector/__tests__/run-sample.js"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
     "@opencode-ai/sdk": "^1.18.6",
     "better-sqlite3": "^13.0.1",
+    "chokidar": "^4.0.0",
     "dotenv": "^17.0.0",
-    "openai": "^4.0.0"
+    "jieba-wasm": "^2.4.0",
+    "openai": "^4.0.0",
+    "typescript": "^5.5.4"
   },
   "_comment": "vendored from Server/; dependencies aligned with cli package.json by prepack"
 }

package/vendor/VERSION

@@ -1,3 +1,3 @@
-0.0.7
-built=2026-09-03T07:18:44.123Z
-sha=f1a4be02fe03f0c6
+0.0.9
+built=2026-09-04T07:23:59.928Z
+sha=84d14394dbb68bd4