dsh-data-domain-knowledge 0.1.0-alpha.9 → 0.1.1-alpha.2

package/lib/types/extraction-runs.js

@@ -1,5 +1,14 @@
 /**
- * 抽取轨迹（`extraction_run`）：把每一次「这份文档抽出了什么」记成一条**不可重建**的记录。
+ * 轨迹流水（`extraction_run`）：把每一次「这一段处理了什么」记成一条**不可重建**的记录。
+ *
+ * ## 三段，一张表
+ *
+ * 2026-10-18 起抽取、归一、物化是三个独立阶段，所以轨迹也分三种（`stage` 列）：
+ * 抽取（一份来源 × 一次）、归一（一份来源 × 一次）、物化（一个卡片分组 × 一次）。
+ * **共用一张表**是因为它们的读写形状完全一样：按 `(kb, stage, 时间)` 倒序翻页、
+ * 点开读一份 JSON 报告、不可重建。拆三张表只会让「这份文档跑过几次」变成三次查询。
+ *
+ * 抽取那一份的正文是整份 `TrialReport`；归一与物化的形状见 `trajectory-types.ts`。
  *
  * ## 它是什么，不是什么
  *
@@ -29,6 +38,7 @@
 import { mkdir } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { loadSqlite } from './fts.js';
+import { applyRetention } from './retention.js';
 const SCHEMA = `
 CREATE TABLE IF NOT EXISTS extraction_runs (
   id TEXT PRIMARY KEY,
@@ -40,19 +50,22 @@ CREATE TABLE IF NOT EXISTS extraction_runs (
   model_ok INTEGER NOT NULL DEFAULT 0,
   model_why TEXT,
   summary TEXT NOT NULL DEFAULT '',
-  report TEXT NOT NULL DEFAULT '{}'
+  report TEXT NOT NULL DEFAULT '{}',
+  stage TEXT NOT NULL DEFAULT 'extract'
 );
 CREATE INDEX IF NOT EXISTS idx_extraction_runs_doc ON extraction_runs(kb, doc_id, created_at DESC);
 CREATE INDEX IF NOT EXISTS idx_extraction_runs_time ON extraction_runs(kb, created_at DESC);
 `;
 /**
- * 抽取轨迹库。**一个知识库一份**（随 Runtime 创建），懒打开。
+ * 轨迹库。**一个知识库一份**（随 Runtime 创建），懒打开。
  *
  * API 与 `OperationLog` 同形（同步的 `DatabaseSync`）：本地文件、单写者，同步最简单。
  */
 export class ExtractionRunStore {
     file;
     db = null;
+    /** 距离上一次裁剪又落了几条（`append` 里用）。 */
+    appendsSincePrune = 0;
     constructor(file) {
         this.file = file;
     }
@@ -67,6 +80,17 @@ export class ExtractionRunStore {
             await mkdir(dirname(this.file), { recursive: true });
             this.db = new sqlite.DatabaseSync(this.file);
             this.db.exec(SCHEMA);
+            /**
+             * 旧库补 `stage` 列（2026-10-18 加）。
+             *
+             * `CREATE TABLE IF NOT EXISTS` 不会给**已存在**的表加列，所以升级必须在真库上跑一遍迁移：
+             * 否则读旧库时那条 SELECT 直接报错，历史轨迹一条也打不开。旧记录落到默认值
+             * `extract` —— 它们本来就只有抽取这一种。
+             */
+            const columns = this.db.prepare('PRAGMA table_info(extraction_runs)').all();
+            if (!columns.some(column => column.name === 'stage'))
+                this.db.exec("ALTER TABLE extraction_runs ADD COLUMN stage TEXT NOT NULL DEFAULT 'extract'");
+            this.db.exec('CREATE INDEX IF NOT EXISTS idx_extraction_runs_stage ON extraction_runs(kb, stage, created_at DESC)');
             return true;
         }
         catch {
@@ -77,11 +101,36 @@ export class ExtractionRunStore {
     available() {
         return this.db !== null;
     }
+    /** Shared audit connection; callers must not close it. */
+    connection() {
+        if (!this.db)
+            throw new Error('EXTRACTION_RUNS_UNAVAILABLE');
+        return this.db;
+    }
     /** 落一条。报告整份序列化进 `report` 列。 */
     async append(entry) {
         if (this.db === null)
             throw new Error('EXTRACTION_RUNS_UNAVAILABLE');
-        this.db.prepare('INSERT INTO extraction_runs (id, kb, doc_id, title, actor, created_at, model_ok, model_why, summary, report) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(entry.id, entry.kb, entry.docId, entry.title, entry.actor, entry.createdAt, entry.modelOk ? 1 : 0, entry.modelWhy ?? null, entry.summary, JSON.stringify(entry.report ?? {}));
+        this.db.prepare('INSERT INTO extraction_runs (id, kb, doc_id, title, actor, created_at, model_ok, model_why, summary, report, stage) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(entry.id, entry.kb, entry.docId, entry.title, entry.actor, entry.createdAt, entry.modelOk ? 1 : 0, entry.modelWhy ?? null, entry.summary, JSON.stringify(entry.report ?? {}), entry.stage);
+        /**
+         * 这张表才是审计库里真正会长大的那张（`report` 是整份模型返回的 JSON，一条几十到几百 KB）。
+         * 上限同样只裁「水位以上」的新行 —— 升级那一刻已有的轨迹一条不删（见 `retention.ts`）。
+         * 每 25 次落一条才做一次，避免每次写入都去数一遍。
+         *
+         * **按阶段各留各的窗口**（2026-10-18）：三段的条数差一个量级 —— 300 个分组的库跑一次
+         * 全链路，物化落 300 条，抽取只落 1 条。用一条全表 FIFO 上限的话，物化会把抽取挤出去，
+         * 而抽取那份是三者里最贵、最不可重建的（它是模型的原始返回）。所以每段各自计数。
+         */
+        this.appendsSincePrune += 1;
+        if (this.appendsSincePrune >= 25) {
+            this.appendsSincePrune = 0;
+            for (const stage of ['extract', 'normalize', 'materialize']) {
+                try {
+                    applyRetention(this.db, `extraction_runs:${stage}`, { table: 'extraction_runs', key: 'rowid', keep: 2000, where: `stage = '${stage}'` });
+                }
+                catch { /* 裁剪是尽力而为 */ }
+            }
+        }
     }
     /** 一条完整记录（含报告）。 */
     async get(id) {
@@ -100,11 +149,15 @@ export class ExtractionRunStore {
             where.push('doc_id = :docId');
             params.docId = query.docId;
         }
+        if (query.stage !== undefined) {
+            where.push('stage = :stage');
+            params.stage = query.stage;
+        }
         const clause = where.length > 0 ? `WHERE ${where.join(' AND ')}` : '';
         const total = this.db.prepare(`SELECT COUNT(*) AS n FROM extraction_runs ${clause}`).get(params);
         const limit = Math.min(100, Math.max(1, query.limit ?? 20));
         const offset = Math.max(0, query.offset ?? 0);
-        const rows = this.db.prepare(`SELECT id, kb, doc_id, title, actor, created_at, model_ok, model_why, summary, report <> '{}' AS has_report
+        const rows = this.db.prepare(`SELECT id, kb, doc_id, title, actor, created_at, model_ok, model_why, summary, stage, report <> '{}' AS has_report
        FROM extraction_runs ${clause} ORDER BY created_at DESC, id DESC LIMIT :limit OFFSET :offset`).all({ ...params, limit, offset });
         return { runs: rows.map(rowToSummary), total: total.n };
     }
@@ -146,6 +199,8 @@ function rowToSummary(row) {
         ...(row.model_why === null || row.model_why === undefined ? {} : { modelWhy: String(row.model_why) }),
         summary: String(row.summary ?? ''),
         hasReport: row.has_report === 1 || row.has_report === true,
+        // 旧库补列之前落下的行没有这一列（或为 null）：它们只可能是抽取。
+        stage: (row.stage === 'normalize' || row.stage === 'materialize' ? row.stage : 'extract'),
     };
 }
 function rowToRecord(row) {
@@ -162,8 +217,14 @@ function rowToRecord(row) {
         report,
     };
 }
-/** 一条轨迹的 id：时间戳（36 进制）+ 随机尾巴，排序即创建序。 */
-export function extractionRunId() {
-    return `run_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+/**
+ * 一条轨迹的 id：时间戳（36 进制）+ 随机尾巴，排序即创建序。
+ *
+ * `stage` 只影响前缀，不影响排序：id 自己写着它属于哪一段，日志里一眼分得清；
+ * 而**不可依赖**它做判别 —— 判别读 `stage` 列（前缀是给人看的，列才是真源）。
+ */
+export function extractionRunId(stage) {
+    const prefix = stage === undefined ? 'run' : stage;
+    return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
 }
 //# sourceMappingURL=extraction-runs.js.map

package/lib/types/extraction-runs.js.map

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

package/lib/types/fs-atomic.d.ts

@@ -1,10 +1,3 @@
-/**
- * 原子写：先写同目录的临时文件，再 `rename` 覆盖目标。
- *
- * 抽成独立模块的理由是**宿主运行时与领域模块都要用它**：SourceRaw / 卡片 / 编译产物
- * 由 runtime 写，一次排查的样本与迁移由 `diagnosis/` 写。把它放在 runtime 里会让
- * `diagnosis/` 反过来依赖 runtime 的实现细节 —— 分层就倒过来了。
- */
 export declare function writeTextAtomic(path: string, content: string): Promise<void>;
 export declare function writeBufferAtomic(path: string, content: Buffer): Promise<void>;
 export declare function unlinkIfExists(path: string): Promise<void>;

package/lib/types/fs-atomic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-atomic.d.ts","sourceRoot":"","sources":["../../src/fs-atomic.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE"}
+{"version":3,"file":"fs-atomic.d.ts","sourceRoot":"","sources":["../../src/fs-atomic.ts"],"names":[],"mappings":"AA4BA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE"}

package/lib/types/fs-atomic.js

@@ -1,3 +1,4 @@
+import { randomUUID } from 'node:crypto';
 import { mkdir, rename, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 /**
@@ -7,11 +8,25 @@ import { dirname } from 'node:path';
  * 由 runtime 写，一次排查的样本与迁移由 `diagnosis/` 写。把它放在 runtime 里会让
  * `diagnosis/` 反过来依赖 runtime 的实现细节 —— 分层就倒过来了。
  */
+/** 进程内的单调计数，和随机尾巴一起保证同进程同毫秒的两次写不会用同一个临时文件。 */
+let temporaryCounter = 0;
+/**
+ * 临时文件名。
+ *
+ * 曾经是 `${path}.${pid}.${Date.now().toString(36)}.tmp` —— 同一个进程、同一个目标、
+ * 同一毫秒就会撞名。撞上之后先完成的 `rename` 把文件吃掉，后完成的那次 `writeFile`
+ * 直接 ENOENT，表现为「整次 persist 抛错、内存改了但磁盘没落」。
+ * 计数 + 随机尾巴把这一条从「取决于时序」变成「不可能」。
+ */
+function temporaryPath(path) {
+    temporaryCounter = (temporaryCounter + 1) % Number.MAX_SAFE_INTEGER;
+    return `${path}.${process.pid}.${temporaryCounter.toString(36)}.${randomUUID().slice(0, 8)}.tmp`;
+}
 export async function writeTextAtomic(path, content) {
     // 原子写需要一个与目标同目录的临时文件，所以目标目录必须先存在。0030 起
     // SourceRaw 现在平铺在 `<段>/` 下，确保段目录存在即可。
     await mkdir(dirname(path), { recursive: true });
-    const temporary = `${path}.${process.pid}.${Date.now().toString(36)}.tmp`;
+    const temporary = temporaryPath(path);
     try {
         await writeFile(temporary, content, 'utf8');
         await rename(temporary, path);
@@ -22,7 +37,7 @@ export async function writeTextAtomic(path, content) {
 }
 export async function writeBufferAtomic(path, content) {
     await mkdir(dirname(path), { recursive: true });
-    const temporary = `${path}.${process.pid}.${Date.now().toString(36)}.tmp`;
+    const temporary = temporaryPath(path);
     try {
         await writeFile(temporary, content);
         await rename(temporary, path);

package/lib/types/fs-atomic.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-atomic.js","sourceRoot":"","sources":["../../src/fs-atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;;;;;GAMG;AAEH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IACjE,wCAAwC;IACxC,sCAAsC;IACtC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAA;IACzE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3C,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;YAAS,CAAC;QACT,MAAM,cAAc,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IACnE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAA;IACzE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACnC,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;YAAS,CAAC;QACT,MAAM,cAAc,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IAAC,MAAM,CAAC,CAAC,2CAA2C,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"fs-atomic.js","sourceRoot":"","sources":["../../src/fs-atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;;;;;GAMG;AAEH,8CAA8C;AAC9C,IAAI,gBAAgB,GAAG,CAAC,CAAA;AAExB;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,gBAAgB,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAA;IACnE,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAA;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IACjE,wCAAwC;IACxC,sCAAsC;IACtC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QAC3C,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;YAAS,CAAC;QACT,MAAM,cAAc,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,OAAe;IACnE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QACnC,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;YAAS,CAAC;QACT,MAAM,cAAc,CAAC,SAAS,CAAC,CAAA;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IAAC,MAAM,CAAC,CAAC,2CAA2C,CAAC,CAAC;AACzD,CAAC"}

package/lib/types/images.d.ts

@@ -0,0 +1,26 @@
+/** Maximum decoded image size accepted by `image_publish`. */
+export declare const MAX_PUBLISHED_IMAGE_BYTES: number;
+export declare class ImagePublishError extends Error {
+    readonly code: string;
+    readonly suggestion?: string | undefined;
+    constructor(code: string, message: string, suggestion?: string | undefined);
+}
+export interface PublishKnowledgeImageInput {
+    filePath?: unknown;
+    contentBase64?: unknown;
+    filename?: unknown;
+    mimeType?: unknown;
+}
+export interface PublishedKnowledgeImage {
+    kb: string;
+    filename: string;
+    path: string;
+    url: string;
+    markdown: string;
+    mimeType: string;
+    bytes: number;
+    sha256: string;
+}
+/** Store one validated image using the knowledge assets content-hash bucket layout. */
+export declare function publishKnowledgeImage(rootDir: string, kb: string, input: PublishKnowledgeImageInput): Promise<PublishedKnowledgeImage>;
+//# sourceMappingURL=images.d.ts.map

package/lib/types/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/images.ts"],"names":[],"mappings":"AAMA,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,QAAmB,CAAA;AAYzD,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAmB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;gBAA3D,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAW,UAAU,CAAC,EAAE,MAAM,YAAA;CAIjF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAuED,uFAAuF;AACvF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAoFlC"}

package/lib/types/images.js

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { basename, extname, join } from 'node:path';
+import { ASSETS_DIR, PUBLISHED_IMAGE_MARKER } from './layout.js';
+import { writeBufferAtomic, writeTextAtomic } from './fs-atomic.js';
+/** Maximum decoded image size accepted by `image_publish`. */
+export const MAX_PUBLISHED_IMAGE_BYTES = 20 * 1024 * 1024;
+const IMAGE_FORMATS = [
+    { mimeType: 'image/png', extension: '.png' },
+    { mimeType: 'image/jpeg', extension: '.jpg' },
+    { mimeType: 'image/gif', extension: '.gif' },
+    { mimeType: 'image/webp', extension: '.webp' },
+    { mimeType: 'image/avif', extension: '.avif' },
+    { mimeType: 'image/bmp', extension: '.bmp' },
+    { mimeType: 'image/svg+xml', extension: '.svg' },
+];
+export class ImagePublishError extends Error {
+    code;
+    suggestion;
+    constructor(code, message, suggestion) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.name = 'ImagePublishError';
+    }
+}
+function invalid(message, suggestion) {
+    throw new ImagePublishError('IMAGE_INVALID', message, suggestion);
+}
+function normalizeMimeType(value) {
+    const mimeType = value.split(';', 1)[0].trim().toLowerCase();
+    return mimeType === 'image/jpg' ? 'image/jpeg' : mimeType;
+}
+function detectImageMimeType(bytes) {
+    if (bytes.length >= 8 && bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])))
+        return 'image/png';
+    if (bytes.length >= 3 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff)
+        return 'image/jpeg';
+    if (bytes.length >= 6 && (bytes.toString('ascii', 0, 6) === 'GIF87a' || bytes.toString('ascii', 0, 6) === 'GIF89a'))
+        return 'image/gif';
+    if (bytes.length >= 12 && bytes.toString('ascii', 0, 4) === 'RIFF' && bytes.toString('ascii', 8, 12) === 'WEBP')
+        return 'image/webp';
+    if (bytes.length >= 12 && bytes.toString('ascii', 0, 2) === 'BM')
+        return 'image/bmp';
+    if (bytes.length >= 12 && bytes.toString('ascii', 4, 8) === 'ftyp') {
+        const brands = bytes.toString('ascii', 8, Math.min(bytes.length, 32));
+        if (/(?:avif|avis)/.test(brands))
+            return 'image/avif';
+    }
+    // SVG is text, so recognize its root element after an optional XML declaration.
+    const text = bytes.toString('utf8', 0, Math.min(bytes.length, 4096)).replace(/^\uFEFF/, '').trimStart();
+    if (/^(?:<\?xml\b[^>]*>\s*)?<svg(?:\s|>)/i.test(text))
+        return 'image/svg+xml';
+    return undefined;
+}
+function decodeBase64(value) {
+    let encoded = value.trim();
+    let declaredMimeType;
+    if (encoded.startsWith('data:')) {
+        const match = /^data:([^;,]+);base64,([\s\S]*)$/i.exec(encoded);
+        if (!match)
+            invalid('content_base64 的 Data URI 格式无效。', '传标准 Base64，或传 data:image/png;base64,... 形式。');
+        declaredMimeType = normalizeMimeType(match[1]);
+        encoded = match[2];
+    }
+    encoded = encoded.replace(/\s+/g, '');
+    if (encoded.length > Math.ceil(MAX_PUBLISHED_IMAGE_BYTES * 4 / 3) + 8) {
+        throw new ImagePublishError('IMAGE_TOO_LARGE', `图片超过 ${MAX_PUBLISHED_IMAGE_BYTES / 1024 / 1024} MiB 限制。`);
+    }
+    if (encoded.length % 4 === 1 || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}={0,2}|[A-Za-z0-9+/]{3}=?)?$/.test(encoded)) {
+        invalid('content_base64 不是有效的 Base64。');
+    }
+    const bytes = Buffer.from(encoded, 'base64');
+    if (bytes.length === 0)
+        invalid('图片内容不能为空。');
+    if (bytes.length > MAX_PUBLISHED_IMAGE_BYTES) {
+        throw new ImagePublishError('IMAGE_TOO_LARGE', `图片超过 ${MAX_PUBLISHED_IMAGE_BYTES / 1024 / 1024} MiB 限制。`);
+    }
+    if (bytes.toString('base64').replace(/=+$/, '') !== encoded.replace(/=+$/, ''))
+        invalid('content_base64 不是有效的 Base64。');
+    return { bytes, ...(declaredMimeType ? { declaredMimeType } : {}) };
+}
+function safeFilename(value, fallback, extension) {
+    const raw = typeof value === 'string' ? value.trim() : '';
+    const leaf = (raw.replace(/\\/g, '/').split('/').pop() ?? '').replace(/[\u0000-\u001f\u007f]/g, '');
+    const suppliedExtension = extname(leaf);
+    const stem = (suppliedExtension ? leaf.slice(0, -suppliedExtension.length) : leaf)
+        .replace(/[^\p{L}\p{N}._ -]/gu, '_')
+        .replace(/\s+/g, '-')
+        .replace(/^\.+$/, '')
+        .slice(0, 120);
+    return `${stem || fallback}${extension}`;
+}
+async function readExisting(path) {
+    try {
+        return await readFile(path);
+    }
+    catch (cause) {
+        if (cause?.code === 'ENOENT')
+            return undefined;
+        throw cause;
+    }
+}
+/** Store one validated image using the knowledge assets content-hash bucket layout. */
+export async function publishKnowledgeImage(rootDir, kb, input) {
+    const filePath = typeof input.filePath === 'string' ? input.filePath.trim() : '';
+    const base64 = typeof input.contentBase64 === 'string' ? input.contentBase64 : '';
+    if (Boolean(filePath) === Boolean(base64)) {
+        invalid('file_path 和 content_base64 必须且只能提供一个。');
+    }
+    let bytes;
+    let sourceName = '';
+    let dataUriMimeType;
+    if (filePath) {
+        let details;
+        try {
+            details = await stat(filePath);
+        }
+        catch (cause) {
+            throw new ImagePublishError('IMAGE_SOURCE_NOT_FOUND', `图片文件无法读取：${cause instanceof Error ? cause.message : String(cause)}`);
+        }
+        if (!details.isFile())
+            throw new ImagePublishError('IMAGE_SOURCE_NOT_FILE', 'file_path 必须指向一个文件。');
+        if (details.size > MAX_PUBLISHED_IMAGE_BYTES) {
+            throw new ImagePublishError('IMAGE_TOO_LARGE', `图片超过 ${MAX_PUBLISHED_IMAGE_BYTES / 1024 / 1024} MiB 限制。`);
+        }
+        try {
+            bytes = await readFile(filePath);
+        }
+        catch (cause) {
+            throw new ImagePublishError('IMAGE_SOURCE_NOT_FOUND', `图片文件无法读取：${cause instanceof Error ? cause.message : String(cause)}`);
+        }
+        sourceName = basename(filePath);
+    }
+    else {
+        const decoded = decodeBase64(base64);
+        bytes = decoded.bytes;
+        dataUriMimeType = decoded.declaredMimeType;
+    }
+    if (bytes.length === 0)
+        invalid('图片内容不能为空。');
+    if (bytes.length > MAX_PUBLISHED_IMAGE_BYTES) {
+        throw new ImagePublishError('IMAGE_TOO_LARGE', `图片超过 ${MAX_PUBLISHED_IMAGE_BYTES / 1024 / 1024} MiB 限制。`);
+    }
+    const mimeType = detectImageMimeType(bytes);
+    if (!mimeType)
+        invalid('文件内容不是支持的图片格式（PNG、JPEG、GIF、WebP、AVIF、BMP、SVG）。');
+    const declaredMimeType = typeof input.mimeType === 'string' && input.mimeType.trim()
+        ? normalizeMimeType(input.mimeType)
+        : dataUriMimeType;
+    if (declaredMimeType && declaredMimeType !== mimeType) {
+        invalid(`声明的 MIME 类型 ${declaredMimeType} 与图片内容 ${mimeType} 不一致。`);
+    }
+    const format = IMAGE_FORMATS.find(item => item.mimeType === mimeType);
+    const sha256 = createHash('sha256').update(bytes).digest('hex');
+    const bucket = sha256.slice(0, 12);
+    const filename = safeFilename(input.filename ?? sourceName, `image-${bucket}`, format.extension);
+    const assetDir = join(rootDir, ASSETS_DIR, bucket);
+    const assetPath = join(assetDir, filename);
+    let existing = await readExisting(assetPath);
+    let storedFilename = filename;
+    // The established bucket uses only the first 12 hash characters. If that prefix and the
+    // supplied filename both collide with different bytes, add more hash characters instead of
+    // replacing the existing asset.
+    if (existing && !existing.equals(bytes)) {
+        const extension = format.extension;
+        const stem = filename.slice(0, -extension.length);
+        storedFilename = `${stem}-${sha256.slice(12, 20)}${extension}`;
+        existing = await readExisting(join(assetDir, storedFilename));
+        if (existing && !existing.equals(bytes)) {
+            storedFilename = `image-${sha256}${extension}`;
+            existing = await readExisting(join(assetDir, storedFilename));
+        }
+    }
+    if (existing && !existing.equals(bytes)) {
+        throw new ImagePublishError('ASSET_NAME_COLLISION', '目标文件名已被不同内容占用，未覆盖现有图片。');
+    }
+    if (!existing?.equals(bytes))
+        await writeBufferAtomic(join(assetDir, storedFilename), bytes);
+    // Standalone hosted images have no SourceRaw or card by design. Keep that intent beside the
+    // asset so the orphan sweep does not mistake it for a disposable extraction artifact.
+    await writeTextAtomic(join(assetDir, PUBLISHED_IMAGE_MARKER), 'image_publish\n');
+    const relativePath = `${ASSETS_DIR}/${bucket}/${storedFilename}`;
+    const url = `/knowledge/assets/${encodeURIComponent(kb)}/${relativePath.split('/').map(encodeURIComponent).join('/')}`;
+    return {
+        kb,
+        filename: storedFilename,
+        path: relativePath,
+        url,
+        markdown: `![${storedFilename}](${url})`,
+        mimeType,
+        bytes: bytes.length,
+        sha256,
+    };
+}
+//# sourceMappingURL=images.js.map

package/lib/types/images.js.map

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

package/lib/types/index.d.ts

@@ -15,12 +15,12 @@ export declare const name = "dsh-data-domain-knowledge";
  * `settings` 在 0.1.7 之后**不再需要**：设置已经是本 entry 的 config
  * （见下面的 `Config`），`settings.installSection` 那条路已经整个删除。
  */
-export declare const inject: readonly ["tools", "webServer"];
+export declare const inject: readonly ["tools", "webServer", "systemPrompt"];
 export { KNOWLEDGE_SETTINGS_SCHEMA, SETTINGS_NAMESPACE };
 export { CONVERT_SETTINGS_SCHEMA };
 /**
  * 组合 schema 与它的取值形态住在 `./config-schema.js`：那里**没有工具层依赖**，
- * 所以 `tests/settings-schema.test.mjs` 能 import 它并把两组设置解析一遍（装载器
+ * 所以 `tests/settings-schema.test.mjs` 能 import 它并把设置解析一遍（装载器
  * 仍然要从**本模块**读到 `Config`，所以这里 import 之后再 re-export）。
  *
  * 0.1.7 删掉了「设置命名空间 + `settings.installSection`」这一整套 API，改成

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAsClD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAiB,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAEpE,OAAO,EACL,YAAY,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,UAAU,IAAI,kBAAkB,EACnG,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAC9C,KAAK,UAAU,EACf,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAA;AAEzB,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,CAAA;AAC7G,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,oBAAoB,EAAE,CAAA;AAExH,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C;;;GAGG;AACH,eAAO,MAAM,MAAM,iCAAkC,CAAA;AAGrD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAClC;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AASvE,OAAO,EAAE,MAAM,EAAE,KAAK,qBAAqB,EAAE,CAAA;AAW7C,wBAAgB,qBAAqB,IAAI,cAAc,GAAG,SAAS,CAAgC;AAmRnG,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,GAAE,qBAA0B,GAAG,IAAI,CA2pDlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AA0ClD,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAiB,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGpE,OAAO,EACL,YAAY,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,UAAU,IAAI,kBAAkB,EACnG,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAC9C,KAAK,UAAU,EACf,KAAK,oBAAoB,EAE1B,MAAM,kBAAkB,CAAA;AAGzB,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,CAAA;AAC7G,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,KAAK,oBAAoB,EAAE,CAAA;AAExH,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C;;;GAGG;AACH,eAAO,MAAM,MAAM,iDAAkD,CAAA;AAGrE,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAClC;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AASvE,OAAO,EAAE,MAAM,EAAE,KAAK,qBAAqB,EAAE,CAAA;AAW7C,wBAAgB,qBAAqB,IAAI,cAAc,GAAG,SAAS,CAAgC;AAwRnG,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,GAAE,qBAA0B,GAAG,IAAI,CA0+DlF"}