apiskill 0.1.2 → 0.1.4

package/MCP.md

@@ -2,11 +2,11 @@
 
 The detailed MCP documentation has moved to standalone docs:
 
-- [English MCP documentation](docs/mcp.md)
-- [中文 MCP 文档](docs/mcp.zh.md)
+- [English MCP documentation](https://unpkg.com/apiskill@latest/docs/mcp.md)
+- [中文 MCP 文档](https://unpkg.com/apiskill@latest/docs/mcp.zh.md)
 
 Project overview:
 
-- [README](README.md)
-- [Web app docs](docs/web.md) / [Web 中文文档](docs/web.zh.md)
-- [CLI docs](docs/cli.md) / [CLI 中文文档](docs/cli.zh.md)
+- [README](https://unpkg.com/apiskill@latest/README.md)
+- [Web app docs](https://unpkg.com/apiskill@latest/docs/web.md) / [Web 中文文档](https://unpkg.com/apiskill@latest/docs/web.zh.md)
+- [CLI docs](https://unpkg.com/apiskill@latest/docs/cli.md) / [CLI 中文文档](https://unpkg.com/apiskill@latest/docs/cli.zh.md)

package/README.ja.md

@@ -1,12 +1,12 @@
 # API Skill
 
-[English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
+[English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
 
-API Skill は、フロントエンド開発と AI 支援開発のためのローカル OpenAPI/Swagger ワークスペースです。3 つの入口が同じキャッシュ済み API ドキュメントを共有します。
+API Skill は、フロントエンド開発と AI 支援開発のためのローカル OpenAPI/Swagger ワークスペースです。人向けの Web ワークスペースと AI Agent 向けの CLI/MCP インターフェースが、同じキャッシュ済み API ドキュメントを共有します。
 
-- Web アプリ: API ドキュメントのインポート、閲覧、検索、確認、テスト、手動 API 操作の管理。
-- CLI: ターミナルからドキュメントをインポートし、ローカル API バージョンを管理または照会。
-- MCP サーバー: 同じ API コンテキストと保守操作を Codex や他の MCP クライアントへ公開。
+- Web アプリ: 人が API ドキュメントをインポート、閲覧、検索、確認、テストし、バージョンと API 操作を管理するための画面。
+- CLI: AI Agent や自動化処理がドキュメント状態を確認し、必要な API コンテキストを取得・保守するためのコマンド。
+- MCP サーバー: 同じ API の照会・保守機能を Codex や他の AI Agent クライアントへ公開。
 
 ## Web アプリの使い方
 
@@ -92,9 +92,9 @@ Agent ワークフローでは MCP が最も効果的です。コーディング
 
 ## ドキュメント
 
-- Web アプリ: [English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
-- CLI 設定と使い方: [English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
-- MCP 設定と使い方: [English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
+- Web アプリ: [English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
+- CLI 設定と使い方: [English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
+- MCP 設定と使い方: [English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
 
 ## データモデル
 

package/README.ko.md

@@ -1,12 +1,12 @@
 # API Skill
 
-[English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
+[English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
 
-API Skill은 프론트엔드 개발과 AI 보조 코딩을 위한 로컬 OpenAPI/Swagger 작업 공간입니다. 세 가지 진입점이 같은 캐시된 API 문서를 공유합니다.
+API Skill은 프론트엔드 개발과 AI 보조 코딩을 위한 로컬 OpenAPI/Swagger 작업 공간입니다. 사람을 위한 Web 작업 공간과 AI Agent를 위한 CLI/MCP 인터페이스가 같은 캐시된 API 문서를 공유합니다.
 
-- Web 앱: API 문서를 가져오고, 탐색하고, 검색하고, 검사하고, 테스트하며, 수동 API 작업을 관리합니다.
-- CLI: 터미널에서 문서를 가져오고 로컬 API 버전을 관리하거나 조회합니다.
-- MCP 서버: 같은 API 컨텍스트와 유지 관리 기능을 Codex 또는 다른 MCP 클라이언트에 제공합니다.
+- Web 앱: 사람이 API 문서를 가져오고, 탐색하고, 검색하고, 검사하고, 테스트하며 버전과 API 작업을 관리합니다.
+- CLI: AI Agent와 자동화 작업이 문서 상태를 확인하고 필요한 API 컨텍스트를 조회하거나 유지 관리합니다.
+- MCP 서버: 같은 API 조회 및 유지 관리 기능을 Codex 또는 다른 AI Agent 클라이언트에 제공합니다.
 
 ## Web 앱 사용
 
@@ -92,9 +92,9 @@ Agent 워크플로는 MCP에서 가장 큰 이점을 얻습니다. 코딩 agent
 
 ## 문서
 
-- Web 앱: [English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
-- CLI 구성 및 사용법: [English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
-- MCP 구성 및 사용법: [English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
+- Web 앱: [English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
+- CLI 구성 및 사용법: [English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
+- MCP 구성 및 사용법: [English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
 
 ## 데이터 모델
 

package/README.md

@@ -1,12 +1,12 @@
 # API Skill
 
-[English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
+[English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
 
-API Skill is a local OpenAPI/Swagger workspace for frontend and agent-assisted development. It has three surfaces that share the same cached API documents:
+API Skill is a local OpenAPI/Swagger workspace for frontend and agent-assisted development. It has one human-facing workspace and two agent-facing interfaces that share the same cached API documents:
 
-- Web app: import, browse, search, inspect, test, and manually maintain API operations.
-- CLI: import documents, manage/query local API versions, and start a MOCK server from a terminal.
-- MCP server: expose the same API context and maintenance actions to Codex or other MCP clients.
+- Web app, for people: import, browse, search, inspect, test, version, and manually maintain API operations.
+- CLI, for AI agents and automation: check document availability, retrieve focused API context, maintain documents, and start local services with predictable commands.
+- MCP server, for AI agents: expose the same query and maintenance actions directly to Codex or other MCP clients.
 
 ## Web App Usage
 
@@ -30,15 +30,116 @@ After importing or creating a blank document, use the version selector to switch
 
 After API document data exists, click Start MOCK Service in the web app or run `apiskill mock` in CLI to start a local random-data MOCK API server from the current interface definitions.
 
-For CLI and MCP usage, run the built-in checks first:
+### AI Agent Quick Start
 
 ```bash
-npm run cli -- check
+# 1. Check whether API documentation is ready
+apiskill check
+
+# 2. Initialize the cache when no document exists
+apiskill import https://example.com/openapi.json
+apiskill crawl https://example.com/swagger
+apiskill import-file ./openapi.yaml
+apiskill document create --title "My API" --doc-version 1.0.0
+
+# 3. Retrieve only the API context needed for the current coding task
+apiskill versions
+apiskill query /api/v1/users --method GET
+
+# 4. Start a local random-data API from the active document
+apiskill mock
+```
+
+CLI and MCP are primarily designed for AI coding agents. Agents should check the cache first, initialize it only when needed, and query a focused endpoint instead of reading the entire OpenAPI document. Run `apiskill --help` for all CLI commands. In MCP clients, start with `apiskill_check`, use `apiskill_search_endpoints` or `apiskill_query_api` to locate an API, and call `apiskill_help` for the complete tool list.
+
+### AI Agent CLI CRUD Protocol
+
+Use `--json` on commands that support it and parse the response instead of scraping human-readable output. For an isolated project cache, set `APISKILL_CACHE_DIR` to an absolute writable directory before every CLI call. Without it, the global installation uses `~/.apiskill/cache`.
+
+1. Check the cache, then create a blank document when no upstream document exists:
+
+```bash
+apiskill check --json
+apiskill document create --title "My API" --doc-version 1.0.0 --description "Local API contract" --json
+```
+
+Read `meta.versionId` from the create response and reuse that exact value for every write. `api create` now defaults to the latest version when `--version` is omitted, but agents should still pass it explicitly so every write targets the intended project document.
+
+2. Save an API configuration as `api-config.json`:
+
+```json
+{
+  "api": {
+    "method": "post",
+    "path": "/api/v1/users/{id}",
+    "summary": "Create user",
+    "operationId": "createUser",
+    "tags": ["Users"],
+    "parameters": [
+      { "name": "id", "location": "path", "required": true, "type": "string" }
+    ],
+    "requestBody": {
+      "required": true,
+      "contentType": "application/json",
+      "fields": [
+        { "name": "name", "type": "string", "required": true },
+        { "name": "email", "type": "string", "format": "email" }
+      ]
+    },
+    "responses": [
+      {
+        "status": "200",
+        "description": "User created",
+        "contentType": "application/json",
+        "fields": [
+          { "name": "success", "type": "boolean", "required": true },
+          { "name": "userId", "type": "string" }
+        ]
+      }
+    ]
+  }
+}
 ```
 
-After npm installation, the equivalent command is `apiskill check`.
+3. Create, inspect, edit, and delete the operation:
+
+```bash
+APISKILL_VERSION_ID="value-from-meta.versionId"
+
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./api-config.json --json
+apiskill api list --version "$APISKILL_VERSION_ID" --query user --method POST --json
+apiskill api query POST '/api/v1/users/{id}' --version "$APISKILL_VERSION_ID" --format cli
+
+# Edit the returned CLI config and save it as api-config.updated.json.
+# POST and the path below identify the original operation; the file contains its replacement.
+apiskill api edit POST '/api/v1/users/{id}' --version "$APISKILL_VERSION_ID" --file ./api-config.updated.json --json
+
+# Use the replacement method/path if the edit changed either value.
+apiskill api delete PATCH '/api/v1/users/{id}' --version "$APISKILL_VERSION_ID" --json
+```
+
+For a batch of operations, pass the same `APISKILL_VERSION_ID` to every command. For compatibility with older CLI releases, an agent should wait for each write to finish before starting the next one, then verify the final set:
+
+```bash
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./users.get.json --json
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./users.create.json --json
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./users.delete.json --json
+apiskill api list --version "$APISKILL_VERSION_ID" --json
+```
+
+The current CLI also serializes writes to the same cache across processes, so an AI tool that accidentally launches these commands in parallel will not lose earlier operations.
+
+Agent rules:
 
-To start from zero in CLI, run `npm run cli -- document create --title "My API" --doc-version 1.0.0`, then add endpoints with `api create`. In MCP clients, call `apiskill_check` to verify the cache, `apiskill_create_document` to create a blank document when no upstream docs exist, and `apiskill_help` to list available tools.
+- `api query` defaults to JSON and does not accept `--json`; use `--format cli` for a normalized configuration that can be edited and written back.
+- `api edit ORIGINAL_METHOD ORIGINAL_PATH` locates the old operation. The replacement config may change its method or path.
+- Quote paths containing `{id}` or other shell-sensitive characters.
+- `api list --query` searches operation metadata and parameters, not response field names. Use exact `api query METHOD PATH` when method and path are known.
+- A blank document with zero paths makes `check --json` return `ok: false` until at least one API is added. The document still exists; inspect `versionsCount` and `latestVersion`.
+- Missing operations and invalid commands return a nonzero process exit code. Agents should treat that as failure and inspect stderr.
+- `--config '<json-or-yaml>'` is equivalent to `--file`; files are safer for large or nested configurations.
+- After a batch write, run `api list --version ... --json` and verify that every expected method/path exists before reporting success.
+- OpenAPI identifies an operation by its method/path pair. Creating the same pair again intentionally replaces it; `meta.paths` counts distinct paths, not the total number of operations.
 
 ## Why This Tool Exists
 
@@ -103,9 +204,9 @@ Agent workflows benefit most from MCP. A coding agent can call `apiskill_search_
 
 ## Documentation
 
-- Web app: [English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
-- CLI configuration and usage: [English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
-- MCP configuration and usage: [English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
+- Web app: [English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
+- CLI configuration and usage: [English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
+- MCP configuration and usage: [English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
 
 ## Data Model
 

package/README.zh.md

@@ -1,12 +1,12 @@
 # API Skill
 
-[English](README.md) / [中文](README.zh.md) / [한국어](README.ko.md) / [日本語](README.ja.md)
+[English](https://unpkg.com/apiskill@latest/README.md) / [中文](https://unpkg.com/apiskill@latest/README.zh.md) / [한국어](https://unpkg.com/apiskill@latest/README.ko.md) / [日本語](https://unpkg.com/apiskill@latest/README.ja.md)
 
-API Skill 是一个本地 OpenAPI/Swagger 工作区，面向前端开发和 AI 辅助编码。它提供三种入口，并共享同一份本地缓存接口文档：
+API Skill 是一个本地 OpenAPI/Swagger 工作区，面向前端开发和 AI 辅助编码。它提供一个面向人的工作台和两个面向 AI Agent 的接口，并共享同一份本地缓存接口文档：
 
-- Web 端：导入、浏览、搜索、查看、测试和手动维护接口。
-- CLI：在终端里导入文档、管理版本、查询和维护本地接口，并启动 MOCK 服务。
-- MCP 服务：把同一套接口上下文和维护能力暴露给 Codex 或其他 MCP 客户端。
+- Web 端，主要给人使用：导入、浏览、搜索、查看、测试、版本管理和手动维护接口。
+- CLI，主要给 AI Agent 和自动化任务使用：检查文档状态、按需获取接口上下文、维护文档并启动本地服务。
+- MCP 服务，主要给 AI Agent 使用：把同一套查询和维护能力直接暴露给 Codex 或其他 MCP 客户端。
 
 ## Web 端使用
 
@@ -30,15 +30,116 @@ npm run dev
 
 已有 API 文档数据后，可以在 Web 端点击“启动MOCK服务”，或在 CLI 里运行 `apiskill mock`，根据当前接口定义启动本地随机数据 MOCK API 服务。
 
-CLI 和 MCP 使用前建议先运行内置检查：
+### AI Agent 快速使用
 
 ```bash
-npm run cli -- check
+# 1. 检查 API 文档是否可用
+apiskill check
+
+# 2. 没有文档时初始化缓存
+apiskill import https://example.com/openapi.json
+apiskill crawl https://example.com/swagger
+apiskill import-file ./openapi.yaml
+apiskill document create --title "My API" --doc-version 1.0.0
+
+# 3. 只获取当前开发任务需要的接口上下文
+apiskill versions
+apiskill query /api/v1/users --method GET
+
+# 4. 根据当前文档启动本地随机数据接口
+apiskill mock
+```
+
+CLI 和 MCP 主要面向 AI 编码 Agent。Agent 应先检查缓存，只在缺少文档时初始化，然后按当前任务精确查询接口，避免每次读取整份 OpenAPI 文档。运行 `apiskill --help` 可以查看全部 CLI 命令；在 MCP 客户端中先调用 `apiskill_check`，再使用 `apiskill_search_endpoints` 或 `apiskill_query_api` 定位接口，调用 `apiskill_help` 可查看完整工具列表。
+
+### AI Agent CLI 增删改查协议
+
+支持 `--json` 的命令应优先使用 JSON 输出并解析字段，不要抓取人类可读文本。需要按项目隔离缓存时，每次调用前将 `APISKILL_CACHE_DIR` 设置为绝对可写目录；未设置时，全局安装默认使用 `~/.apiskill/cache`。
+
+1. 检查缓存；没有上游文档时创建空白文档：
+
+```bash
+apiskill check --json
+apiskill document create --title "My API" --doc-version 1.0.0 --description "Local API contract" --json
+```
+
+从创建结果读取 `meta.versionId`，后续所有写操作都复用这个精确值。现在 `api create` 省略 `--version` 时会默认写入最新版本，但 Agent 仍应显式传入，确保每次都写入目标项目文档。
+
+2. 将接口配置保存为 `api-config.json`：
+
+```json
+{
+  "api": {
+    "method": "post",
+    "path": "/api/v1/users/{id}",
+    "summary": "创建用户",
+    "operationId": "createUser",
+    "tags": ["Users"],
+    "parameters": [
+      { "name": "id", "location": "path", "required": true, "type": "string" }
+    ],
+    "requestBody": {
+      "required": true,
+      "contentType": "application/json",
+      "fields": [
+        { "name": "name", "type": "string", "required": true },
+        { "name": "email", "type": "string", "format": "email" }
+      ]
+    },
+    "responses": [
+      {
+        "status": "200",
+        "description": "用户创建成功",
+        "contentType": "application/json",
+        "fields": [
+          { "name": "success", "type": "boolean", "required": true },
+          { "name": "userId", "type": "string" }
+        ]
+      }
+    ]
+  }
+}
 ```
 
-npm 安装后的等价命令是 `apiskill check`。
+3. 新增、读取、修改并删除接口：
+
+```bash
+APISKILL_VERSION_ID="value-from-meta.versionId"
+
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./api-config.json --json
+apiskill api list --version "$APISKILL_VERSION_ID" --query user --method POST --json
+apiskill api query POST '/api/v1/users/{id}' --version "$APISKILL_VERSION_ID" --format cli
+
+# 修改返回的 CLI 配置并保存为 api-config.updated.json。
+# 下面的 POST 和路径用于定位旧接口，文件中保存替换后的新配置。
+apiskill api edit POST '/api/v1/users/{id}' --version "$APISKILL_VERSION_ID" --file ./api-config.updated.json --json
+
+# 如果修改时改变了 method 或 path，删除时使用替换后的值。
+apiskill api delete PATCH '/api/v1/users/{id}' --version "$APISKILL_VERSION_ID" --json
+```
+
+批量写入多个接口时，每条命令都必须使用同一个 `APISKILL_VERSION_ID`。为了兼容旧版 CLI，Agent 应等待上一条写命令完成后再执行下一条，最后检查完整接口列表：
+
+```bash
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./users.get.json --json
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./users.create.json --json
+apiskill api create --version "$APISKILL_VERSION_ID" --file ./users.delete.json --json
+apiskill api list --version "$APISKILL_VERSION_ID" --json
+```
+
+当前版本还会在多个进程之间串行化同一缓存目录的写操作，因此 AI 工具即使意外并行执行这些命令，也不会再丢失先写入的接口。
+
+Agent 执行规则：
 
-如果要通过 CLI 从零开始，运行 `npm run cli -- document create --title "My API" --doc-version 1.0.0` 创建空白文档，再用 `api create` 追加接口。在 MCP 客户端里，先调用 `apiskill_check` 检查缓存；没有上游文档时调用 `apiskill_create_document` 创建空白文档；再调用 `apiskill_help` 查看可用工具。
+- `api query` 默认输出 JSON，不支持 `--json`；需要可修改并回写的标准配置时使用 `--format cli`。
+- `api edit ORIGINAL_METHOD ORIGINAL_PATH` 的前两个参数定位旧接口，新配置可以改变 method 或 path。
+- 包含 `{id}` 等 shell 特殊字符的路径必须加引号。
+- `api list --query` 搜索接口元数据和参数，不搜索响应字段名。已知 method 和 path 时使用精确的 `api query METHOD PATH`。
+- 空白文档没有任何 path 时，`check --json` 会返回 `ok: false`，直到至少添加一个 API。文档并未丢失，可检查 `versionsCount` 和 `latestVersion`。
+- 接口不存在或命令参数无效时，进程返回非零退出码。Agent 应视为失败并读取 stderr。
+- `--config '<json-or-yaml>'` 与 `--file` 等效；复杂或嵌套配置优先使用文件，避免 shell 转义错误。
+- 批量写入结束后，执行 `api list --version ... --json`，逐一核对预期的 method/path 均存在，再报告任务成功。
+- OpenAPI 使用 method/path 组合唯一标识接口；再次创建相同组合会按预期替换原接口。`meta.paths` 统计的是不同路径数，不是接口操作总数。
 
 ## 为什么开发这个工具
 
@@ -103,9 +204,9 @@ Agent 工作流最适合接入 MCP。编码 agent 可以先调用 `apiskill_sear
 
 ## 文档
 
-- Web 端：[English](docs/web.md) / [中文](docs/web.zh.md) / [한국어](docs/web.ko.md) / [日本語](docs/web.ja.md)
-- CLI 配置和使用：[English](docs/cli.md) / [中文](docs/cli.zh.md) / [한국어](docs/cli.ko.md) / [日本語](docs/cli.ja.md)
-- MCP 配置和使用：[English](docs/mcp.md) / [中文](docs/mcp.zh.md) / [한국어](docs/mcp.ko.md) / [日本語](docs/mcp.ja.md)
+- Web 端：[English](https://unpkg.com/apiskill@latest/docs/web.md) / [中文](https://unpkg.com/apiskill@latest/docs/web.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/web.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/web.ja.md)
+- CLI 配置和使用：[English](https://unpkg.com/apiskill@latest/docs/cli.md) / [中文](https://unpkg.com/apiskill@latest/docs/cli.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/cli.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/cli.ja.md)
+- MCP 配置和使用：[English](https://unpkg.com/apiskill@latest/docs/mcp.md) / [中文](https://unpkg.com/apiskill@latest/docs/mcp.zh.md) / [한국어](https://unpkg.com/apiskill@latest/docs/mcp.ko.md) / [日本語](https://unpkg.com/apiskill@latest/docs/mcp.ja.md)
 
 ## 数据模型