dsh-cite 0.3.2 → 0.3.4

package/README.en.md

@@ -1,5 +1,11 @@
 # dsh-cite
 
+## 0.3.4 update (2026-09-27)
+
+Preserves given/family name boundaries and compound surnames in BibTeX. Corporate authors are protected with braces instead of being parsed as personal names.
+
+Validation host: Harness 0.1.7-rc.2 built from official sources, retaining the local tool-scheduler fix. Build and automated checks pass; interactive coverage and external-service limits are recorded in this release round.
+
 ![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.
@@ -18,7 +24,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

@@ -1,5 +1,11 @@
 # dsh-cite
 
+## 0.3.4 更新（2026-09-27）
+
+修复 BibTeX 作者姓名顺序，保留复合姓氏；机构作者使用独立括号，避免被拆成人名。
+
+验证宿主：官方源码构建的 Harness 0.1.7-rc.2（保留本地工具调度器修复）。构建与自动测试通过；实际操作和外部服务限制见本轮验收记录。
+
 ![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。
@@ -18,7 +24,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.2 (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.2 (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/format.js

@@ -245,9 +245,17 @@ export function buildBibtex(work, key) {
     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 ');
+    const authors = work.authors.map((author) => {
+        // BibTeX interprets an unpunctuated personal name as First Last.
+        // Preserve the provider's family/given boundary, including compound surnames.
+        if (author.name !== '')
+            return '{' + escapeLatex(author.name) + '}';
+        if (author.family !== '' && author.given !== '')
+            return escapeLatex(author.family) + ', ' + escapeLatex(author.given);
+        return '{' + escapeLatex(author.family || author.given) + '}';
+    }).join(' and ');
     if (authors !== '')
-        fields.push('  author={' + escapeLatex(authors) + '}');
+        fields.push('  author={' + authors + '}');
     fields.push('  title={' + escapeLatex(titleOf(work)) + '}');
     if (work.containerTitle !== '')
         fields.push(type === 'article' ? '  journal={' + escapeLatex(work.containerTitle) + '}' : '  booktitle={' + escapeLatex(work.containerTitle) + '}');

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "dsh-cite",
-  "version": "0.3.2",
-  "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.4",
+  "description": "DSH 参考文献插件：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"
+}