From 29e34119a25b6d1e76f2b495d04912a6a77a0781 Mon Sep 17 00:00:00 2001
From: Scott Hu <huzhen555@qq.com>
Date: Thu, 9 Jul 2026 14:30:43 +0800
Subject: [PATCH 1/4] docs: modify agent promots

---
 docs/src/components/home/agentPrompt.ts       | 114 ++++++++-------
 .../presets/ai-doc/SKILL.md.handlebars        |   2 +-
 pnpm-lock.yaml                                | 131 +++++++++++-------
 3 files changed, 144 insertions(+), 103 deletions(-)

diff --git a/docs/src/components/home/agentPrompt.ts b/docs/src/components/home/agentPrompt.ts
index eceecdbd..0ee4f921 100644
--- a/docs/src/components/home/agentPrompt.ts
+++ b/docs/src/components/home/agentPrompt.ts
@@ -1,51 +1,63 @@
-const PREDEFINED_CLIENTS = ['alova', 'axios', 'fetch', 'ky'] as const
-
-export const AGENT_PROMPT = `Install the worma-guidelines skill and the worma npm package, then configure worma for this project.
-
-**Step 1: Install**
-\`\`\`bash
-npx skills add alovajs/skills --skill worma-guidelines
-npm i wormajs -D
-\`\`\`
-
-**Step 2: Detect HTTP client**
-Check \`package.json\` for an already installed HTTP client among: ${PREDEFINED_CLIENTS.join(', ')}.
-- If found, use that client's worma template (e.g. axios → \`axios()\`, fetch → \`fetch()\`).
-- If none found, install alova (\`npm i alova\`) and default to the \`alova()\` template.
-
-**Step 3: Ask the user for their API setup**
-Before configuring, ask:
-- What is the OpenAPI data source URL?
-- Which platform or source type are they using?
-  - Swagger / Knife4j / FastAPI → use the \`platform()\` plugin
-  - Apifox → use the \`apifox()\` plugin (needs projectId and apifoxToken)
-  - Direct OpenAPI file URL → use \`input\` directly
-
-**Step 4: Initialize config**
-Run \`npx worma init -T <template>\` with the template detected in Step 2. This auto-detects the project type and generates a config pre-configured for that HTTP client.
-Then modify the generated config to:
-- Add the appropriate data source plugin from Step 3
-- Add \`aiDoc()\` to generate AI Skill docs
-
-Example: \`npx worma init -T axios\` for an axios project, then add \`platform('swagger')\` and \`aiDoc()\`.
-
-Result for a TypeScript project using axios + Swagger:
-\`\`\`ts
-import { defineConfig } from 'wormajs';
-import { axios, aiDoc, platform } from 'wormajs/plugin';
-
-export default defineConfig({
-  generator: [{
-    input: '<user-provided-url>',
-    output: 'src/api',
-    plugins: [platform('swagger'), axios(), aiDoc()],
-  }],
-});
-\`\`\`
-
-**Step 5: Run generation**
-\`npx worma gen\`
-
-This will produce API calling code, TypeScript types, and AI Skill docs for the project.`
-
-export const COPY_TOAST_MESSAGE = '已复制提示词，请直接发送给agent'
+const PREDEFINED_CLIENTS = ['alova', 'axios', 'fetch', 'ky'] as const
+
+export const AGENT_PROMPT = `Install the worma-guidelines skill and the worma npm package, then configure worma for this project.
+
+**Step 1: Install**
+Detect network: if npmjs registry is slow/unreachable, auto-use a mirror (e.g. \`https://registry.npmmirror.com\`) and tell the user; otherwise use the default registry.
+\`\`\`bash
+npx skills add alovajs/skills --yes --skill worma-guidelines
+npm i wormajs -D
+\`\`\`
+
+**Step 2: Detect HTTP client**
+Check \`package.json\` for an already installed HTTP client among: ${PREDEFINED_CLIENTS.join(', ')}.
+- If found, use that client's worma template (e.g. axios → \`axios()\`, fetch → \`fetch()\`).
+- If none found, recommand alova, install it(\`npm i alova\`) and default to the \`alova()\` template.
+
+**Step 3: Ask the user for their API setup**
+Before configuring, ask:
+- What is the OpenAPI data source URL?
+- Which platform or source type are they using?
+  - Swagger / Knife4j / FastAPI → use the \`platform()\` plugin
+  - Apifox → use the \`apifox()\` plugin (needs projectId and apifoxToken)
+  - Direct OpenAPI file URL → use \`input\` directly
+
+**Step 4: Initialize config**
+Run \`npx wormajs init --template [http client]\` to generate \`worma.config.[j|ts]\` for the client from Step 2. Then modify it:
+- The input should be the URL from Step 3.
+- The output should be \`src/api\`.
+
+> Do not remove comments in the config file.
+
+Result for a TypeScript project using axios + Swagger:
+\`\`\`ts
+import { defineConfig } from 'wormajs';
+import { axios, aiDoc, platform } from 'wormajs/plugin';
+
+export default defineConfig({
+  generator: [{
+    input: '<user-provided-url>',
+    output: 'src/api',
+    plugins: [platform('swagger'), axios(), aiDoc()],
+  }],
+});
+\`\`\`
+
+**Step 5: Set agent & run generation**
+Before running generation, write the current agent's name into \`.env.local\` (e.g. \`agent=codex\`, where the name is the agent currently running this prompt). If \`.env.local\` already exists, append to it — do not overwrite existing contents:
+\`\`\`bash
+echo "agent=<name of the agent running this prompt>" >> .env.local
+\`\`\`
+Then run:
+\`\`\`bash
+npx wormajs gen
+\`\`\`
+
+This will produce API calling code, TypeScript types, and AI Skill docs for the project.
+
+**Step 6: Offer @alova/wormhole migration**
+After generation, if \`@alova/wormhole\` is in \`package.json\`, ask the user whether to migrate to worma now. Only migrate after explicit confirmation.
+
+**Note:** Don't overthink — just follow the steps above.`
+
+export const COPY_TOAST_MESSAGE = '已复制提示词，请直接发送给agent'
diff --git a/packages/worma/src/template/presets/ai-doc/SKILL.md.handlebars b/packages/worma/src/template/presets/ai-doc/SKILL.md.handlebars
index db8052c0..8eb11521 100644
--- a/packages/worma/src/template/presets/ai-doc/SKILL.md.handlebars
+++ b/packages/worma/src/template/presets/ai-doc/SKILL.md.handlebars
@@ -1,5 +1,5 @@
 ---
-name: {{{title}}}-api-reference
+name: apis-{{{title}}}
 description: >-
   API reference documentation for {{{serverName}}} ({{{title}}} v{{{version}}}).
   Contains specifications for all REST API endpoints, including HTTP request methods,
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 9f26e9fb..3cc1984d 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -628,57 +628,6 @@ importers:
         specifier: ^6.0.3
         version: 6.0.3
 
-  e2e-fixtures-temp/commonjs:
-    dependencies:
-      alova:
-        specifier: ^3.0.0
-        version: 3.3.4
-      axios:
-        specifier: ^1.17.0
-        version: 1.17.0
-    devDependencies:
-      wormajs:
-        specifier: workspace:*
-        version: link:../../packages/worma
-
-  e2e-fixtures-temp/esm:
-    dependencies:
-      alova:
-        specifier: ^3.0.0
-        version: 3.3.4
-      axios:
-        specifier: ^1.17.0
-        version: 1.17.0
-      ky:
-        specifier: ^2.0.2
-        version: 2.0.2
-    devDependencies:
-      wormajs:
-        specifier: workspace:*
-        version: link:../../packages/worma
-
-  e2e-fixtures-temp/typescript:
-    dependencies:
-      alova:
-        specifier: ^3.0.0
-        version: 3.3.4
-      axios:
-        specifier: ^1.17.0
-        version: 1.17.0
-      ky:
-        specifier: ^2.0.2
-        version: 2.0.2
-    devDependencies:
-      tsx:
-        specifier: ^4.22.4
-        version: 4.22.4
-      typescript:
-        specifier: ^5.9.3
-        version: 5.9.3
-      wormajs:
-        specifier: workspace:*
-        version: link:../../packages/worma
-
   examples/commonjs:
     dependencies:
       alova:
