ai4scholar 0.3.3 → 0.4.0

package/README.md

@@ -6,7 +6,7 @@ Powered by [ai4scholar.net](https://ai4scholar.net).
 
 ## What It Does
 
-AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** through **35 built-in tools**, plus 2 agent skills for literature surveys and automatic citation annotation.
+AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** through **37 built-in tools**, plus a literature survey skill for comprehensive report generation.
 
 ### Platforms
 
@@ -19,7 +19,7 @@ AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** t
 | **bioRxiv** | Biology preprints |
 | **medRxiv** | Health sciences preprints |
 
-### Tools (35)
+### Tools (37)
 
 **Search (9)**
 
@@ -91,12 +91,23 @@ AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** t
 |------|-------------|
 | `paper_quality_rank` | Rank papers by CCF classification, citations, year, h-index |
 
+**Auto-Citation (1)**
+
+| Tool | Description |
+|------|-------------|
+| `auto_cite` | One-click citation annotation: add real references to academic text (IEEE/APA/Vancouver/Nature styles) |
+
+**Scientific Drawing (1)**
+
+| Tool | Description |
+|------|-------------|
+| `sci_draw` | AI-powered scientific figure generation (text-to-image, edit, style transfer, SVG, critique) |
+
 ### Skills
 
 | Skill | Description |
 |-------|-------------|
 | **literature-survey** | Multi-source literature survey with HTML report generation |
-| **auto-cite** | Automatically add citation markers and reference list to academic text |
 
 ### Slash Commands
 
@@ -156,7 +167,7 @@ Set your API key in `openclaw.json`:
 }
 ```
 
-Get your API key at [ai4scholar.net/dashboard](https://ai4scholar.net/dashboard?view=api-keys).
+Get your API key at [ai4scholar.net](https://ai4scholar.net?src=openclaw).
 
 ## Usage
 
@@ -194,6 +205,8 @@ ai4scholar/
 │   │   ├── biorxiv.ts           # 6 bioRxiv/medRxiv tools
 │   │   ├── doi-download.ts      # 2 DOI-based download tools
 │   │   ├── quality-rank.ts      # Paper quality ranking (CCF)
+│   │   ├── auto-cite.ts         # Auto-citation via ai4scholar API
+│   │   ├── sci-draw.ts          # Scientific figure generation
 │   │   ├── pdf-utils.ts         # PDF download & text extraction
 │   │   ├── result.ts            # Tool result helpers
 │   │   └── params.ts            # Parameter parsing
@@ -204,9 +217,7 @@ ai4scholar/
 ├── scripts/                     # Python helpers (HTML reports)
 ├── assets/                      # Report templates
 ├── skills/
-│   ├── literature-survey/
-│   │   └── SKILL.md
-│   └── auto-cite/
+│   └── literature-survey/
 │       └── SKILL.md
 ├── data/
 │   └── ccf_2022.jsonl           # CCF ranking data

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAgDlD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,iBAAiB,QA4FtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAkDlD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,iBAAiB,QAqGtD"}

package/dist/index.js

@@ -8,6 +8,8 @@ import { createArxivSearchTool, createArxivDownloadTool, createArxivReadTool } f
 import { createBiorxivSearchTool, createMedrxivSearchTool, createBiorxivDownloadTool, createMedrxivDownloadTool, createBiorxivReadTool, createMedrxivReadTool, } from "./src/tools/biorxiv.js";
 import { createDoiDownloadTool, createDoiReadTool } from "./src/tools/doi-download.js";
 import { createPaperQualityRankTool } from "./src/tools/quality-rank.js";
+import { createAutoCiteTool } from "./src/tools/auto-cite.js";
+import { createSciDrawTool } from "./src/tools/sci-draw.js";
 import { handleLibrary, handleProjects, handleReadingList, } from "./src/commands.js";
 import { createScholarModeHook } from "./src/hooks/scholar-mode.js";
 export default function register(api) {
@@ -16,7 +18,10 @@ export default function register(api) {
         setApiKey(cfg.apiKey);
     }
     else {
-        api.logger.warn("AI4Scholar: no apiKey configured. Semantic Scholar, PubMed, and Google Scholar tools require an API key from ai4scholar.net.");
+        api.logger.warn(`AI4Scholar: apiKey 未配置。请在 openclaw.json 的 plugins.entries.ai4scholar 中添加：
+  "config": { "apiKey": "<your-key>" }
+获取 API Key → https://ai4scholar.net?src=openclaw
+配置后重启 Gateway 生效。arXiv / bioRxiv / medRxiv 工具无需 Key 即可使用。`);
     }
     // --- Semantic Scholar (17 tools) ---
     api.registerTool(createSemanticSearchTool());
@@ -60,6 +65,10 @@ export default function register(api) {
     api.registerTool(createDoiReadTool());
     // --- Quality evaluation (1 tool) ---
     api.registerTool(createPaperQualityRankTool());
+    // --- Auto-cite (1 tool) ---
+    api.registerTool(createAutoCiteTool());
+    // --- Scientific drawing (1 tool) ---
+    api.registerTool(createSciDrawTool());
     // --- Slash commands ---
     api.registerCommand({
         name: "library",
@@ -85,6 +94,6 @@ export default function register(api) {
     // --- Hooks ---
     api.on("before_prompt_build", createScholarModeHook(), { priority: 100 });
     api.on("before_tool_call", createSkillInjectionHook(path.dirname(api.source)));
-    api.logger.info(`AI4Scholar plugin loaded — 35 tools registered (apiKey: ${cfg?.apiKey ? "configured" : "missing"})`);
+    api.logger.info(`AI4Scholar plugin loaded — 37 tools registered (apiKey: ${cfg?.apiKey ? "configured" : "missing"})`);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,yCAAyC,EACzC,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAsB;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,YAA+C,CAAC;IAEhE,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,8HAA8H,CAC/H,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAChD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,iCAAiC,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,YAAY,CAAC,yCAAyC,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,YAAY,CAAC,+BAA+B,EAAE,CAAC,CAAC;IACpD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAClD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC/C,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAE3C,2BAA2B;IAC3B,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE1C,kCAAkC;IAClC,GAAG,CAAC,YAAY,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAElD,0BAA0B;IAC1B,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAExC,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE1C,wCAAwC;IACxC,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEtC,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAE/C,yBAAyB;IACzB,GAAG,CAAC,eAAe,CAAC;QAClB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC;QAClB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC;QAClB,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,iBAAiB;KAC3B,CAAC,CAAC;IAEH,gBAAgB;IAChB,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE/E,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,2DAA2D,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,GAAG,CACrG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,yCAAyC,EACzC,+BAA+B,EAC/B,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAsB;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,YAA+C,CAAC;IAEhE,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,MAAM,CAAC,IAAI,CACb;;;0DAGoD,CACrD,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,2BAA2B,EAAE,CAAC,CAAC;IAChD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,iCAAiC,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,YAAY,CAAC,yCAAyC,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,YAAY,CAAC,+BAA+B,EAAE,CAAC,CAAC;IACpD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAClD,GAAG,CAAC,YAAY,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACjD,GAAG,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC/C,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAE3C,2BAA2B;IAC3B,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE1C,kCAAkC;IAClC,GAAG,CAAC,YAAY,CAAC,6BAA6B,EAAE,CAAC,CAAC;IAElD,0BAA0B;IAC1B,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAExC,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE1C,wCAAwC;IACxC,GAAG,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEtC,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAE/C,6BAA6B;IAC7B,GAAG,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEvC,sCAAsC;IACtC,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEtC,yBAAyB;IACzB,GAAG,CAAC,eAAe,CAAC;QAClB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC;QAClB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC;QAClB,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,OAAO,EAAE,iBAAiB;KAC3B,CAAC,CAAC;IAEH,gBAAgB;IAChB,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE/E,GAAG,CAAC,MAAM,CAAC,IAAI,CACb,2DAA2D,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,GAAG,CACrG,CAAC;AACJ,CAAC"}

package/dist/src/hooks/scholar-mode.js

@@ -1,4 +1,4 @@
-const SCHOLAR_MODE_PROMPT = `[AI4Scholar] You have 35 academic literature tools covering Semantic Scholar, PubMed, Google Scholar, arXiv, bioRxiv, and medRxiv. Capabilities include: search, paper detail, citations, references, author lookup, recommendations, snippet search, batch queries, title matching, bulk search, PDF download, full-text reading, direct DOI-based paper download (leverages institutional access when available), and paper quality ranking (CCF classification). For paper search or literature questions, call the tools directly and respond in Markdown. When the user pastes academic text and asks to add citations/references, read the auto-cite SKILL.md. Only read the literature-survey SKILL.md when the user explicitly requests an HTML report or a comprehensive multi-source survey.`;
+const SCHOLAR_MODE_PROMPT = `[AI4Scholar] You have 37 academic tools covering Semantic Scholar, PubMed, Google Scholar, arXiv, bioRxiv, and medRxiv. Capabilities: search, paper detail, citations, references, author lookup, recommendations, snippet search, batch queries, title matching, bulk search, PDF download, full-text reading, DOI-based paper download (institutional access), paper quality ranking (CCF), auto-citation (auto_cite tool), and scientific figure generation (sci_draw tool). For paper search or literature questions, call the search tools directly and respond in Markdown. When the user pastes academic text and asks to add citations/references, call the auto_cite tool directly. When the user asks to create scientific figures or diagrams, call the sci_draw tool. Only read the literature-survey SKILL.md when the user explicitly requests an HTML report or a comprehensive multi-source survey.`;
 export function createScholarModeHook() {
     return (event, _context) => {
         if (!event.messages || event.messages.length === 0) {

package/dist/src/hooks/scholar-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"scholar-mode.js","sourceRoot":"","sources":["../../../src/hooks/scholar-mode.ts"],"names":[],"mappings":"AAgBA,MAAM,mBAAmB,GAAG,wwBAAwwB,CAAC;AAEryB,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,KAAgB,EAAE,QAAqB,EAAc,EAAE;QAC7D,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"scholar-mode.js","sourceRoot":"","sources":["../../../src/hooks/scholar-mode.ts"],"names":[],"mappings":"AAgBA,MAAM,mBAAmB,GAAG,q3BAAq3B,CAAC;AAEl5B,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,KAAgB,EAAE,QAAqB,EAAc,EAAE;QAC7D,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/tools/auto-cite.d.ts

@@ -0,0 +1,24 @@
+export declare function createAutoCiteTool(): {
+    label: string;
+    name: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        text: import("@sinclair/typebox").TString;
+        mode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        minCitations: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        field: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        yearPreference: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        excludePreprints: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        excludeConferences: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        citationStyle: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (_id: string, raw: unknown) => Promise<{
+        type: "tool_result";
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: boolean;
+    }>;
+};
+//# sourceMappingURL=auto-cite.d.ts.map

package/dist/src/tools/auto-cite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-cite.d.ts","sourceRoot":"","sources":["../../../src/tools/auto-cite.ts"],"names":[],"mappings":"AA8FA,wBAAgB,kBAAkB;;;;;;;;;;;;;;mBA0CT,MAAM,OAAO,OAAO;;;;;;;;EAsC5C"}

package/dist/src/tools/auto-cite.js

@@ -0,0 +1,137 @@
+import { Type } from "@sinclair/typebox";
+import { getApiKey } from "./api-client.js";
+import { readString, readNumber } from "./params.js";
+import { Result } from "./result.js";
+const BASE_URL = "https://ai4scholar.net";
+const TIMEOUT_MS = 300_000;
+async function callAutoCiteApi(body) {
+    const apiKey = getApiKey();
+    if (!apiKey)
+        return { ok: false, error: "API key not configured" };
+    const res = await fetch(`${BASE_URL}/api/proxy/auto-cite`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            "User-Agent": "ai4scholar-openclaw/0.3",
+        },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        return { ok: false, error: `HTTP ${res.status}: ${text}` };
+    }
+    const reader = res.body?.getReader();
+    if (!reader)
+        return { ok: false, error: "No response body" };
+    const decoder = new TextDecoder();
+    let buffer = "";
+    let result = null;
+    let lastError = null;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() || "";
+        let currentEvent = "";
+        for (const line of lines) {
+            if (line.startsWith("event: ")) {
+                currentEvent = line.slice(7).trim();
+            }
+            else if (line.startsWith("data: ")) {
+                try {
+                    const data = JSON.parse(line.slice(6));
+                    if (currentEvent === "result") {
+                        result = data;
+                    }
+                    else if (currentEvent === "error") {
+                        lastError = data.message || "Processing error";
+                    }
+                }
+                catch {
+                    // skip malformed JSON
+                }
+            }
+        }
+    }
+    if (result)
+        return { ok: true, data: result };
+    return { ok: false, error: lastError || "No result received from auto-cite API" };
+}
+export function createAutoCiteTool() {
+    return {
+        label: "Auto-Cite Academic Text",
+        name: "auto_cite",
+        description: "Automatically add real citations to academic text. Analyzes the text, searches matching papers from Semantic Scholar / PubMed / Google Scholar, and inserts citation markers [1], [2] with a formatted reference list. Supports IEEE, APA, Vancouver, Nature, and numbered citation styles. Returns annotated text + references + BibTeX. Processing takes 20-60 seconds.",
+        parameters: Type.Object({
+            text: Type.String({
+                description: "Academic text to annotate with citations (100-10000 characters)",
+            }),
+            mode: Type.Optional(Type.String({
+                description: "'auto' (detect citation locations, default) or 'manual' (use [CITE] markers in text)",
+                enum: ["auto", "manual"],
+            })),
+            minCitations: Type.Optional(Type.Number({
+                description: "Minimum number of citations to add in auto mode (default 10)",
+                minimum: 1,
+                maximum: 50,
+            })),
+            field: Type.Optional(Type.String({ description: "Academic field for search optimization (e.g. 'computer science', 'biology')" })),
+            yearPreference: Type.Optional(Type.Number({ description: "Preferred publication year for cited papers (e.g. 2024)" })),
+            excludePreprints: Type.Optional(Type.Boolean({ description: "Exclude preprints from citations (default false)" })),
+            excludeConferences: Type.Optional(Type.Boolean({ description: "Exclude conference papers from citations (default false)" })),
+            citationStyle: Type.Optional(Type.String({
+                description: "Citation format: 'ieee' (default), 'apa', 'vancouver', 'nature', 'numbered'",
+                enum: ["ieee", "apa", "vancouver", "nature", "numbered"],
+            })),
+        }),
+        execute: async (_id, raw) => {
+            const p = raw;
+            const text = readString(p, "text", { required: true });
+            if (text.length < 100)
+                return Result.err("text_too_short", "Text must be at least 100 characters");
+            if (text.length > 10000)
+                return Result.err("text_too_long", "Text must be at most 10000 characters");
+            const body = { text };
+            const mode = readString(p, "mode");
+            if (mode)
+                body.mode = mode;
+            const minCitations = readNumber(p, "minCitations");
+            if (minCitations !== undefined)
+                body.minCitations = minCitations;
+            const field = readString(p, "field");
+            if (field)
+                body.field = field;
+            const yearPref = readNumber(p, "yearPreference");
+            if (yearPref !== undefined)
+                body.yearPreference = yearPref;
+            if (p.excludePreprints !== undefined)
+                body.excludePreprints = p.excludePreprints;
+            if (p.excludeConferences !== undefined)
+                body.excludeConferences = p.excludeConferences;
+            const style = readString(p, "citationStyle");
+            if (style)
+                body.citationStyle = style;
+            try {
+                const res = await callAutoCiteApi(body);
+                if (!res.ok)
+                    return Result.err("api_error", res.error);
+                const { annotatedText, references, bibtex, stats } = res.data;
+                return Result.ok({
+                    annotatedText,
+                    referenceCount: references.length,
+                    references,
+                    bibtex: bibtex || "",
+                    stats,
+                });
+            }
+            catch (e) {
+                return Result.err("request_failed", e instanceof Error ? e.message : String(e));
+            }
+        },
+    };
+}
+//# sourceMappingURL=auto-cite.js.map

package/dist/src/tools/auto-cite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-cite.js","sourceRoot":"","sources":["../../../src/tools/auto-cite.ts"],"names":[],"mappings":"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"}

package/dist/src/tools/sci-draw.d.ts

@@ -0,0 +1,24 @@
+export declare function createSciDrawTool(): {
+    label: string;
+    name: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        action: import("@sinclair/typebox").TString;
+        prompt: import("@sinclair/typebox").TString;
+        model: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        imageSize: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        aspectRatio: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        images: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        stylePreset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        lang: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (_id: string, raw: unknown) => Promise<{
+        type: "tool_result";
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: boolean;
+    }>;
+};
+//# sourceMappingURL=sci-draw.d.ts.map

package/dist/src/tools/sci-draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sci-draw.d.ts","sourceRoot":"","sources":["../../../src/tools/sci-draw.ts"],"names":[],"mappings":"AAkBA,wBAAgB,iBAAiB;;;;;;;;;;;;;;mBA8CR,MAAM,OAAO,OAAO;;;;;;;;EAmE5C"}

package/dist/src/tools/sci-draw.js

@@ -0,0 +1,113 @@
+import { Type } from "@sinclair/typebox";
+import { getApiKey } from "./api-client.js";
+import { readString } from "./params.js";
+import { Result } from "./result.js";
+const BASE_URL = "https://ai4scholar.net";
+const TIMEOUT_MS = 300_000;
+export function createSciDrawTool() {
+    return {
+        label: "Scientific Drawing",
+        name: "sci_draw",
+        description: "Generate or process scientific figures using AI. Actions: 'smart' (auto-optimize prompt, supports Chinese), 'generate' (text-to-image), 'edit' (modify existing image), 'style' (style transfer), 'compose' (combine multiple images), 'iterate' (auto-review and refine), 'critic' (expert review, returns text), 'svg' (generate SVG vector graphics). Models: 'flash' (fast), 'flash31' (balanced, default), 'pro' (high quality). Returns image URL or SVG code.",
+        parameters: Type.Object({
+            action: Type.String({
+                description: "Operation type: 'smart', 'generate', 'edit', 'style', 'compose', 'iterate', 'critic', 'svg'",
+                enum: ["smart", "generate", "edit", "style", "compose", "iterate", "critic", "svg"],
+            }),
+            prompt: Type.String({
+                description: "Description or instruction for the image. Can be empty for 'critic' action. Supports Chinese in 'smart' mode.",
+            }),
+            model: Type.Optional(Type.String({
+                description: "Model: 'flash' (fast), 'flash31' (balanced, default), 'pro' (high quality)",
+                enum: ["flash", "flash31", "pro"],
+            })),
+            imageSize: Type.Optional(Type.String({
+                description: "Output resolution: '1K', '2K' (default), '4K'",
+                enum: ["1K", "2K", "4K"],
+            })),
+            aspectRatio: Type.Optional(Type.String({
+                description: "Aspect ratio: '1:1' (default), '16:9', '4:3', '3:4', '9:16'",
+            })),
+            images: Type.Optional(Type.Array(Type.String(), {
+                description: "Input images as base64 data URIs or URLs. Required for edit/style/compose/iterate/critic.",
+            })),
+            stylePreset: Type.Optional(Type.String({ description: "Style preset name (for 'style' action)" })),
+            lang: Type.Optional(Type.String({
+                description: "Language: 'en' (default), 'zh'",
+                enum: ["en", "zh"],
+            })),
+        }),
+        execute: async (_id, raw) => {
+            const p = raw;
+            const apiKey = getApiKey();
+            if (!apiKey)
+                return Result.err("no_api_key", "API key not configured");
+            const action = readString(p, "action", { required: true });
+            const prompt = readString(p, "prompt") ?? "";
+            const needsImages = ["edit", "style", "compose", "iterate", "critic"];
+            const images = p.images;
+            if (needsImages.includes(action) && (!images || images.length === 0)) {
+                return Result.err("missing_images", `Action '${action}' requires at least one image in the 'images' parameter`);
+            }
+            if (action === "compose" && images && images.length < 2) {
+                return Result.err("insufficient_images", "Action 'compose' requires at least 2 images");
+            }
+            const body = { action, prompt };
+            const model = readString(p, "model");
+            if (model)
+                body.model = model;
+            const imageSize = readString(p, "imageSize");
+            if (imageSize)
+                body.imageSize = imageSize;
+            const aspectRatio = readString(p, "aspectRatio");
+            if (aspectRatio)
+                body.aspectRatio = aspectRatio;
+            if (images)
+                body.images = images;
+            const stylePreset = readString(p, "stylePreset");
+            if (stylePreset)
+                body.stylePreset = stylePreset;
+            const lang = readString(p, "lang");
+            if (lang)
+                body.lang = lang;
+            try {
+                const res = await fetch(`${BASE_URL}/api/proxy/nano/generate`, {
+                    method: "POST",
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                        "User-Agent": "ai4scholar-openclaw/0.3",
+                    },
+                    body: JSON.stringify(body),
+                    signal: AbortSignal.timeout(TIMEOUT_MS),
+                });
+                if (!res.ok) {
+                    const errText = await res.text().catch(() => "");
+                    return Result.err("api_error", `HTTP ${res.status}: ${errText}`);
+                }
+                const data = (await res.json());
+                if (!data.success) {
+                    return Result.err("generation_failed", "Image generation failed");
+                }
+                const result = { action };
+                if (data.imageUrl)
+                    result.imageUrl = data.imageUrl;
+                if (data.svgCode)
+                    result.svgCode = data.svgCode;
+                if (data.svgUrl)
+                    result.svgUrl = data.svgUrl;
+                if (data.optimizedPrompt)
+                    result.optimizedPrompt = data.optimizedPrompt;
+                if (data.critique)
+                    result.critique = data.critique;
+                if (data.creditCost !== undefined)
+                    result.creditCost = data.creditCost;
+                return Result.ok(result);
+            }
+            catch (e) {
+                return Result.err("request_failed", e instanceof Error ? e.message : String(e));
+            }
+        },
+    };
+}
+//# sourceMappingURL=sci-draw.js.map

package/dist/src/tools/sci-draw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sci-draw.js","sourceRoot":"","sources":["../../../src/tools/sci-draw.ts"],"names":[],"mappings":"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"}

package/docs/tutorial.md

@@ -1,35 +1,74 @@
-# AI4Scholar OpenClaw 插件：安装、配置与使用教程
+# AI4Scholar OpenClaw 教程：安装、配置与使用
 
 > 让你的 OpenClaw 龙虾学会搜论文、读全文、评质量、加引用。
 
----
+AI4Scholar 提供两种接入方式：
 
-## 一、前提条件
+| | MCP 方式（轻量） | 插件方式（完整） |
+|---|---|---|
+| 安装 | 无需安装，改配置即可 | 需要安装插件 |
+| 学术搜索工具 | ✅ | ✅ 37 个工具 |
+| PDF 下载/阅读 | ✅ | ✅ |
+| 文献自动标注 | ❌ | ✅ `auto_cite` |
+| 科研绘图 | ❌ | ✅ `sci_draw` |
+| 论文质量评估（CCF） | ❌ | ✅ |
+| 文献综述技能 | ❌ | ✅ |
+| Scholar Mode 提示 | ❌ | ✅ |
+| Slash 命令 | ❌ | ✅ |
 
-在安装 AI4Scholar 插件之前，请确保以下环境已就绪：
+**推荐**：如果你只想快速体验论文搜索，用 MCP 方式；如果需要完整的科研助手能力，装插件。
 
-- **OpenClaw** 已安装并可正常运行（版本 ≥ 2024.0.0）
-- **Node.js** ≥ 18
-- **ai4scholar.net 账号**（用于获取 API Key）
+---
 
-如果你还需要生成 HTML 格式的文献综述报告（可选），额外需要：
+## 一、获取 API Key
 
-- **Python** ≥ 3.8
+1. 打开 [ai4scholar.net](https://ai4scholar.net?src=openclaw)
+2. 注册或登录你的账号
+3. 点击「创建 API Key」，复制生成的 Key
+
+请妥善保管你的 API Key，不要分享给他人。
 
 ---
 
-## 二、获取 API Key
+## 二、方式一：MCP 接入（最简单）
 
-1. 打开 [ai4scholar.net](https://ai4scholar.net)
-2. 注册或登录你的账号
-3. 进入 [API Keys 页面](https://ai4scholar.net/dashboard?view=api-keys)
-4. 点击「创建 API Key」，复制生成的 Key
+只需在 `openclaw.json`（通常在 `~/.openclaw/openclaw.json`）中添加 MCP 服务器配置：
 
-请妥善保管你的 API Key，不要分享给他人。
+```json
+{
+  "mcpServers": {
+    "ai4scholar": {
+      "url": "https://mcp.ai4scholar.net/sse",
+      "headers": {
+        "Authorization": "Bearer 你的API Key"
+      }
+    }
+  }
+}
+```
+
+重启 Gateway 即可使用：
+
+```bash
+openclaw gateway stop && openclaw gateway start
+```
+
+配好后直接跟 Agent 对话就能搜论文了。如果你需要更多能力（文献综述、自动引用、质量评估等），继续往下看插件安装方式。
 
 ---
 
-## 三、安装插件
+## 三、方式二：安装插件（完整体验）
+
+### 前提条件
+
+- **OpenClaw** 已安装并可正常运行（版本 ≥ 2024.0.0）
+- **Node.js** ≥ 18
+
+如果你还需要生成 HTML 格式的文献综述报告（可选），额外需要：
+
+- **Python** ≥ 3.8
+
+### 安装
 
 在终端中执行：
 
@@ -37,12 +76,28 @@
 openclaw plugins install ai4scholar
 ```
 
