pixivflow 2.9.0 → 2.10.1

package/dist/topic/createTopicPipeline.d.ts

@@ -0,0 +1,16 @@
+import type { IPixivClient } from '../interfaces/IPixivClient';
+import { TopicPipeline } from './TopicPipeline';
+export type TopicPipelineFactory = () => TopicPipeline;
+/**
+ * Builds the topic pipeline with a persistent cache beside the SQLite database
+ * (which lives on the data volume in Docker, so it survives container rebuilds).
+ * One instance is shared across targets within a download run.
+ */
+type DbPathSource = string | {
+    getDatabasePath(): string;
+} | undefined;
+export declare function createTopicPipeline(client: IPixivClient, databasePath: DbPathSource, requestDelayMs?: number): TopicPipeline;
+/** Lazily builds one shared pipeline per download run (cache + resolver). */
+export declare function createTopicPipelineFactory(client: IPixivClient, databasePath: DbPathSource, requestDelayMs?: number): TopicPipelineFactory;
+export {};
+//# sourceMappingURL=createTopicPipeline.d.ts.map

package/dist/topic/createTopicPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTopicPipeline.d.ts","sourceRoot":"","sources":["../../src/topic/createTopicPipeline.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,MAAM,oBAAoB,GAAG,MAAM,aAAa,CAAC;AAEvD;;;;GAIG;AACH,KAAK,YAAY,GAAG,MAAM,GAAG;IAAE,eAAe,IAAI,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAYvE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,SAAM,GAAG,aAAa,CAKzH;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,SAAM,GAAG,oBAAoB,CAMvI"}

package/dist/topic/createTopicPipeline.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTopicPipeline = createTopicPipeline;
+exports.createTopicPipelineFactory = createTopicPipelineFactory;
+const node_path_1 = require("node:path");
+const TopicCache_1 = require("./TopicCache");
+const TopicPipeline_1 = require("./TopicPipeline");
+const TopicResolver_1 = require("./TopicResolver");
+function resolveDbPath(source) {
+    const raw = typeof source === 'function'
+        ? undefined
+        : source && typeof source === 'object'
+            ? source.getDatabasePath()
+            : source;
+    const absolute = raw && (0, node_path_1.isAbsolute)(raw) ? raw : (0, node_path_1.resolve)(process.cwd(), raw ?? 'data/pixiv-downloader.db');
+    return absolute;
+}
+function createTopicPipeline(client, databasePath, requestDelayMs = 500) {
+    const resolved = resolveDbPath(databasePath);
+    const cache = new TopicCache_1.TopicCache((0, node_path_1.resolve)((0, node_path_1.dirname)(resolved), 'topic-cache'));
+    const resolver = new TopicResolver_1.TopicResolver(client, cache, requestDelayMs);
+    return new TopicPipeline_1.TopicPipeline(client, resolver, requestDelayMs);
+}
+/** Lazily builds one shared pipeline per download run (cache + resolver). */
+function createTopicPipelineFactory(client, databasePath, requestDelayMs = 500) {
+    let instance;
+    return () => {
+        if (!instance)
+            instance = createTopicPipeline(client, databasePath, requestDelayMs);
+        return instance;
+    };
+}
+//# sourceMappingURL=createTopicPipeline.js.map