@@ -2212,89 +2161,105 @@ packages:
     resolution: {integrity: sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-libvips-linux-arm@1.2.4':
     resolution: {integrity: sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==}
     cpu: [arm]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-libvips-linux-ppc64@1.2.4':
     resolution: {integrity: sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==}
     cpu: [ppc64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-libvips-linux-riscv64@1.2.4':
     resolution: {integrity: sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==}
     cpu: [riscv64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-libvips-linux-s390x@1.2.4':
     resolution: {integrity: sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==}
     cpu: [s390x]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-libvips-linux-x64@1.2.4':
     resolution: {integrity: sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-libvips-linuxmusl-arm64@1.2.4':
     resolution: {integrity: sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@img/sharp-libvips-linuxmusl-x64@1.2.4':
     resolution: {integrity: sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@img/sharp-linux-arm64@0.34.5':
     resolution: {integrity: sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-linux-arm@0.34.5':
     resolution: {integrity: sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-linux-ppc64@0.34.5':
     resolution: {integrity: sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [ppc64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-linux-riscv64@0.34.5':
     resolution: {integrity: sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [riscv64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-linux-s390x@0.34.5':
     resolution: {integrity: sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [s390x]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-linux-x64@0.34.5':
     resolution: {integrity: sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@img/sharp-linuxmusl-arm64@0.34.5':
     resolution: {integrity: sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@img/sharp-linuxmusl-x64@0.34.5':
     resolution: {integrity: sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@img/sharp-wasm32@0.34.5':
     resolution: {integrity: sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==}
@@ -2555,24 +2520,28 @@ packages:
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@next/swc-linux-arm64-musl@16.2.7':
     resolution: {integrity: sha512-qyogG9QtBzWxgJfeGBvOEHI3851gTfCF3wLZ5RDLTBJGAmE9p1qDwKCOdrBrvBzRvYDT+gUDp72pzlSEfAXgNA==}
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@next/swc-linux-x64-gnu@16.2.7':
     resolution: {integrity: sha512-Vhe4ZDuBpmMogrGi5D4R2Kq4JAQlj6+wvgaFYy31zfES0zPmt6TLA+cuYpM/OLrPZjo2MYQTHVqNUSCR6+fDZQ==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@next/swc-linux-x64-musl@16.2.7':
     resolution: {integrity: sha512-srvian89JahFLw1YLBEuhvPJ0DO5lpUeJQMXy4xYo7g628ZlNgXdNkqoxSAv9OYrBfByh6vxISMwW/mRbzCY+g==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@next/swc-win32-arm64-msvc@16.2.7':
     resolution: {integrity: sha512-GX3wvLpULFuRFJzwHaKfm7QZJ18F4ZSuxlPJ96BoBglCzBmdSjyeBKF+ZhWhvL/ckxNfLnNa7bsObO2ipYpszw==}
@@ -2627,24 +2596,28 @@ packages:
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@node-rs/crc32-linux-arm64-musl@1.10.6':
     resolution: {integrity: sha512-k8ra/bmg0hwRrIEE8JL1p32WfaN9gDlUUpQRWsbxd1WhjqvXea7kKO6K4DwVxyxlPhBS9Gkb5Urq7Y4mXANzaw==}
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@node-rs/crc32-linux-x64-gnu@1.10.6':
     resolution: {integrity: sha512-IfjtqcuFK7JrSZ9mlAFhb83xgium30PguvRjIMI45C3FJwu18bnLk1oR619IYb/zetQT82MObgmqfKOtgemEKw==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@node-rs/crc32-linux-x64-musl@1.10.6':
     resolution: {integrity: sha512-LbFYsA5M9pNunOweSt6uhxenYQF94v3bHDAQRPTQ3rnjn+mK6IC7YTAYoBjvoJP8lVzcvk9hRj8wp4Jyh6Y80g==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@node-rs/crc32-wasm32-wasi@1.10.6':
     resolution: {integrity: sha512-KaejdLgHMPsRaxnM+OG9L9XdWL2TabNx80HLdsCOoX9BVhEkfh39OeahBo8lBmidylKbLGMQoGfIKDjq0YMStw==}
@@ -2754,48 +2727,56 @@ packages:
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@oxfmt/binding-linux-arm64-musl@0.35.0':
     resolution: {integrity: sha512-5Okqi+uhYFxwKz8hcnUftNNwdm8BCkf6GSCbcz9xJxYMm87k1E4p7PEmAAbhLTk7cjSdDre6TDL0pDzNX+Y22Q==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@oxfmt/binding-linux-ppc64-gnu@0.35.0':
     resolution: {integrity: sha512-9k66pbZQXM/lBJWys3Xbc5yhl4JexyfqkEf/tvtq8976VIJnLAAL3M127xHA3ifYSqxdVHfVGTg84eiBHCGcNw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ppc64]
     os: [linux]
+    libc: [glibc]
 
   '@oxfmt/binding-linux-riscv64-gnu@0.35.0':
     resolution: {integrity: sha512-aUcY9ofKPtjO52idT6t0SAQvEF6ctjzUQa1lLp7GDsRpSBvuTrBQGeq0rYKz3gN8dMIQ7mtMdGD9tT4LhR8jAQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
+    libc: [glibc]
 
   '@oxfmt/binding-linux-riscv64-musl@0.35.0':
     resolution: {integrity: sha512-C6yhY5Hvc2sGM+mCPek9ZLe5xRUOC/BvhAt2qIWFAeXMn4il04EYIjl3DsWiJr0xDMTJhvMOmD55xTRPlNp39w==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
+    libc: [musl]
 
   '@oxfmt/binding-linux-s390x-gnu@0.35.0':
     resolution: {integrity: sha512-RG2hlvOMK4OMZpO3mt8MpxLQ0AAezlFqhn5mI/g5YrVbPFyoCv9a34AAvbSJS501ocOxlFIRcKEuw5hFvddf9g==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [s390x]
     os: [linux]
+    libc: [glibc]
 
   '@oxfmt/binding-linux-x64-gnu@0.35.0':
     resolution: {integrity: sha512-wzmh90Pwvqj9xOKHJjkQYBpydRkaXG77ZvDz+iFDRRQpnqIEqGm5gmim2s6vnZIkDGsvKCuTdtxm0GFmBjM1+w==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@oxfmt/binding-linux-x64-musl@0.35.0':
     resolution: {integrity: sha512-+HCqYCJPCUy5I+b2cf+gUVaApfgtoQT3HdnSg/l7NIcLHOhKstlYaGyrFZLmUpQt4WkFbpGKZZayG6zjRU0KFA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@oxfmt/binding-openharmony-arm64@0.35.0':
     resolution: {integrity: sha512-kFYmWfR9YL78XyO5ws+1dsxNvZoD973qfVMNFOS4e9bcHXGF7DvGC2tY5UDFwyMCeB33t3sDIuGONKggnVNSJA==}
@@ -2868,48 +2849,56 @@ packages:
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@oxlint/binding-linux-arm64-musl@1.71.0':
     resolution: {integrity: sha512-fJZrs5sDZtTaPIOiemRQQmo82Ezy+vOGXemPc4Ok7iVVsYsFa7SlW6Z5XN819VfsqBHRm3NJ3rTdnR8+bJYJdQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@oxlint/binding-linux-ppc64-gnu@1.71.0':
     resolution: {integrity: sha512-cwl7VKGERIy9p+G+AvZdfy/06q0aHXaTt/mMRReC751iuNYJgqKjB7NydXSS30nBT9vtr2tunciOtrR4fD6FUA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ppc64]
     os: [linux]
+    libc: [glibc]
 
   '@oxlint/binding-linux-riscv64-gnu@1.71.0':
     resolution: {integrity: sha512-eZ8ieVXvzGi8jr7+ybQGPK2STw3mldfxZlgA2738iflfB/rzA69sE6m5rDRpQaxC7dpm745Enlh1Tod0QAk9Gg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
+    libc: [glibc]
 
   '@oxlint/binding-linux-riscv64-musl@1.71.0':
     resolution: {integrity: sha512-puMDbQYe6+NXwfMusojoA7CXGn2b3utukmd23PQqc1E3XhVCwyZ+FueSMzDYeNgDV2dUfIVXAAKZBcFDeCL6sA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
+    libc: [musl]
 
   '@oxlint/binding-linux-s390x-gnu@1.71.0':
     resolution: {integrity: sha512-4NJLxBs1ujISCt3L/1FcywLs73PWtJuw+piD6feK2V6h6OS6P7xu9/sWt1DTRLibe6QCzmfZzmM/2HPORoV/Lg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [s390x]
     os: [linux]
+    libc: [glibc]
 
   '@oxlint/binding-linux-x64-gnu@1.71.0':
     resolution: {integrity: sha512-cFDaiR8L3430qp88tfZnvFlt3KotFhR/DlbIL0nHOMMYiG/9Wy4l+6f7t8G8pTa9bd8Lt8+M0y/qjRQ/xcB74g==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@oxlint/binding-linux-x64-musl@1.71.0':
     resolution: {integrity: sha512-orfixdt76KlpNly9z0PkWBBNfwjKz+JFVLP/7wnVchlKNU9Dpt9InU/ZggeSej6fC7qwHmHNOGlhLnQXcYoGuA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@oxlint/binding-openharmony-arm64@1.71.0':
     resolution: {integrity: sha512-9emQu2lAp6yhPB3XuI+++vR+l/o6JR1X+EpxwcumPdQXBWXEPAsquPGL7l158EqU8SebQMXTUa/S5zN98juyHw==}
@@ -3353,24 +3342,28 @@ packages:
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@rolldown/binding-linux-arm64-musl@1.0.0-beta.42':
     resolution: {integrity: sha512-/bNTYb9aKNhzdbPn3O4MK2aLv55AlrkUKPE4KNfBYjkoZUfDr4jWp7gsSlvTc5A/99V1RCm9axvt616ZzeXGyA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@rolldown/binding-linux-x64-gnu@1.0.0-beta.42':
     resolution: {integrity: sha512-n/SLa4h342oyeGykZdch7Y3GNCNliRPL4k5wkeZ/5eQZs+c6/ZG1SHCJQoy7bZcmxiMyaXs9HoFmv1PEKrZgWg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@rolldown/binding-linux-x64-musl@1.0.0-beta.42':
     resolution: {integrity: sha512-4PSd46sFzqpLHSGdaSViAb1mk55sCUMpJg+X8ittXaVocQsV3QLG/uydSH8RyL0ngHX5fy3D70LcCzlB15AgHw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@rolldown/binding-openharmony-arm64@1.0.0-beta.42':
     resolution: {integrity: sha512-BmWoeJJyeZXmZBcfoxG6J9+rl2G7eO47qdTkAzEegj4n3aC6CBIHOuDcbE8BvhZaEjQR0nh0nJrtEDlt65Q7Sw==}
@@ -3480,121 +3473,145 @@ packages:
     resolution: {integrity: sha512-xRiOu9Of1FZ4SxVbB0iEDXc4ddIcjCv2aj03dmW8UrZIW7aIQ9jVJdLBIhxBI+MaTnGAKyvMwPwQnoOEvP7FgQ==}
     cpu: [arm]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-arm-gnueabihf@4.62.2':
     resolution: {integrity: sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==}
     cpu: [arm]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-arm-musleabihf@4.52.4':
     resolution: {integrity: sha512-FbhM2p9TJAmEIEhIgzR4soUcsW49e9veAQCziwbR+XWB2zqJ12b4i/+hel9yLiD8pLncDH4fKIPIbt5238341Q==}
     cpu: [arm]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-arm-musleabihf@4.62.2':
     resolution: {integrity: sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==}
     cpu: [arm]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-arm64-gnu@4.52.4':
     resolution: {integrity: sha512-4n4gVwhPHR9q/g8lKCyz0yuaD0MvDf7dV4f9tHt0C73Mp8h38UCtSCSE6R9iBlTbXlmA8CjpsZoujhszefqueg==}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-arm64-gnu@4.62.2':
     resolution: {integrity: sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-arm64-musl@4.52.4':
     resolution: {integrity: sha512-u0n17nGA0nvi/11gcZKsjkLj1QIpAuPFQbR48Subo7SmZJnGxDpspyw2kbpuoQnyK+9pwf3pAoEXerJs/8Mi9g==}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-arm64-musl@4.62.2':
     resolution: {integrity: sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-loong64-gnu@4.52.4':
     resolution: {integrity: sha512-0G2c2lpYtbTuXo8KEJkDkClE/+/2AFPdPAbmaHoE870foRFs4pBrDehilMcrSScrN/fB/1HTaWO4bqw+ewBzMQ==}
     cpu: [loong64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-loong64-gnu@4.62.2':
     resolution: {integrity: sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==}
     cpu: [loong64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-loong64-musl@4.62.2':
     resolution: {integrity: sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==}
     cpu: [loong64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-ppc64-gnu@4.52.4':
     resolution: {integrity: sha512-teSACug1GyZHmPDv14VNbvZFX779UqWTsd7KtTM9JIZRDI5NUwYSIS30kzI8m06gOPB//jtpqlhmraQ68b5X2g==}
     cpu: [ppc64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-ppc64-gnu@4.62.2':
     resolution: {integrity: sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==}
     cpu: [ppc64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-ppc64-musl@4.62.2':
     resolution: {integrity: sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==}
     cpu: [ppc64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-riscv64-gnu@4.52.4':
     resolution: {integrity: sha512-/MOEW3aHjjs1p4Pw1Xk4+3egRevx8Ji9N6HUIA1Ifh8Q+cg9dremvFCUbOX2Zebz80BwJIgCBUemjqhU5XI5Eg==}
     cpu: [riscv64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-riscv64-gnu@4.62.2':
     resolution: {integrity: sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==}
     cpu: [riscv64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-riscv64-musl@4.52.4':
     resolution: {integrity: sha512-1HHmsRyh845QDpEWzOFtMCph5Ts+9+yllCrREuBR/vg2RogAQGGBRC8lDPrPOMnrdOJ+mt1WLMOC2Kao/UwcvA==}
     cpu: [riscv64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-riscv64-musl@4.62.2':
     resolution: {integrity: sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==}
     cpu: [riscv64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-s390x-gnu@4.52.4':
     resolution: {integrity: sha512-seoeZp4L/6D1MUyjWkOMRU6/iLmCU2EjbMTyAG4oIOs1/I82Y5lTeaxW0KBfkUdHAWN7j25bpkt0rjnOgAcQcA==}
     cpu: [s390x]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-s390x-gnu@4.62.2':
     resolution: {integrity: sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==}
     cpu: [s390x]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-x64-gnu@4.52.4':
     resolution: {integrity: sha512-Wi6AXf0k0L7E2gteNsNHUs7UMwCIhsCTs6+tqQ5GPwVRWMaflqGec4Sd8n6+FNFDw9vGcReqk2KzBDhCa1DLYg==}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-x64-gnu@4.62.2':
     resolution: {integrity: sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@rollup/rollup-linux-x64-musl@4.52.4':
     resolution: {integrity: sha512-dtBZYjDmCQ9hW+WgEkaffvRRCKm767wWhxsFW3Lw86VXz/uJRuD438/XvbZT//B96Vs8oTA8Q4A0AfHbrxP9zw==}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-linux-x64-musl@4.62.2':
     resolution: {integrity: sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@rollup/rollup-openbsd-x64@4.62.2':
     resolution: {integrity: sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==}
@@ -3869,48 +3886,56 @@ packages:
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@tailwindcss/oxide-linux-arm64-gnu@4.3.2':
     resolution: {integrity: sha512-wDgEIGwoM8w8pufh9LVt1PahDgNdKXrLC2qfAnV3vAmococ9RWbxeAw4pxPttd/TsJfwjyLf90Dg1y9y8I6Emw==}
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   '@tailwindcss/oxide-linux-arm64-musl@4.3.1':
     resolution: {integrity: sha512-Bwv9KwOvE0VKa86xPFif9b9c3Y1NxOV1P0gLti/IYaWEsQYZXDlxfGEtA8mdDZ7SG3wyNXAWYT5SIn3giL57oA==}
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@tailwindcss/oxide-linux-arm64-musl@4.3.2':
     resolution: {integrity: sha512-J5Nuk0uZQIiMTJj3LEx4sAA9tMFUoXQZFv1J6An+QGYe53HKRJuFDi0rpq/tuouCZeAbOBY3kQ6g8qeD4TUjtA==}
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   '@tailwindcss/oxide-linux-x64-gnu@4.3.1':
     resolution: {integrity: sha512-Ymi8O8T15HYQdOUWUtTI6ldN0neHP85FC+Qz32xTcZ7iJXtem/x8ITev0o1e9e5rkqj4lONZfTRLvkmin1+tKg==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@tailwindcss/oxide-linux-x64-gnu@4.3.2':
     resolution: {integrity: sha512-kqCZpSKOBEJO4mz7OqWoofBZeXTAwaVGPj0ErAj7CojmhKpWVWVOnrt9dE8odoIraZq4oj3ausM37kXi+Tow8w==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   '@tailwindcss/oxide-linux-x64-musl@4.3.1':
     resolution: {integrity: sha512-M+P/91qJ6uILLw4k2G93GMDRAXj61SMvFQYt39AqvUqYgExXpLL5aepfns7sj4HiAQeolirQF9E0lzRvdf4zPQ==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@tailwindcss/oxide-linux-x64-musl@4.3.2':
     resolution: {integrity: sha512-cixpqbh2toJDmkuCRI68nXA8ZxNmdK9Y+9v5h3MC3ZQKy/0BO8AWzlkWyRM7JAFSGBlfig4YVTPsK6MVgqz1uw==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   '@tailwindcss/oxide-wasm32-wasi@4.3.1':
     resolution: {integrity: sha512-zsM8uOeqvVGHsAXsJxsT28ttosFahLJKCLOTUBqRAtKnVgGSRitds9T432QiT8b77Yga7JIBkulIRRlJPtYhRA==}
@@ -7239,24 +7264,28 @@ packages:
     engines: {node: '>= 12.0.0'}
     cpu: [arm64]
     os: [linux]
+    libc: [glibc]
 
   lightningcss-linux-arm64-musl@1.32.0:
     resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==}
     engines: {node: '>= 12.0.0'}
     cpu: [arm64]
     os: [linux]
+    libc: [musl]
 
   lightningcss-linux-x64-gnu@1.32.0:
     resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [linux]
+    libc: [glibc]
 
   lightningcss-linux-x64-musl@1.32.0:
     resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [linux]
+    libc: [musl]
 
   lightningcss-win32-arm64-msvc@1.32.0:
     resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==}

From 8081e110a78bcd2c387b4a60473018add554a55b Mon Sep 17 00:00:00 2001
From: Scott Hu <huzhen555@qq.com>
Date: Thu, 9 Jul 2026 14:32:57 +0800
Subject: [PATCH 2/4] chore: Remove obsolete .changeset files

Delete two outdated .changeset entries (fuzzy-places-stop.md and olive-hats-kiss.md). These files contained small patch notes (extension logo change and temp filename fix) and were removed to avoid applying stale or duplicate release notes during the release process.
---
 .changeset/fuzzy-places-stop.md | 5 -----
 .changeset/olive-hats-kiss.md   | 5 -----
 2 files changed, 10 deletions(-)
 delete mode 100644 .changeset/fuzzy-places-stop.md
 delete mode 100644 .changeset/olive-hats-kiss.md

diff --git a/.changeset/fuzzy-places-stop.md b/.changeset/fuzzy-places-stop.md
deleted file mode 100644
index 21ea5868..00000000
--- a/.changeset/fuzzy-places-stop.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"worma-vscode": patch
----
-
-Change extension logo.
diff --git a/.changeset/olive-hats-kiss.md b/.changeset/olive-hats-kiss.md
deleted file mode 100644
index dffcd7f9..00000000
--- a/.changeset/olive-hats-kiss.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"wormajs": patch
----
-
-Correc temp file name. Which is bundled by esbuild.

From 2cfd90bf9eff5eb4bd23faa1a49214dce7d414b2 Mon Sep 17 00:00:00 2001
From: Scott Hu <huzhen555@qq.com>
Date: Thu, 9 Jul 2026 14:49:15 +0800
Subject: [PATCH 3/4] fix: modify api skill name, support multiple agent set

---
 .changeset/fine-beers-make.md                 |   5 +
 README.md                                     |   4 +-
 docs/content/docs/index.mdx                   | 198 ++++++++--------
 .../plugin-system/builtin-plugins/aiDoc.mdx   |   6 +-
 docs/src/components/home/agentPrompt.ts       |   2 +-
 packages/worma/README.md                      |   6 +-
 packages/worma/src/plugins/presets/aiDoc.ts   |  52 ++++-
 packages/worma/test/plugins/aiDoc.spec.ts     | 219 +++++++++++++++++-
 8 files changed, 373 insertions(+), 119 deletions(-)
 create mode 100644 .changeset/fine-beers-make.md

diff --git a/.changeset/fine-beers-make.md b/.changeset/fine-beers-make.md
new file mode 100644
index 00000000..44385f39
--- /dev/null
+++ b/.changeset/fine-beers-make.md
@@ -0,0 +1,5 @@
+---
+"wormajs": patch
+---
+
+modify api skill name, support multiple agent set
diff --git a/README.md b/README.md
index 58e5df21..060c2bb9 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-# worma - Universal OpenAPI Code Generator
+# worma - The OpenAPI Generator for human and AI
+
+![](https://worma.js.org/img/banner.png)
 
 [![npm version](https://img.shields.io/npm/v/wormajs)](https://www.npmjs.com/package/wormajs)
 [![license](https://img.shields.io/github/license/alovajs/devtools)](https://github.com/alovajs/devtools/blob/main/LICENSE)
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index ab4eccfe..bda8860a 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -1,99 +1,99 @@
----
-title: 介绍
-description: worma — 一份 OpenAPI，同时生成调用代码和 AI 知识
----
-
-> **让 worma 成为 AI 编程工作流中不可或缺的一环——一份 OpenAPI，同时生成开发者能直接调用的代码，和 AI 能读懂的接口知识。**
-
-在 AI 编码工具（如 Cursor）中，当 AI 尝试调用后端接口时，常常会出现函数名错误、参数不匹配等问题。worma 正是为解决这一问题而生。
-
-worma 是一款通用的 OpenAPI 代码生成工具，与后端语言和前端请求库无关。无论后端使用 Java、Go 还是 Python，前端使用 Alova、Axios、Fetch 还是 Ky，无论项目运行在 Node.js、Deno 还是 Bun，TypeScript 或 JavaScript 项目均可使用，且从 OpenAPI 规范到生成代码全程类型安全。只需提供一份 OpenAPI 规范文件，即可同时生成调用代码、TypeScript 类型定义、接口文档和 AI Skill。
-
-名字取自"虫洞"（wormhole），寓意后端接口与前端代码之间的连接应当像虫洞一样直接，无需绕行。worma 在 `@alova/wormhole` 基础上进行了大量重新设计和性能优化，扩展为通用 OpenAPI 代码生成工具，原有 `@alova/wormhole` 用户可通过 `alovaGlobals` 模板平滑迁移。
-
-## 工作流程
-
-<Steps>
-  <Step>
-    **后端交付 OpenAPI 文件**
-
-    Swagger、Knife4j、FastAPI、ApiFox 等均可，只需一份 OpenAPI 规范文件即可开始。
-
-  </Step>
-  <Step>
-    **运行 `worma gen`**
-
-    一条命令即可同时生成两种产出：
-
-    - **你用的**：调用函数、TypeScript 类型、编辑器内文档
-    - **AI 用的**：Skill 文档，供 AI 直接读取
-
-    生成后项目中会新增以下内容：
-
-    <Files>
-      <Folder name=".skills" defaultOpen>
-        <File name="SKILL.md" />
-        <Folder name="references" defaultOpen>
-          <File name="user-info.md" />
-          <File name="user-login.md" />
-        </Folder>
-      </Folder>
-      <Folder name="src/api" defaultOpen>
-        <File name="user.ts" />
-        <File name="types.ts" />
-      </Folder>
-    </Files>
-
-    `.skills/` 为 AI 直接读取的知识库，`src/api/` 为开发者可直接 import 的调用代码。
-
-  </Step>
-  <Step>
-    **在编辑器中编写业务代码，AI 自动查询接口**
-
-    输入「获取用户列表」，AI 自动补全 `getUserList({ page: 1 })`，函数名、参数、请求路径均准确无误。
-
-    只需描述业务意图，无需查阅接口文档——AI 会根据 Skill 自动匹配合适的接口。
-
-  </Step>
-</Steps>
-
-## 核心特性
-
-### 🤖 AI Skill 一键生成
-
-自动生成符合 Skills 规范的接口文档，支持[绝大部分 coding agent](https://www.npmjs.com/package/skills#supported-agents)，安装即用。大模型可准确感知项目中的所有 API，避免对函数名和参数进行猜测。
-
-### 🧩 四合一信息输出
-
-一份 OpenAPI 规范同时产出调用函数、TypeScript 类型、可读文档和 AI Skill。开发者使用代码，AI 使用知识，各取所需。
-
-### 🔌 多请求库 + 自定义模板
-
-内置 Alova、Axios、Fetch、Ky 模板，可一键切换。团队可根据实际使用的请求库选择对应模板。如有定制需求，可通过 Handlebars 模板引擎自由修改。
-
-### 📝 编辑器内文档
-
-安装 VSCode 扩展后，悬停即可查看完整的参数表和返回示例，即使是纯 JavaScript 项目也能获得接近 TypeScript 级别的类型提示。开发者与 AI 共享同一份接口知识，代码补全更加精准。
-
-## 即刻体验
-
-无需本地安装，直接在浏览器中体验：
-
-- [TypeScript 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/typescript)
-- [ESM 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/esm)
-- [CommonJS 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/commonjs)
-- [Monorepo 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/monorepo)
-
-## 为 AI 安装 worma skill
-
-为 AI 添加 worma 的配置和使用知识：
-
-```bash
-skills add alovajs/skills --skill worma-guidelines
-```
-
-安装完成后，AI 即可理解 worma 的配置方式和使用命令。
-
----
-
-[快速开始](/docs/quick-start)，5 分钟即可完成接入。
+---
+title: 介绍
+description: worma — 一份 OpenAPI，同时生成调用代码和 AI 知识
+---
+
+> **让 worma 成为 AI 编程工作流中不可或缺的一环——一份 OpenAPI，同时生成开发者能直接调用的代码，和 AI 能读懂的接口知识。**
+
+在 AI 编码工具（如 Cursor）中，当 AI 尝试调用后端接口时，常常会出现函数名错误、参数不匹配等问题。worma 正是为解决这一问题而生。
+
+worma 是一款通用的 OpenAPI 代码生成工具，与后端语言和前端请求库无关。无论后端使用 Java、Go 还是 Python，前端使用 Alova、Axios、Fetch 还是 Ky，无论项目运行在 Node.js、Deno 还是 Bun，TypeScript 或 JavaScript 项目均可使用，且从 OpenAPI 规范到生成代码全程类型安全。只需提供一份 OpenAPI 规范文件，即可同时生成调用代码、TypeScript 类型定义、接口文档和 AI Skill。
+
+名字取自"虫洞"（wormhole），寓意后端接口与前端代码之间的连接应当像虫洞一样直接，无需绕行。worma 在 `@alova/wormhole` 基础上进行了大量重新设计和性能优化，扩展为通用 OpenAPI 代码生成工具，原有 `@alova/wormhole` 用户可通过 `alovaGlobals` 模板平滑迁移。
+
+## 工作流程
+
+<Steps>
+  <Step>
+    **后端交付 OpenAPI 文件**
+
+    Swagger、Knife4j、FastAPI、ApiFox 等均可，只需一份 OpenAPI 规范文件即可开始。
+
+  </Step>
+  <Step>
+    **运行 `worma gen`**
+
+    一条命令即可同时生成两种产出：
+
+    - **你用的**：调用函数、TypeScript 类型、编辑器内文档
+    - **AI 用的**：Skill 文档，供 AI 直接读取
+
+    生成后项目中会新增以下内容：
+
+    <Files>
+      <Folder name=".skills" defaultOpen>
+        <File name="SKILL.md" />
+        <Folder name="references" defaultOpen>
+          <File name="user-info.md" />
+          <File name="user-login.md" />
+        </Folder>
+      </Folder>
+      <Folder name="src/api" defaultOpen>
+        <File name="user.ts" />
+        <File name="types.ts" />
+      </Folder>
+    </Files>
+
+    `.skills/` 为 AI 直接读取的知识库，`src/api/` 为开发者可直接 import 的调用代码。
+
+  </Step>
+  <Step>
+    **coding agent 自动查询对应的接口**
+
+    输入「实现获取用户列表页」，AI 自动查询 `getUserList({ page: 1 })`，函数名、参数、请求路径均准确无误。
+
+    只需描述业务意图，无需查阅接口文档——AI 会根据 Skill 自动匹配合适的接口。
+
+  </Step>
+</Steps>
+
+## 核心特性
+
+### 🤖 AI Skill 一键生成
+
+自动生成符合 Skills 规范的接口文档，支持[绝大部分 coding agent](https://www.npmjs.com/package/skills#supported-agents)，安装即用。大模型可准确感知项目中的所有 API，避免对函数名和参数进行猜测。
+
+### 🧩 四合一信息输出
+
+一份 OpenAPI 规范同时产出调用函数、TypeScript 类型、可读文档和 AI Skill。开发者使用代码，AI 使用知识，各取所需。
+
+### 🔌 多请求库 + 自定义模板
+
+内置 Alova、Axios、Fetch、Ky 模板，可一键切换。团队可根据实际使用的请求库选择对应模板。如有定制需求，可通过 Handlebars 模板引擎自由修改。
+
+### 📝 编辑器内文档
+
+安装 VSCode 扩展后，悬停即可查看完整的参数表和返回示例，即使是纯 JavaScript 项目也能获得接近 TypeScript 级别的类型提示。开发者与 AI 共享同一份接口知识，代码补全更加精准。
+
+## 即刻体验
+
+无需本地安装，直接在浏览器中体验：
+
+- [TypeScript 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/typescript)
+- [ESM 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/esm)
+- [CommonJS 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/commonjs)
+- [Monorepo 示例](https://stackblitz.com/fork/github/alovajs/devtools/tree/main/examples/monorepo)
+
+## 为 AI 安装 worma skill
+
+为 AI 添加 worma 的配置和使用知识：
+
+```bash
+skills add alovajs/skills --skill worma-guidelines
+```
+
+安装完成后，AI 即可理解 worma 的配置方式和使用命令。
+
+---
+
+[快速开始](/docs/quick-start)，5 分钟即可完成接入。
diff --git a/docs/content/docs/plugin-system/builtin-plugins/aiDoc.mdx b/docs/content/docs/plugin-system/builtin-plugins/aiDoc.mdx
index 90c44695..35d9fa19 100644
--- a/docs/content/docs/plugin-system/builtin-plugins/aiDoc.mdx
+++ b/docs/content/docs/plugin-system/builtin-plugins/aiDoc.mdx
@@ -12,6 +12,7 @@ description: 生成 AI 可读的接口知识文档，让编码助手准确感知
 - 自动生成 `SKILL.md` 总览索引和按 tag 分组的 API 参考文档
 - 支持自定义模板路径和输出目录
 - 支持自动安装 Skill 到主流编码助手（Cursor、Claude Code、Windsurf 等）
+- 支持在 `.env.local` 中通过逗号分隔配置多个编码助手，一次生成同时安装到多个助手
 
 ## 基本使用
 
@@ -87,11 +88,14 @@ function aiDoc(config?: AiDocConfig): ApiPlugin;
 
 ```ini
 # Worma aiDoc skill installer configuration
-# Please set the coding agent you are using (e.g. cursor, claude-code, windsurf).
+# Please set the coding agent(s) you are using (e.g. cursor, claude-code, windsurf).
+# You can configure multiple agents comma-separated, e.g. agent=cursor,claude-code.
 # Supported agents list: https://www.npmjs.com/package/skills#supported-agents
 agent=cursor
 ```
 
+> 如需同时安装到多个编码助手，使用逗号分隔即可，例如 `agent=cursor,claude-code,windsurf`。worma 会自动去重，并为每个助手执行一次安装。
+
 2. **运行生成命令**：
 
 ```bash
diff --git a/docs/src/components/home/agentPrompt.ts b/docs/src/components/home/agentPrompt.ts
index 0ee4f921..92293f1c 100644
--- a/docs/src/components/home/agentPrompt.ts
+++ b/docs/src/components/home/agentPrompt.ts
@@ -6,7 +6,7 @@ export const AGENT_PROMPT = `Install the worma-guidelines skill and the worma np
 Detect network: if npmjs registry is slow/unreachable, auto-use a mirror (e.g. \`https://registry.npmmirror.com\`) and tell the user; otherwise use the default registry.
 \`\`\`bash
 npx skills add alovajs/skills --yes --skill worma-guidelines
-npm i wormajs -D
+npm i wormajs@beta -D
 \`\`\`
 
 **Step 2: Detect HTTP client**
diff --git a/packages/worma/README.md b/packages/worma/README.md
index 33c73106..4833491d 100644
--- a/packages/worma/README.md
+++ b/packages/worma/README.md
@@ -1,8 +1,6 @@
-# worma - A Universal OpenAPI Code Generator
+# worma - The OpenAPI Generator for human and AI
 
-<p align="center">
-<img width="200px" src="https://alova.js.org/img/logo-text-vertical.svg" />
-</p>
+![](https://worma.js.org/img/banner.png)
 
 <p align="center"><b>One OpenAPI spec. Code for developers, knowledge for AI.<br />Generate API calling functions, TypeScript types, documentation, and AI Skills in a single command.</b></p>
 
diff --git a/packages/worma/src/plugins/presets/aiDoc.ts b/packages/worma/src/plugins/presets/aiDoc.ts
index 81380124..7643cbb5 100644
--- a/packages/worma/src/plugins/presets/aiDoc.ts
+++ b/packages/worma/src/plugins/presets/aiDoc.ts
@@ -81,43 +81,70 @@ export function aiDoc(config?: AiDocConfig): ApiPlugin {
       })
 
       if (installSkillEnabled) {
-        const { agent } = resolveAgent(projectPath)
-        installSkill(aidocsDir, agent, projectPath)
+        const { agents } = resolveAgents(projectPath)
+        for (const agent of agents) {
+          installSkill(aidocsDir, agent, projectPath)
+        }
       }
     },
   }
 }
 
 /**
- * Resolve the target coding agent from `.env.local` in the project root.
+ * Resolve the target coding agents from `.env.local` in the project root.
+ *
+ * Multiple agents can be configured as a comma-separated list, e.g.
+ * `agent=cursor, claude-code, windsurf`. Both commas and surrounding
+ * whitespace are tolerated.
  *
  * If the file does not exist, it will be created and `.gitignore` will be
  * updated to ignore `*.local` files. An error is then thrown asking the user
- * to set `agent=<coding-agent>`.
+ * to set `agent=<coding-agent>` (optionally multiple, comma-separated).
  *
- * If `agent` is missing, an error is thrown with guidance.
+ * If `agent` is missing or empty, an error is thrown with guidance.
  */
-function resolveAgent(projectPath: string): { agent: string } {
+function resolveAgents(projectPath: string): { agents: string[] } {
   const envFilePath = path.join(projectPath, '.env.local')
 
   if (!fs.existsSync(envFilePath)) {
     createEnvLocalFile(envFilePath)
     ensureGitIgnoreLocal(projectPath)
     throw logger.throwError(
-      `${prefix}Created .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`,
+      `${prefix}Created .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor or multiple agents comma-separated: agent=cursor,claude-code. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`,
     )
   }
 
   const content = fs.readFileSync(envFilePath, 'utf-8')
-  const agent = parseEnvValue(content, 'agent')
+  const raw = parseEnvValue(content, 'agent') ?? ''
+  const agents = parseAgentList(raw)
 
-  if (!agent) {
+  if (agents.length === 0) {
     throw logger.throwError(
-      `${prefix}Missing "agent" in .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`,
+      `${prefix}Missing "agent" in .env.local at project root. Please set the coding agent you are using, e.g. agent=cursor or multiple agents comma-separated: agent=cursor,claude-code. Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}`,
     )
   }
 
-  return { agent }
+  return { agents }
+}
+
+/**
+ * Parse an agent string into a deduplicated list of trimmed agent names.
+ *
+ * Agents may be separated by either an English comma (`,`) or a Chinese
+ * comma (`，`), with any amount of whitespace (including none) allowed on
+ * either side. Empty entries are ignored.
+ */
+export function parseAgentList(raw: string): string[] {
+  const seen = new Set<string>()
+  const result: string[] = []
+  for (const part of raw.split(/[,，]/)) {
+    const agent = part.trim()
+    if (!agent || seen.has(agent))
+      continue
+    seen.add(agent)
+    result.push(agent)
+  }
+  return result
 }
 
 /**
@@ -159,7 +186,8 @@ function installSkill(skillPath: string, agent: string, projectPath: string) {
 
 function createEnvLocalFile(envFilePath: string) {
   const content = `# Worma aiDoc skill installer configuration
-# Please set the coding agent you are using (e.g. cursor, claude-code, windsurf).
+# Please set the coding agent(s) you are using (e.g. cursor, claude-code, windsurf).
+# You can configure multiple agents comma-separated, e.g. agent=cursor,claude-code.
 # Supported agents list: ${SKILLS_SUPPORTED_AGENTS_URL}
 agent=
 `
diff --git a/packages/worma/test/plugins/aiDoc.spec.ts b/packages/worma/test/plugins/aiDoc.spec.ts
index e094109e..28477ded 100644
--- a/packages/worma/test/plugins/aiDoc.spec.ts
+++ b/packages/worma/test/plugins/aiDoc.spec.ts
@@ -3,7 +3,7 @@ import type { RenderTemplateParams } from '@/helper/config/type'
 import { resolve } from 'node:path'
 import { logger } from '@/helper/logger'
 import { TemplateHelper } from '@/helper/template'
-import { aiDoc } from '@/plugins/presets/aiDoc'
+import { aiDoc, parseAgentList } from '@/plugins/presets/aiDoc'
 import { generateWithPlugin } from '../util'
 
 // Hoisted: create the shared memfs volume before any module imports
@@ -626,6 +626,223 @@ describe('plugins/aiDoc', () => {
       expect(callArg).toContain('-a "unknown-agent"')
     })
 
+    it('parseAgentList should split comma-separated agents, trim and dedupe', () => {
+      expect(parseAgentList('cursor')).toEqual(['cursor'])
+      expect(parseAgentList('cursor, claude-code')).toEqual(['cursor', 'claude-code'])
+      expect(parseAgentList(' cursor , claude-code , windsurf ')).toEqual([
+        'cursor',
+        'claude-code',
+        'windsurf',
+      ])
+      // Chinese comma is supported, mixed with English comma and arbitrary spacing
+      expect(parseAgentList('cursor，claude-code')).toEqual(['cursor', 'claude-code'])
+      expect(parseAgentList('cursor， claude-code ，windsurf')).toEqual([
+        'cursor',
+        'claude-code',
+        'windsurf',
+      ])
+      expect(parseAgentList('cursor,claude-code，windsurf')).toEqual([
+        'cursor',
+        'claude-code',
+        'windsurf',
+      ])
+      // zero spaces around commas
+      expect(parseAgentList('cursor,claude-code,windsurf')).toEqual([
+        'cursor',
+        'claude-code',
+        'windsurf',
+      ])
+      // duplicate entries are removed
+      expect(parseAgentList('cursor, cursor, claude-code')).toEqual(['cursor', 'claude-code'])
+      expect(parseAgentList('cursor，cursor，claude-code')).toEqual(['cursor', 'claude-code'])
+      // whitespace-only / empty entries are ignored
+      expect(parseAgentList('')).toEqual([])
+      expect(parseAgentList(' , , ')).toEqual([])
+      expect(parseAgentList('，,，')).toEqual([])
+      expect(parseAgentList('cursor,,claude-code')).toEqual(['cursor', 'claude-code'])
+      // quotes around values are preserved as-is (callers pass clean names)
+      expect(parseAgentList('"cursor", "claude-code"')).toEqual(['"cursor"', '"claude-code"'])
+    })
+
+    it('should install skill into every comma-separated agent in .env.local', async () => {
+      const { execSync } = await import('node:child_process')
+      testVol.writeFileSync(
+        resolve(process.cwd(), '.env.local'),
+        'agent=cursor, claude-code, windsurf\n',
+        'utf-8',
+      )
+
+      const plugin = aiDoc({ installSkill: true })
+      const outputPath = 'src/api-skill-multi-agent'
+      plugin.config?.({ config: { output: outputPath } as any, projectPath: process.cwd(), reportProgress: vi.fn() })
+
+      const apiTest = {
+        tag: 'test',
+        method: 'GET',
+        summary: 'Test',
+        path: '/test',
+        name: 'testApi',
+        response: 'void',
+        pathKey: 'test.testApi',
+        pathParameters: '',
+        queryParameters: '',
+        callingCode: '',
+      }
+      const data: any = {
+        title: 'Skill Multi Agent Test',
+        version: '1.0.0',
+        openapi: '3.0.1',
+        baseUrl: '/api',
+        allApis: [apiTest],
+        components: [],
+        componentNames: [],
+        type: 'typescript',
+        config: {},
+        tagedApis: [
+          {
+            tagName: 'test',
+            apis: [apiTest],
+          },
+        ],
+      }
+
+      await plugin.codeGenerated?.({
+        config: {} as any,
+        data,
+        filePaths: [],
+        outputDir: resolve(process.cwd(), outputPath),
+        projectPath: process.cwd(),
+        reportProgress: vi.fn(),
+        renderTemplate: renderTemplateFn,
+      })
+
+      // One execSync call per configured agent
+      const calls = (execSync as ReturnType<typeof vi.fn>).mock.calls
+      expect(calls.length).toBe(3)
+      const args = calls.map(c => c[0] as string)
+      expect(args.some(arg => arg.includes('-a "cursor"'))).toBe(true)
+      expect(args.some(arg => arg.includes('-a "claude-code"'))).toBe(true)
+      expect(args.some(arg => arg.includes('-a "windsurf"'))).toBe(true)
+    })
+
+    it('should dedupe repeated agents when installing skill', async () => {
+      const { execSync } = await import('node:child_process')
+      testVol.writeFileSync(
+        resolve(process.cwd(), '.env.local'),
+        'agent=cursor, cursor, claude-code\n',
+        'utf-8',
+      )
+
+      const plugin = aiDoc({ installSkill: true })
+      const outputPath = 'src/api-skill-dedupe'
+      plugin.config?.({ config: { output: outputPath } as any, projectPath: process.cwd(), reportProgress: vi.fn() })
+
+      const apiTest = {
+        tag: 'test',
+        method: 'GET',
+        summary: 'Test',
+        path: '/test',
+        name: 'testApi',
+        response: 'void',
+        pathKey: 'test.testApi',
+        pathParameters: '',
+        queryParameters: '',
+        callingCode: '',
+      }
+      const data: any = {
+        title: 'Skill Dedupe Test',
+        version: '1.0.0',
+        openapi: '3.0.1',
+        baseUrl: '/api',
+        allApis: [apiTest],
+        components: [],
+        componentNames: [],
+        type: 'typescript',
+        config: {},
+        tagedApis: [
+          {
+            tagName: 'test',
+            apis: [apiTest],
+          },
+        ],
+      }
+
+      await plugin.codeGenerated?.({
+        config: {} as any,
+        data,
+        filePaths: [],
+        outputDir: resolve(process.cwd(), outputPath),
+        projectPath: process.cwd(),
+        reportProgress: vi.fn(),
+        renderTemplate: renderTemplateFn,
+      })
+
+      const calls = (execSync as ReturnType<typeof vi.fn>).mock.calls
+      expect(calls.length).toBe(2)
+      const args = calls.map(c => c[0] as string)
+      expect(args.filter(arg => arg.includes('-a "cursor"')).length).toBe(1)
+      expect(args.some(arg => arg.includes('-a "claude-code"'))).toBe(true)
+    })
+
+    it('should install skill into agents separated by a Chinese comma', async () => {
+      const { execSync } = await import('node:child_process')
+      testVol.writeFileSync(
+        resolve(process.cwd(), '.env.local'),
+        'agent=cursor，claude-code\n',
+        'utf-8',
+      )
+
+      const plugin = aiDoc({ installSkill: true })
+      const outputPath = 'src/api-skill-cn-comma'
+      plugin.config?.({ config: { output: outputPath } as any, projectPath: process.cwd(), reportProgress: vi.fn() })
+
+      const apiTest = {
+        tag: 'test',
+        method: 'GET',
+        summary: 'Test',
+        path: '/test',
+        name: 'testApi',
+        response: 'void',
+        pathKey: 'test.testApi',
+        pathParameters: '',
+        queryParameters: '',
+        callingCode: '',
+      }
+      const data: any = {
+        title: 'Skill Cn Comma Test',
+        version: '1.0.0',
+        openapi: '3.0.1',
+        baseUrl: '/api',
+        allApis: [apiTest],
+        components: [],
+        componentNames: [],
+        type: 'typescript',
+        config: {},
+        tagedApis: [
+          {
+            tagName: 'test',
+            apis: [apiTest],
+          },
+        ],
+      }
+
+      await plugin.codeGenerated?.({
+        config: {} as any,
+        data,
+        filePaths: [],
+        outputDir: resolve(process.cwd(), outputPath),
+        projectPath: process.cwd(),
+        reportProgress: vi.fn(),
+        renderTemplate: renderTemplateFn,
+      })
+
+      const calls = (execSync as ReturnType<typeof vi.fn>).mock.calls
+      expect(calls.length).toBe(2)
+      const args = calls.map(c => c[0] as string)
+      expect(args.some(arg => arg.includes('-a "cursor"'))).toBe(true)
+      expect(args.some(arg => arg.includes('-a "claude-code"'))).toBe(true)
+    })
+
     it('should throw via logger when skills CLI fails', async () => {
       const { execSync } = await import('node:child_process')
       const throwErrorSpy = vi.spyOn(logger, 'throwError').mockReturnValue(new Error('mock install failed'))

From 964e14c73ac6b62f8474ff12e817ec7a48188c6b Mon Sep 17 00:00:00 2001
From: Scott Hu <hujou555@gmail.com>
Date: Thu, 9 Jul 2026 09:56:25 +0000
Subject: [PATCH 4/4] fix: regenerate vscode-extension typings and fix e2e
 fixture lockfile

- wormajs: re-export Api, ApiDoc, CacheData from package root

- vscode-extension: regenerate typings/handlers.d.ts from current source

- e2e: use --no-frozen-lockfile for runtime fixtures

Also: docs/website content updates, migration guides, and example bumps.
---
 AGENT.md                                      |  25 +
 README.md                                     |   2 +-
 docs/content/docs/index.mdx                   |   8 +
 .../from-alova.mdx}                           | 245 +++---
 docs/content/docs/migration/from-axios.mdx    | 105 +++
 docs/content/docs/migration/from-ky.mdx       | 113 +++
 docs/content/docs/migration/meta.json         |   8 +
 examples/commonjs/package.json                |   2 +-
 examples/commonjs/petstore.json               | 708 ++++++++++++------
 examples/esm/package.json                     |   2 +-
 examples/monorepo/package.json                |  34 +-
 examples/typescript/package.json              |   2 +-
 packages/vscode-extension/e2e/index.ts        |   6 +-
 .../vscode-extension/typings/handlers.d.ts    |  46 +-
 packages/worma/src/index.ts                   |   2 +-
 packages/worma/typings/plugins.d.ts           |   8 +
 pnpm-lock.yaml                                | 131 ++--
 worm-guidelines/SKILL.md                      | 109 +--
 18 files changed, 1054 insertions(+), 502 deletions(-)
 rename docs/content/docs/{migration.mdx => migration/from-alova.mdx} (94%)
 create mode 100644 docs/content/docs/migration/from-axios.mdx
 create mode 100644 docs/content/docs/migration/from-ky.mdx
 create mode 100644 docs/content/docs/migration/meta.json

diff --git a/AGENT.md b/AGENT.md
index 1dd239e0..c1f23778 100644
--- a/AGENT.md
+++ b/AGENT.md
@@ -8,3 +8,28 @@ When developing new features or modifying existing features, always update the f
 2. `worma@2规格说明.md` — Specification document, you will mark to `finish` after the feature is implemented
 
 This ensures documentation stays in sync with the implementation and serves as the source of truth for design decisions.
+
+## CI / pnpm-lockfile Fragility (e2e)
+
+The e2e tests (`packages/vscode-extension/e2e/index.ts`) copy `examples/{commonjs,esm,typescript}`
+into `e2e-fixtures-temp/*` at runtime, then run a nested `pnpm i`. Because
+`e2e-fixtures-temp/*` is a workspace member (`pnpm-workspace.yaml`), that nested install
+reuses the root `pnpm-lock.yaml` with `frozen-lockfile` (CI default) and checks every
+workspace member against it.
+
+`examples/*` may use explicit versions (e.g. `axios: ^1.17.0`), but the committed
+`pnpm-lock.yaml` records these fixtures with `catalog:` specifiers. Any drift between the
+two triggers `ERR_PNPM_OUTDATED_LOCKFILE` in CI.
+
+**Rules to avoid breaking e2e CI:**
+
+- If you change dependency versions in `examples/{commonjs,esm,typescript}/package.json`,
+  you MUST regenerate the lockfile so `e2e-fixtures-temp/*` entries match (generate the
+  fixtures locally, run `pnpm install`, commit `pnpm-lock.yaml`).
+- If you add/change an action's `fixtures.js` to declare a new example fixture not yet in
+  the lockfile, regenerate and commit `pnpm-lock.yaml` for it.
+- Do NOT commit `e2e-fixtures-temp/` itself — it is gitignored and generated at runtime.
+
+**Root cause / durable fix (not yet applied):** make the e2e harness write fixture
+dependencies as `catalog:` so they decouple from `examples/*` explicit versions and the
+lockfile never needs resyncing.
diff --git a/README.md b/README.md
index 060c2bb9..ef979c2a 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,7 @@ npx worma gen
 
 - [Full Documentation](https://worma.js.org)
 - [Quick Start Guide](https://worma.js.org/docs/quick-start)
-- [Migration from @alova/wormhole](https://worma.js.org/docs/migration)
+- [Migration from @alova/wormhole](https://worma.js.org/docs/migration/from-alova)
 - [Plugin System](https://worma.js.org/docs/plugin-system)
 
 ## Changelog
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index bda8860a..e1514d2d 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -94,6 +94,14 @@ skills add alovajs/skills --skill worma-guidelines
 
 安装完成后，AI 即可理解 worma 的配置方式和使用命令。
 
+## 从现有方案迁移
+
+worma 兼容多种请求库，可与你当前的技术栈平滑衔接：
+
+- 正在手动调用 axios？参考 [从 Axios 迁移](/docs/migration/from-axios)
+- 正在手动调用 ky？参考 [从 Ky 迁移](/docs/migration/from-ky)
+- 正在使用 `@alova/wormhole`？参考 [从 wormhole 迁移](/docs/migration/from-alova)
+
 ---
 
 [快速开始](/docs/quick-start)，5 分钟即可完成接入。
diff --git a/docs/content/docs/migration.mdx b/docs/content/docs/migration/from-alova.mdx
similarity index 94%
rename from docs/content/docs/migration.mdx
rename to docs/content/docs/migration/from-alova.mdx
index 58825c9e..aa3a03a3 100644
--- a/docs/content/docs/migration.mdx
+++ b/docs/content/docs/migration/from-alova.mdx
@@ -1,119 +1,126 @@
----
-title: 从 wormhole 迁移
-description: "@alova/wormhole 迁移到 worma 的完整指南"
----
-
-worma 是从 `@alova/wormhole` 中独立出来、并重新进行通用化设计的 OpenAPI 代码生成工具。不再局限于 alova 请求库，新增 axios、fetch、ky 等多套模板，支持自定义模板和更完善的插件系统。
-
-## AI 自动迁移
-
-安装 worma Skill。
-
-```bash
-skills add alovajs/skills --skill worma-guidelines
-```
-
-然后在 AI 对话中输入以下提示词即可自动完成迁移：
-
-```text
-请将此项目从@alova/wormhole迁移到worma
-```
-
-## 包名与安装
-
-| 项目     | @alova/wormhole                 | worma                 |
-| -------- | ------------------------------- | --------------------- |
-| npm 包名 | `@alova/wormhole`               | `wormajs`             |
-| 安装命令 | `npm i @alova/wormhole -D`      | `npm i wormajs -D`    |
-| 入口引用 | `from '@alova/wormhole'`        | `from 'wormajs'`      |
-| 插件引用 | `from '@alova/wormhole/plugin'` | `from 'wormajs/plugin'` |
-
-## 配置文件
-
-将 `alova.config.{js,ts}` 重命名为 `worma.config.{js,ts}` 即可，`defineConfig` 用法保持一致。worma 新增了 `.wormarc` 简易配置支持。
-
-## CLI 命令
-
-| 项目           | @alova/wormhole   | worma               |
-| -------------- | ----------------- | ------------------- |
-| 初始化         | `alova init`      | `worma init`        |
-| 生成           | `alova gen`       | `worma gen`         |
-| 指定项目       | `-c, --cwd`       | `-p, --project`     |
-| Workspace 模式 | `-w, --workspace` | 默认行为，无需 flag |
-| 详细日志       | `--verbose`       | `-d, --debug`       |
-
-## 模板迁移：默认模式 → `plugins`
-
-`@alova/wormhole` 默认使用 alovaGlobals 模板（全局挂载），无需在配置中指定。worma 必须通过 `plugins` 数组显式选择模板：
-
-```javascript
-// @alova/wormhole（默认 alovaGlobals，无需配置）
-export default defineConfig({
-  generator: [{
-    input: 'https://api.example.com/openapi.json',
-    output: 'src/api',
-  }],
-});
-
-// worma（需显式指定）
-import { alovaGlobals } from 'wormajs/plugin';
-
-export default defineConfig({
-  generator: [{
-    input: 'https://api.example.com/openapi.json',
-    output: 'src/api',
-    plugins: [alovaGlobals()],
-  }],
-});
-```
-
-worma 还新增了 `alova`（按需引入）、`axios`、`fetch`、`ky` 等多套模板可选，详见 [预定义模板](/docs/template-system/predefined-templates)。
-
-## platform 配置 → 插件
-
-`@alova/wormhole` 的 `platform` 配置项在 worma 中改为 `platform` 插件：
-
-```javascript
-// @alova/wormhole
-defineConfig({
-  generator: [
-    {
-      input: "https://api.example.com",
-      platform: "swagger",
-    },
-  ],
-});
-
-// worma
-import { platform } from "wormajs/plugin";
-
-defineConfig({
-  generator: [
-    {
-      input: "https://api.example.com",
-      plugins: [platform("swagger")],
-    },
-  ],
-});
-```
-
-## 已移除的配置项
-
-| @alova/wormhole 配置项 | 说明                           |
-| ---------------------- | ------------------------------ |
-| `fileNameCase`         | 已移除，无替代方案             |
-| `autoUpdate`（根配置） | 已移除，由 VSCode 扩展自行管理 |
-| `platform` 参数        | 改为 `platform` 插件           |
-
-## 其他变更
-
-- alova 模板仅支持 **alova@3**，不再支持 alova@2
-
-## 迁移检查清单
-
-1. 卸载 `@alova/wormhole`，安装 `wormajs`
-2. 重命名配置文件：`alova.config.{js,ts}` → `worma.config.{js,ts}`
-3. 更新 import 路径：`@alova/wormhole` → `wormajs`，`@alova/wormhole/plugin` → `wormajs/plugin`
-4. 添加模板插件到 `plugins` 数组（如 `alovaGlobals()`）
-5. `platform` 参数改为 `platform` 插件
-6. CLI 参数 `-c, --cwd` → `-p, --project`
+---
+title: 从 wormhole 迁移
+description: "@alova/wormhole 迁移到 worma 的完整指南"
+---
+
+worma 是从 `@alova/wormhole` 中独立出来、并重新进行通用化设计的 OpenAPI 代码生成工具。不再局限于 alova 请求库，新增 axios、fetch、ky 等多套模板，支持自定义模板和更完善的插件系统。
+
+## AI 自动迁移
+
+安装 worma Skill。
+
+```bash
+skills add alovajs/skills --skill worma-guidelines
+```
+
+然后在 AI 对话中输入以下提示词即可自动完成迁移：
+
+```text
+请将此项目从@alova/wormhole迁移到worma
+```
+
+## 包名与安装
+
+| 项目     | @alova/wormhole                 | worma                 |
+| -------- | ------------------------------- | --------------------- |
+| npm 包名 | `@alova/wormhole`               | `wormajs`             |
+| 安装命令 | `npm i @alova/wormhole -D`      | `npm i wormajs -D`    |
+| 入口引用 | `from '@alova/wormhole'`        | `from 'wormajs'`      |
+| 插件引用 | `from '@alova/wormhole/plugin'` | `from 'wormajs/plugin'` |
+
+## 配置文件
+
+将 `alova.config.{js,ts}` 重命名为 `worma.config.{js,ts}` 即可，`defineConfig` 用法保持一致。worma 新增了 `.wormarc` 简易配置支持。
+
+## CLI 命令
+
+| 项目           | @alova/wormhole   | worma               |
+| -------------- | ----------------- | ------------------- |
+| 初始化         | `alova init`      | `worma init`        |
+| 生成           | `alova gen`       | `worma gen`         |
+| 指定项目       | `-c, --cwd`       | `-p, --project`     |
+| Workspace 模式 | `-w, --workspace` | 默认行为，无需 flag |
+| 详细日志       | `--verbose`       | `-d, --debug`       |
+
+## 模板迁移：默认模式 → `plugins`
+
+`@alova/wormhole` 默认使用 alovaGlobals 模板（全局挂载），无需在配置中指定。worma 必须通过 `plugins` 数组显式选择模板：
+
+```javascript
+// @alova/wormhole（默认 alovaGlobals，无需配置）
+export default defineConfig({
+  generator: [{
+    input: 'https://api.example.com/openapi.json',
+    output: 'src/api',
+  }],
+});
+
+// worma（需显式指定）
+import { alovaGlobals } from 'wormajs/plugin';
+
+export default defineConfig({
+  generator: [{
+    input: 'https://api.example.com/openapi.json',
+    output: 'src/api',
+    plugins: [alovaGlobals()],
+  }],
+});
+```
+
+worma 还新增了 `alova`（按需引入）、`axios`、`fetch`、`ky` 等多套模板可选，详见 [预定义模板](/docs/template-system/predefined-templates)。
+
+## platform 配置 → 插件
+
+`@alova/wormhole` 的 `platform` 配置项在 worma 中改为 `platform` 插件：
+
+```javascript
+// @alova/wormhole
+defineConfig({
+  generator: [
+    {
+      input: "https://api.example.com",
+      platform: "swagger",
+    },
+  ],
+});
+
+// worma
+import { platform } from "wormajs/plugin";
+
+defineConfig({
+  generator: [
+    {
+      input: "https://api.example.com",
+      plugins: [platform("swagger")],
+    },
+  ],
+});
+```
+
+## 已移除的配置项
+
+| @alova/wormhole 配置项 | 说明                           |
+| ---------------------- | ------------------------------ |
+| `fileNameCase`         | 已移除，无替代方案             |
+| `autoUpdate`（根配置） | 已移除，由 VSCode 扩展自行管理 |
+| `platform` 参数        | 改为 `platform` 插件           |
+
+## 其他变更
+
+- alova 模板仅支持 **alova@3**，不再支持 alova@2
+
+## 迁移检查清单
+
+1. 卸载 `@alova/wormhole`，安装 `wormajs`
+2. 重命名配置文件：`alova.config.{js,ts}` → `worma.config.{js,ts}`
+3. 更新 import 路径：`@alova/wormhole` → `wormajs`，`@alova/wormhole/plugin` → `wormajs/plugin`
+4. 添加模板插件到 `plugins` 数组（如 `alovaGlobals()`）
+5. `platform` 参数改为 `platform` 插件
+6. CLI 参数 `-c, --cwd` → `-p, --project`
+
+## 其他来源迁移
+
+如果你当前直接使用 axios、ky 等请求库手写接口调用，可参考对应的迁移指南：
+
+- [从 Axios 迁移](/docs/migration/from-axios)
+- [从 Ky 迁移](/docs/migration/from-ky)
diff --git a/docs/content/docs/migration/from-axios.mdx b/docs/content/docs/migration/from-axios.mdx
new file mode 100644
index 00000000..6d7b0aeb
--- /dev/null
+++ b/docs/content/docs/migration/from-axios.mdx
@@ -0,0 +1,105 @@
+---
+title: 从 Axios 迁移
+description: 从手动调用 axios 迁移到 worma 生成的类型安全调用代码
+---
+
+如果你的项目当前直接使用 axios 手写接口调用（拼接 URL、手动维护请求/响应类型），可以借助 worma 从 OpenAPI 规范生成类型安全的调用代码。**底层依然是标准 axios，因此兼容性极好，你原有的 axios 请求可以完全保留，无需一次性迁移。**
+
+## 迁移前：手写 axios 调用
+
+```typescript
+import axios from 'axios';
+
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+const res = await axios.get<User>('/api/users', {
+  params: { page: 1, size: 10 },
+});
+const users = res.data;
+
+const created = await axios
+  .post<User>('/api/users', { name: 'Alice', email: 'alice@example.com' })
+  .then((r) => r.data);
+```
+
+## 迁移步骤
+
+### 1. 使用 init 创建配置文件
+
+```bash
+npx worma init --template axios
+```
+
+该命令会在项目根目录生成 `worma.config.ts`（或 `.js`），已默认选用 axios 模板。也可以不传 `--template`，在交互式菜单中选择 axios。
+
+### 2. 使用 gen 生成调用代码
+
+```bash
+npx worma gen
+```
+
+生成结果位于 `src/api/axios/` 下，每个 API 作为独立函数导出，支持 Tree-shaking：
+
+<Files>
+  <Folder name="axios" defaultOpen>
+    <File name="index.ts" />
+    <File name="helper.ts" />
+    <File name="components.d.ts" />
+    <Folder name="services" defaultOpen>
+      <File name="user.ts" />
+    </Folder>
+  </Folder>
+</Files>
+
+其中 `index.ts` 会创建一个默认的 `axiosInstance`：
+
+```typescript
+// src/api/axios/index.ts
+import axios from 'axios';
+
+export const axiosInstance = axios.create({
+  baseURL: 'https://api.example.com',
+});
+```
+
+### 3. 替换实例（唯一需要修改的地方）
+
+迁移非常简单：**只需从你已有的 axios 实例文件导入实例，在生成的 `index.ts` 中同名导出即可，其他文件无需任何修改。**
+
+```typescript
+// src/api/axios/index.ts
+// 从你已有的 axios 实例文件导入，并同名（axiosInstance）导出
+export { myAxios as axiosInstance } from '@/lib/request';
+```
+
+> `@/lib/request` 即你项目中已配置好拦截器、baseURL 等的 axios 实例文件，`myAxios` 为其导出名。这样 `services` 中引用的 `axiosInstance` 直接指向你的实例，无需改动任何其它文件。
+
+## 兼容性说明
+
+worma 生成的调用代码底层就是标准 axios，因此**兼容性极好，你原有的 axios 请求可以完全保留，可逐步迁移**——将手写调用替换为生成的类型安全函数，与原有 `axios.get/post` 调用并行不冲突。
+
+## 替换手写调用
+
+```typescript
+// 迁移后：函数名、参数、返回类型均由 OpenAPI 自动推导
+import { getUserList, createUser } from './api/axios/services/user';
+
+const users = await getUserList({ params: { page: 1, size: 10 } });
+
+const created = await createUser({
+  data: { name: 'Alice', email: 'alice@example.com' },
+});
+```
+
+`data` 对应请求体、`params` 对应查询参数、`pathParams` 对应路径参数，与原生 axios 配置项语义一致。生成的函数同样接受原生 axios 请求配置（如 `timeout`、`headers`、`signal` 等）。
+
+## 迁移检查清单
+
+1. 运行 `worma init --template axios` 生成配置文件
+2. 运行 `worma gen` 生成 `src/api/axios/`
+3. 将 `index.ts` 中的默认 `axiosInstance` 替换为你的现有实例并导出（其余文件无需改动）
+4. 按需将手写 `axios.get/post` 调用替换为生成的类型安全函数
diff --git a/docs/content/docs/migration/from-ky.mdx b/docs/content/docs/migration/from-ky.mdx
new file mode 100644
index 00000000..97617cbf
--- /dev/null
+++ b/docs/content/docs/migration/from-ky.mdx
@@ -0,0 +1,113 @@
+---
+title: 从 Ky 迁移
+description: 从手动调用 ky 迁移到 worma 生成的类型安全调用代码
+---
+
+如果你的项目当前直接使用 [ky](https://github.com/sindresorhus/ky) 手写接口调用，可以借助 worma 从 OpenAPI 规范生成类型安全的调用代码。**底层依然是标准 ky，因此兼容性极好，你原有的 ky 请求可以完全保留，无需一次性迁移。**
+
+## 迁移前：手写 ky 调用
+
+```typescript
+import ky from 'ky';
+
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+const users = await ky
+  .get('api/users', { searchParams: { page: 1, size: 10 } })
+  .json<User>();
+
+const created = await ky
+  .post('api/users', { json: { name: 'Alice', email: 'alice@example.com' } })
+  .json<User>();
+```
+
+## 迁移步骤
+
+### 1. 使用 init 创建配置文件
+
+```bash
+npx worma init --template ky
+```
+
+该命令会在项目根目录生成 `worma.config.ts`（或 `.js`），已默认选用 ky 模板。也可以不传 `--template`，在交互式菜单中选择 ky。
+
+### 2. 使用 gen 生成调用代码
+
+```bash
+npx worma gen
+```
+
+生成结果位于 `src/api/ky/` 下，每个 API 作为独立函数导出，支持 Tree-shaking：
+
+<Files>
+  <Folder name="ky" defaultOpen>
+    <File name="index.ts" />
+    <File name="helper.ts" />
+    <File name="components.d.ts" />
+    <Folder name="services" defaultOpen>
+      <File name="user.ts" />
+    </Folder>
+  </Folder>
+</Files>
+
+其中 `index.ts` 会创建一个默认的 `kyInstance`：
+
+```typescript
+// src/api/ky/index.ts
+import ky from 'ky';
+
+export const kyInstance = ky.create({
+  prefix: 'https://api.example.com/',
+});
+```
+
+### 3. 替换实例（唯一需要修改的地方）
+
+迁移非常简单：**只需从你已有的 ky 实例文件导入实例，在生成的 `index.ts` 中同名导出即可，其他文件无需任何修改。**
+
+```typescript
+// src/api/ky/index.ts
+// 从你已有的 ky 实例文件导入，并同名（kyInstance）导出
+export { myKy as kyInstance } from '@/lib/request';
+```
+
+> `@/lib/request` 即你项目中已配置好前缀、钩子等能力的 ky 实例文件，`myKy` 为其导出名。这样 `services` 中引用的 `kyInstance` 直接指向你的实例，无需改动任何其它文件。
+
+## 兼容性说明
+
+worma 生成的调用代码底层就是标准 ky，因此**兼容性极好，你原有的 ky 请求可以完全保留，可逐步迁移**——将手写调用替换为生成的类型安全函数，与原有 `ky.get/post` 调用并行不冲突。
+
+## 替换手写调用
+
+```typescript
+// 迁移后：无需 .json()，返回类型由 OpenAPI 自动推导
+import { getUserList, createUser } from './api/ky/services/user';
+
+const users = await getUserList({ params: { page: 1, size: 10 } });
+
+const created = await createUser({
+  data: { name: 'Alice', email: 'alice@example.com' },
+});
+```
+
+调用约定对照：
+
+| 手写 ky                          | worma 生成函数                    |
+| -------------------------------- | --------------------------------- |
+| `ky.get(url, { searchParams })`  | `fn({ params })`                  |
+| `ky.post(url, { json })`         | `fn({ data })`                    |
+| `ky.get(url, { searchParams: { id } })` | `fn({ pathParams: { id } })` |
+| `await ky.x().json<T>()`         | `await fn(...)` 直接返回 `T`      |
+
+生成的函数同样接受原生 ky 请求配置（如 `timeout`、`headers`、`retry`、`signal` 等）。
+
+## 迁移检查清单
+
+1. 运行 `worma init --template ky` 生成配置文件
+2. 运行 `worma gen` 生成 `src/api/ky/`
+3. 将 `index.ts` 中的默认 `kyInstance` 替换为你的现有实例并导出（其余文件无需改动）
+4. 按需将手写 `ky.get/post` 调用替换为生成的类型安全函数，并把 `searchParams` → `params`、`json` 请求体 → `data`
diff --git a/docs/content/docs/migration/meta.json b/docs/content/docs/migration/meta.json
new file mode 100644
index 00000000..7c9d498b
--- /dev/null
+++ b/docs/content/docs/migration/meta.json
@@ -0,0 +1,8 @@
+{
+  "pages": [
+    "from-axios",
+    "from-ky",
+    "from-alova"
+  ],
+  "title": "迁移指南"
+}
diff --git a/examples/commonjs/package.json b/examples/commonjs/package.json
index 91f394d4..13ce0055 100644
--- a/examples/commonjs/package.json
+++ b/examples/commonjs/package.json
@@ -5,7 +5,7 @@
   "description": "Worma CommonJS example - all templates for CJS projects",
   "scripts": {
     "gen": "worma gen -f",
-    "start": "node src/main.js"
+    "start": "npm run gen && node src/main.js"
   },
   "dependencies": {
     "alova": "^3.0.0",
diff --git a/examples/commonjs/petstore.json b/examples/commonjs/petstore.json
index 365154f1..a962bee8 100644
--- a/examples/commonjs/petstore.json
+++ b/examples/commonjs/petstore.json
@@ -1,210 +1,498 @@
-{
-  "openapi": "3.0.3",
-  "info": {
-    "title": "Petstore - OpenAPI 3.0",
-    "description": "A sample pet store API built with OpenAPI 3.0, demonstrating worma code generation capabilities across multiple templates.",
-    "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" },
-    "version": "1.0.0"
-  },
-  "servers": [{ "url": "https://petstore3.swagger.io/api/v3" }],
-  "tags": [
-    { "name": "pet", "description": "Everything about your Pets" },
-    { "name": "store", "description": "Access to Petstore orders" },
-    { "name": "user", "description": "Operations about user" }
-  ],
-  "paths": {
-    "/pet": {
-      "post": {
-        "tags": ["pet"],
-        "summary": "Add a new pet to the store",
-        "operationId": "addPet",
-        "requestBody": {
-          "description": "Create a new pet in the store",
-          "required": true,
-          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pet" } } }
-        },
-        "responses": {
-          "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pet" } } } },
-          "405": { "description": "Invalid input" }
-        }
-      },
-      "put": {
-        "tags": ["pet"],
-        "summary": "Update an existing pet",
-        "operationId": "updatePet2",
-        "requestBody": {
-          "description": "Update an existent pet in the store",
-          "required": true,
-          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pet" } } }
-        },
-        "responses": {
-          "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pet" } } } },
-          "400": { "description": "Invalid ID supplied" },
-          "404": { "description": "Pet not found" },
-          "405": { "description": "Validation exception" }
-        }
-      }
-    },
-    "/pet/findByStatus": {
-      "get": {
-        "tags": ["pet"],
-        "summary": "Finds Pets by status",
-        "operationId": "findPetsByStatus",
-        "parameters": [
-          {
-            "name": "status",
-            "in": "query",
-            "description": "Status values to filter by",
-            "required": true,
-            "explode": true,
-            "schema": { "type": "string", "enum": ["available", "pending", "sold"] }
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "successful operation",
-            "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Pet" } } } }
-          },
-          "400": { "description": "Invalid status value" }
-        }
-      }
-    },
-    "/pet/{petId}": {
-      "get": {
-        "tags": ["pet"],
-        "summary": "Find pet by ID",
-        "operationId": "getPetById",
-        "parameters": [
-          { "name": "petId", "in": "path", "description": "ID of pet to return", "required": true, "schema": { "type": "integer", "format": "int64" } }
-        ],
-        "responses": {
-          "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pet" } } } },
-          "400": { "description": "Invalid ID supplied" },
-          "404": { "description": "Pet not found" }
-        }
-      },
-      "delete": {
-        "tags": ["pet"],
-        "summary": "Deletes a pet",
-        "operationId": "deletePet",
-        "parameters": [
-          { "name": "petId", "in": "path", "description": "Pet id to delete", "required": true, "schema": { "type": "integer", "format": "int64" } },
-          { "name": "api_key", "in": "header", "required": false, "schema": { "type": "string" } }
-        ],
-        "responses": {
-          "204": { "description": "Deleted successfully" },
-          "400": { "description": "Invalid pet value" }
-        }
-      }
-    },
-    "/store/inventory": {
-      "get": {
-        "tags": ["store"],
-        "summary": "Returns pet inventories by status",
-        "operationId": "getInventory",
-        "responses": {
-          "200": {
-            "description": "successful operation",
-            "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "integer", "format": "int32" } } } }
-          }
-        }
-      }
-    },
-    "/store/order": {
-      "post": {
-        "tags": ["store"],
-        "summary": "Place an order for a pet",
-        "operationId": "placeOrder",
-        "requestBody": {
-          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Order" } } }
-        },
-        "responses": {
-          "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Order" } } } },
-          "405": { "description": "Invalid input" }
-        }
-      }
-    },
-    "/store/order/{orderId}": {
-      "get": {
-        "tags": ["store"],
-        "summary": "Find purchase order by ID",
-        "operationId": "getOrderById",
-        "parameters": [
-          { "name": "orderId", "in": "path", "description": "ID of order to return", "required": true, "schema": { "type": "integer", "format": "int64" } }
-        ],
-        "responses": {
-          "200": { "description": "successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Order" } } } },
-          "400": { "description": "Invalid ID supplied" },
-          "404": { "description": "Order not found" }
-        }
-      }
-    },
-    "/store/order/{orderId}/cancel": {
-      "post": {
-        "tags": ["store"],
-        "summary": "Cancel purchase order by ID",
-        "operationId": "cancelOrder",
-        "parameters": [
-          { "name": "orderId", "in": "path", "required": true, "schema": { "type": "integer", "format": "int64" } }
-        ],
-        "responses": { "204": { "description": "Cancelled successfully" } }
-      }
-    },
-    "/user/login": {
-      "get": {
-        "tags": ["user"],
-        "summary": "Logs user into the system",
-        "operationId": "loginUser",
-        "parameters": [
-          { "name": "username", "in": "query", "required": false, "schema": { "type": "string" } },
-          { "name": "password", "in": "query", "required": false, "schema": { "type": "string" } }
-        ],
-        "responses": {
-          "200": { "description": "successful operation", "content": { "application/json": { "schema": { "type": "string" } } } },
-          "400": { "description": "Invalid username/password supplied" }
-        }
-      }
-    }
-  },
-  "components": {
-    "schemas": {
-      "Pet": {
-        "required": ["name", "photoUrls"],
-        "type": "object",
-        "properties": {
-          "id": { "type": "integer", "format": "int64", "example": 10 },
-          "name": { "type": "string", "example": "doggie" },
-          "category": { "$ref": "#/components/schemas/Category" },
-          "photoUrls": { "type": "array", "items": { "type": "string", "format": "uri" } },
-          "tags": { "type": "array", "items": { "$ref": "#/components/schemas/Tag" } },
-          "status": { "type": "string", "description": "pet status in the store", "enum": ["available", "pending", "sold"] }
-        }
-      },
-      "Category": {
-        "type": "object",
-        "properties": {
-          "id": { "type": "integer", "format": "int64", "example": 1 },
-          "name": { "type": "string", "example": "Dogs" }
-        }
-      },
-      "Tag": {
-        "type": "object",
-        "properties": {
-          "id": { "type": "integer", "format": "int64" },
-          "name": { "type": "string" }
-        }
-      },
-      "Order": {
-        "type": "object",
-        "properties": {
-          "id": { "type": "integer", "format": "int64", "example": 10 },
-          "petId": { "type": "integer", "format": "int64", "example": 198772 },
-          "quantity": { "type": "integer", "format": "int32", "example": 7 },
-          "shipDate": { "type": "string", "format": "date-time" },
-          "status": { "type": "string", "description": "Order Status", "enum": ["placed", "approved", "delivered"] },
-          "complete": { "type": "boolean" }
-        }
-      }
-    }
-  }
-}
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Petstore - OpenAPI 3.0",
+    "description": "A sample pet store API built with OpenAPI 3.0, demonstrating worma code generation capabilities across multiple templates.",
+    "license": {
+      "name": "MIT",
+      "url": "https://opensource.org/licenses/MIT"
+    },
+    "version": "1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://petstore3.swagger.io/api/v3"
+    }
+  ],
+  "tags": [
+    {
+      "name": "pet",
+      "description": "Everything about your Pets"
+    },
+    {
+      "name": "store",
+      "description": "Access to Petstore orders"
+    },
+    {
+      "name": "user",
+      "description": "Operations about user"
+    }
+  ],
+  "paths": {
+    "/pet": {
+      "post": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Add a new pet to the store",
+        "operationId": "addPet",
+        "requestBody": {
+          "description": "Create a new pet in the store",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Pet"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "405": {
+            "description": "Invalid input"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Update an existing pet",
+        "operationId": "updatePet",
+        "requestBody": {
+          "description": "Update an existent pet in the store",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Pet"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          },
+          "405": {
+            "description": "Validation exception"
+          }
+        }
+      }
+    },
+    "/pet/findByStatus": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Finds Pets by status",
+        "operationId": "findPetsByStatus",
+        "parameters": [
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Status values to filter by",
+            "required": true,
+            "explode": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "available",
+                "pending",
+                "sold"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/Pet"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid status value"
+          }
+        }
+      }
+    },
+    "/pet/{petId}": {
+      "get": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Find pet by ID",
+        "operationId": "getPetById",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "ID of pet to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Pet"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Pet not found"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "pet"
+        ],
+        "summary": "Deletes a pet",
+        "operationId": "deletePet",
+        "parameters": [
+          {
+            "name": "petId",
+            "in": "path",
+            "description": "Pet id to delete",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          {
+            "name": "api_key",
+            "in": "header",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Deleted successfully"
+          },
+          "400": {
+            "description": "Invalid pet value"
+          }
+        }
+      }
+    },
+    "/store/inventory": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Returns pet inventories by status",
+        "operationId": "getInventory",
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "integer",
+                    "format": "int32"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/store/order": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Place an order for a pet",
+        "operationId": "placeOrder",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Order"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "405": {
+            "description": "Invalid input"
+          }
+        }
+      }
+    },
+    "/store/order/{orderId}": {
+      "get": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Find purchase order by ID",
+        "operationId": "getOrderById",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "description": "ID of order to return",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Order"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Order not found"
+          }
+        }
+      }
+    },
+    "/store/order/{orderId}/cancel": {
+      "post": {
+        "tags": [
+          "store"
+        ],
+        "summary": "Cancel purchase order by ID",
+        "operationId": "cancelOrder",
+        "parameters": [
+          {
+            "name": "orderId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Cancelled successfully"
+          }
+        }
+      }
+    },
+    "/user/login": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Logs user into the system",
+        "operationId": "loginUser",
+        "parameters": [
+          {
+            "name": "username",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "password",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid username/password supplied"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Pet": {
+        "required": [
+          "name",
+          "photoUrls"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64",
+            "example": 10
+          },
+          "name": {
+            "type": "string",
+            "example": "doggie"
+          },
+          "category": {
+            "$ref": "#/components/schemas/Category"
+          },
+          "photoUrls": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uri"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Tag"
+            }
+          },
+          "status": {
+            "type": "string",
+            "description": "pet status in the store",
+            "enum": [
+              "available",
+              "pending",
+              "sold"
+            ]
+          }
+        }
+      },
+      "Category": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64",
+            "example": 1
+          },
+          "name": {
+            "type": "string",
+            "example": "Dogs"
+          }
+        }
+      },
+      "Tag": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string"
+          }
+        }
+      },
+      "Order": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64",
+            "example": 10
+          },
+          "petId": {
+            "type": "integer",
+            "format": "int64",
+            "example": 198772
+          },
+          "quantity": {
+            "type": "integer",
+            "format": "int32",
+            "example": 7
+          },
+          "shipDate": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "description": "Order Status",
+            "enum": [
+              "placed",
+              "approved",
+              "delivered"
+            ]
+          },
+          "complete": {
+            "type": "boolean"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/examples/esm/package.json b/examples/esm/package.json
index 02562814..b84c331a 100644
--- a/examples/esm/package.json
+++ b/examples/esm/package.json
@@ -5,7 +5,7 @@
   "description": "Worma ESM example - all templates for ES Module projects",
   "scripts": {
     "gen": "worma gen -f",
-    "start": "node --experimental-specifier-resolution=node src/main.js"
+    "start": "npm run gen && node --experimental-specifier-resolution=node src/main.js"
   },
   "dependencies": {
     "alova": "^3.0.0",
diff --git a/examples/monorepo/package.json b/examples/monorepo/package.json
index db95e6ec..f83d0039 100644
--- a/examples/monorepo/package.json
+++ b/examples/monorepo/package.json
@@ -1,17 +1,17 @@
-{
-  "name": "worma-demo-esm-monorepo",
-  "type": "module",
-  "private": true,
-  "description": "Worma ESM monorepo example — each sub-package tests a single generator template",
-  "scripts": {
-    "gen:all": "pnpm -r exec worma gen -f",
-    "start:alova": "pnpm --filter alova-app start",
-    "start:axios": "pnpm --filter axios-app start",
-    "start:fetch": "pnpm --filter fetch-app start",
-    "start:ky": "pnpm --filter ky-app start",
-    "start": "pnpm start:alova && pnpm start:axios && pnpm start:fetch && pnpm start:ky"
-  },
-  "devDependencies": {
-    "wormajs": "catalog:"
-  }
-}
+{
+  "name": "worma-demo-esm-monorepo",
+  "type": "module",
+  "private": true,
+  "description": "Worma ESM monorepo example — each sub-package tests a single generator template",
+  "scripts": {
+    "gen:all": "pnpm -r exec worma gen -f",
+    "start:alova": "pnpm --filter alova-app start",
+    "start:axios": "pnpm --filter axios-app start",
+    "start:fetch": "pnpm --filter fetch-app start",
+    "start:ky": "pnpm --filter ky-app start",
+    "start": "npm run gen:all && pnpm start:alova && pnpm start:axios && pnpm start:fetch && pnpm start:ky"
+  },
+  "devDependencies": {
+    "wormajs": "catalog:"
+  }
+}
diff --git a/examples/typescript/package.json b/examples/typescript/package.json
index 23451078..82b71034 100644
--- a/examples/typescript/package.json
+++ b/examples/typescript/package.json
@@ -5,7 +5,7 @@
   "description": "Worma TypeScript example - all templates in one project",
   "scripts": {
     "gen": "worma gen -f",
-    "start": "tsx src/main.ts",
+    "start": "npm run gen && tsx src/main.ts",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
diff --git a/packages/vscode-extension/e2e/index.ts b/packages/vscode-extension/e2e/index.ts
index a5a959a0..2d70e3d4 100644
--- a/packages/vscode-extension/e2e/index.ts
+++ b/packages/vscode-extension/e2e/index.ts
@@ -75,7 +75,11 @@ async function main() {
         await fs.writeJson(pkgFile, pkg, { spaces: 2 })
     }
 
-    await run('pnpm i', { cwd: fixtureTargetPath })
+    // These fixtures are generated at runtime (gitignored) and are NOT present
+    // in the committed `pnpm-lock.yaml`, so a frozen-lockfile install (the CI
+    // default in pnpm 10) fails with ERR_PNPM_OUTDATED_LOCKFILE. Allow the
+    // lockfile to be updated for the temporary fixture install.
+    await run('pnpm i --no-frozen-lockfile', { cwd: fixtureTargetPath })
     installed.add(example)
   }
 
diff --git a/packages/vscode-extension/typings/handlers.d.ts b/packages/vscode-extension/typings/handlers.d.ts
index 52a67de9..27eb4611 100644
--- a/packages/vscode-extension/typings/handlers.d.ts
+++ b/packages/vscode-extension/typings/handlers.d.ts
@@ -1,25 +1,37 @@
 import type { Publisher } from '@jsonrpc-rx/server'
 import type { ExtensionContext, TextDocument } from 'vscode'
 
-export type { Api, ApiDoc, CacheData } from 'wormajs'
-
-export interface ApiWithSource extends Api {
-  serverName: string
-  serverPath: string
-  projectName: string
-  serverIndex: number
-}
-
-export interface ApiRef {
-  uniqueKey: string
-  serverName: string
-  serverPath: string
+export interface Api {
+  tag: string
   method: string
-  path: string
   summary: string
-  targetKey: string
+  path: string
+  pathParameters: string
+  queryParameters: string
+  pathParametersComment?: string
+  queryParametersComment?: string
+  responseComment?: string
+  requestBodyComment?: string
+  name: string
+  response: string
+  requestBody?: string
+  callingCode?: string
+}
+export interface ApiDoc {
+  apis: Api[]
+  tagName: string
+}
+/**
+ * Standardized cache data for VSCode extension
+ * Used for rendering sidebar API tree and quick search
+ */
+export interface CacheData {
+  path: string
+  /** Server name displayed in sidebar */
+  serverName?: string
+  /** All APIs as a flat array */
+  apis: Api[]
 }
-
 declare function getApiDocs(): Promise<{
   name: string
   servers: CacheData[]
@@ -51,3 +63,5 @@ export declare function getHandlers(context: ExtensionContext): {
   execCommand: (command: string, ...rest: any[]) => Promise<unknown>
   onDidOpenTextDocument: import('@jsonrpc-rx/server').Observable<({ next }: Publisher<TextDocument>) => () => any>
 }
+
+export {}
diff --git a/packages/worma/src/index.ts b/packages/worma/src/index.ts
index 71e7d5fc..b7a07281 100644
--- a/packages/worma/src/index.ts
+++ b/packages/worma/src/index.ts
@@ -5,4 +5,4 @@ export { default as generate } from './generate'
 export { logger } from './helper'
 export * from './readConfig'
 export { default as resolveWorkspaces } from './resolveWorkspaces'
-export type { CacheData } from './type/lib'
+export type { Api, ApiDoc, CacheData } from './type/lib'
diff --git a/packages/worma/typings/plugins.d.ts b/packages/worma/typings/plugins.d.ts
index d7b30682..2a63b4b4 100644
--- a/packages/worma/typings/plugins.d.ts
+++ b/packages/worma/typings/plugins.d.ts
@@ -426,6 +426,14 @@ export interface AiDocConfig {
 	installSkill?: boolean;
 }
 export declare function aiDoc(config?: AiDocConfig): ApiPlugin;
+/**
+ * Parse an agent string into a deduplicated list of trimmed agent names.
+ *
+ * Agents may be separated by either an English comma (`,`) or a Chinese
+ * comma (`，`), with any amount of whitespace (including none) allowed on
+ * either side. Empty entries are ignored.
+ */
+export declare function parseAgentList(raw: string): string[];
 export type ScopeType = "ALL" | "SELECTED_ENDPOINTS" | "SELECTED_TAGS" | "SELECTED_FOLDERS";
 export interface APIFoxBody {
 	scope?: {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 3cc1984d..9f26e9fb 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -628,6 +628,57 @@ importers:
         specifier: ^6.0.3
         version: 6.0.3
 
+  e2e-fixtures-temp/commonjs:
+    dependencies:
+      alova:
+        specifier: ^3.0.0
+        version: 3.3.4
+      axios:
+        specifier: ^1.17.0
+        version: 1.17.0
+    devDependencies:
+      wormajs:
+        specifier: workspace:*
+        version: link:../../packages/worma
+
+  e2e-fixtures-temp/esm:
+    dependencies:
+      alova:
+        specifier: ^3.0.0
+        version: 3.3.4
+      axios:
+        specifier: ^1.17.0
+        version: 1.17.0
+      ky:
+        specifier: ^2.0.2
+        version: 2.0.2
+    devDependencies:
+      wormajs:
+        specifier: workspace:*
+        version: link:../../packages/worma
+
+  e2e-fixtures-temp/typescript:
+    dependencies:
+      alova:
+        specifier: ^3.0.0
+        version: 3.3.4
+      axios:
+        specifier: ^1.17.0
+        version: 1.17.0
+      ky:
+        specifier: ^2.0.2
+        version: 2.0.2
+    devDependencies:
+      tsx:
+        specifier: ^4.22.4
+        version: 4.22.4
+      typescript:
+        specifier: ^5.9.3
+        version: 5.9.3
+      wormajs:
+        specifier: workspace:*
+        version: link:../../packages/worma
+
   examples/commonjs:
     dependencies:
       alova:
@@ -2161,105 +2212,89 @@ packages:
     resolution: {integrity: sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-libvips-linux-arm@1.2.4':
     resolution: {integrity: sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==}
     cpu: [arm]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-libvips-linux-ppc64@1.2.4':
     resolution: {integrity: sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==}
     cpu: [ppc64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-libvips-linux-riscv64@1.2.4':
     resolution: {integrity: sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==}
     cpu: [riscv64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-libvips-linux-s390x@1.2.4':
     resolution: {integrity: sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==}
     cpu: [s390x]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-libvips-linux-x64@1.2.4':
     resolution: {integrity: sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-libvips-linuxmusl-arm64@1.2.4':
     resolution: {integrity: sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@img/sharp-libvips-linuxmusl-x64@1.2.4':
     resolution: {integrity: sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@img/sharp-linux-arm64@0.34.5':
     resolution: {integrity: sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-linux-arm@0.34.5':
     resolution: {integrity: sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-linux-ppc64@0.34.5':
     resolution: {integrity: sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [ppc64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-linux-riscv64@0.34.5':
     resolution: {integrity: sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [riscv64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-linux-s390x@0.34.5':
     resolution: {integrity: sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [s390x]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-linux-x64@0.34.5':
     resolution: {integrity: sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@img/sharp-linuxmusl-arm64@0.34.5':
     resolution: {integrity: sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@img/sharp-linuxmusl-x64@0.34.5':
     resolution: {integrity: sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==}
     engines: {node: ^18.17.0 || ^20.3.0 || >=21.0.0}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@img/sharp-wasm32@0.34.5':
     resolution: {integrity: sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==}
@@ -2520,28 +2555,24 @@ packages:
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@next/swc-linux-arm64-musl@16.2.7':
     resolution: {integrity: sha512-qyogG9QtBzWxgJfeGBvOEHI3851gTfCF3wLZ5RDLTBJGAmE9p1qDwKCOdrBrvBzRvYDT+gUDp72pzlSEfAXgNA==}
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@next/swc-linux-x64-gnu@16.2.7':
     resolution: {integrity: sha512-Vhe4ZDuBpmMogrGi5D4R2Kq4JAQlj6+wvgaFYy31zfES0zPmt6TLA+cuYpM/OLrPZjo2MYQTHVqNUSCR6+fDZQ==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@next/swc-linux-x64-musl@16.2.7':
     resolution: {integrity: sha512-srvian89JahFLw1YLBEuhvPJ0DO5lpUeJQMXy4xYo7g628ZlNgXdNkqoxSAv9OYrBfByh6vxISMwW/mRbzCY+g==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@next/swc-win32-arm64-msvc@16.2.7':
     resolution: {integrity: sha512-GX3wvLpULFuRFJzwHaKfm7QZJ18F4ZSuxlPJ96BoBglCzBmdSjyeBKF+ZhWhvL/ckxNfLnNa7bsObO2ipYpszw==}
@@ -2596,28 +2627,24 @@ packages:
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@node-rs/crc32-linux-arm64-musl@1.10.6':
     resolution: {integrity: sha512-k8ra/bmg0hwRrIEE8JL1p32WfaN9gDlUUpQRWsbxd1WhjqvXea7kKO6K4DwVxyxlPhBS9Gkb5Urq7Y4mXANzaw==}
     engines: {node: '>= 10'}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@node-rs/crc32-linux-x64-gnu@1.10.6':
     resolution: {integrity: sha512-IfjtqcuFK7JrSZ9mlAFhb83xgium30PguvRjIMI45C3FJwu18bnLk1oR619IYb/zetQT82MObgmqfKOtgemEKw==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@node-rs/crc32-linux-x64-musl@1.10.6':
     resolution: {integrity: sha512-LbFYsA5M9pNunOweSt6uhxenYQF94v3bHDAQRPTQ3rnjn+mK6IC7YTAYoBjvoJP8lVzcvk9hRj8wp4Jyh6Y80g==}
     engines: {node: '>= 10'}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@node-rs/crc32-wasm32-wasi@1.10.6':
     resolution: {integrity: sha512-KaejdLgHMPsRaxnM+OG9L9XdWL2TabNx80HLdsCOoX9BVhEkfh39OeahBo8lBmidylKbLGMQoGfIKDjq0YMStw==}
@@ -2727,56 +2754,48 @@ packages:
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@oxfmt/binding-linux-arm64-musl@0.35.0':
     resolution: {integrity: sha512-5Okqi+uhYFxwKz8hcnUftNNwdm8BCkf6GSCbcz9xJxYMm87k1E4p7PEmAAbhLTk7cjSdDre6TDL0pDzNX+Y22Q==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@oxfmt/binding-linux-ppc64-gnu@0.35.0':
     resolution: {integrity: sha512-9k66pbZQXM/lBJWys3Xbc5yhl4JexyfqkEf/tvtq8976VIJnLAAL3M127xHA3ifYSqxdVHfVGTg84eiBHCGcNw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ppc64]
     os: [linux]
-    libc: [glibc]
 
   '@oxfmt/binding-linux-riscv64-gnu@0.35.0':
     resolution: {integrity: sha512-aUcY9ofKPtjO52idT6t0SAQvEF6ctjzUQa1lLp7GDsRpSBvuTrBQGeq0rYKz3gN8dMIQ7mtMdGD9tT4LhR8jAQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
-    libc: [glibc]
 
   '@oxfmt/binding-linux-riscv64-musl@0.35.0':
     resolution: {integrity: sha512-C6yhY5Hvc2sGM+mCPek9ZLe5xRUOC/BvhAt2qIWFAeXMn4il04EYIjl3DsWiJr0xDMTJhvMOmD55xTRPlNp39w==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
-    libc: [musl]
 
   '@oxfmt/binding-linux-s390x-gnu@0.35.0':
     resolution: {integrity: sha512-RG2hlvOMK4OMZpO3mt8MpxLQ0AAezlFqhn5mI/g5YrVbPFyoCv9a34AAvbSJS501ocOxlFIRcKEuw5hFvddf9g==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [s390x]
     os: [linux]
-    libc: [glibc]
 
   '@oxfmt/binding-linux-x64-gnu@0.35.0':
     resolution: {integrity: sha512-wzmh90Pwvqj9xOKHJjkQYBpydRkaXG77ZvDz+iFDRRQpnqIEqGm5gmim2s6vnZIkDGsvKCuTdtxm0GFmBjM1+w==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@oxfmt/binding-linux-x64-musl@0.35.0':
     resolution: {integrity: sha512-+HCqYCJPCUy5I+b2cf+gUVaApfgtoQT3HdnSg/l7NIcLHOhKstlYaGyrFZLmUpQt4WkFbpGKZZayG6zjRU0KFA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@oxfmt/binding-openharmony-arm64@0.35.0':
     resolution: {integrity: sha512-kFYmWfR9YL78XyO5ws+1dsxNvZoD973qfVMNFOS4e9bcHXGF7DvGC2tY5UDFwyMCeB33t3sDIuGONKggnVNSJA==}
@@ -2849,56 +2868,48 @@ packages:
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@oxlint/binding-linux-arm64-musl@1.71.0':
     resolution: {integrity: sha512-fJZrs5sDZtTaPIOiemRQQmo82Ezy+vOGXemPc4Ok7iVVsYsFa7SlW6Z5XN819VfsqBHRm3NJ3rTdnR8+bJYJdQ==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@oxlint/binding-linux-ppc64-gnu@1.71.0':
     resolution: {integrity: sha512-cwl7VKGERIy9p+G+AvZdfy/06q0aHXaTt/mMRReC751iuNYJgqKjB7NydXSS30nBT9vtr2tunciOtrR4fD6FUA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [ppc64]
     os: [linux]
-    libc: [glibc]
 
   '@oxlint/binding-linux-riscv64-gnu@1.71.0':
     resolution: {integrity: sha512-eZ8ieVXvzGi8jr7+ybQGPK2STw3mldfxZlgA2738iflfB/rzA69sE6m5rDRpQaxC7dpm745Enlh1Tod0QAk9Gg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
-    libc: [glibc]
 
   '@oxlint/binding-linux-riscv64-musl@1.71.0':
     resolution: {integrity: sha512-puMDbQYe6+NXwfMusojoA7CXGn2b3utukmd23PQqc1E3XhVCwyZ+FueSMzDYeNgDV2dUfIVXAAKZBcFDeCL6sA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [riscv64]
     os: [linux]
-    libc: [musl]
 
   '@oxlint/binding-linux-s390x-gnu@1.71.0':
     resolution: {integrity: sha512-4NJLxBs1ujISCt3L/1FcywLs73PWtJuw+piD6feK2V6h6OS6P7xu9/sWt1DTRLibe6QCzmfZzmM/2HPORoV/Lg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [s390x]
     os: [linux]
-    libc: [glibc]
 
   '@oxlint/binding-linux-x64-gnu@1.71.0':
     resolution: {integrity: sha512-cFDaiR8L3430qp88tfZnvFlt3KotFhR/DlbIL0nHOMMYiG/9Wy4l+6f7t8G8pTa9bd8Lt8+M0y/qjRQ/xcB74g==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@oxlint/binding-linux-x64-musl@1.71.0':
     resolution: {integrity: sha512-orfixdt76KlpNly9z0PkWBBNfwjKz+JFVLP/7wnVchlKNU9Dpt9InU/ZggeSej6fC7qwHmHNOGlhLnQXcYoGuA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@oxlint/binding-openharmony-arm64@1.71.0':
     resolution: {integrity: sha512-9emQu2lAp6yhPB3XuI+++vR+l/o6JR1X+EpxwcumPdQXBWXEPAsquPGL7l158EqU8SebQMXTUa/S5zN98juyHw==}
@@ -3342,28 +3353,24 @@ packages:
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@rolldown/binding-linux-arm64-musl@1.0.0-beta.42':
     resolution: {integrity: sha512-/bNTYb9aKNhzdbPn3O4MK2aLv55AlrkUKPE4KNfBYjkoZUfDr4jWp7gsSlvTc5A/99V1RCm9axvt616ZzeXGyA==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@rolldown/binding-linux-x64-gnu@1.0.0-beta.42':
     resolution: {integrity: sha512-n/SLa4h342oyeGykZdch7Y3GNCNliRPL4k5wkeZ/5eQZs+c6/ZG1SHCJQoy7bZcmxiMyaXs9HoFmv1PEKrZgWg==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@rolldown/binding-linux-x64-musl@1.0.0-beta.42':
     resolution: {integrity: sha512-4PSd46sFzqpLHSGdaSViAb1mk55sCUMpJg+X8ittXaVocQsV3QLG/uydSH8RyL0ngHX5fy3D70LcCzlB15AgHw==}
     engines: {node: ^20.19.0 || >=22.12.0}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@rolldown/binding-openharmony-arm64@1.0.0-beta.42':
     resolution: {integrity: sha512-BmWoeJJyeZXmZBcfoxG6J9+rl2G7eO47qdTkAzEegj4n3aC6CBIHOuDcbE8BvhZaEjQR0nh0nJrtEDlt65Q7Sw==}
@@ -3473,145 +3480,121 @@ packages:
     resolution: {integrity: sha512-xRiOu9Of1FZ4SxVbB0iEDXc4ddIcjCv2aj03dmW8UrZIW7aIQ9jVJdLBIhxBI+MaTnGAKyvMwPwQnoOEvP7FgQ==}
     cpu: [arm]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-arm-gnueabihf@4.62.2':
     resolution: {integrity: sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==}
     cpu: [arm]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-arm-musleabihf@4.52.4':
     resolution: {integrity: sha512-FbhM2p9TJAmEIEhIgzR4soUcsW49e9veAQCziwbR+XWB2zqJ12b4i/+hel9yLiD8pLncDH4fKIPIbt5238341Q==}
     cpu: [arm]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-arm-musleabihf@4.62.2':
     resolution: {integrity: sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==}
     cpu: [arm]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-arm64-gnu@4.52.4':
     resolution: {integrity: sha512-4n4gVwhPHR9q/g8lKCyz0yuaD0MvDf7dV4f9tHt0C73Mp8h38UCtSCSE6R9iBlTbXlmA8CjpsZoujhszefqueg==}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-arm64-gnu@4.62.2':
     resolution: {integrity: sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-arm64-musl@4.52.4':
     resolution: {integrity: sha512-u0n17nGA0nvi/11gcZKsjkLj1QIpAuPFQbR48Subo7SmZJnGxDpspyw2kbpuoQnyK+9pwf3pAoEXerJs/8Mi9g==}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-arm64-musl@4.62.2':
     resolution: {integrity: sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-loong64-gnu@4.52.4':
     resolution: {integrity: sha512-0G2c2lpYtbTuXo8KEJkDkClE/+/2AFPdPAbmaHoE870foRFs4pBrDehilMcrSScrN/fB/1HTaWO4bqw+ewBzMQ==}
     cpu: [loong64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-loong64-gnu@4.62.2':
     resolution: {integrity: sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==}
     cpu: [loong64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-loong64-musl@4.62.2':
     resolution: {integrity: sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==}
     cpu: [loong64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-ppc64-gnu@4.52.4':
     resolution: {integrity: sha512-teSACug1GyZHmPDv14VNbvZFX779UqWTsd7KtTM9JIZRDI5NUwYSIS30kzI8m06gOPB//jtpqlhmraQ68b5X2g==}
     cpu: [ppc64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-ppc64-gnu@4.62.2':
     resolution: {integrity: sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==}
     cpu: [ppc64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-ppc64-musl@4.62.2':
     resolution: {integrity: sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==}
     cpu: [ppc64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-riscv64-gnu@4.52.4':
     resolution: {integrity: sha512-/MOEW3aHjjs1p4Pw1Xk4+3egRevx8Ji9N6HUIA1Ifh8Q+cg9dremvFCUbOX2Zebz80BwJIgCBUemjqhU5XI5Eg==}
     cpu: [riscv64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-riscv64-gnu@4.62.2':
     resolution: {integrity: sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==}
     cpu: [riscv64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-riscv64-musl@4.52.4':
     resolution: {integrity: sha512-1HHmsRyh845QDpEWzOFtMCph5Ts+9+yllCrREuBR/vg2RogAQGGBRC8lDPrPOMnrdOJ+mt1WLMOC2Kao/UwcvA==}
     cpu: [riscv64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-riscv64-musl@4.62.2':
     resolution: {integrity: sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==}
     cpu: [riscv64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-s390x-gnu@4.52.4':
     resolution: {integrity: sha512-seoeZp4L/6D1MUyjWkOMRU6/iLmCU2EjbMTyAG4oIOs1/I82Y5lTeaxW0KBfkUdHAWN7j25bpkt0rjnOgAcQcA==}
     cpu: [s390x]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-s390x-gnu@4.62.2':
     resolution: {integrity: sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==}
     cpu: [s390x]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-x64-gnu@4.52.4':
     resolution: {integrity: sha512-Wi6AXf0k0L7E2gteNsNHUs7UMwCIhsCTs6+tqQ5GPwVRWMaflqGec4Sd8n6+FNFDw9vGcReqk2KzBDhCa1DLYg==}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-x64-gnu@4.62.2':
     resolution: {integrity: sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@rollup/rollup-linux-x64-musl@4.52.4':
     resolution: {integrity: sha512-dtBZYjDmCQ9hW+WgEkaffvRRCKm767wWhxsFW3Lw86VXz/uJRuD438/XvbZT//B96Vs8oTA8Q4A0AfHbrxP9zw==}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-linux-x64-musl@4.62.2':
     resolution: {integrity: sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@rollup/rollup-openbsd-x64@4.62.2':
     resolution: {integrity: sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==}
@@ -3886,56 +3869,48 @@ packages:
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@tailwindcss/oxide-linux-arm64-gnu@4.3.2':
     resolution: {integrity: sha512-wDgEIGwoM8w8pufh9LVt1PahDgNdKXrLC2qfAnV3vAmococ9RWbxeAw4pxPttd/TsJfwjyLf90Dg1y9y8I6Emw==}
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   '@tailwindcss/oxide-linux-arm64-musl@4.3.1':
     resolution: {integrity: sha512-Bwv9KwOvE0VKa86xPFif9b9c3Y1NxOV1P0gLti/IYaWEsQYZXDlxfGEtA8mdDZ7SG3wyNXAWYT5SIn3giL57oA==}
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@tailwindcss/oxide-linux-arm64-musl@4.3.2':
     resolution: {integrity: sha512-J5Nuk0uZQIiMTJj3LEx4sAA9tMFUoXQZFv1J6An+QGYe53HKRJuFDi0rpq/tuouCZeAbOBY3kQ6g8qeD4TUjtA==}
     engines: {node: '>= 20'}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   '@tailwindcss/oxide-linux-x64-gnu@4.3.1':
     resolution: {integrity: sha512-Ymi8O8T15HYQdOUWUtTI6ldN0neHP85FC+Qz32xTcZ7iJXtem/x8ITev0o1e9e5rkqj4lONZfTRLvkmin1+tKg==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@tailwindcss/oxide-linux-x64-gnu@4.3.2':
     resolution: {integrity: sha512-kqCZpSKOBEJO4mz7OqWoofBZeXTAwaVGPj0ErAj7CojmhKpWVWVOnrt9dE8odoIraZq4oj3ausM37kXi+Tow8w==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   '@tailwindcss/oxide-linux-x64-musl@4.3.1':
     resolution: {integrity: sha512-M+P/91qJ6uILLw4k2G93GMDRAXj61SMvFQYt39AqvUqYgExXpLL5aepfns7sj4HiAQeolirQF9E0lzRvdf4zPQ==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@tailwindcss/oxide-linux-x64-musl@4.3.2':
     resolution: {integrity: sha512-cixpqbh2toJDmkuCRI68nXA8ZxNmdK9Y+9v5h3MC3ZQKy/0BO8AWzlkWyRM7JAFSGBlfig4YVTPsK6MVgqz1uw==}
     engines: {node: '>= 20'}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   '@tailwindcss/oxide-wasm32-wasi@4.3.1':
     resolution: {integrity: sha512-zsM8uOeqvVGHsAXsJxsT28ttosFahLJKCLOTUBqRAtKnVgGSRitds9T432QiT8b77Yga7JIBkulIRRlJPtYhRA==}
@@ -7264,28 +7239,24 @@ packages:
     engines: {node: '>= 12.0.0'}
     cpu: [arm64]
     os: [linux]
-    libc: [glibc]
 
   lightningcss-linux-arm64-musl@1.32.0:
     resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==}
     engines: {node: '>= 12.0.0'}
     cpu: [arm64]
     os: [linux]
-    libc: [musl]
 
   lightningcss-linux-x64-gnu@1.32.0:
     resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [linux]
-    libc: [glibc]
 
   lightningcss-linux-x64-musl@1.32.0:
     resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==}
     engines: {node: '>= 12.0.0'}
     cpu: [x64]
     os: [linux]
-    libc: [musl]
 
   lightningcss-win32-arm64-msvc@1.32.0:
     resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==}
diff --git a/worm-guidelines/SKILL.md b/worm-guidelines/SKILL.md
index c86dbd6b..f55c0e53 100644
--- a/worm-guidelines/SKILL.md
+++ b/worm-guidelines/SKILL.md
@@ -1,54 +1,55 @@
----
-name: worma-guidelines
-description: worma OpenAPI code generation and configuration. Use this skill whenever the user mentions worma config, API code generation, OpenAPI/Swagger integration, worma CLI, or migration from @alova/wormhole. Trigger for questions about worma.config, npx worma init/gen, or generating API code from OpenAPI specs.
----
-
-# worma — Universal OpenAPI Code Generator
-
-Pick the scenario that matches the user's need, then fetch the detailed information from the corresponding docs link before answering.
-
-## Scenario Guides
-
-| Scenario                               | Docs Link                                                                                                                                                 |
-| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| First time setup / install & configure | [Installation & Configuration](https://worma.js.org/llms.mdx/docs/guide/installation-config.md)                                                           |
-| Quick start                            | [Quick Start](https://worma.js.org/llms.mdx/docs/quick-start.md)                                                                                          |
-| Migrate from `@alova/wormhole`         | [Migration Guide](https://worma.js.org/llms.mdx/docs/migration.md)                                                                                        |
-| CLI commands (`init`, `gen`, etc.)     | [CLI Commands](https://worma.js.org/llms.mdx/docs/cli-commands.md)                                                                                        |
-| Write custom Handlebars templates      | [Custom Templates](https://worma.js.org/llms.mdx/docs/template-system/custom-templates.md)                                                                |
-| Build your own plugin                  | [Custom Plugin](https://worma.js.org/llms.mdx/docs/plugin-system/custom-plugin.md) / [Plugin API](https://worma.js.org/llms.mdx/docs/api/plugin-api.md)   |
-| Programmatic API                       | [Core Functions](https://worma.js.org/llms.mdx/docs/api/core-functions.md) / [Configuration API](https://worma.js.org/llms.mdx/docs/api/configuration.md) |
-| Generate AI Skill docs                 | [AI Skills](https://worma.js.org/llms.mdx/docs/ai-skills/index.md)                                                                                        |
-| VSCode extension                       | [Editor Docs](https://worma.js.org/llms.mdx/docs/guide/editor-docs.md)                                                                                    |
-| Monorepo setup                         | [Monorepo](https://worma.js.org/llms.mdx/docs/guide/monorepo.md)                                                                                          |
-| Performance tuning                     | [Performance](https://worma.js.org/llms.mdx/docs/performance.md)                                                                                          |
-
-## Predefined Templates
-
-worma ships with request-library templates such as `alova`, `axios`, `fetch`, and `ky`. Use them in `generator.plugins` to control how API code is generated.
-
-→ See [Predefined Templates](https://worma.js.org/llms.mdx/docs/template-system/predefined-templates.md) for usage, options, and examples.
-
-> **Using the alova template?** Install the alova skills for better client/server API usage guidance:
->
-> ```bash
-> npx skills add https://github.com/alovajs/skills --skill alova-client-usage
-> npx skills add alovajs/skills --skill alova-server-usage
-> ```
-
-## Predefined Plugins
-
-Add these plugins to `generator.plugins` to customize the generation pipeline.
-
-| Plugin              | Description                                                          | Docs                                                                                                    |
-| ------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| `aiDoc()`           | Generates AI-readable interface docs for coding assistants.          | [aiDoc](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/aiDoc.md)                      |
-| `platform()`        | Auto-assembles OpenAPI URLs for Swagger, Knife4j, FastAPI, and YApi. | [platform](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/platform.md)                |
-| `apifox()`          | Imports OpenAPI documents directly from Apifox.                      | [apifox](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/apifox.md)                    |
-| `rename()`          | Renames/transforms API URLs and parameters.                          | [rename](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/rename.md)                    |
-| `tagModifier()`     | Modifies the `tags` of APIs in the OpenAPI spec.                     | [tagModifier](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/tag-modifier.md)         |
-| `payloadModifier()` | Adds, removes, or changes request/response parameter types.          | [payloadModifier](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/payload-modifier.md) |
-| `filterApi()`       | Filters APIs by URL or tag with matching rules.                      | [filterApi](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/filter-api.md)             |
-| `importType()`      | Reuses external types and excludes auto-generated types.             | [importType](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/import-type.md)           |
-
-→ See [Built-in Plugins Overview](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/index.md) for shared usage patterns and more details.
+t---
+name: worma-guidelines
+description: worma OpenAPI code generation and configuration. Use this skill whenever the user mentions worma config, API code generation, OpenAPI/Swagger integration, worma CLI, or migration from @alova/wormhole. Trigger for questions about worma.config, npx worma init/gen, or generating API code from OpenAPI specs.
+
+---
+
+# worma — Universal OpenAPI Code Generator
+
+Pick the scenario that matches the user's need, then fetch the detailed information from the corresponding docs link before answering.
+
+## Scenario Guides
+
+| Scenario                               | Docs Link                                                                                                                                                 |
+| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| First time setup / install & configure | [Installation & Configuration](https://worma.js.org/llms.mdx/docs/guide/installation-config.md)                                                           |
+| Quick start                            | [Quick Start](https://worma.js.org/llms.mdx/docs/quick-start.md)                                                                                          |
+| Migrate from `@alova/wormhole`         | [Migration Guide](https://worma.js.org/llms.mdx/docs/migration/from-alova.md)                                                                             |
+| CLI commands (`init`, `gen`, etc.)     | [CLI Commands](https://worma.js.org/llms.mdx/docs/cli-commands.md)                                                                                        |
+| Write custom Handlebars templates      | [Custom Templates](https://worma.js.org/llms.mdx/docs/template-system/custom-templates.md)                                                                |
+| Build your own plugin                  | [Custom Plugin](https://worma.js.org/llms.mdx/docs/plugin-system/custom-plugin.md) / [Plugin API](https://worma.js.org/llms.mdx/docs/api/plugin-api.md)   |
+| Programmatic API                       | [Core Functions](https://worma.js.org/llms.mdx/docs/api/core-functions.md) / [Configuration API](https://worma.js.org/llms.mdx/docs/api/configuration.md) |
+| Generate AI Skill docs                 | [AI Skills](https://worma.js.org/llms.mdx/docs/ai-skills/index.md)                                                                                        |
+| VSCode extension                       | [Editor Docs](https://worma.js.org/llms.mdx/docs/guide/editor-docs.md)                                                                                    |
+| Monorepo setup                         | [Monorepo](https://worma.js.org/llms.mdx/docs/guide/monorepo.md)                                                                                          |
+| Performance tuning                     | [Performance](https://worma.js.org/llms.mdx/docs/performance.md)                                                                                          |
+
+## Predefined Templates
+
+worma ships with request-library templates such as `alova`, `axios`, `fetch`, and `ky`. Use them in `generator.plugins` to control how API code is generated.
+
+→ See [Predefined Templates](https://worma.js.org/llms.mdx/docs/template-system/predefined-templates.md) for usage, options, and examples.
+
+> **Using the alova template?** Install the alova skills for better client/server API usage guidance:
+>
+> ```bash
+> npx skills add https://github.com/alovajs/skills --skill alova-client-usage
+> npx skills add alovajs/skills --skill alova-server-usage
+> ```
+
+## Predefined Plugins
+
+Add these plugins to `generator.plugins` to customize the generation pipeline.
+
+| Plugin              | Description                                                          | Docs                                                                                                    |
+| ------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| `aiDoc()`           | Generates AI-readable interface docs for coding assistants.          | [aiDoc](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/aiDoc.md)                      |
+| `platform()`        | Auto-assembles OpenAPI URLs for Swagger, Knife4j, FastAPI, and YApi. | [platform](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/platform.md)                |
+| `apifox()`          | Imports OpenAPI documents directly from Apifox.                      | [apifox](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/apifox.md)                    |
+| `rename()`          | Renames/transforms API URLs and parameters.                          | [rename](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/rename.md)                    |
+| `tagModifier()`     | Modifies the `tags` of APIs in the OpenAPI spec.                     | [tagModifier](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/tag-modifier.md)         |
+| `payloadModifier()` | Adds, removes, or changes request/response parameter types.          | [payloadModifier](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/payload-modifier.md) |
+| `filterApi()`       | Filters APIs by URL or tag with matching rules.                      | [filterApi](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/filter-api.md)             |
+| `importType()`      | Reuses external types and excludes auto-generated types.             | [importType](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/import-type.md)           |
+
+→ See [Built-in Plugins Overview](https://worma.js.org/llms.mdx/docs/plugin-system/builtin-plugins/index.md) for shared usage patterns and more details.