+安装过程会自动下载依赖，通常需要 1-2 分钟。如果你的服务器在国内，建议先配置 npm 镜像源以加快速度：
+
+```bash
+npm config set registry https://registry.npmmirror.com
+```
+
 安装完成后，重启 OpenClaw Gateway：
 
 ```bash
-openclaw gateway
+openclaw gateway stop && openclaw gateway start
+```
+
+> `openclaw gateway start` 会以后台服务方式运行，关闭终端也不会停止。如果只想前台调试，用 `openclaw gateway`（Ctrl+C 退出）。
+
+### 验证安装
+
+```bash
+openclaw plugins list
 ```
 
+你应该能看到 `ai4scholar` 出现在已安装插件列表中。
+
 ### 从源码安装（可选）
 
 如果你想参与开发或查看源码：
@@ -55,44 +110,42 @@ pnpm build
 openclaw plugins install -l .
 ```
 
----
-
-## 四、配置插件
+### 配置 API Key
 
-安装完成后，需要在 `openclaw.json` 中配置 API Key。
+安装完成后，插件已自动启用，但还需要配置 API Key。启动 Gateway 时你会看到提示信息，告诉你如何配置。
 
-打开你的 `openclaw.json` 文件，在 `plugins.entries` 下添加或修改 `ai4scholar` 配置：
+打开你的 `openclaw.json`（通常在 `~/.openclaw/openclaw.json`），找到 `ai4scholar` 部分，加上 `config`：
 
 ```json
