dsh-cite 0.3.0 → 0.3.1

package/README.en.md

@@ -1,8 +1,10 @@
 # dsh-cite
 
+![npm](https://img.shields.io/npm/v/dsh-cite) ![downloads](https://img.shields.io/npm/dm/dsh-cite) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-cite) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-cite?style=social)
+
 > Give it a DOI, get a proper citation — GB/T 7714 / APA / MLA / Chicago / BibTeX.
 
-A DeepSeek Harness plugin for bibliographic references: query Crossref and format citations. Four tools, zero runtime dependencies.
+A DeepSeek Harness plugin for bibliographic references: query Crossref and format citations. Five tools (including the `cite_health` self-check), zero runtime dependencies.
 
 ## Tools
 
@@ -12,10 +14,11 @@ A DeepSeek Harness plugin for bibliographic references: query Crossref and forma
 | `cite_format` | Generate a formatted citation | `doi`; `style`: gb-t-7714 / apa / mla / chicago |
 | `cite_bibtex` | Generate a BibTeX entry | `doi`; `key` optional |
 | `cite_check` | Extract DOIs from text and validate them | `text`; `maxChecks` 1-50, default 10 |
+| `cite_health` | Self-check: probe Crossref connectivity and report latency | none |
 
 ## Compatibility
 
-Verified against `@deepseek-ai/dsh@0.1.1-rc.2` on 2026-08-26. Built for the cordis patch-bundle plugin model (`cordis.patch.yml` + `dsh.bundle.patch`). No runtime imports of `@deepseek-ai/*` internals.
+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.
 
 ## Install
 
@@ -23,8 +26,6 @@ Verified against `@deepseek-ai/dsh@0.1.1-rc.2` on 2026-08-26. Built for the cord
 dsh plugin --profile web add dsh-cite
 ```
 
-MIT
-
 ## Uninstall
 
 ```bash

package/README.md

@@ -1,8 +1,10 @@
 # dsh-cite
 
+![npm](https://img.shields.io/npm/v/dsh-cite) ![downloads](https://img.shields.io/npm/dm/dsh-cite) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-cite) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-cite?style=social)
+
 > 给一个 DOI，还你规范参考文献——GB/T 7714 / APA / MLA / Chicago / BibTeX。
 
-DeepSeek Harness 参考文献工具插件：通过 Crossref API 查询文献元数据并格式化引用。四个工具、零运行时依赖、全平台通用。
+DeepSeek Harness 参考文献工具插件：通过 Crossref API 查询文献元数据并格式化引用。五个工具（含 `cite_health` 自检）、零运行时依赖、全平台通用。
 
 ## 工具
 
@@ -12,10 +14,11 @@ DeepSeek Harness 参考文献工具插件：通过 Crossref API 查询文献元
 | `cite_format` | 生成规范引文 | `doi` 必填；`style`：gb-t-7714 / apa / mla / chicago |
 | `cite_bibtex` | 生成 BibTeX 条目 | `doi` 必填；`key` 可选 |
 | `cite_check` | 从文本提取 DOI 并并发校验是否存在（并发 3，保持输入顺序） | `text` 必填；`maxChecks` 1-50 默认 10 |
+| `cite_health` | 自检：探测 Crossref 连通性并报告延迟 | 无 |
 
 ## 兼容性
 
-在 `@deepseek-ai/dsh@0.1.1-rc.2` 上验证（2026-08-26）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
+在 `@deepseek-ai/dsh@0.1.2-alpha.2` 上验证（2026-08-31）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。
 
 ## 安装
 

package/lib/config.d.ts

@@ -11,6 +11,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 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

@@ -4,7 +4,7 @@
  * @module dsh-cite/config
  */
 const DEFAULT_TIMEOUT_MS = 15000;
-const DEFAULT_USER_AGENT = 'dsh-cite/0.2.0 (DeepSeek Harness citation plugin; mailto:STARDUSTLC666@users.noreply.github.com)';
+export const DEFAULT_USER_AGENT = 'dsh-cite/0.3.1 (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.js

@@ -6,7 +6,7 @@
 const CROSSREF_API = 'https://api.crossref.org/works/';
 const DOI_PATTERN = /^10\.\d{4,9}\/[-._;()/:A-Za-z0-9]+$/i;
 export function assertDoi(value) {
-    const doi = value.trim().replace(/^https?:\/\/doi\.org\//i, '').replace(/^doi:\s*/i, '');
+    const doi = value.trim().replace(/^https?:\/\/(dx\.)?doi\.org\//i, '').replace(/^doi:\s*/i, '');
     if (!DOI_PATTERN.test(doi))
         throw new Error('DOI 格式不正确：' + value + '（示例：10.1038/nature12345）。');
     return doi;

package/lib/format.js

@@ -146,14 +146,15 @@ function buildApa(work) {
             text += '(' + work.issue + ')';
         if (work.page !== '')
             text += ', ' + work.page;
-        text += '. ';
-        text += work.doi !== '' ? 'https://doi.org/' + work.doi : work.url;
-        return text;
+        const tail = work.doi !== '' ? 'https://doi.org/' + work.doi : work.url;
+        if (tail !== '')
+            return text + '. ' + tail;
+        return text + '.';
     }
     if (work.type === 'book' || work.type === 'monograph' || work.type === 'edited-book') {
-        return authors + ' (' + year + '). ' + title + '. ' + (work.publisher !== '' ? work.publisher + '.' : '');
+        return authors + ' (' + year + '). ' + title + '.' + (work.publisher !== '' ? ' ' + work.publisher + '.' : '');
     }
-    return authors + ' (' + year + '). ' + title + '. ' + (work.url !== '' ? work.url : '');
+    return authors + ' (' + year + '). ' + title + '.' + (work.url !== '' ? ' ' + work.url : '');
 }
 /** 生成 MLA 9 参考文献条目。 */
 function buildMla(work) {
@@ -241,7 +242,7 @@ function bibtexType(work) {
 export function buildBibtex(work, key) {
     const first = work.authors[0];
     const firstWord = titleOf(work).split(/[^\p{L}\p{N}]+/u).find((part) => part !== '') ?? 'work';
-    const baseKey = key !== undefined && key.trim() !== '' ? sanitizeBibtexKey(key.trim()) : ((first?.family ?? first?.name ?? 'author') + yearText(work) + firstWord).toLowerCase();
+    const baseKey = key !== undefined && key.trim() !== '' ? sanitizeBibtexKey(key.trim()) : sanitizeBibtexKey(((first?.family || first?.name || 'author') + yearText(work) + firstWord).toLowerCase());
     const type = bibtexType(work);
     const fields = [];
     const authors = work.authors.map((author) => fullName(author)).join(' and ');

package/lib/index.d.ts

@@ -1,9 +1,9 @@
 /**
  * dsh-cite —— 参考文献工具插件（node 半身，配置走 cordis.patch.yml）。
  *
- * 插件导出 apply(ctx, config)：注册四个面向模型的工具（cite_lookup / cite_format /
- * cite_bibtex / cite_check），通过 Crossref API 查询元数据并生成 GB/T 7714 / APA /
- * MLA / Chicago 引文。零运行时依赖。
+ * 插件导出 apply(ctx, config)：注册五个面向模型的工具（cite_lookup / cite_format /
+ * cite_bibtex / cite_check / cite_health），通过 Crossref API 查询元数据并生成
+ * GB/T 7714 / APA / MLA / Chicago 引文。零运行时依赖。
  *
  * @module dsh-cite
  */

package/lib/index.js

@@ -1,9 +1,9 @@
 /**
  * dsh-cite —— 参考文献工具插件（node 半身，配置走 cordis.patch.yml）。
  *
- * 插件导出 apply(ctx, config)：注册四个面向模型的工具（cite_lookup / cite_format /
- * cite_bibtex / cite_check），通过 Crossref API 查询元数据并生成 GB/T 7714 / APA /
- * MLA / Chicago 引文。零运行时依赖。
+ * 插件导出 apply(ctx, config)：注册五个面向模型的工具（cite_lookup / cite_format /
+ * cite_bibtex / cite_check / cite_health），通过 Crossref API 查询元数据并生成
+ * GB/T 7714 / APA / MLA / Chicago 引文。零运行时依赖。
  *
  * @module dsh-cite
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-cite",
-  "version": "0.3.0",
-  "description": "DSH 参考文献工具插件：cite_lookup/cite_format/cite_bibtex/cite_check 四工具，Crossref 元数据查询（含 DOI 精确解析与并发校验），GB/T 7714 / APA / MLA / Chicago 格式化，零运行时依赖。",
+  "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",