dsh-source-cnki 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/CHANGELOG.md +48 -0
  2. package/LICENSE +201 -0
  3. package/README-zh.md +106 -0
  4. package/README.md +105 -2
  5. package/cordis.patch.yml +17 -0
  6. package/lib/cite.d.ts +33 -0
  7. package/lib/cite.d.ts.map +1 -0
  8. package/lib/cite.js +117 -0
  9. package/lib/cite.js.map +1 -0
  10. package/lib/config.d.ts +32 -0
  11. package/lib/config.d.ts.map +1 -0
  12. package/lib/config.js +44 -0
  13. package/lib/config.js.map +1 -0
  14. package/lib/formats.d.ts +61 -0
  15. package/lib/formats.d.ts.map +1 -0
  16. package/lib/formats.js +217 -0
  17. package/lib/formats.js.map +1 -0
  18. package/lib/index.d.ts +39 -0
  19. package/lib/index.d.ts.map +1 -0
  20. package/lib/index.js +51 -0
  21. package/lib/index.js.map +1 -0
  22. package/lib/runtime.d.ts +84 -0
  23. package/lib/runtime.d.ts.map +1 -0
  24. package/lib/runtime.js +228 -0
  25. package/lib/runtime.js.map +1 -0
  26. package/lib/tools/cnki-check.d.ts +12 -0
  27. package/lib/tools/cnki-check.d.ts.map +1 -0
  28. package/lib/tools/cnki-check.js +56 -0
  29. package/lib/tools/cnki-check.js.map +1 -0
  30. package/lib/tools/cnki-cite.d.ts +12 -0
  31. package/lib/tools/cnki-cite.d.ts.map +1 -0
  32. package/lib/tools/cnki-cite.js +62 -0
  33. package/lib/tools/cnki-cite.js.map +1 -0
  34. package/lib/tools/cnki-import.d.ts +12 -0
  35. package/lib/tools/cnki-import.d.ts.map +1 -0
  36. package/lib/tools/cnki-import.js +75 -0
  37. package/lib/tools/cnki-import.js.map +1 -0
  38. package/lib/tools/shared.d.ts +20 -0
  39. package/lib/tools/shared.d.ts.map +1 -0
  40. package/lib/tools/shared.js +14 -0
  41. package/lib/tools/shared.js.map +1 -0
  42. package/lib/validate.d.ts +29 -0
  43. package/lib/validate.d.ts.map +1 -0
  44. package/lib/validate.js +51 -0
  45. package/lib/validate.js.map +1 -0
  46. package/lib/version.d.ts +7 -0
  47. package/lib/version.d.ts.map +1 -0
  48. package/lib/version.js +7 -0
  49. package/lib/version.js.map +1 -0
  50. package/package.json +79 -4
  51. package/src/cite.ts +124 -0
  52. package/src/config.ts +64 -0
  53. package/src/formats.ts +236 -0
  54. package/src/index.ts +62 -0
  55. package/src/runtime.ts +254 -0
  56. package/src/tools/cnki-check.ts +56 -0
  57. package/src/tools/cnki-cite.ts +62 -0
  58. package/src/tools/cnki-import.ts +74 -0
  59. package/src/tools/shared.ts +14 -0
  60. package/src/validate.ts +65 -0
  61. package/src/version.ts +7 -0
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Config schema and resolution for `dsh-source-cnki`.
3
+ * @module dsh-source-cnki/config
4
+ */
5
+ import z from '@deepseek-ai/schemastery';
6
+ /** Raw plugin config. */
7
+ export interface Config {
8
+ enabled?: boolean;
9
+ root?: string;
10
+ workspaceRoot?: string;
11
+ maxChars?: number;
12
+ persist?: boolean;
13
+ style?: string;
14
+ }
15
+ /** Fully resolved config. */
16
+ export interface ResolvedConfig {
17
+ readonly enabled: boolean;
18
+ readonly root: string;
19
+ readonly workspaceRoot: string;
20
+ readonly maxChars: number;
21
+ readonly persist: boolean;
22
+ readonly style: 'gbt7714' | 'gbt7714-numeric' | 'apa';
23
+ }
24
+ /** Schemastery schema. */
25
+ export declare const Config: z<Config>;
26
+ /**
27
+ * Validate raw values and fill explicit defaults.
28
+ * @param config - raw plugin config.
29
+ * @returns the fully resolved config.
30
+ */
31
+ export declare function resolveConfig(config?: Config): ResolvedConfig;
32
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,yBAAyB;AACzB,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB,GAAG,KAAK,CAAA;CACtD;AAED,0BAA0B;AAC1B,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAO3B,CAAA;AAOF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAejE"}
package/lib/config.js ADDED
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Config schema and resolution for `dsh-source-cnki`.
3
+ * @module dsh-source-cnki/config
4
+ */
5
+ import path from 'node:path';
6
+ import z from '@deepseek-ai/schemastery';
7
+ /** Schemastery schema. */
8
+ export const Config = z.object({
9
+ enabled: z.boolean().default(true),
10
+ root: z.string().default('.source-cnki'),
11
+ workspaceRoot: z.string(),
12
+ maxChars: z.number().default(2_000_000),
13
+ persist: z.boolean().default(true),
14
+ style: z.string().default('gbt7714-numeric'),
15
+ });
16
+ /** Throw unless the value is a positive safe integer. */
17
+ function assertPositiveInt(name, value) {
18
+ if (!Number.isSafeInteger(value) || value <= 0)
19
+ throw new TypeError(`${name} must be a positive safe integer, got ${String(value)}`);
20
+ }
21
+ /**
22
+ * Validate raw values and fill explicit defaults.
23
+ * @param config - raw plugin config.
24
+ * @returns the fully resolved config.
25
+ */
26
+ export function resolveConfig(config = {}) {
27
+ const root = config.root ?? '.source-cnki';
28
+ if (typeof root !== 'string' || root.trim() === '')
29
+ throw new TypeError('root must be a non-empty path');
30
+ const maxChars = config.maxChars ?? 2_000_000;
31
+ assertPositiveInt('maxChars', maxChars);
32
+ const style = config.style ?? 'gbt7714-numeric';
33
+ if (!['gbt7714', 'gbt7714-numeric', 'apa'].includes(style))
34
+ throw new TypeError('style must be gbt7714, gbt7714-numeric or apa');
35
+ return {
36
+ enabled: config.enabled ?? true,
37
+ root: path.resolve(root),
38
+ workspaceRoot: path.resolve(config.workspaceRoot ?? process.cwd()),
39
+ maxChars,
40
+ persist: config.persist ?? true,
41
+ style: style,
42
+ };
43
+ }
44
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAsBxC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAc,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC;CAC7C,CAAC,CAAA;AAEF,yDAAyD;AACzD,SAAS,iBAAiB,CAAC,IAAY,EAAE,KAAa;IACpD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,yCAAyC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AACtI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,cAAc,CAAA;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAA;IACxG,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAA;IAC7C,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,iBAAiB,CAAA;IAC/C,IAAI,CAAC,CAAC,SAAS,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAA;IAChI,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClE,QAAQ;QACR,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,KAAK,EAAE,KAA8C;KACtD,CAAA;AACH,CAAC"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * Importing Chinese-literature records from exported files.
3
+ *
4
+ * Scope decision, stated up front: CNKI has no public API for this purpose, and
5
+ * the plugin **does not log in and does not scrape**. It reads what the user
6
+ * exported — RIS/EndNote-style tagged text or a labeled (`题名:…`) text file —
7
+ * and turns it into structured records. Anything the export does not contain is
8
+ * reported as missing, never inferred.
9
+ *
10
+ * @module dsh-source-cnki/formats
11
+ */
12
+ /** One bibliographic record. */
13
+ export interface BibRecord {
14
+ readonly recordId: string;
15
+ readonly type: 'journal' | 'thesis' | 'conference' | 'book' | 'other';
16
+ readonly title: string;
17
+ readonly authors: readonly string[];
18
+ readonly journal?: string;
19
+ readonly year?: number;
20
+ readonly volume?: string;
21
+ readonly issue?: string;
22
+ readonly pages?: string;
23
+ readonly doi?: string;
24
+ readonly keywords?: readonly string[];
25
+ readonly abstract?: string;
26
+ readonly language: 'zh' | 'en' | 'unknown';
27
+ }
28
+ /** Parse failure codes. */
29
+ export type ImportErrorCode = 'EMPTY' | 'NO_RECORDS' | 'UNKNOWN_FORMAT';
30
+ /** A typed import failure. */
31
+ export declare class ImportError extends Error {
32
+ /** Stable code. */
33
+ readonly code: ImportErrorCode;
34
+ constructor(code: ImportErrorCode, message: string);
35
+ }
36
+ /** Stable record id from a DOI, or from title+year. */
37
+ export declare function recordIdOf(input: {
38
+ doi?: string;
39
+ title: string;
40
+ year?: number;
41
+ }): string;
42
+ /**
43
+ * Parse an RIS/EndNote-style export (`TY - JOUR` … `ER -`).
44
+ * @param text - the export.
45
+ * @returns records (empty when the format does not match).
46
+ */
47
+ export declare function parseRis(text: string): BibRecord[];
48
+ /**
49
+ * Parse a labeled text export (`题名:…`, `作者:…`, blank line between records).
50
+ * @param text - the export.
51
+ * @returns records (empty when the format does not match).
52
+ */
53
+ export declare function parseLabeled(text: string): BibRecord[];
54
+ /**
55
+ * Import records with format detection.
56
+ * @param text - the export text.
57
+ * @param format - `auto`, `ris` or `labeled`.
58
+ * @returns the parsed records.
59
+ */
60
+ export declare function importRecords(text: string, format?: 'auto' | 'ris' | 'labeled'): BibRecord[];
61
+ //# sourceMappingURL=formats.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gCAAgC;AAChC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAA;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;CAC3C;AAED,2BAA2B;AAC3B,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,YAAY,GAAG,gBAAgB,CAAA;AAEvE,8BAA8B;AAC9B,qBAAa,WAAY,SAAQ,KAAK;IACpC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;gBAElB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQxF;AAsFD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA2ClD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CA0BtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,KAAK,GAAG,SAAkB,GAAG,SAAS,EAAE,CAOpG"}
package/lib/formats.js ADDED
@@ -0,0 +1,217 @@
1
+ /**
2
+ * Importing Chinese-literature records from exported files.
3
+ *
4
+ * Scope decision, stated up front: CNKI has no public API for this purpose, and
5
+ * the plugin **does not log in and does not scrape**. It reads what the user
6
+ * exported — RIS/EndNote-style tagged text or a labeled (`题名:…`) text file —
7
+ * and turns it into structured records. Anything the export does not contain is
8
+ * reported as missing, never inferred.
9
+ *
10
+ * @module dsh-source-cnki/formats
11
+ */
12
+ /** A typed import failure. */
13
+ export class ImportError extends Error {
14
+ /** Stable code. */
15
+ code;
16
+ constructor(code, message) {
17
+ super(message);
18
+ this.name = 'ImportError';
19
+ this.code = code;
20
+ }
21
+ }
22
+ /** Stable record id from a DOI, or from title+year. */
23
+ export function recordIdOf(input) {
24
+ const base = input.doi !== undefined ? `doi:${input.doi.toLowerCase()}` : `t:${input.title.toLowerCase()}:${input.year ?? ''}`;
25
+ let hash = 2166136261;
26
+ for (const character of base) {
27
+ hash ^= character.codePointAt(0);
28
+ hash = Math.imul(hash, 16777619);
29
+ }
30
+ return `cnki-${(hash >>> 0).toString(16).padStart(8, '0')}`;
31
+ }
32
+ /** Chinese text detection. */
33
+ function languageOf(text) {
34
+ if (/[\u3400-\u9fff]/u.test(text))
35
+ return 'zh';
36
+ if (/[a-zA-Z]/u.test(text))
37
+ return 'en';
38
+ return 'unknown';
39
+ }
40
+ /** Field aliases for the labeled format and for RIS tags. */
41
+ const ALIASES = {
42
+ // Chinese labels
43
+ 题名: 'title', 标题: 'title', 题目: 'title', 篇名: 'title',
44
+ 作者: 'authors', 责任者: 'authors', 第一作者: 'authors',
45
+ 来源: 'journal', 刊名: 'journal', 期刊: 'journal', 文献来源: 'journal', 报纸: 'journal',
46
+ 年: 'year', 年份: 'year', 出版年: 'year', 发表时间: 'year',
47
+ 卷: 'volume', 期: 'issue', 页码: 'pages', 页: 'pages',
48
+ DOI: 'doi', doi: 'doi',
49
+ 关键词: 'keywords', 关键字: 'keywords',
50
+ 摘要: 'abstract', 文摘: 'abstract',
51
+ 类型: 'type', 文献类型: 'type', 数据库: 'type',
52
+ // RIS tags
53
+ TI: 'title', T1: 'title', TY: 'type', AU: 'authors', A1: 'authors',
54
+ JO: 'journal', JF: 'journal', T2: 'journal', JA: 'journal',
55
+ PY: 'year', Y1: 'year', DA: 'year',
56
+ VL: 'volume', IS: 'issue', SP: 'pages', EP: 'pages',
57
+ DO: 'doi', KW: 'keywords', AB: 'abstract', N2: 'abstract',
58
+ };
59
+ /** Map a type string to the record type. */
60
+ function typeOf(raw) {
61
+ const value = raw.toUpperCase();
62
+ if (value.includes('JOUR') || value.includes('期刊'))
63
+ return 'journal';
64
+ if (value.includes('THES') || value.includes('学位') || value.includes('硕士') || value.includes('博士'))
65
+ return 'thesis';
66
+ if (value.includes('CONF') || value.includes('会议'))
67
+ return 'conference';
68
+ if (value.includes('BOOK') || value.includes('图书') || value.includes('专著'))
69
+ return 'book';
70
+ return 'other';
71
+ }
72
+ /** Clean a value. */
73
+ function clean(value) {
74
+ return value.trim().replace(/^[::]\s*/u, '').replace(/\s+/gu, ' ');
75
+ }
76
+ /** Normalize export line endings and strip a leading UTF-8 BOM. */
77
+ function normalizeExport(text) {
78
+ return text.replace(/^\uFEFF/u, '').replace(/\r\n?/gu, '\n');
79
+ }
80
+ /** Split authors on common delimiters. */
81
+ function authorsOf(value) {
82
+ return clean(value)
83
+ .split(/\s*[;;,,]\s*/u)
84
+ .map(name => name.trim())
85
+ .filter(name => name !== '');
86
+ }
87
+ /** Normalize one raw field map into a record. */
88
+ function toRecord(fields) {
89
+ const title = (fields.get('title') ?? []).join(' ').trim();
90
+ if (title === '')
91
+ return undefined;
92
+ const typeRaw = (fields.get('type') ?? []).join(' ');
93
+ const rawAuthors = fields.get('authors') ?? [];
94
+ const yearRaw = (fields.get('year') ?? [])[0] ?? '';
95
+ const yearMatch = /\d{4}/u.exec(yearRaw);
96
+ const pagesRaw = (fields.get('pages') ?? []).join('-');
97
+ const doiRaw = (fields.get('doi') ?? [])[0]?.trim();
98
+ const keywords = (fields.get('keywords') ?? []).flatMap(value => value.split(/\s*[;;,,]\s*/u)).filter(Boolean);
99
+ const abstract = (fields.get('abstract') ?? []).join(' ').trim();
100
+ return {
101
+ recordId: recordIdOf({ title, ...(yearMatch === null ? {} : { year: Number(yearMatch[0]) }), ...(doiRaw === undefined || doiRaw === '' ? {} : { doi: doiRaw }) }),
102
+ type: typeOf(typeRaw),
103
+ title,
104
+ authors: rawAuthors.flatMap(authorsOf),
105
+ ...((fields.get('journal') ?? []).join(' ').trim() === '' ? {} : { journal: (fields.get('journal') ?? []).join(' ').trim() }),
106
+ ...(yearMatch === null ? {} : { year: Number(yearMatch[0]) }),
107
+ ...((fields.get('volume') ?? []).join('') === '' ? {} : { volume: (fields.get('volume') ?? []).join('') }),
108
+ ...((fields.get('issue') ?? []).join('') === '' ? {} : { issue: (fields.get('issue') ?? []).join('') }),
109
+ ...(pagesRaw === '' ? {} : { pages: pagesRaw.replace(/\s+/gu, '') }),
110
+ ...(doiRaw === undefined || doiRaw === '' ? {} : { doi: doiRaw }),
111
+ ...(keywords.length === 0 ? {} : { keywords }),
112
+ ...(abstract === '' ? {} : { abstract }),
113
+ language: languageOf(title),
114
+ };
115
+ }
116
+ /**
117
+ * Parse an RIS/EndNote-style export (`TY - JOUR` … `ER -`).
118
+ * @param text - the export.
119
+ * @returns records (empty when the format does not match).
120
+ */
121
+ export function parseRis(text) {
122
+ const records = [];
123
+ let fields = new Map();
124
+ let inRecord = false;
125
+ for (const line of normalizeExport(text).split('\n')) {
126
+ const match = /^([A-Z][A-Z0-9])\s{2}-\s?(.*)$/u.exec(line);
127
+ if (match === null) {
128
+ if (inRecord && line.trim() !== '' && fields.size > 0) {
129
+ const lastKey = [...fields.keys()].at(-1);
130
+ const values = fields.get(lastKey);
131
+ values[values.length - 1] = `${values.at(-1)} ${line.trim()}`;
132
+ }
133
+ continue;
134
+ }
135
+ const tag = match[1];
136
+ const value = match[2] ?? '';
137
+ if (tag === 'TY') {
138
+ inRecord = true;
139
+ fields = new Map();
140
+ fields.set('type', [value]);
141
+ continue;
142
+ }
143
+ if (tag === 'ER') {
144
+ const record = toRecord(fields);
145
+ if (record !== undefined)
146
+ records.push(record);
147
+ inRecord = false;
148
+ fields = new Map();
149
+ continue;
150
+ }
151
+ const key = ALIASES[tag];
152
+ if (key === undefined || key === 'type') {
153
+ if (key === 'type') {
154
+ const list = fields.get('type') ?? [];
155
+ list.push(value);
156
+ fields.set('type', list);
157
+ }
158
+ continue;
159
+ }
160
+ const list = fields.get(key) ?? [];
161
+ list.push(value);
162
+ fields.set(key, list);
163
+ }
164
+ return records;
165
+ }
166
+ /**
167
+ * Parse a labeled text export (`题名:…`, `作者:…`, blank line between records).
168
+ * @param text - the export.
169
+ * @returns records (empty when the format does not match).
170
+ */
171
+ export function parseLabeled(text) {
172
+ const records = [];
173
+ for (const block of normalizeExport(text).split(/\n\s*\n/u)) {
174
+ const fields = new Map();
175
+ for (const line of block.split('\n')) {
176
+ const match = /^\s*([^::]{1,12})\s*[::]\s*(.+)$/u.exec(line);
177
+ if (match === null) {
178
+ // Continuation line of the previous field.
179
+ if (fields.size > 0) {
180
+ const lastKey = [...fields.keys()].at(-1);
181
+ const values = fields.get(lastKey);
182
+ values[values.length - 1] = `${values.at(-1)} ${line.trim()}`;
183
+ }
184
+ continue;
185
+ }
186
+ const key = ALIASES[match[1].trim()];
187
+ if (key === undefined)
188
+ continue;
189
+ const list = fields.get(key) ?? [];
190
+ list.push(match[2].trim());
191
+ fields.set(key, list);
192
+ if (key === 'type')
193
+ fields.set('type', [match[2].trim()]);
194
+ }
195
+ const record = toRecord(fields);
196
+ if (record !== undefined)
197
+ records.push(record);
198
+ }
199
+ return records;
200
+ }
201
+ /**
202
+ * Import records with format detection.
203
+ * @param text - the export text.
204
+ * @param format - `auto`, `ris` or `labeled`.
205
+ * @returns the parsed records.
206
+ */
207
+ export function importRecords(text, format = 'auto') {
208
+ if (typeof text !== 'string' || text.trim() === '')
209
+ throw new ImportError('EMPTY', 'the export is empty');
210
+ const ris = format === 'labeled' ? [] : parseRis(text);
211
+ const labeled = format === 'ris' ? [] : parseLabeled(text);
212
+ const records = ris.length >= labeled.length ? ris : labeled;
213
+ if (records.length === 0)
214
+ throw new ImportError('NO_RECORDS', 'no records were recognized; export as RIS or as labeled text (题名:/作者:/来源:)');
215
+ return records;
216
+ }
217
+ //# sourceMappingURL=formats.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formats.js","sourceRoot":"","sources":["../src/formats.ts"],"names":[],"mappings":"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"}
package/lib/index.d.ts ADDED
@@ -0,0 +1,39 @@
1
+ /**
2
+ * `dsh-source-cnki` — Chinese-literature export import, citation formatting and
3
+ * structural validation.
4
+ *
5
+ * No login, no scraping, no CNKI API: it reads what the user exported (RIS or
6
+ * labeled text) and formats GB/T 7714 / APA citations. Three tools:
7
+ * cnki_import, cnki_cite, cnki_check.
8
+ *
9
+ * Function plugin — no default export.
10
+ * @module dsh-source-cnki
11
+ */
12
+ import type { Context } from '@deepseek-ai/cordis';
13
+ import { Config, resolveConfig, type Config as ConfigShape } from './config.ts';
14
+ /** Cordis plugin name. */
15
+ export declare const name = "source-cnki";
16
+ /** The tool registry is required; the REP service is optional. */
17
+ export declare const inject: string[];
18
+ export { Config, resolveConfig };
19
+ export type { ConfigShape };
20
+ export type { ResolvedConfig } from './config.ts';
21
+ export { VERSION } from './version.ts';
22
+ export { formatBibliography, formatCitation } from './cite.ts';
23
+ export type { CiteOptions, CiteStyle } from './cite.ts';
24
+ export { importRecords, ImportError, parseLabeled, parseRis, recordIdOf } from './formats.ts';
25
+ export type { ImportErrorCode, BibRecord } from './formats.ts';
26
+ export { validateRecords } from './validate.ts';
27
+ export type { RecordIssue, ValidationResult } from './validate.ts';
28
+ export { SourceError, SourceRuntime } from './runtime.ts';
29
+ export type { EvidencePort, ImportValue, SourceErrorCode, SourceRuntimeOptions } from './runtime.ts';
30
+ export { makeCnkiImportTool } from './tools/cnki-import.ts';
31
+ export { makeCnkiCiteTool } from './tools/cnki-cite.ts';
32
+ export { makeCnkiCheckTool } from './tools/cnki-check.ts';
33
+ /**
34
+ * Mount the three tools.
35
+ * @param ctx - the plugin context (host).
36
+ * @param config - raw plugin config.
37
+ */
38
+ export declare function apply(ctx: Context, config: ConfigShape): void;
39
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,MAAM,IAAI,WAAW,EAAE,MAAM,aAAa,CAAA;AAM/E,0BAA0B;AAC1B,eAAO,MAAM,IAAI,gBAAgB,CAAA;AAEjC,kEAAkE;AAClE,eAAO,MAAM,MAAM,UAAY,CAAA;AAE/B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,CAAA;AAC3B,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC7F,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAe7D"}
package/lib/index.js ADDED
@@ -0,0 +1,51 @@
1
+ /**
2
+ * `dsh-source-cnki` — Chinese-literature export import, citation formatting and
3
+ * structural validation.
4
+ *
5
+ * No login, no scraping, no CNKI API: it reads what the user exported (RIS or
6
+ * labeled text) and formats GB/T 7714 / APA citations. Three tools:
7
+ * cnki_import, cnki_cite, cnki_check.
8
+ *
9
+ * Function plugin — no default export.
10
+ * @module dsh-source-cnki
11
+ */
12
+ import { Config, resolveConfig } from "./config.js";
13
+ import { SourceRuntime } from "./runtime.js";
14
+ import { makeCnkiCheckTool } from "./tools/cnki-check.js";
15
+ import { makeCnkiCiteTool } from "./tools/cnki-cite.js";
16
+ import { makeCnkiImportTool } from "./tools/cnki-import.js";
17
+ /** Cordis plugin name. */
18
+ export const name = 'source-cnki';
19
+ /** The tool registry is required; the REP service is optional. */
20
+ export const inject = ['tools'];
21
+ export { Config, resolveConfig };
22
+ export { VERSION } from "./version.js";
23
+ export { formatBibliography, formatCitation } from "./cite.js";
24
+ export { importRecords, ImportError, parseLabeled, parseRis, recordIdOf } from "./formats.js";
25
+ export { validateRecords } from "./validate.js";
26
+ export { SourceError, SourceRuntime } from "./runtime.js";
27
+ export { makeCnkiImportTool } from "./tools/cnki-import.js";
28
+ export { makeCnkiCiteTool } from "./tools/cnki-cite.js";
29
+ export { makeCnkiCheckTool } from "./tools/cnki-check.js";
30
+ /**
31
+ * Mount the three tools.
32
+ * @param ctx - the plugin context (host).
33
+ * @param config - raw plugin config.
34
+ */
35
+ export function apply(ctx, config) {
36
+ const resolved = resolveConfig(config);
37
+ const logger = ctx.logger('source-cnki');
38
+ if (!resolved.enabled) {
39
+ logger.info('disabled: enabled is false — no tools are mounted');
40
+ return;
41
+ }
42
+ const service = ctx.get('researchEvidence');
43
+ const runtime = new SourceRuntime({ config: resolved, ...(service === undefined ? {} : { service }) });
44
+ if (service === undefined) {
45
+ logger.info(`ctx.researchEvidence is not mounted; using a local core store under ${resolved.root}`);
46
+ }
47
+ ctx.effect(() => ctx.tools.register(makeCnkiImportTool(runtime)), 'source-cnki: cnki_import tool');
48
+ ctx.effect(() => ctx.tools.register(makeCnkiCiteTool(runtime)), 'source-cnki: cnki_cite tool');
49
+ ctx.effect(() => ctx.tools.register(makeCnkiCheckTool(runtime)), 'source-cnki: cnki_check tool');
50
+ }
51
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,MAAM,EAAE,aAAa,EAA8B,MAAM,aAAa,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAqB,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,0BAA0B;AAC1B,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAA;AAEjC,kEAAkE;AAClE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;AAE/B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;AAGhC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE7F,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAmB;IACrD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;IACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;QAChE,OAAM;IACR,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAA6B,CAAA;IACvE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;IACtG,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,uEAAuE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IACrG,CAAC;IACD,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,+BAA+B,CAAC,CAAA;IAClG,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,EAAE,6BAA6B,CAAC,CAAA;IAC9F,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,8BAA8B,CAAC,CAAA;AAClG,CAAC"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * Runtime: workspace-safe export loading, import with REP evidence, citation and
3
+ * validation. No network: CNKI has no public API here and the plugin neither
4
+ * logs in nor scrapes.
5
+ * @module dsh-source-cnki/runtime
6
+ */
7
+ import { type AddEvidenceInput, type CaptureInput, type Evidence, type ResearchRecord, type Snapshot } from '@perrylink/dsh-research-core';
8
+ import type { ResolvedConfig } from './config.ts';
9
+ import { type CiteOptions } from './cite.ts';
10
+ import { type BibRecord } from './formats.ts';
11
+ import { type ValidationResult } from './validate.ts';
12
+ /** Stable error codes. */
13
+ export type SourceErrorCode = 'INVALID_INPUT' | 'NOT_FOUND' | 'PATH_ESCAPE' | 'NOT_A_FILE' | 'TOO_LARGE' | 'UNSUPPORTED_FILE' | 'NO_RECORDS' | 'STORE_ERROR';
14
+ /** A typed failure. */
15
+ export declare class SourceError extends Error {
16
+ /** Stable code. */
17
+ readonly code: SourceErrorCode;
18
+ constructor(code: SourceErrorCode, message: string);
19
+ }
20
+ /** The subset of the REP service used here. */
21
+ export interface EvidencePort {
22
+ capture(input: CaptureInput): Promise<{
23
+ snapshot: Snapshot;
24
+ }>;
25
+ addEvidence(input: AddEvidenceInput): Promise<{
26
+ evidence: Evidence;
27
+ }>;
28
+ buildRecord(options?: {
29
+ evidenceIds?: readonly string[];
30
+ }): Promise<Omit<ResearchRecord, 'manifest'>>;
31
+ }
32
+ /** Import result. */
33
+ export interface ImportValue {
34
+ readonly records: readonly BibRecord[];
35
+ readonly validation: ValidationResult;
36
+ readonly evidenceId?: string;
37
+ readonly recordPath?: string;
38
+ }
39
+ /** Runtime options. */
40
+ export interface SourceRuntimeOptions {
41
+ readonly config: ResolvedConfig;
42
+ readonly service?: EvidencePort;
43
+ readonly now?: () => Date;
44
+ }
45
+ /** The runtime. */
46
+ export declare class SourceRuntime {
47
+ #private;
48
+ readonly config: ResolvedConfig;
49
+ constructor(options: SourceRuntimeOptions);
50
+ /** Current ISO timestamp. */
51
+ iso(): string;
52
+ /** The evidence port. */
53
+ port(): EvidencePort;
54
+ /** Resolve a file inside the workspace. */
55
+ resolveFile(input: string): Promise<{
56
+ absolute: string;
57
+ id: string;
58
+ }>;
59
+ /**
60
+ * Import exported records and optionally persist the export as evidence.
61
+ * @param request - text/path, format and persistence.
62
+ * @returns records and validation.
63
+ */
64
+ import(request: {
65
+ text?: string;
66
+ path?: string;
67
+ format?: 'auto' | 'ris' | 'labeled';
68
+ persist?: boolean;
69
+ }): Promise<ImportValue>;
70
+ /**
71
+ * Format citations.
72
+ * @param records - records to cite.
73
+ * @param options - style and starting number.
74
+ * @returns the formatted citations.
75
+ */
76
+ cite(records: readonly BibRecord[], options?: CiteOptions): string[];
77
+ /**
78
+ * Validate records.
79
+ * @param records - records to check.
80
+ * @returns the validation result.
81
+ */
82
+ check(records: readonly BibRecord[]): ValidationResult;
83
+ }
84
+ //# sourceMappingURL=runtime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAEjB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGtE,0BAA0B;AAC1B,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,kBAAkB,GAAG,YAAY,GAAG,aAAa,CAAA;AAE5J,uBAAuB;AACvB,qBAAa,WAAY,SAAQ,KAAK;IACpC,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;gBAElB,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD;AAED,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;IAC7D,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;IACrE,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC,CAAA;CACtG;AAED,qBAAqB;AACrB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,uBAAuB;AACvB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAoCD,mBAAmB;AACnB,qBAAa,aAAa;;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;gBAMnB,OAAO,EAAE,oBAAoB;IAMzC,6BAA6B;IAC7B,GAAG,IAAI,MAAM;IAIb,yBAAyB;IACzB,IAAI,IAAI,YAAY;IAMpB,2CAA2C;IACrC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAqB3E;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA8ErI;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,EAAE;IAUxE;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,gBAAgB;CAGvD"}