-{
-  "plugins": {
-    "entries": {
-      "ai4scholar": {
-        "enabled": true,
-        "config": {
-          "apiKey": "你的API Key"
-        }
-      }
-    }
+"ai4scholar": {
+  "enabled": true,
+  "config": {
+    "apiKey": "你的API Key"
   }
 }
 ```
 
-也可以通过环境变量设置：
+> 安装器会自动创建 `"ai4scholar": { "enabled": true }`，你只需要加上 `"config": { "apiKey": "..." }` 这一行即可。
+
+API Key 获取地址：[ai4scholar.net](https://ai4scholar.net?src=openclaw)
+
+配置完成后重启 Gateway 即可生效：
 
 ```bash
-export AI4SCHOLAR_API_KEY="你的API Key"
+openclaw gateway stop && openclaw gateway start
 ```
 
-配置完成后重启 Gateway 即可生效。
+启动日志中出现 `apiKey: configured` 说明配置成功。
+
+> **提示**：arXiv、bioRxiv、medRxiv 的搜索和下载工具无需 API Key 即可使用。API Key 主要用于 Semantic Scholar、PubMed 和 Google Scholar。
 
 ---
 
-## 五、插件能力一览
+## 四、插件能力一览
 
-安装后，你的 OpenClaw Agent 将获得 **35 个学术工具**，覆盖 6 大数据库平台。
+安装后，你的 OpenClaw Agent 将获得 **37 个学术工具**，覆盖 6 大数据库平台。
 
-### 5.1 论文搜索
+### 4.1 论文搜索
 
 | 工具 | 平台 | 说明 |
 |------|------|------|
@@ -106,7 +159,7 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 | `search_semantic_bulk` | Semantic Scholar | 批量搜索，单次最多 1000 条 |
 | `search_semantic_paper_match` | Semantic Scholar | 按标题精确匹配 |
 
-### 5.2 论文详情
+### 4.2 论文详情
 
 | 工具 | 说明 |
 |------|------|
@@ -115,7 +168,7 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 | `get_semantic_paper_batch` | 批量获取论文详情（最多 500 篇） |
 | `get_pubmed_paper_batch` | 批量获取 PubMed 论文详情 |
 
-### 5.3 引用与参考文献
+### 4.3 引用与参考文献
 
 | 工具 | 说明 |
 |------|------|
@@ -124,7 +177,7 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 | `get_pubmed_citations` | PubMed 引用查询 |
 | `get_pubmed_related` | PubMed 相关论文推荐 |
 
-### 5.4 作者信息
+### 4.4 作者信息
 
 | 工具 | 说明 |
 |------|------|
@@ -134,14 +187,14 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 | `get_semantic_author_batch` | 批量获取作者详情（最多 1000 人） |
 | `get_semantic_paper_authors` | 获取某论文的所有作者详情 |
 
-### 5.5 论文推荐
+### 4.5 论文推荐
 
 | 工具 | 说明 |
 |------|------|
 | `get_semantic_recommendations` | 基于多篇论文推荐相关论文 |
 | `get_semantic_recommendations_for_paper` | 基于单篇论文推荐 |
 
-### 5.6 PDF 下载与全文阅读
+### 4.6 PDF 下载与全文阅读
 
 | 工具 | 说明 |
 |------|------|
@@ -156,15 +209,27 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 | `download_by_doi` | 通过 DOI 下载论文 PDF（支持校园网机构访问） |
 | `read_by_doi` | 通过 DOI 下载并提取论文全文 |
 
-### 5.7 论文质量评估
+### 4.7 论文质量评估
 
 | 工具 | 说明 |
 |------|------|
 | `paper_quality_rank` | 基于 CCF 分级、引用量、发表年份、作者 h-index 综合评分排序 |
 
+### 4.8 文献自动标注
+
+| 工具 | 说明 |
+|------|------|
+| `auto_cite` | 一键为学术文本添加真实引用，支持 IEEE / APA / Vancouver / Nature 格式，返回标注文本 + 参考文献列表 + BibTeX |
+
+### 4.9 科研绘图
+
+| 工具 | 说明 |
+|------|------|
+| `sci_draw` | AI 科研绘图：智能绘图（支持中文）、文生图、图片编辑、风格转换、多图组合、迭代优化、图片评审、SVG 矢量图 |
+
 ---
 
-## 六、Slash 命令
+## 五、Slash 命令
 
 安装插件后，你可以在聊天中使用以下快捷命令：
 
@@ -176,11 +241,9 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 
 ---
 
-## 七、内置技能
+## 六、内置技能
 
-插件包含两个 AI 技能，Agent 会根据你的需求自动调用。
-
-### 7.1 文献综述（literature-survey）
+### 6.1 文献综述（literature-survey）
 
 **触发方式**：当你明确要求 Agent 做一份完整的文献综述或生成 HTML 报告时。
 
@@ -193,34 +256,9 @@ export AI4SCHOLAR_API_KEY="你的API Key"
 
 Agent 会自动执行多轮搜索、筛选、整理，生成结构化的综述报告。
 
-### 7.2 自动引用标注（auto-cite）
-
-**触发方式**：当你粘贴一段学术文本，并要求 Agent 添加引用/参考文献时。
-
-**示例**：
-
-```
-请给下面这段文字加上引用：
-
-Large language models have shown remarkable capabilities in understanding 
-and generating scientific text. Recent studies demonstrate that these models 
-can assist in hypothesis generation, experimental design, and data analysis. 
-The integration of tool-use capabilities further enhances their potential 
-for automated scientific discovery.
-```
-
-Agent 会自动：
-1. 分析文本，识别需要引用的断言
-2. 在 Semantic Scholar、PubMed 等平台搜索匹配论文
-3. 用 `paper_quality_rank` 评估候选论文质量
-4. 在原文中插入引用标记 [1]、[2, 3]
-5. 在末尾生成 APA 格式参考文献列表
-
-所有引用的论文都是从真实数据库搜索得到的，DOI 可验证。
-
 ---
 
-## 八、使用示例
+## 七、使用示例
 
 以下是一些常见的使用场景，直接在聊天中发送即可。
 
@@ -269,9 +307,25 @@ Agent 会自动：
 ### 自动加引用
 
 ```
-给下面这段 Introduction 加上引用：
+给下面这段 Introduction 加上引用，用 IEEE 格式：
+
+（粘贴你的学术文本，100-10000 字符）
+```
+
+Agent 会调用 `auto_cite` 工具，服务端自动完成引用匹配，返回标注好的文本和参考文献列表（约 20-60 秒）。
+
+### 科研绘图
+
+```
+帮我画一张蛋白质结构示意图，标注 alpha helix 和 beta sheet
+```
+
+```
+帮我画一张 CRISPR-Cas9 基因编辑机制图，用高质量模式
+```
 
-（粘贴你的学术文本）
+```
+把这张图转换成论文风格（发送图片后）
 ```
 
 ### 文献综述
@@ -283,7 +337,7 @@ Agent 会自动：
 
 ---
 
-## 九、常见问题
+## 八、常见问题
 
 ### Q: 安装后提示 "plugin not found"
 
@@ -316,11 +370,15 @@ PDF 文本提取依赖论文的 PDF 格式。扫描版 PDF 或图片较多的论
 openclaw plugins install ai4scholar
 ```
 
-重新执行安装命令会自动更新到最新版本。更新后需要重启 Gateway。
+重新执行安装命令会自动更新到最新版本。更新后重启 Gateway：
+
+```bash
+openclaw gateway stop && openclaw gateway start
+```
 
 ---
 
-## 十、反馈与贡献
+## 九、反馈与贡献
 
 - **GitHub**: [github.com/literaf/ai4scholar](https://github.com/literaf/ai4scholar)
 - **网站**: [ai4scholar.net](https://ai4scholar.net)

package/openclaw.plugin.json

@@ -20,7 +20,7 @@
   "uiHints": {
     "apiKey": {
       "label": "AI4Scholar API Key",
-      "description": "Get your key at https://ai4scholar.net/dashboard?view=api-keys",
+      "description": "Get your key at https://ai4scholar.net?src=openclaw",
       "inputType": "password"
     },
     "autoUpdate": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai4scholar",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Multi-source academic literature search, management, and analysis plugin for OpenClaw. Powered by ai4scholar.net.",
   "type": "module",
   "main": "dist/index.js",

package/skills/literature-survey/SKILL.md

@@ -71,6 +71,13 @@ metadata:
 |------|---------|
 | `paper_quality_rank` | Rank papers by quality score (CCF classification, citations, year, h-index) |
 
+### Auto-Citation & Scientific Drawing
+
+| Tool | Purpose |
+|------|---------|
+| `auto_cite` | Automatically add real citations to academic text (server-side, supports IEEE/APA/Vancouver/Nature styles) |
+| `sci_draw` | Generate scientific figures with AI (text-to-image, edit, style transfer, SVG, critique) |
+
 ### PDF Download & Full-text Reading
 
 | Tool | Purpose |

package/skills/auto-cite/SKILL.md

@@ -1,150 +0,0 @@
----
-name: auto-cite
-description: "Automatically add citation markers to academic text and generate a numbered reference list. Use when the user pastes a paragraph or section (e.g. Introduction, Related Work) and asks to add citations/references."
-metadata:
-  {
-    "openclaw":
-      {
-        "emoji": "📎",
-      },
-  }
----
-
-# Auto-Cite: Automatic Citation Annotation
-
-**Don't ask permission. Just do it.**
-
-## What This Skill Does
-
-User pastes academic text → You identify where citations are needed → Search real papers → Insert citation markers [1], [2, 3] → Append a numbered APA reference list.
-
-Every cited paper MUST come from a real database (Semantic Scholar, PubMed, arXiv, bioRxiv, medRxiv). Never fabricate papers.
-
-## Workflow
-
-### Step 1: Analyze the Text
-
-Read the entire text. For each sentence, decide:
-
-**Needs citation:**
-- Factual claims ("X has been shown to...", "Studies have demonstrated...")
-- Methodological references ("The Transformer architecture...", "Using the BERT model...")
-- Statistical or quantitative claims ("affects 30% of...", "outperforms by 5%...")
-- Domain consensus ("It is widely accepted that...")
-- Comparisons or enumerations of existing methods
-
-**Does NOT need citation:**
-- The author's own contributions or opinions
-- Common knowledge ("Neural networks are computational models...")
-- Transitional sentences and connective text
-- Descriptions of the current paper's method
-
-Output a mental list of citation positions, each with:
-- The sentence or clause that needs a citation
-- What kind of support it needs (foundational work, method origin, evidence, survey)
-- 2-3 English search keywords
-
-### Step 2: Search Papers
-
-For each citation position, search across appropriate platforms:
-
-| Text Domain | Primary Search | Secondary Search |
-|-------------|---------------|-----------------|
-| Biomedical / Clinical | `search_pubmed` | `search_semantic`, `search_biorxiv`, `search_medrxiv` |
-| Computer Science / AI / ML | `search_semantic` | `search_arxiv` |
-| General / Cross-discipline | `search_semantic` | `search_pubmed` |
-| Preprints / Cutting-edge | `search_arxiv`, `search_biorxiv` | `search_semantic` |
-
-For each position, search 10-20 candidates. Use English search terms even for Chinese input text.
-
-**Do NOT use** `search_google_scholar` for this workflow — use the five platforms above.
-
-### Step 3: Rank by Quality
-
-Call `paper_quality_rank` with the candidate papers to get quality scores and CCF rankings.
-
-The tool evaluates:
-- **CCF rank** (A/B/C) for CS venues
-- **Citation count** (log-scaled)
-- **Publication year** (newer = better, within reason)
-- **Author h-index** (if available)
-- **arXiv penalty** (pure arXiv preprints score lower)
-
-### Step 4: Select Best Matches
-
-For each citation position, pick the best 1-3 papers considering:
-
-1. **Semantic relevance** (most important) — does the paper actually discuss what the sentence claims?
-2. **Quality score** from Step 3 — prefer higher-ranked venues and more-cited papers
-3. **Recency** — prefer newer papers unless citing foundational/seminal work
-4. **Diversity** — avoid citing the same paper in too many positions; avoid citing only one research group
-
-**Deduplication rules:**
-- If the same paper matches multiple positions, use a single reference number across all positions
-- If a sentence needs multiple citations (e.g., listing several approaches), group them: [3, 5, 7]
-- Aim for 1-2 citations per position; 3 is the maximum unless enumerating methods
-
-### Step 5: Generate Output
-
-Produce TWO sections:
-
-#### Part 1: Annotated Text
-
-The original text with [N] markers inserted at the correct positions.
-
-Rules:
-- Place markers at the END of the relevant clause or sentence, BEFORE the period
-- Use sequential numbering starting from [1]
-- Group multiple citations: [1, 2] or [3-5]
-- Preserve ALL original text — do not modify wording, only insert markers
-
-Example:
-```
-Large language models have achieved remarkable performance across NLP tasks [1, 2]. However, these models often generate outputs misaligned with human values [3]. RLHF has emerged as a promising approach to address this challenge [4, 5].
-```
-
-#### Part 2: Reference List
-
-Numbered APA-format references at the end. Each entry includes:
-- Authors (first author et al. if >3 authors)
-- Year in parentheses
-- Title
-- Journal/conference name
-- DOI or URL (if available)
-
-Format:
-```
-[1] Brown, T. et al. (2020). Language Models are Few-Shot Learners. Advances in Neural Information Processing Systems, 33, 1877-1901.
-[2] Touvron, H. et al. (2023). LLaMA: Open and Efficient Foundation Language Models. arXiv:2302.13971.
-```
-
-For papers with DOI, append the DOI link.
-For arXiv papers, use the arXiv ID format.
-For PubMed papers, include the PMID.
-
-## Chinese Input
-
-When user provides Chinese text:
-- Search keywords must be in **English** (translate internally)
-- Annotated text output remains in **Chinese** (preserve original)
-- Reference list uses English (paper titles, author names stay in original language)
-- Respond in Chinese when communicating with the user
-
-## Quality Checklist
-
-Before returning results, verify:
-
-- [ ] Every [N] marker corresponds to a real paper in the reference list
-- [ ] Every paper in the reference list has been verified via search tools (not hallucinated)
-- [ ] Citation positions are reasonable (factual claims have citations, opinions don't)
-- [ ] No duplicate entries in the reference list
-- [ ] Sequential numbering with no gaps
-- [ ] Reference list is in APA format
-
-## Constraints
-
-- **Never fabricate papers** — every citation must come from tool search results
-- **Never modify the user's original text** beyond inserting [N] markers
-- Do not add citations to the author's own claims or contributions
-- If a passage is too vague to find good citations, skip it rather than force a bad match
-- Prefer published papers over preprints when both are available