npm - kcode-pi - Versions diffs - 0.1.5 → 0.1.7 - Mend

kcode-pi 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (50) hide show

package/vendor/kingdee-skills/ok-cosmic/README.md DELETED Viewed

@@ -1,460 +0,0 @@
-# ok-cosmic
-**作者：** 陈泽贤、钱芮名
-**注意：仅限内部使用**
-面向金蝶云苍穹开发的 AI Skill，提供插件模板、离线 API 知识查询、表单元数据查询、基础资料查询与文档增强能力。
----
-## 📌 概览
-`ok-cosmic` 是一个面向金蝶云苍穹开发的 AI Skill，聚焦表单插件、单据插件、列表插件、操作插件、BOTP 转换、报表插件、工作流、后台任务、OpenAPI 等常见二开场景。它结合本地知识库、文档库、查询脚本、模板骨架和规则约束，帮助 AI 更准确地理解苍穹 SDK、ServiceHelper、元数据字段与插件生命周期，降低 API 幻觉和字段误用风险。
-## 🧠 核心能力
-- `🧩` 插件选型与模板骨架：支持苍穹常见开发场景的插件选型、模板骨架和开发约束
-- `🔎` 离线 API 查询：支持查询类、方法、返回值、参数说明、继承链和方法注释
-- `🗂️` 表单元数据 / 基础资料 / 业务拓展点查询：支持查询字段标识、引用类型、枚举映射、基础资料编码名称映射和业务拓展点候选接口
-- `📝` 文档增强回填：支持利用文档库补齐参数名、参数说明和父类/接口方法注释
-- `⚡` 紧凑事实输出：支持低噪音输出，便于继续交给 AI 生成代码
-## 🧭 规则分层与校验
-`ok-cosmic` 当前将规则分为三层：
-- `A 层`：硬约束 / 交付红线。直接影响事实准确性、事件阶段、插件上下文与运行期正确性。
-- `B 层`：推荐项 / 新代码默认写法。代表团队希望新代码优先采用的封装、工具类和实现风格。
-- `C 层`：目标态治理 / 渐进优化。适合模板升级、专项治理和批量重构，不作为默认一次性交付阻断项。
-代码生成后的默认校验命令：
-```bash
-python3 <SKILL_ROOT>/scripts/cosmic-post-check.py <file-or-dir> --fix-hint
-```
-默认模式下：
-- `ERROR`：按 A 层硬约束处理，必须修复
-- `WARNING`：按 B 层推荐项处理，新代码优先修复
-- `INFO`：按 C 层治理项处理，作为后续优化参考
-当需要做模板升级、补验证来源留痕或更严格的治理检查时，可追加严格模式：
-```bash
-python3 <SKILL_ROOT>/scripts/cosmic-post-check.py <file-or-dir> --fix-hint --strict
-```
-## 🚀 快速开始与安装
-### 快速分流
-| 你的情况 | 从哪步开始 | 预计耗时 |
-|----------|-----------|--------|
-| 首次完整安装（含服务端） | 步骤 1 | 30 分钟 |
-| 服务端已就绪，新项目接入 | 步骤 6 | 2 分钟 |
-| 已有项目，换 Agent | 步骤 7 | 1 分钟 |
-> 步骤 2–3 为**服务端一次性配置**，完成后所有项目共享；步骤 4–5 为**知识库一次性构建**，构建完成后复制即用。
-下面是完整安装与使用流程。
-## 1. 环境检查
-在开始之前，请确保您的系统满足以下要求：
-### 必需环境
-| 依赖项 | 版本要求 | 检查命令 | 备注 |
-|--------|--------|----------|------|
-| Java | JDK 8+ | `java -version` | 必须配置 JAVA_HOME |
-| Python | 3.8+ | `python3 --version` | 用于 API 知识查询脚本 |
-> Python 依赖包（tree-sitter 等）无需手动安装——Step 0 配置预检会自动检测并安装。完整清单见 `requirements.txt`。
-### 检查清单
-```bash
-# 检查 Java 版本
-java -version
-# 检查 Python 版本
-python3 --version
-# 检查 JAVA_HOME 是否配置（Mac/Linux）
-echo $JAVA_HOME
-# 检查 JAVA_HOME 是否配置（Windows）
-echo %JAVA_HOME%
-```
----
-## 2. 部署自定义封装库
-将 `setup/cuslib/` 目录下的两个 JAR 包部署到苍穹环境：
-### 2.1 本地环境部署
-将以下 JAR 文件复制到苍穹本地开发环境的 `cus` 目录：
-```
-setup/cuslib/
-├── kd-cd-cosmic-commons.jar   # 公共封装库
-└── kd-cd-cosmic-features.jar  # 功能封装库
-```
-**目标路径示例：**
-```bash
-# Mac/Linux
-cp setup/cuslib/*.jar /path/to/cosmic/cus/
-# Windows
-copy setup\cuslib\*.jar C:\path\to\cosmic\cus\
-```
-### 2.2 Dev 线上环境部署
-将上述 JAR 包同时部署到 Dev 线上环境，确保封装库在开发调试时可用。
----
-## 3. 统一路由 API 注册
-将统一路由接口注册到 Dev 环境的 OpenAPI，用于在线查询表单元数据、基础资料和业务拓展点。
-### 3.1 注册接口
-在苍穹开发平台中，注册提供 `runtime/route` 的自定义接口。
-**注册步骤：**
-1. 登录 Dev 环境苍穹开发平台
-2. 进入 **OpenAPI 管理** → **自定义接口**
-3. 新增接口，填写统一路由控制器类名：kd.cd.feature.ai.mcp.route.McpRoutingController
-4. **推荐使用基本认证（Basic Auth）** 方式注册
-### 3.2 获取统一路由 API URL
-注册成功后，获取统一路由 API URL，格式如下：
-```
-https://deverp.xxxx.com/ierp/kapi/v2/xxxx/xxxx_devportal_ext/runtime/route?openApiSign=YOUR_SIGN_HERE
-```
-### 3.3 配置统一路由 API 地址
-将获取的 API URL 填入配置文件 `ok-cosmic.json` 的 `route.apiUrl` 字段：
-```json
-{
-  "route": {
-    "apiUrl": "https://deverp.xxxx.com/ierp/kapi/v2/xxxx/xxxx_devportal_ext/runtime/route?openApiSign=YOUR_SIGN_HERE",
-    "timeoutSeconds": 30
-  }
-}
-```
----
-## 4. 知识库构建
-运行初始化工具构建知识库。setup.jar 已自带，无需额外构建。
-**Mac/Linux:**
-```bash
-cd skills/ok-cosmic/setup
-chmod +x setup-mac.sh
-./setup-mac.sh -libpath=<项目苍穹JAR库目录>
-```
-**Windows:**
-```cmd
-cd skills\ok-cosmic\setup
-setup-windows.bat -libpath=<项目苍穹JAR库目录>
-```
-### 4.1 参数说明
-| 参数 | 说明 | 默认值 | 必填 |
-|------|------|--------|------|
-| `-libpath` | 苍穹 SDK JAR 库目录 | 无 | 推荐 |
-| `-docsdbpath` | 文档数据库路径 | `ok-cosmic-docs.db` | 否 |
-| `-dbpath` | 输出知识库文件路径 | `ok-cosmic-knowledge.db` | 否 |
-| `-jarthreads` | JAR 解析并发线程数 | CPU 核心数 | 否 |
-| `-verifyjar` | 校验用 JAR 文件路径 | - | 否 |
-| `-verifyclass` | 校验用完整类名 | - | 否 |
-### 4.2 典型使用示例
-```bash
-# 使用默认参数
-./setup-mac.sh
-# 指定自定义路径
-./setup-mac.sh -libpath=/path/to/cosmic/libs
-# 使用多线程加速构建
-./setup-mac.sh -libpath=./libs -jarthreads=8
-```
----
-## 5. 知识验证
-### 5.1 检查初始构建产物
-```bash
-# 检查 setup 目录中的初始知识库是否存在
-ls -la skills/ok-cosmic/setup/ok-cosmic-knowledge.db
-# 检查数据库大小（应大于 0）
-du -h skills/ok-cosmic/setup/ok-cosmic-knowledge.db
-```
-### 5.2 检查项目最终知识库（推荐做法）
-如果您在后续步骤中采用“项目根目录维护知识库”的方式，请改为检查项目根目录中的 `ok-cosmic-knowledge.db`：
-```bash
-ls -la ./ok-cosmic-knowledge.db
-du -h ./ok-cosmic-knowledge.db
-```
-### 5.3 验证知识库
-构建完成后，在项目根目录验证知识库是否正常（假设已按步骤 6 将知识库和配置文件放到项目根目录）：
-```bash
-# 测试 API 知识搜索
-python3 skills/ok-cosmic/scripts/cosmic-api-knowledge.py --config ok-cosmic.json search QueryServiceHelper
-# 测试元数据查询（需要配置 route.apiUrl）
-python3 skills/ok-cosmic/scripts/cosmic-form-metadata.py --config ok-cosmic.json get 物料
-# 测试基础资料查询（需要配置 route.apiUrl；entityId 必须是已确认来源的准确英文标识，不确定时先用元数据脚本查 refType 或按中文名称查英文标识）
-python3 skills/ok-cosmic/scripts/cosmic-basedata-query.py --config ok-cosmic.json get --entity-id bd_material --number-or-name 01.0001
-# 测试业务拓展点查询（需要配置 route.apiUrl；生成代码/查看 Java 示例时再加 --full，示例缺失或签名不确定时再用 cosmic-api-knowledge.py detail）
-python3 skills/ok-cosmic/scripts/cosmic-extpoints-query.py --config ok-cosmic.json get --keyword 应付
-```
----
-## 6. 项目配置
-在您的苍穹开发项目根目录创建 `ok-cosmic.json` 配置文件：
-> 建议（适配本地多项目开发）：
-> 将 `ok-cosmic-knowledge.db` 复制或移动到**当前项目根目录**，再让 `ok-cosmic.json` 的 `graph.dbPath` 直接指向该数据库文件。
-> 这样每个项目都可以维护自己的知识库副本，避免多个本地项目共享同一份数据库时相互干扰。
-```json
-{
-  "graph": {
-    "dbPath": "/path/to/your-current-project/ok-cosmic-knowledge.db"
-  },
-  "route": {
-    "apiUrl": "https://deverp.xxxx.com/ierp/kapi/v2/xxxx/xxxx_devportal_ext/runtime/route?openApiSign=YOUR_SIGN_HERE",
-    "timeoutSeconds": 30
-  },
-  "extensionRepos": [
-    "/path/to/your-extension-project-1",
-    "/path/to/your-extension-project-2"
-  ]
-}
-```
-例如，将知识库复制到项目根目录后，参照上方模板创建 `ok-cosmic.json`：
-```bash
-cp /Users/yourname/kingdee/code/cosmic-skill/ok-cosmic-knowledge/ok-cosmic-knowledge.db /path/to/your-current-project/
-```
-### 配置说明
-| 配置项 | 说明 | 默认值 | 是否必填 |
-|--------|------|--------|----------|
-| `graph.dbPath` | 知识库数据库全路径 | 无 | 是 |
-| `route.apiUrl` | 统一路由 API 服务地址（`runtime/route`） | 空（离线模式） | 在线查询时必填 |
-| `route.timeoutSeconds` | 统一路由 API 超时时间 | 10 | 否 |
-| `extensionRepos` | 扩展代码库路径数组（fallback 参考源） | `[]` | 否 |
-### 6.1 扩展代码库回落机制（`extensionRepos`）
-当内置的决策矩阵、`rules/cheat-sheet.md` 和 `assets/snippets/` 均无法覆盖当前需求时，Skill 会按需到 `extensionRepos` 配置的路径下搜索您自己的拓展实现作为参考。
-- **使用场景**（需同时成立）：
-  - Skill 内置的决策矩阵、`rules/cheat-sheet.md` 和 `assets/snippets/` 均无法覆盖当前需求；
-  - 且 **当前项目中没有具体实现可以满足需求**（在用户项目搜相似插件/业务无果，或现有实现与需求不匹配）。
-  此时可以回落到 `extensionRepos` 配置的拓展仓库寻找实现参考。
-- **配置方式**：在 `ok-cosmic.json` 中新增顶层字段 `extensionRepos`，值为**字符串数组**，每项为拓展仓库的绝对路径（支持 `~` 展开）：
-  ```json
-  {
-    "extensionRepos": [
-      "/Users/yourname/kingdee/code/your-extension-project-1",
-      "~/kingdee/code/your-extension-project-2"
-    ]
-  }
-  ```
-- **数量**：支持 1 个或多个；不配置或给空数组时回落机制不触发，不影响其他功能。
-- **生效时机**：仅在内置资产全部 miss **且** 当前项目也无可用实现时才触发。只做 **实现参考**，**不等同于 ok-cosmic 推荐写法**；若与 ok-cosmic A/B 层规范冲突，以 ok-cosmic 规范为准。
-- **预检输出**：Step 0 `cosmic-config-check.py` 会逐个校验路径：
-  - 路径合法且目录存在 → `[OK] extensionRepos[i]: 扩展代码库: /xxx`
-  - 路径不存在或非目录 → `[WARNING]`（不阻断，仅提示）
-  - 类型非数组或元素为空字符串 → `[ERROR]`（需修正后再继续）
-更详细的触发条件和结果使用原则见 `SKILL.md` 的“扩展代码库探索（Extension Repos Fallback）”章节。
-创建完成后，建议先执行一次 Step 0 预检：
-```bash
-python3 skills/ok-cosmic/scripts/cosmic-config-check.py --config ok-cosmic.json
-```
-该命令会检查：
-- 配置文件是否存在
-- JSON 是否合法
-- `graph.dbPath` 等关键字段是否缺失
-- `route.apiUrl` 未配置时给出在线查询能力受限提示
-- `extensionRepos` 路径是否存在且是目录
-## 7. 安装 Skill
-如果您当前的目标只是让多个 Agent 共用同一份本地 Skill，可以直接从本步骤开始。
-建议在本机只维护一份 `ok-cosmic` skill 源目录，然后让不同 Agent 的 skill 安装目录通过软链接（或目录联接）指向它。这样后续你只需要更新一处，多个 Agent 都能同步生效。
-### 7.1 推荐目录结构
-```text
-/Users/yourname/skills/ok-cosmic            # 唯一维护的 skill 源目录
-~/.claude/skills/ok-cosmic                 # 指向上面的软链接
-~/.opencode/skills/ok-cosmic               # 指向上面的软链接
-~/.codex/skills/ok-cosmic                  # 指向上面的软链接
-~/.gemini/antigravity/skills/ok-cosmic     # 指向上面的软链接
-```
-### 7.2 macOS / Linux
-1. 准备统一维护目录
-```bash
-mkdir -p ~/skills
-cp -R /path/to/ok-cosmic ~/skills/ok-cosmic
-```
-2. 为不同 Agent 创建软链接
-```bash
-mkdir -p ~/.claude/skills ~/.opencode/skills ~/.codex/skills ~/.gemini/antigravity/skills
-ln -sfn ~/skills/ok-cosmic ~/.claude/skills/ok-cosmic
-ln -sfn ~/skills/ok-cosmic ~/.opencode/skills/ok-cosmic
-ln -sfn ~/skills/ok-cosmic ~/.codex/skills/ok-cosmic
-ln -sfn ~/skills/ok-cosmic ~/.gemini/antigravity/skills/ok-cosmic
-```
-### 7.3 Windows
-1. 准备统一维护目录
-```powershell
-mkdir $env:USERPROFILE\skills -ErrorAction SilentlyContinue
-Copy-Item -Path D:\path\to\ok-cosmic -Destination $env:USERPROFILE\skills\ok-cosmic -Recurse
-```
-2. 为不同 Agent 创建目录联接（推荐管理员 PowerShell）
-```powershell
-mkdir $env:USERPROFILE\.claude\skills -ErrorAction SilentlyContinue
-mkdir $env:USERPROFILE\.opencode\skills -ErrorAction SilentlyContinue
-mkdir $env:USERPROFILE\.codex\skills -ErrorAction SilentlyContinue
-cmd /c mklink /J "$env:USERPROFILE\.claude\skills\ok-cosmic" "$env:USERPROFILE\skills\ok-cosmic"
-cmd /c mklink /J "$env:USERPROFILE\.opencode\skills\ok-cosmic" "$env:USERPROFILE\skills\ok-cosmic"
-cmd /c mklink /J "$env:USERPROFILE\.codex\skills\ok-cosmic" "$env:USERPROFILE\skills\ok-cosmic"
-```
-### 7.4 维护建议
-- 平时只修改统一维护目录中的 skill 源文件
-- 如果某个 Agent 已经存在旧目录，先删除旧目录，再创建软链接
-- 更新后若 Agent 有缓存，重启对应 Agent 进程或刷新技能列表
----
-## 8. 加载 Skill 开始编程
-在您的苍穹开发项目中，通过 Agent 加载 ok-cosmic Skill，即可开始 AI 辅助编程。
-### 8.1 加载 Skill
-在项目根目录下，告诉 Agent 加载技能：
-```
-加载 ok-cosmic 技能
-```
-或者直接提出开发需求，Agent 会自动识别并加载相关技能：
-```
-帮我开发一个销售订单的表单插件，实现字段联动校验
-```
-### 8.2 开始编程之旅
-Skill 加载后，您可以：
-| 场景 | 示例指令                        |
-|------|-----------------------------|
-| 表单插件开发 | "帮我写一个表单插件，实现字段联动"          |
-| 操作插件开发 | "开发一个审核操作插件，保存前校验数据"        |
-| BOTP 转换开发 | "实现销售订单到出库单的下推转换"           |
-| API 查询 | "查询 QueryServiceHelper 的用法" |
-| 元数据查询 | "获取物料表单的字段列表（ai生成时会一般自动触发）" |
-| 基础资料查询 | "查询 bd_material 中编码 01.0001 对应的基础资料" |
----
-## 🛠️ 常见问题排查
-### Q1: Java 版本不兼容
-**错误信息:** `Unsupported major.minor version`
-**解决方案:** 升级 Java 到 JDK 8 或更高版本
-### Q2: 知识库搜索无结果
-**可能原因:**
-1. 数据库路径配置错误
-2. 知识库构建失败或数据为空
-3. 搜索关键词过于精确
-**排查步骤:**
-```bash
-# 检查配置文件路径
-cat ok-cosmic.json
-# 检查数据库文件大小
-ls -la skills/ok-cosmic/setup/ok-cosmic-knowledge.db
-# 尝试更宽泛的搜索
-python3 skills/ok-cosmic/scripts/cosmic-api-knowledge.py --config ok-cosmic.json search Helper --kind helper
-```
-### Q3: 元数据查询超时
-**解决方案:**
-1. 增加 `route.timeoutSeconds` 配置值
-2. 检查网络连接是否正常
-3. 确认 `route.apiUrl` 配置为 OpenAPI 中的 `runtime/route` 地址
-### Q4: 基础资料查询失败或超时
-**解决方案:**
-1. 确认 `route.apiUrl` 已配置为 OpenAPI 中的 `runtime/route` 地址
-2. 检查统一路由接口是否支持 `data.type=basedata`
-3. 增加 `route.timeoutSeconds` 配置值
-4. 若 `entityId` 不确定，先用元数据脚本查真实标识：可以查字段 `refType`，也可以按基础资料中文名称查英文标识；禁止按中文名称或经验猜测基础资料标识

