pixivflow 2.8.0 → 2.10.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopicTagScorer.d.ts","sourceRoot":"","sources":["../../src/topic/TopicTagScorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAoCrD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,qBAAa,cAAc;IACzB,2DAA2D;IAC3D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1B,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE;CA+EzC"}

package/dist/topic/TopicTagScorer.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicTagScorer = void 0;
+/**
+ * Lightweight, explainable tag relatedness. No ML — pure co-occurrence stats
+ * over the small, bounded samples the resolver fetches.
+ *
+ *   score = coverage * specificity * suggestionWeight
+ *
+ * - coverage:      fraction of the seed-topic sample that carries the tag.
+ * - specificity:   how much more often the tag appears with the topic than in
+ *                  the background. High-frequency but topic-agnostic tags
+ *                  (R-18, オリジナル, 女の子…) get pushed down automatically.
+ * - suggestionWeight: a modest boost when Pixiv autocomplete also returns it.
+ *
+ * The background document frequency is estimated from a cheap background
+ * sample (a recent, unrelated search) when available, falling back to a small
+ * curated set of platform-wide tags. We deliberately keep that list tiny — the
+ * specificity score does the real denoising.
+ */
+/** Platform-level tags that are almost never topic-specific. */
+const GENERIC_TAG_PENALTY = new Set([
+    'r-18', 'r-18g', 'r-15', 'original', 'オリジナル', '創作', '女の子', '男の子',
+    'イラスト', '漫画', 'manga', 'illustration', 'artwork', '落書き', 'らくがき',
+    '1000users入り', '5000users入り', '10000users入り', '500users入り', '100users入り',
+    'pixiv', 'commission', 'skeb', '依頼絵', '仕事絵',
+]);
+class TopicTagScorer {
+    /** Normalize for matching/keys: trim, NFKC, lower-case. */
+    key(value) {
+        return value.trim().normalize('NFKC').toLocaleLowerCase();
+    }
+    score(input) {
+        const seedKey = this.key(input.seed);
+        const topicSize = Math.max(input.topicWorks.length, 1);
+        const backgroundSize = Math.max(input.backgroundWorks.length, 1);
+        const stats = new Map();
+        const accumulate = (works, bucket) => {
+            for (const work of works) {
+                const seen = new Set();
+                for (const tag of work.tags ?? []) {
+                    const name = tag.name?.trim();
+                    const k = this.key(name ?? '');
+                    if (!k || seen.has(k))
+                        continue;
+                    seen.add(k);
+                    let stat = stats.get(k);
+                    if (!stat) {
+                        stat = { name: name, translatedName: tag.translated_name?.trim() || undefined, topicDocs: 0, backgroundDocs: 0, suggested: false };
+                        stats.set(k, stat);
+                    }
+                    else if (!stat.translatedName && tag.translated_name?.trim()) {
+                        stat.translatedName = tag.translated_name.trim();
+                    }
+                    stat[bucket] += 1;
+                }
+            }
+        };
+        accumulate(input.topicWorks, 'topicDocs');
+        accumulate(input.backgroundWorks, 'backgroundDocs');
+        for (const name of input.suggestedNames) {
+            const k = this.key(name);
+            const stat = stats.get(k);
+            if (stat)
+                stat.suggested = true;
+        }
+        const resolved = [];
+        for (const [k, stat] of stats) {
+            if (k === seedKey)
+                continue; // seed is added separately with score 1
+            const coverage = stat.topicDocs / topicSize;
+            if (stat.topicDocs <= 0)
+                continue;
+            // Background frequency of the tag in the unrelated sample. Tags that are
+            // common everywhere (R-18, オリジナル…) have high backgroundFreq; tags
+            // that only travel with the topic have ~0.
+            const backgroundFreq = stat.backgroundDocs / backgroundSize;
+            // PMI-style lift: how much more the tag appears with the topic than at
+            // large. Positive (and growing for background-absent tags), near/below 0
+            // for generic tags. Additive smoothing prevents divide-by-zero blowups.
+            const lift = Math.log((coverage + 0.03) / (backgroundFreq + 0.03));
+            // Map lift to a 0..1+ specificity via a logistic-ish squish; a lift of ~0
+            // (equally common in background) maps to ~0.5 and strongly generic tags
+            // fall below it.
+            const specificity = Math.max(0, Math.min(1.2, lift / 3 + 0.5));
+            // Final score rewards both co-occurrence (recall) and specificity
+            // (precision), so rare-but-exclusive tags can still surface while
+            // ubiquitous tags are suppressed.
+            const recall = Math.sqrt(coverage); // dampen so mid-coverage can win
+            const suggestionWeight = stat.suggested ? 1.1 : 1.0;
+            const genericPenalty = GENERIC_TAG_PENALTY.has(k) ? 0.4 : 1.0;
+            const raw = recall * specificity * suggestionWeight * genericPenalty;
+            resolved.push({
+                name: stat.name,
+                translatedName: stat.translatedName,
+                score: Number(raw.toFixed(4)),
+                occurrences: stat.topicDocs,
+                coverage: Number(coverage.toFixed(4)),
+                specificity: Number(specificity.toFixed(4)),
+                suggested: stat.suggested,
+                seed: false,
+            });
+        }
+        resolved.sort((a, b) => b.score - a.score || b.occurrences - a.occurrences || a.name.localeCompare(b.name));
+        return resolved;
+    }
+}
+exports.TopicTagScorer = TopicTagScorer;
+//# sourceMappingURL=TopicTagScorer.js.map

package/dist/topic/TopicTagScorer.js.map

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

package/dist/topic/createTopicPipeline.d.ts

@@ -0,0 +1,12 @@
+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.
+ */
+export declare function createTopicPipeline(client: IPixivClient, databasePath: string | undefined, requestDelayMs?: number): TopicPipeline;
+/** Lazily builds one shared pipeline per download run (cache + resolver). */
+export declare function createTopicPipelineFactory(client: IPixivClient, databasePath: string | undefined, requestDelayMs?: number): TopicPipelineFactory;
+//# 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,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,SAAM,GAAG,aAAa,CAO/H;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,SAAM,GAAG,oBAAoB,CAM7I"}

package/dist/topic/createTopicPipeline.js

@@ -0,0 +1,31 @@
+"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");
+/**
+ * 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.
+ */
+function createTopicPipeline(client, databasePath, requestDelayMs = 500) {
+    const resolved = databasePath && (0, node_path_1.isAbsolute)(databasePath)
+        ? databasePath
+        : (0, node_path_1.resolve)(process.cwd(), databasePath ?? 'data/pixiv-downloader.db');
+    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":";;AAgBA,kDAOC;AAGD,gEAMC;AA/BD,yCAAwE;AAIxE,6CAA0C;AAC1C,mDAAgD;AAChD,mDAAgD;AAIhD;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,MAAoB,EAAE,YAAgC,EAAE,cAAc,GAAG,GAAG;IAC9G,MAAM,QAAQ,GAAG,YAAY,IAAI,IAAA,sBAAU,EAAC,YAAY,CAAC;QACvD,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,IAAA,mBAAW,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,IAAI,0BAA0B,CAAC,CAAC;IAC3E,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,YAAgC,EAAE,cAAc,GAAG,GAAG;IACrH,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.8.0",
+  "version": "2.10.0",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/package.json

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