dsh-cite 0.3.1 → 0.3.3

package/README.en.md

@@ -18,7 +18,7 @@ A DeepSeek Harness plugin for bibliographic references: query Crossref and forma
 
 ## Compatibility
 
-Verified against `@deepseek-ai/dsh@0.1.2-alpha.2` on 2026-08-31. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+Verified with official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: all 18 components load alongside Modlens, with passing tool-schema, skill-registration and offline read-only invocation checks. Uses the `cordis.patch.yml` + `dsh.bundle.patch` bundle model. Node requirements match this Harness release: 22.19 or later within 22.x, or 24 or later. Live external-service workflows require separate configuration and validation.
 
 ## Install
 

package/README.md

@@ -18,7 +18,7 @@ DeepSeek Harness 参考文献工具插件：通过 Crossref API 查询文献元
 
 ## 兼容性
 
-在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+已在官方 `@deepseek-ai/dsh@0.1.5-rc.1`、Node `24.16.0` 上验证（2026-09-11）：18 个组件与 Modlens 同载，工具 schema、技能注册及离线只读调用检查通过。采用 `cordis.patch.yml` + `dsh.bundle.patch` 组合包模型。Node 要求与该版本 Harness 一致：22.19 及以上的 22.x，或 24 及以上。外部服务的实际业务操作需按各组件配置单独验证。
 
 ## 安装
 

package/lib/config.d.ts