package/vendor/kingdee-skills/ok-cosmic/requirements.txt DELETED Viewed

	@@ -1,2 +0,0 @@
1	- tree-sitter>=0.23.0
2	- tree-sitter-java>=0.23.0

package/vendor/kingdee-skills/ok-cosmic/scripts/config_loader.py DELETED Viewed

@@ -1,204 +0,0 @@
-#!/usr/bin/env python3
-# SPDX-License-Identifier: NOASSERTION
-"""
-config_loader.py — Shared configuration loader for ok-cosmic scripts.
-Provides shared helpers to:
-1. Locate and parse ``ok-cosmic.json``
-2. Validate Step 0 required content
-3. Inject resolved config path metadata for downstream scripts
-"""
-import json
-import os
-import sys
-from pathlib import Path
-from typing import Any, Dict, List, Optional, Tuple
-# Windows console encoding fix (shared by all scripts)
-if os.name == "nt":
-    try:
-        sys.stdout.reconfigure(encoding="utf-8")
-        sys.stderr.reconfigure(encoding="utf-8")
-    except Exception:
-        pass
-Issue = Dict[str, str]
-def resolve_project_config_path(config_path: Optional[str] = None) -> Path:
-    """Resolve ``ok-cosmic.json`` path from CLI input or current working directory."""
-    return Path(config_path).expanduser() if config_path else Path.cwd() / "ok-cosmic.json"
-def read_project_config(config_path: Optional[str] = None) -> Tuple[Path, Dict[str, Any]]:
-    """
-    Read and parse ``ok-cosmic.json`` without mutating the payload.
-    Returns:
-    - resolved absolute config path
-    - raw JSON object as dict
-    """
-    target_path = resolve_project_config_path(config_path)
-    if not target_path.is_file():
-        raise FileNotFoundError(
-            f"找不到配置文件: {target_path}。请确保文件存在或通过 --config 参数指定正确路径。"
-        )
-    try:
-        with target_path.open("r", encoding="utf-8") as f:
-            data = json.load(f)
-    except FileNotFoundError:
-        raise
-    except json.JSONDecodeError as e:
-        raise RuntimeError(
-            f"加载配置文件 {target_path} 失败: JSON 解析错误，第 {e.lineno} 行第 {e.colno} 列: {e.msg}"
-        ) from e
-    except Exception as e:
-        raise RuntimeError(f"加载配置文件 {target_path} 失败: {e}") from e
-    if not isinstance(data, dict):
-        raise ValueError(f"配置文件格式错误: {target_path} 必须包含有效的 JSON 对象")
-    return target_path.resolve(), data
-def _add_issue(issues: List[Issue], level: str, key: str, message: str) -> None:
-    issues.append({"level": level, "key": key, "message": message})
-def _is_positive_number(value: Any) -> bool:
-    try:
-        return float(value) > 0
-    except (TypeError, ValueError):
-        return False
-def _resolve_child_path(base_dir: Path, raw_path: str) -> Path:
-    expanded = Path(os.path.expanduser(raw_path))
-    if expanded.is_absolute():
-        return expanded.resolve()
-    return (base_dir / expanded).resolve()
-def validate_project_config(config: Dict[str, Any], config_path: Optional[str] = None) -> List[Issue]:
-    """
-    Validate ``ok-cosmic.json`` content for Step 0 preflight.
-    Validation levels:
-    - ERROR: should stop before running skill scripts
-    - WARNING: non-blocking but means some capabilities are unavailable
-    """
-    issues: List[Issue] = []
-    raw_config_path = config_path or str(config.get("__config_path__", "")).strip()
-    base_dir = (
-        Path(raw_config_path).expanduser().resolve().parent
-        if raw_config_path
-        else Path.cwd()
-    )
-    graph_config = config.get("graph")
-    if graph_config is None:
-        _add_issue(issues, "ERROR", "graph", "缺少 `graph` 配置对象。")
-    elif not isinstance(graph_config, dict):
-        _add_issue(issues, "ERROR", "graph", "`graph` 必须是 JSON 对象。")
-    else:
-        db_path = str(graph_config.get("dbPath", "")).strip()
-        if not db_path:
-            _add_issue(issues, "ERROR", "graph.dbPath", "缺少必填项 `graph.dbPath`。")
-        else:
-            resolved_db_path = _resolve_child_path(base_dir, db_path)
-            if not resolved_db_path.exists():
-                _add_issue(
-                    issues,
-                    "WARNING",
-                    "graph.dbPath",
-                    f"`graph.dbPath` 指向的文件不存在: {resolved_db_path}",
-                )
-    route_env_available = bool(os.getenv("COSMIC_ROUTE_API") or os.getenv("COSMIC_RUNTIME_ROUTE_API"))
-    route_config = config.get("route")
-    route_api_url = ""
-    if route_config is not None:
-        if not isinstance(route_config, dict):
-            _add_issue(issues, "ERROR", "route", "`route` 必须是 JSON 对象。")
-        else:
-            route_api_url = str(route_config.get("apiUrl", "")).strip()
-            if not route_api_url and not route_env_available:
-                _add_issue(
-                    issues,
-                    "WARNING",
-                    "route.apiUrl",
-                    "`route.apiUrl` 为空，统一路由在线查询将不可用。",
-                )
-            if "timeoutSeconds" in route_config and not _is_positive_number(route_config.get("timeoutSeconds")):
-                _add_issue(
-                    issues,
-                    "ERROR",
-                    "route.timeoutSeconds",
-                    "`route.timeoutSeconds` 必须是大于 0 的数字。",
-                )
-            if "openApiSign" in route_config and not isinstance(route_config.get("openApiSign"), str):
-                _add_issue(
-                    issues,
-                    "ERROR",
-                    "route.openApiSign",
-                    "`route.openApiSign` 必须是字符串。",
-                )
-    if route_config is None and not route_env_available:
-        _add_issue(
-            issues,
-            "WARNING",
-            "route",
-            "缺少 `route` 配置节，三个在线查询脚本将无法通过统一路由查询。",
-        )
-    extension_repos = config.get("extensionRepos")
-    if extension_repos is not None:
-        if not isinstance(extension_repos, list):
-            _add_issue(issues, "ERROR", "extensionRepos", "`extensionRepos` 必须是字符串数组。")
-        else:
-            for idx, raw_path in enumerate(extension_repos):
-                key = f"extensionRepos[{idx}]"
-                if not isinstance(raw_path, str) or not raw_path.strip():
-                    _add_issue(
-                        issues,
-                        "ERROR",
-                        key,
-                        f"`{key}` 必须是非空字符串路径。",
-                    )
-                    continue
-                resolved_repo = _resolve_child_path(base_dir, raw_path.strip())
-                if not resolved_repo.is_dir():
-                    _add_issue(
-                        issues,
-                        "WARNING",
-                        key,
-                        f"扩展代码库路径不存在或不是目录: {resolved_repo}",
-                    )
-                else:
-                    _add_issue(
-                        issues,
-                        "OK",
-                        key,
-                        f"扩展代码库: {resolved_repo}",
-                    )
-    return issues
-def load_project_config(config_path: Optional[str] = None) -> Dict[str, Any]:
-    """
-    Load project-level config from provided path or current working directory.
-    Returns a dict with two injected keys for downstream consumers:
-    - ``__config_path__``: absolute path to the resolved config file
-    - ``__config_dir__``: absolute path to the parent directory of the config file
-    """
-    resolved, data = read_project_config(config_path)
-    data.setdefault("__config_path__", str(resolved))
-    data.setdefault("__config_dir__", str(resolved.parent))
-    return data