package/dist/topic/createTopicPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTopicPipeline.js","sourceRoot":"","sources":["../../src/topic/createTopicPipeline.ts"],"names":[],"mappings":";;AA4BA,kDAKC;AAGD,gEAMC;AAzCD,yCAAwE;AAIxE,6CAA0C;AAC1C,mDAAgD;AAChD,mDAAgD;AAWhD,SAAS,aAAa,CAAC,MAAoB;IACzC,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,UAAU;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YACpC,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE;YAC1B,CAAC,CAAC,MAAM,CAAC;IACb,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAA,sBAAU,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,mBAAW,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,0BAA0B,CAAC,CAAC;IAC9G,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAoB,EAAE,YAA0B,EAAE,cAAc,GAAG,GAAG;IACxG,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,uBAAU,CAAC,IAAA,mBAAW,EAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,6BAAa,CAAC,MAAe,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IAC3E,OAAO,IAAI,6BAAa,CAAC,MAAe,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AACtE,CAAC;AAED,6EAA6E;AAC7E,SAAgB,0BAA0B,CAAC,MAAoB,EAAE,YAA0B,EAAE,cAAc,GAAG,GAAG;IAC/G,IAAI,QAAmC,CAAC;IACxC,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,QAAQ;YAAE,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;QACpF,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/topic/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Semantic-topic download: resolve a user topic into a dynamic, Pixiv-derived
+ * search space. Pure metadata/tag signals only — no LLM, VLM, embeddings or
+ * local models are used anywhere in this module.
+ */
+export type TopicContentType = 'illustration' | 'novel';
+/** A single related tag with a 0..1 relatedness score and provenance. */
+export interface ResolvedTag {
+    name: string;
+    translatedName?: string;
+    /** Combined relatedness score (co-occurrence * specificity * suggestion). */
+    score: number;
+    /** How many sampled works (of the seed search) carried this tag. */
+    occurrences: number;
+    /** Coverage of the sampled seed works (occurrences / sample size). */
+    coverage: number;
+    /** Specificity: high when common with the topic but rare in the background. */
+    specificity: number;
+    /** Present in Pixiv autocomplete for the seed. */
+    suggested: boolean;
+    /** The seed tag always scores 1.0 and is always included. */
+    seed: boolean;
+}
+/**
+ * The resolved search space for one topic + content type. Cached on the data
+ * volume so daily runs reuse it and a failed refresh can fall back to it.
+ */
+export interface TopicSpace {
+    version: 1;
+    topic: string;
+    contentType: TopicContentType;
+    createdAt: string;
+    expiresAt: string;
+    sampleSize: number;
+    sampledWorks: number;
+    tags: ResolvedTag[];
+}
+export interface TopicDiscoveryOptions {
+    maxTags?: number;
+    sampleWorks?: number;
+    cacheDays?: number;
+    minScore?: number;
+    refresh?: boolean;
+}
+export interface TopicCollectOptions {
+    maxPerTag?: number;
+    maxCandidates?: number;
+    minMetadataScore?: number;
+}
+/** A trimmed candidate: only fields needed for filtering/ranking. */
+export interface TopicCandidate {
+    id: number;
+    type: TopicContentType;
+    title: string;
+    caption: string;
+    tags: string[];
+    bookmarks: number;
+    views: number;
+    /** Local popularity score (bookmarks + views/1000). */
+    popularity: number;
+    /** Metadata topic-relevance score computed by the filter stage. */
+    metadataScore: number;
+}
+/** Minimal surface the resolver/collector need from the Pixiv client. */
+export interface TopicClient {
+    getTagAutocomplete(seed: string): Promise<Array<{
+        name: string;
+        translated_name?: string;
+    }>>;
+    searchIllustrationsForTags(seed: string, limit: number, options?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<Array<WorkLike>>;
+    searchNovelsForTags(seed: string, limit: number, options?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<Array<WorkLike>>;
+}
+export interface WorkLike {
+    id: number;
+    title?: string;
+    caption?: string;
+    create_date?: string;
+    tags?: Array<{
+        name: string;
+        translated_name?: string;
+    }>;
+    total_bookmarks?: number;
+    bookmark_count?: number;
+    total_view?: number;
+    view_count?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/topic/types.d.ts.map

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

package/dist/topic/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Semantic-topic download: resolve a user topic into a dynamic, Pixiv-derived
+ * search space. Pure metadata/tag signals only — no LLM, VLM, embeddings or
+ * local models are used anywhere in this module.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/topic/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/topic/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/webui/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow-webui-backend",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixivflow",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "description": "🎨 智能的 Pixiv 自动化下载工具 - 支持批量下载插画和小说、定时任务、Docker部署 | Intelligent Pixiv Automation Downloader with batch download, scheduler, and Docker support",
   "repository": {
     "type": "git",