@@ -1,8 +1,3 @@
-/**
- * dsh-cite 配置解析：Crossref 请求超时与 User-Agent。
- *
- * @module dsh-cite/config
- */
 export interface CiteConfig {
     timeoutMs?: number;
     userAgent?: string;
@@ -11,7 +6,7 @@ export interface ResolvedCiteConfig {
     timeoutMs: number;
     userAgent: string;
 }
-export declare const DEFAULT_USER_AGENT = "dsh-cite/0.3.1 (DeepSeek Harness citation plugin; mailto:STARDUSTLC666@users.noreply.github.com)";
+export declare const DEFAULT_USER_AGENT: string;
 export declare const CITE_TIMEOUT_ENV = "DSH_CITE_TIMEOUT_MS";
 export declare const CITE_USER_AGENT_ENV = "DSH_CITE_USER_AGENT";
 export declare function resolveConfig(config: CiteConfig | undefined | null, env?: NodeJS.ProcessEnv): ResolvedCiteConfig;

package/lib/config.js

@@ -3,8 +3,10 @@
  *
  * @module dsh-cite/config
  */
+import { createRequire } from 'node:module';
 const DEFAULT_TIMEOUT_MS = 15000;
-export const DEFAULT_USER_AGENT = 'dsh-cite/0.3.1 (DeepSeek Harness citation plugin; mailto:STARDUSTLC666@users.noreply.github.com)';
+const pkg = createRequire(import.meta.url)('../package.json');
+export const DEFAULT_USER_AGENT = `dsh-cite/${pkg.version} (DeepSeek Harness citation plugin; mailto:STARDUSTLC666@users.noreply.github.com)`;
 export const CITE_TIMEOUT_ENV = 'DSH_CITE_TIMEOUT_MS';
 export const CITE_USER_AGENT_ENV = 'DSH_CITE_USER_AGENT';
 export function resolveConfig(config, env = process.env) {

package/lib/crossref.d.ts

@@ -30,8 +30,8 @@ export type FetchLike = (url: string, init?: {
 }) => Promise<Response>;
 export declare function assertDoi(value: string): string;
 /** 按 DOI 查询 Crossref 并归一化。 */
-export declare function lookupDoi(doi: string, cfg: ResolvedCiteConfig, fetchImpl?: FetchLike): Promise<Work>;
+export declare function lookupDoi(doi: string, cfg: ResolvedCiteConfig, fetchImpl?: FetchLike, signal?: AbortSignal): Promise<Work>;
 /** 按题录文本检索 Crossref，返回归一化结果。 */
-export declare function searchWorks(query: string, limit: number, cfg: ResolvedCiteConfig, fetchImpl?: FetchLike): Promise<Work[]>;
+export declare function searchWorks(query: string, limit: number, cfg: ResolvedCiteConfig, fetchImpl?: FetchLike, signal?: AbortSignal): Promise<Work[]>;
 /** 从任意文本里提取 DOI。 */
 export declare function extractDois(text: string): string[];

package/lib/crossref.js

@@ -63,18 +63,23 @@ function normalizeWork(raw) {
 function makeHeaders(cfg) {
     return { 'user-agent': cfg.userAgent, accept: 'application/json' };
 }
+function requestSignal(timeoutMs, signal) {
+    const timeoutSignal = AbortSignal.timeout(timeoutMs);
+    return signal === undefined ? timeoutSignal : AbortSignal.any([signal, timeoutSignal]);
+}
 /** 按 DOI 查询 Crossref 并归一化。 */
-export async function lookupDoi(doi, cfg, fetchImpl) {
+export async function lookupDoi(doi, cfg, fetchImpl, signal) {
     const clean = assertDoi(doi);
     const fetcher = fetchImpl ?? globalThis.fetch;
     let response;
     try {
         response = await fetcher(CROSSREF_API + encodeURIComponent(clean), {
             headers: makeHeaders(cfg),
-            signal: AbortSignal.timeout(cfg.timeoutMs),
+            signal: requestSignal(cfg.timeoutMs, signal),
         });
     }
     catch (error) {
+        signal?.throwIfAborted();
         throw new Error('Crossref 请求失败：' + (error instanceof Error ? error.message : String(error)));
     }
     if (!response.ok) {
@@ -98,7 +103,7 @@ export async function lookupDoi(doi, cfg, fetchImpl) {
     return work;
 }
 /** 按题录文本检索 Crossref，返回归一化结果。 */
-export async function searchWorks(query, limit, cfg, fetchImpl) {
+export async function searchWorks(query, limit, cfg, fetchImpl, signal) {
     const q = query.trim();
     if (q === '')
         throw new Error('检索词不能为空。');
@@ -108,10 +113,11 @@ export async function searchWorks(query, limit, cfg, fetchImpl) {
     try {
         response = await fetcher(url, {
             headers: makeHeaders(cfg),
-            signal: AbortSignal.timeout(cfg.timeoutMs),
+            signal: requestSignal(cfg.timeoutMs, signal),
         });
     }
     catch (error) {
+        signal?.throwIfAborted();
         throw new Error('Crossref 检索失败：' + (error instanceof Error ? error.message : String(error)));
     }
     if (!response.ok)

package/lib/index.d.ts

@@ -14,9 +14,7 @@ export declare const name = "cite";
 export declare const inject: string[];
 export interface CitePluginContext {
     tools: {
-        register(definition: CiteToolDefinition, options?: {
-            prepend?: boolean;
-        }): () => void;
+        register(definition: CiteToolDefinition): () => void;
     };
     on?(event: string, listener: () => void): () => void;
 }

package/lib/index.js

@@ -23,7 +23,7 @@ export function apply(ctx, config) {
     }
     const disposers = [];
     for (const definition of buildCiteTools(cfg)) {
-        disposers.push(ctx.tools.register(definition, { prepend: true }));
+        disposers.push(ctx.tools.register(definition));
     }
     if (typeof ctx.on === 'function') {
         ctx.on('dispose', () => {

package/lib/tools.js

@@ -74,11 +74,12 @@ const checkSchema = {
     additionalProperties: true,
 };
 /** 以固定并发度执行异步任务并保持原顺序。 */
-async function mapWithConcurrency(items, concurrency, fn) {
+async function mapWithConcurrency(items, concurrency, fn, signal) {
     const results = new Array(items.length);
     let next = 0;
     const workers = Array.from({ length: Math.min(concurrency, items.length) }, async () => {
         while (true) {
+            signal?.throwIfAborted();
             const index = next;
             next += 1;
             if (index >= items.length)
@@ -89,6 +90,14 @@ async function mapWithConcurrency(items, concurrency, fn) {
     await Promise.all(workers);
     return results;
 }
+function executionSignal(exec) {
+    if (typeof exec !== 'object' || exec === null)
+        return undefined;
+    const signal = exec.signal;
+    return signal instanceof AbortSignal ? signal : undefined;
+}
+const CHECK_CONCURRENCY = 3;
+const MAX_CHECKS = 50;
 function workLabel(work) {
     const title = work.title !== '' ? work.title : '(无标题)';
     return title + '（' + (work.year > 0 ? work.year + ', ' : '') + (work.containerTitle !== '' ? work.containerTitle : work.publisher) + '）';
@@ -107,23 +116,23 @@ export function buildCiteTools(cfg, fetchImpl) {
                 const works = Array.isArray(rec.works) ? rec.works : [];
                 return [{ type: 'text', text: works.map((work, index) => (index + 1) + '. ' + workLabel(work)).join('\n') }];
             } },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = (rawArgs ?? {});
             const doi = optionalString(args, 'doi');
             const query = optionalString(args, 'query');
             if (doi === undefined && query === undefined)
                 throw new Error('cite_lookup 需要 doi 或 query 参数（至少一个）。');
             if (doi !== undefined) {
-                const work = await lookupDoi(doi, cfg, fetchImpl);
+                const work = await lookupDoi(doi, cfg, fetchImpl, executionSignal(exec));
                 return { count: 1, works: [work] };
             }
             const queryDoi = extractDois(query)[0];
             if (queryDoi !== undefined) {
-                const work = await lookupDoi(queryDoi, cfg, fetchImpl);
+                const work = await lookupDoi(queryDoi, cfg, fetchImpl, executionSignal(exec));
                 return { count: 1, works: [work], matchedDoi: queryDoi };
             }
             const limit = optionalInteger(args, 'limit', '返回条数', 1, 10, 5);
-            const works = await searchWorks(query, limit, cfg, fetchImpl);
+            const works = await searchWorks(query, limit, cfg, fetchImpl, executionSignal(exec));
             if (works.length === 0)
                 throw new Error('Crossref 没有找到匹配文献，请尝试更精确的标题/作者。');
             return { count: works.length, works };
@@ -142,12 +151,12 @@ export function buildCiteTools(cfg, fetchImpl) {
                 const rec = (value ?? {});
                 return [{ type: 'text', text: typeof rec.citation === 'string' ? rec.citation : '' }];
             } },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = (rawArgs ?? {});
             const doi = requiredString(args, 'doi', 'DOI');
             const style = readStyle(args.style);
             const lang = args.lang === 'en' ? 'en' : 'zh';
-            const work = await lookupDoi(doi, cfg, fetchImpl);
+            const work = await lookupDoi(doi, cfg, fetchImpl, executionSignal(exec));
             const citation = buildCitation(work, style, lang);
             return { doi: work.doi || doi, style, citation, work };
         },
@@ -164,13 +173,13 @@ export function buildCiteTools(cfg, fetchImpl) {
                 const rec = (value ?? {});
                 return [{ type: 'text', text: typeof rec.bibtex === 'string' ? rec.bibtex : '' }];
             } },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = (rawArgs ?? {});
             const doi = requiredString(args, 'doi', 'DOI');
             const key = optionalString(args, 'key');
-            const work = await lookupDoi(doi, cfg, fetchImpl);
+            const work = await lookupDoi(doi, cfg, fetchImpl, executionSignal(exec));
             const bibtex = buildBibtex(work, key);
-            return { doi: work.doi || doi, key, bibtex };
+            return { doi: work.doi || doi, ...(key !== undefined ? { key } : {}), bibtex };
         },
         timeoutMs: cfg.timeoutMs + 2000,
     };
@@ -189,23 +198,25 @@ export function buildCiteTools(cfg, fetchImpl) {
                             return (row.ok === true ? '✅' : '❌') + ' ' + row.doi + (typeof row.title === 'string' && row.title !== '' ? ' — ' + row.title : '');
                         }).join('\n') }];
             } },
-        async execute(rawArgs) {
+        async execute(rawArgs, exec) {
             const args = (rawArgs ?? {});
             const text = requiredString(args, 'text', '待检查文本');
             const maxChecks = optionalInteger(args, 'maxChecks', '校验数量', 1, 50, 10);
             const dois = extractDois(text).slice(0, maxChecks);
-            const results = await mapWithConcurrency(dois, 3, async (doi) => {
+            const signal = executionSignal(exec);
+            const results = await mapWithConcurrency(dois, CHECK_CONCURRENCY, async (doi) => {
                 try {
-                    const work = await lookupDoi(doi, cfg, fetchImpl);
+                    const work = await lookupDoi(doi, cfg, fetchImpl, signal);
                     return { doi, ok: true, title: work.title, url: work.url };
                 }
                 catch (error) {
+                    signal?.throwIfAborted();
                     return { doi, ok: false, title: '', url: '', error: error instanceof Error ? error.message : String(error) };
                 }
-            });
+            }, signal);
             return { count: results.length, results };
         },
-        timeoutMs: cfg.timeoutMs * 3 + 5000,
+        timeoutMs: cfg.timeoutMs * Math.ceil(MAX_CHECKS / CHECK_CONCURRENCY) + 5000,
     };
     const citeHealth = {
         name: 'cite_health',
@@ -224,16 +235,20 @@ export function buildCiteTools(cfg, fetchImpl) {
                 return [{ type: 'text', text: lines.join('\n') }];
             },
         },
-        async execute() {
+        async execute(_rawArgs, exec) {
             const checks = [];
             let ok = true;
             const startedAt = Date.now();
+            const signal = executionSignal(exec);
             try {
                 const fetcher = fetchImpl ?? globalThis.fetch;
                 const response = await fetcher('https://api.crossref.org/works?rows=1&select=DOI', {
                     headers: { 'user-agent': cfg.userAgent },
-                    signal: AbortSignal.timeout(Math.min(cfg.timeoutMs, 15000)),
+                    signal: signal === undefined
+                        ? AbortSignal.timeout(Math.min(cfg.timeoutMs, 15000))
+                        : AbortSignal.any([signal, AbortSignal.timeout(Math.min(cfg.timeoutMs, 15000))]),
                 });
+                signal?.throwIfAborted();
                 if (response.ok) {
                     checks.push({ name: 'Crossref API', ok: true, detail: 'HTTP ' + response.status + '，' + (Date.now() - startedAt) + 'ms' });
                 }
@@ -243,6 +258,7 @@ export function buildCiteTools(cfg, fetchImpl) {
                 }
             }
             catch (error) {
+                signal?.throwIfAborted();
                 ok = false;
                 checks.push({ name: 'Crossref API', ok: false, detail: (error instanceof Error ? error.message : String(error)) + '（网络需要特殊代理时请配置系统代理后重启）' });
             }

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "dsh-cite",
-  "version": "0.3.1",
-  "description": "DSH 参考文献工具插件：cite_lookup/cite_format/cite_bibtex/cite_check/cite_health 五工具（含自检），Crossref 元数据查询（含 DOI 精确解析与并发校验），GB/T 7714 / APA / MLA / Chicago 格式化，零运行时依赖。",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
-    "prepublishOnly": "pnpm run build"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "citation",
-    "crossref",
-    "gb-t-7714",
-    "apa",
-    "mla",
-    "chicago",
-    "dsh-plugin"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=22"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.6.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/STARDUSTLC666/dsh-cite.git"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-cite/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-cite#readme",
-  "author": "stardustlc",
-  "packageManager": "pnpm@11.7.0"
-}
+{
+  "name": "dsh-cite",
+  "version": "0.3.3",
+  "description": "DSH 参考文献工具插件：cite_lookup/cite_format/cite_bibtex/cite_check/cite_health 五工具（含自检），Crossref 元数据查询（含 DOI 精确解析与并发校验），GB/T 7714 / APA / MLA / Chicago 格式化，零运行时依赖。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "citation",
+    "crossref",
+    "gb-t-7714",
+    "apa",
+    "mla",
+    "chicago",
+    "dsh-plugin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STARDUSTLC666/dsh-cite.git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-cite/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-cite#readme",
+  "author": "stardustlc",
+  "packageManager": "pnpm@11.7.0"
+}