ehbrowser 1.0.0

package/dist/config/atomic.js

@@ -0,0 +1,85 @@
+/*
+ * 落盘。
+ * 流程：临时文件 -> fsync -> rename -> chmod -> fsync 目录。
+ */
+import { randomUUID } from "node:crypto";
+import { chmod, mkdir, open, readFile, rename, unlink } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+export async function ensureDir(dir, mode = 0o700) {
+    await mkdir(dir, { recursive: true, mode });
+}
+/** 文件不存在时返回 null */
+export async function readTextIfExists(file) {
+    try {
+        return await readFile(file, "utf8");
+    }
+    catch (error) {
+        if (isNotFound(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export function isNotFound(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        error.code === "ENOENT");
+}
+/**
+ * 原子写。临时文件必须与目标文件同目录，跨分区 rename 不再具有原子性。
+ * mode 未传入时使用 0o600。
+ */
+export async function writeFileAtomic(file, text, options = {}) {
+    const dir = dirname(file);
+    const mode = options.mode ?? 0o600;
+    await ensureDir(dir);
+    const tmp = join(dir, `.${basename(file)}.tmp-${process.pid}-${randomUUID().slice(0, 8)}`);
+    const handle = await open(tmp, "w", mode);
+    try {
+        await handle.writeFile(text, "utf8");
+        // 写入的内容先落盘，随后执行 sync
+        await handle.sync();
+    }
+    catch (error) {
+        await handle.close().catch(() => undefined);
+        await unlink(tmp).catch(() => undefined);
+        throw error;
+    }
+    await handle.close();
+    try {
+        await rename(tmp, file);
+    }
+    catch (error) {
+        await unlink(tmp).catch(() => undefined);
+        throw error;
+    }
+    // 部分文件系统在 rename 后权限会跟随临时文件，这里显式重设权限
+    await chmod(file, mode);
+    await syncDir(dir);
+}
+/** 将损坏文件移到一边，返回移动后的位置 */
+export async function moveAside(file, suffix) {
+    const target = `${file}.${suffix}`;
+    await rename(file, target);
+    return target;
+}
+/** 备份与损坏文件用的时间戳，形如 20260919-013045 */
+export function timeStamp(date = new Date()) {
+    const pad = (n) => String(n).padStart(2, "0");
+    return (`${date.getFullYear()}${pad(date.getMonth() + 1)}${pad(date.getDate())}` +
+        `-${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`);
+}
+async function syncDir(dir) {
+    try {
+        const handle = await open(dir, "r");
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch {
+        // 目录 fsync 失败时忽略该错误
+    }
+}

package/dist/config/auth-setting.js

@@ -0,0 +1,97 @@
+/*
+ * auth_setting.json 的接线与账号数据操作。
+ * 文件包含 cookie：权限 0600、不进入日志、对外输出前脱敏。
+ * 本层仅做数据操作（增删账号、切换激活）；业务规则属于 services。
+ */
+import { join } from "node:path";
+import { getPaths } from "../platform/paths.js";
+import { createJsonStore } from "./json-store.js";
+import { AUTH_SETTING_MIGRATIONS } from "./migrations.js";
+import { AUTH_SETTING_DEFAULTS, AUTH_SETTING_FIELDS, } from "./schema.js";
+export const AUTH_SETTING_FILENAME = "auth_setting.json";
+export function authSettingFile(configDir = getPaths().configDir) {
+    return join(configDir, AUTH_SETTING_FILENAME);
+}
+export function createAuthSettingStore(options = {}) {
+    return createJsonStore({
+        file: options.file ?? authSettingFile(),
+        defaults: AUTH_SETTING_DEFAULTS,
+        fields: AUTH_SETTING_FIELDS,
+        migrations: AUTH_SETTING_MIGRATIONS,
+        mode: 0o600,
+        logger: options.logger,
+    });
+}
+/** cookie 是否完整。结构校验属于 schema，此处仅检查取值 */
+export function isCompleteCookies(cookies) {
+    return (cookies.ipbMemberId.trim() !== "" &&
+        cookies.ipbPassHash.trim() !== "" &&
+        cookies.igneous.trim() !== "");
+}
+/** igneous 有效期；超过一半视为临近过期 */
+export const IGNEOUS_TTL_SECONDS = 30 * 24 * 60 * 60;
+/** 已存在的天数，无记录返回 null */
+export function igneousAgeDays(account, now = Date.now()) {
+    if (account === null || account.igneousUpdatedAt === null) {
+        return null;
+    }
+    return Math.floor((now / 1000 - account.igneousUpdatedAt) / 86400);
+}
+/** 超过半个有效期即视为临近过期 */
+export function isIgneousStale(account, now = Date.now()) {
+    const age = igneousAgeDays(account, now);
+    if (age === null) {
+        return false;
+    }
+    return age * 86400 > IGNEOUS_TTL_SECONDS * 0.5;
+}
+/** 未指定时取第一个账号 */
+export function activeAccount(auth) {
+    if (auth.activeAccountId === null) {
+        return auth.accounts[0] ?? null;
+    }
+    return auth.accounts.find((item) => item.id === auth.activeAccountId) ?? null;
+}
+/** 对外摘要；输出到服务端的字段仅限这些 */
+export function summarizeAccount(auth, account) {
+    return {
+        id: account.id,
+        label: account.label,
+        site: account.site,
+        active: activeAccount(auth)?.id === account.id,
+        igneousUpdatedAt: account.igneousUpdatedAt,
+        hasApiKey: account.apiKey !== undefined,
+    };
+}
+/** 日志用；cookie 仅保留长度 */
+export function redactAuth(auth) {
+    return {
+        schemaVersion: auth.schemaVersion,
+        activeAccountId: auth.activeAccountId,
+        accounts: auth.accounts.map((account) => ({
+            id: account.id,
+            label: account.label,
+            site: account.site,
+            igneousLength: account.cookies.igneous.length,
+            igneousUpdatedAt: account.igneousUpdatedAt,
+        })),
+        proxyAuth: auth.proxyAuth.username === "" ? "(空)" : "(有)",
+    };
+}
+/** 已存在时替换，否则追加 */
+export function upsertAccount(accounts, account) {
+    const index = accounts.findIndex((item) => item.id === account.id);
+    if (index === -1) {
+        return [...accounts, account];
+    }
+    const next = [...accounts];
+    next[index] = account;
+    return next;
+}
+export function removeAccount(accounts, id) {
+    return accounts.filter((item) => item.id !== id);
+}
+/** 随机标识；用户名可重复且可变更，不适合作为 id */
+export function newAccountId() {
+    return `acc_${Math.random().toString(36).slice(2, 10)}`;
+}

package/dist/config/cli.js

@@ -0,0 +1,19 @@
+/* npm run config:path：打印生效的三条目录与文件状态 */
+import { existsSync } from "node:fs";
+import { databaseFile } from "./db.js";
+import { describePaths, initPaths } from "../platform/paths.js";
+import { authSettingFile } from "./auth-setting.js";
+import { userSettingFile } from "./user-setting.js";
+const paths = initPaths();
+console.log(describePaths(paths));
+console.log();
+const files = [
+    userSettingFile(paths.configDir),
+    authSettingFile(paths.configDir),
+    databaseFile(paths.dataDir),
+];
+for (const file of files) {
+    console.log(`${existsSync(file) ? "有" : "无"}  ${file}`);
+}
+console.log();
+console.log("优先级：EHBROWSER_CONFIG_DIR 等 > EHBROWSER_HOME > 系统默认");

package/dist/config/db.js

@@ -0,0 +1,168 @@
+/*
+ * 机器写数据库：程序标记、画廊缓存、下载任务、每画廊读到第几页。
+ * 每次开库设置三个 pragma：WAL、busy_timeout、foreign_keys（默认关闭）。
+ * 表结构版本由 PRAGMA user_version 记录。
+ */
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+export const DB_FILENAME = "ehbrowser.db";
+export const DB_VERSION = 4;
+export function databaseFile(dataDir) {
+    return join(dataDir, DB_FILENAME);
+}
+// 每版一段，新版本追加，历史段落不变
+const MIGRATIONS = [
+    `
+    create table if not exists meta (
+        key text primary key,
+        value text not null
+    );
+
+    create table if not exists galleries (
+        gid integer primary key,
+        token text not null,
+        title text not null default '',
+        title_jpn text not null default '',
+        category text not null default '',
+        thumb_url text not null default '',
+        uploader text not null default '',
+        posted_at integer,
+        page_count integer,
+        size_bytes integer,
+        rating real,
+        torrent_count integer,
+        expunged integer not null default 0,
+        language text,
+        tags_json text not null default '[]',
+        fetched_at integer not null
+    );
+
+    create table if not exists downloads (
+        id text primary key,
+        gid integer not null,
+        token text not null,
+        title text not null default '',
+        resolution text not null default 'org',
+        status text not null default 'queued',
+        bytes_done integer not null default 0,
+        bytes_total integer,
+        output_path text,
+        error text,
+        created_at integer not null,
+        updated_at integer not null
+    );
+
+    -- 每画廊读到第几页
+    create table if not exists reading_progress (
+        gid integer primary key,
+        page integer not null default 1,
+        updated_at integer not null
+    );
+
+    create index if not exists idx_downloads_status on downloads (status, created_at);
+    create index if not exists idx_galleries_fetched on galleries (fetched_at);
+    `,
+    // v2：用户播放列表。需要持久化，因此存放在数据库中，而不是内存或配置文件里
+    `
+    create table if not exists playlist_items (
+        key text primary key,
+        position integer not null,
+        gid integer not null,
+        token text not null,
+        title text not null default '',
+        thumb_url text not null default '',
+        page_count integer not null default 0,
+        resolution text,
+        page integer not null default 1,
+        bytes_per_page integer not null default 0,
+        added_at integer not null,
+        updated_at integer not null
+    );
+
+    create index if not exists idx_playlist_position on playlist_items (position);
+    `,
+    // v3：本地收藏夹与收藏项。云端分类只是槽位号，条目本身保存在本地
+    `
+    create table if not exists favorite_folders (
+        id text primary key,
+        name text not null,
+        position integer not null default 0,
+        created_at integer not null
+    );
+
+    create table if not exists favorite_items (
+        folder_id text not null,
+        gid integer not null,
+        token text not null,
+        title text not null default '',
+        thumb_url text not null default '',
+        page_count integer not null default 0,
+        -- 云端分类槽位；-1 表示只在本地、没有对应的云端收藏
+        slot integer not null default -1,
+        added_at integer not null,
+        primary key (folder_id, gid)
+    );
+
+    create index if not exists idx_favorite_items_folder on favorite_items (folder_id, added_at);
+    `,
+    // v4：逐页下载（游客也可下载）需要记录「第几页 / 共几页」，归档任务这两列为空
+    `
+    alter table downloads add column pages_done integer not null default 0;
+    alter table downloads add column page_count integer;
+    `,
+];
+export function openDatabase(file) {
+    const db = new DatabaseSync(file);
+    db.exec("pragma journal_mode = WAL");
+    db.exec("pragma busy_timeout = 5000");
+    db.exec("pragma foreign_keys = ON");
+    migrate(db);
+    return {
+        file,
+        raw: db,
+        getMeta(key) {
+            const row = db.prepare("select value from meta where key = ?").get(key);
+            return row?.value ?? null;
+        },
+        setMeta(key, value) {
+            db.prepare("insert into meta (key, value) values (?, ?) on conflict(key) do update set value = excluded.value").run(key, value);
+        },
+        deleteMeta(key) {
+            db.prepare("delete from meta where key = ?").run(key);
+        },
+        allMeta() {
+            const rows = db.prepare("select key, value from meta").all();
+            const out = {};
+            for (const row of rows) {
+                out[row.key] = row.value;
+            }
+            return out;
+        },
+        close() {
+            try {
+                db.exec("pragma wal_checkpoint(truncate)");
+            }
+            catch {
+                // 合并失败时忽略，下次开库会再次合并
+            }
+            db.close();
+        },
+    };
+}
+function migrate(db) {
+    const row = db.prepare("pragma user_version").get();
+    let version = row?.user_version ?? 0;
+    if (version > MIGRATIONS.length) {
+        // 数据库版本高于程序支持的版本：读操作正常，写操作存在风险
+        throw new Error(`数据库版本 v${version} 高于程序支持的 v${MIGRATIONS.length}`);
+    }
+    while (version < MIGRATIONS.length) {
+        const sql = MIGRATIONS[version];
+        if (sql === undefined) {
+            break;
+        }
+        db.exec(sql);
+        version += 1;
+        db.exec(`pragma user_version = ${version}`);
+    }
+}

package/dist/config/index.js

@@ -0,0 +1,48 @@
+/*
+ * config 层的门面。
+ */
+import { ensureDirs, getPaths } from "../platform/paths.js";
+import { authSettingFile, createAuthSettingStore } from "./auth-setting.js";
+import { databaseFile, openDatabase } from "./db.js";
+import { createUserSettingStore, userSettingFile } from "./user-setting.js";
+export async function initConfig(options = {}) {
+    const paths = options.paths ?? getPaths();
+    const logger = options.logger ?? consoleLogger;
+    await ensureDirs(paths);
+    const user = createUserSettingStore({ file: userSettingFile(paths.configDir), logger });
+    const auth = createAuthSettingStore({ file: authSettingFile(paths.configDir), logger });
+    // 并行加载；文件损坏时回退默认值，不阻塞启动。
+    await Promise.all([user.load(), auth.load()]);
+    const db = openDatabase(databaseFile(paths.dataDir));
+    db.setMeta("last_started_at", String(Math.floor(Date.now() / 1000)));
+    db.setMeta("user_setting_version", String(user.get().schemaVersion));
+    return {
+        paths,
+        user,
+        auth,
+        db,
+        async close() {
+            await Promise.all([user.flush(), auth.flush()]);
+            db.close();
+        },
+    };
+}
+const consoleLogger = (level, message, meta) => {
+    const line = `[config] ${message}`;
+    if (level === "error") {
+        console.error(line, meta ?? "");
+    }
+    else if (level === "warn") {
+        console.warn(line, meta ?? "");
+    }
+    else {
+        console.info(line, meta ?? "");
+    }
+};
+export { createJsonStore, ConfigInvalidError } from "./json-store.js";
+export { describePaths, getPaths, initPaths, resetPaths } from "../platform/paths.js";
+export * from "./schema.js";
+export { activeAccount, igneousAgeDays, isCompleteCookies, isIgneousStale, newAccountId, redactAuth, removeAccount, summarizeAccount, upsertAccount, } from "./auth-setting.js";
+export { databaseFile, DB_FILENAME, openDatabase } from "./db.js";
+export { createUserSettingStore, USER_SETTING_FILENAME, userSettingFile } from "./user-setting.js";
+export { authSettingFile, AUTH_SETTING_FILENAME, createAuthSettingStore } from "./auth-setting.js";

package/dist/config/json-store.js

@@ -0,0 +1,219 @@
+/*
+ * 通用 JSON 存储管线：读取、迁移、校验、修复与原子写入
+ */
+import { readTextIfExists, moveAside, timeStamp, writeFileAtomic } from "./atomic.js";
+import { readVersion, runMigrations } from "./migrations.js";
+import { collectUnknownPaths, deepMerge, isPlainObject, repairFields, validateFields, } from "./validate.js";
+/** 字段校验失败时抛出，携带字段级问题列表。 */
+export class ConfigInvalidError extends Error {
+    issues;
+    constructor(issues) {
+        super(`配置校验失败：${issues.map((i) => i.path).join("、")}`);
+        this.name = "ConfigInvalidError";
+        this.issues = issues;
+    }
+}
+export function createJsonStore(options) {
+    const log = options.logger ?? (() => undefined);
+    const listeners = new Set();
+    let snapshot = null;
+    let queue = Promise.resolve();
+    /** 写操作串行队列，避免并发 patch 相互覆盖。 */
+    function serialize(task) {
+        const next = queue.then(task, task);
+        queue = next.then(() => undefined, () => undefined);
+        return next;
+    }
+    async function load() {
+        if (snapshot !== null) {
+            return snapshot.value;
+        }
+        snapshot = await serialize(readFromDisk);
+        return snapshot.value;
+    }
+    async function readFromDisk() {
+        const text = await readTextIfExists(options.file);
+        // 文件不存在：写入默认值，供用户查看与编辑。
+        if (text === null) {
+            const result = finish(clone(options.defaults), true);
+            await write(result.raw);
+            return result;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch (error) {
+            const moved = await moveAside(options.file, `corrupt-${timeStamp()}`);
+            log("warn", `无法读取配置文件。源文件已移动到 ${moved}，本次使用默认值`, { error });
+            const result = finish(clone(options.defaults), true);
+            await write(result.raw);
+            return result;
+        }
+        if (!isPlainObject(parsed)) {
+            const moved = await moveAside(options.file, `corrupt-${timeStamp()}`);
+            log("warn", `配置根节点不是对象。源文件已移动到 ${moved}，本次使用默认值`);
+            const result = finish(clone(options.defaults), true);
+            await write(result.raw);
+            return result;
+        }
+        const version = readVersion(parsed);
+        const target = options.defaults.schemaVersion;
+        // 版本高于程序：仅读取，不写回。
+        if (version > target) {
+            log("warn", `文件版本 v${version} 高于程序支持的 v${target}。已进入只读模式`);
+            const merged = deepMerge(clone(options.defaults), parsed);
+            return { value: deepFreeze(merged), raw: clone(parsed), writable: false };
+        }
+        // 版本低于程序：执行迁移
+        let raw = parsed;
+        let migrated = false;
+        if (version < target) {
+            const outcome = runMigrations(raw, target, options.migrations ?? []);
+            if (outcome.applied.length > 0) {
+                await backup();
+                raw = outcome.data;
+                migrated = true;
+                log("info", `配置已从 v${version} 迁移到 v${target}`);
+            }
+        }
+        // 默认值打底、文件内容覆盖。未声明字段由 deepMerge 保留。
+        const withDefaults = deepMerge(clone(options.defaults), raw);
+        const issues = repairFields(withDefaults, options.defaults, options.fields);
+        if (issues.length > 0) {
+            log("warn", `配置存在 ${issues.length} 处非法值。已替换为默认值`, issues);
+        }
+        const result = finish(withDefaults, true);
+        // 迁移或修复后写回磁盘。
+        if (migrated || issues.length > 0) {
+            await write(result.raw);
+        }
+        return result;
+    }
+    function finish(raw, writable) {
+        const merged = deepMerge(clone(options.defaults), raw);
+        return { value: deepFreeze(merged), raw, writable };
+    }
+    async function write(raw) {
+        const text = `${JSON.stringify(raw, null, 4)}\n`;
+        await writeFileAtomic(options.file, text, { mode: options.mode });
+    }
+    async function backup() {
+        try {
+            await moveAside(options.file, `bak-${timeStamp()}`);
+        }
+        catch (error) {
+            log("warn", "迁移前备份失败，继续执行", { error });
+        }
+    }
+    function current() {
+        if (snapshot === null) {
+            throw new Error(`配置文件尚未加载：${options.file}`);
+        }
+        return snapshot;
+    }
+    function broadcast(value) {
+        for (const listener of listeners) {
+            try {
+                listener(value);
+            }
+            catch (error) {
+                log("warn", "onChange 回调执行异常", { error });
+            }
+        }
+    }
+    async function commit(next) {
+        const state = current();
+        // 只读模式：拒绝写入。
+        if (!state.writable) {
+            throw new Error(`只读模式：${options.file} 的版本高于当前程序，禁止写入`);
+        }
+        const issues = validateFields(next, options.fields);
+        if (!issues.ok) {
+            throw new ConfigInvalidError(issues.issues);
+        }
+        await write(next);
+        snapshot = {
+            value: deepFreeze(deepMerge(clone(options.defaults), next)),
+            raw: next,
+            writable: true,
+        };
+        broadcast(snapshot.value);
+        return snapshot.value;
+    }
+    return {
+        file: options.file,
+        async load() {
+            return load();
+        },
+        isLoaded() {
+            return snapshot !== null;
+        },
+        get() {
+            return current().value;
+        },
+        raw() {
+            return current().raw;
+        },
+        async patch(patch) {
+            await load();
+            return serialize(async () => {
+                const unknown = collectUnknownPaths(patch, options.defaults);
+                if (unknown.length > 0) {
+                    throw new ConfigInvalidError(unknown.map((path) => ({
+                        path,
+                        code: "conflict",
+                        message: "未声明字段",
+                    })));
+                }
+                const state = current();
+                // 以磁盘内容为基准打补丁，未声明字段一并保留
+                const draft = clone(state.raw);
+                const merged = deepMerge(draft, patch);
+                return commit(merged);
+            });
+        },
+        async replace(next) {
+            await load();
+            return serialize(async () => {
+                const issues = validateFields(next, options.fields);
+                if (!issues.ok) {
+                    throw new ConfigInvalidError(issues.issues);
+                }
+                return commit(clone(next));
+            });
+        },
+        async reload() {
+            // 此处不可调用 load()：load() 会再次进入 serialize，
+            // 内层排在外层之后、外层等待内层，形成死锁。
+            return serialize(async () => {
+                snapshot = await readFromDisk();
+                return snapshot.value;
+            });
+        },
+        async flush() {
+            await queue;
+        },
+        onChange(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        isWritable() {
+            return snapshot?.writable ?? true;
+        },
+    };
+}
+function clone(value) {
+    return structuredClone(value);
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === "object") {
+        for (const item of Object.values(value)) {
+            deepFreeze(item);
+        }
+        Object.freeze(value);
+    }
+    return value;
+}