dsh-config-manager 0.1.39 → 0.1.41

package/lib/core/cache-cleaner.d.ts

@@ -0,0 +1,39 @@
+/** 临时文件缺省保留期：24 小时（覆盖跨会话「刷新恢复导入」窗口，昨天的残留自动清） */
+export declare const TMP_RETENTION_DEFAULT_MS: number;
+/** 导出产物缺省保留期：7 天（导出时用户已通过浏览器下载/另存到本地，host 端副本按周回收） */
+export declare const EXPORTS_RETENTION_DEFAULT_MS: number;
+/** 市场缓存/工作副本缺省保留期：7 天（重建成本 = 一次网络拉取） */
+export declare const MARKET_RETENTION_DEFAULT_MS: number;
+export interface CacheCleanupOptions {
+    /** 临时目录（$DSH_HOME/dsh-config-manager/tmp） */
+    tmpDir: string;
+    /** 导出产物目录（$DSH_HOME/dsh-config-manager/exports） */
+    exportsDir: string;
+    /** 市场缓存根（$DSH_HOME/dsh-config-manager/market/cache） */
+    marketCacheRoot: string;
+    /** 市场工作副本根（$DSH_HOME/dsh-config-manager/market/work） */
+    marketWorkRoot: string;
+    /** 临时文件保留期（缺省 24h） */
+    tmpRetentionMs?: number;
+    /** 导出产物保留期（缺省 7 天） */
+    exportsRetentionMs?: number;
+    /** 市场缓存/工作副本保留期（缺省 7 天） */
+    marketRetentionMs?: number;
+    /** 时间源（测试注入；缺省 Date.now） */
+    now?: () => number;
+}
+export interface CacheCleanupResult {
+    /** 删除条目数（文件 + 目录） */
+    removed: number;
+    /** 释放字节数（仅被删文件的 size 累计；目录删除统计为 0） */
+    freedBytes: number;
+    /** 单项失败数（不影响主流程） */
+    errors: number;
+    /** 每条删除记录（相对 dataDir 的描述 + 字节数），供日志/审计 */
+    detail: string[];
+}
+/**
+ * 执行一次缓存清理（幂等；可重复调用）。
+ * 只清理超期（超过保留期）的缓存/临时条目，其余一律保留。
+ */
+export declare function cleanupCaches(opts: CacheCleanupOptions): Promise<CacheCleanupResult>;

package/lib/core/cache-cleaner.js

@@ -0,0 +1,164 @@
+/**
+ * 缓存自动清理（cache-cleaner）
+ *
+ * 只清理「可重建 / 一次性」的缓存与临时文件，绝不触碰用户数据与安全网：
+ *   - tmpDir 下过期的 `.zip`（upload-* / market-* / publish-* / decrypted-* /
+ *     export-plain-* 等导入/导出/市场暂存，以及 SyncEngine 遗留的临时目录
+ *     dsh-sync-pull-*）——保留期内文件不删（供「刷新恢复导入」等跨请求流程继续消费）；
+ *   - exportsDir 下过期的导出产物 `.zip`（导出时用户已通过浏览器下载/另存到本地，
+ *     host 端只是暂存副本，按保留期回收）；
+ *   - market/cache/<url-hash>/（市场 index 缓存与条目缓存，refresh/download 可重建）；
+ *   - market/work/<url-hash>/（市场 git 只读工作副本，readIndex 时自动重新 clone）。
+ *
+ * 保留不动（属用户数据/安全网，由各自 UI 或业务逻辑管理）：
+ *   - snapshots/（导入前强制快照）、sync/（同步配置/历史/git 工作副本）。
+ *
+ * 实现：与 DSH 运行时解耦的纯函数（node:fs/promises），保留期与时间源参数化，
+ * 任何单项失败均不阻断其余清理（尽力而为），返回清理报告供宿主日志。
+ * 健康性：删除前按 mtime 判定超期（now - mtime > retention），stat 失败保守不删。
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/** 临时文件缺省保留期：24 小时（覆盖跨会话「刷新恢复导入」窗口，昨天的残留自动清） */
+export const TMP_RETENTION_DEFAULT_MS = 24 * 60 * 60 * 1000;
+/** 导出产物缺省保留期：7 天（导出时用户已通过浏览器下载/另存到本地，host 端副本按周回收） */
+export const EXPORTS_RETENTION_DEFAULT_MS = 7 * 24 * 60 * 60 * 1000;
+/** 市场缓存/工作副本缺省保留期：7 天（重建成本 = 一次网络拉取） */
+export const MARKET_RETENTION_DEFAULT_MS = 7 * 24 * 60 * 60 * 1000;
+/** SyncEngine 在 zipDir（即 tmpDir）下 mkdtemp 的目录前缀（用完即删，崩溃残留由清理兜底） */
+const SYNC_TMP_DIR_PREFIX = 'dsh-sync-pull-';
+/** 目录是否超期（stat 失败保守视为未超期 → 不删） */
+async function isExpired(target, retentionMs, nowMs) {
+    try {
+        const st = await fs.stat(target);
+        return nowMs - st.mtimeMs > retentionMs;
+    }
+    catch {
+        return false;
+    }
+}
+/** 删除一个文件/目录并计入报告；目录的 freedBytes 统计为 0（递归统计不划算，用途仅是日志） */
+async function removeEntry(target, label, result) {
+    try {
+        let size = 0;
+        try {
+            const st = await fs.stat(target);
+            size = st.isFile() ? st.size : 0;
+        }
+        catch {
+            /* stat 失败仍尝试删除（rm 自己会兜底不存在） */
+        }
+        await fs.rm(target, { recursive: true, force: true });
+        result.removed += 1;
+        result.freedBytes += size;
+        result.detail.push(`${label} (${size} bytes)`);
+    }
+    catch {
+        result.errors += 1;
+    }
+}
+/**
+ * 执行一次缓存清理（幂等；可重复调用）。
+ * 只清理超期（超过保留期）的缓存/临时条目，其余一律保留。
+ */
+export async function cleanupCaches(opts) {
+    const nowMs = (opts.now ?? Date.now)();
+    const tmpRetentionMs = opts.tmpRetentionMs ?? TMP_RETENTION_DEFAULT_MS;
+    const exportsRetentionMs = opts.exportsRetentionMs ?? EXPORTS_RETENTION_DEFAULT_MS;
+    const marketRetentionMs = opts.marketRetentionMs ?? MARKET_RETENTION_DEFAULT_MS;
+    const result = { removed: 0, freedBytes: 0, errors: 0, detail: [] };
+    // 1) tmpDir：过期 .zip（导入/导出/市场/解密暂存）与 SyncEngine 遗留的 dsh-sync-pull-* 目录
+    try {
+        const entries = await fs.readdir(opts.tmpDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const target = path.join(opts.tmpDir, entry.name);
+            const isTmpish = (entry.isFile() && entry.name.endsWith('.zip')) ||
+                (entry.isDirectory() && entry.name.startsWith(SYNC_TMP_DIR_PREFIX));
+            if (!isTmpish)
+                continue;
+            if (await isExpired(target, tmpRetentionMs, nowMs)) {
+                await removeEntry(target, `tmp/${entry.name}`, result);
+            }
+        }
+    }
+    catch {
+        // tmpDir 不存在/不可读 → 跳过（尽力而为）
+        result.errors += 1;
+    }
+    // 2) exportsDir：过期的导出产物 .zip（导出时已下载/另存到本地，host 端副本按保留期回收）
+    try {
+        const entries = await fs.readdir(opts.exportsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.endsWith('.zip'))
+                continue;
+            const target = path.join(opts.exportsDir, entry.name);
+            if (await isExpired(target, exportsRetentionMs, nowMs)) {
+                await removeEntry(target, `exports/${entry.name}`, result);
+            }
+        }
+    }
+    catch {
+        // exportsDir 不存在/不可读 → 跳过
+        result.errors += 1;
+    }
+    // 3) market/cache：过期 index.json 与 items/<itemId> 条目缓存；删空后回收 hash 目录
+    try {
+        const hashes = await fs.readdir(opts.marketCacheRoot);
+        for (const hash of hashes) {
+            const hashDir = path.join(opts.marketCacheRoot, hash);
+            let st;
+            try {
+                st = await fs.stat(hashDir);
+            }
+            catch {
+                continue; // 竞态删除/不可读 → 跳过该 hash
+            }
+            if (!st.isDirectory())
+                continue;
+            const indexFile = path.join(hashDir, 'index.json');
+            if (await isExpired(indexFile, marketRetentionMs, nowMs)) {
+                await removeEntry(indexFile, `market/cache/${hash}/index.json`, result);
+            }
+            const itemsDir = path.join(hashDir, 'items');
+            const itemDirs = await fs.readdir(itemsDir).catch(() => []);
+            for (const itemId of itemDirs) {
+                const itemDir = path.join(itemsDir, itemId);
+                if (await isExpired(itemDir, marketRetentionMs, nowMs)) {
+                    await removeEntry(itemDir, `market/cache/${hash}/items/${itemId}`, result);
+                }
+            }
+            // items 子目录删空后回收；hash 目录删空后回收
+            const itemsLeft = await fs.readdir(itemsDir).catch(() => []);
+            if (itemsLeft.length === 0) {
+                await removeEntry(itemsDir, `market/cache/${hash}/items`, result);
+            }
+            const remaining = await fs.readdir(hashDir).catch(() => []);
+            if (remaining.length === 0) {
+                await removeEntry(hashDir, `market/cache/${hash}`, result);
+            }
+        }
+    }
+    catch {
+        // marketCacheRoot 不存在/不可读 → 跳过
+        result.errors += 1;
+    }
+    // 3) market/work：过期 git 只读工作副本（readIndex 时会按需重新 clone）
+    try {
+        const hashes = await fs.readdir(opts.marketWorkRoot);
+        for (const hash of hashes) {
+            const workDir = path.join(opts.marketWorkRoot, hash);
+            const st = await fs.stat(workDir).catch(() => null);
+            if (st === null || !st.isDirectory())
+                continue;
+            if (await isExpired(workDir, marketRetentionMs, nowMs)) {
+                await removeEntry(workDir, `market/work/${hash}`, result);
+            }
+        }
+    }
+    catch {
+        // marketWorkRoot 不存在/不可读 → 跳过
+        result.errors += 1;
+    }
+    return result;
+}
+//# sourceMappingURL=cache-cleaner.js.map

package/lib/core/cache-cleaner.js.map

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

package/lib/index.js

@@ -44,6 +44,7 @@ import { credentialRef } from '@deepseek-ai/dsh-credentials';
 import { dshHomePath, resolveDshHome } from '@deepseek-ai/dsh-home-paths';
 import * as yaml from 'js-yaml';
 import { Exporter, FileSnapshotStore, Importer } from "./core/index.js";
+import { cleanupCaches } from "./core/cache-cleaner.js";
 import { listSnapshots, planRestore } from "./core/restore.js";
 import { rollback as performRollback } from "./core/rollback.js";
 import { RunRegistry } from "./core/run-registry.js";
@@ -72,7 +73,7 @@ import { prepareMarketItem } from "./market/prepare.js";
 import { validateMarketRepoUrl } from "./market/url.js";
 import { marketItemWarnings, toMarketListItem } from "./market/view.js";
 import { GitHubAuthRest, GitHubApiError } from "./market/github-repos.js";
-import { MyRepoService, USER_CONFIGS_REPO, userConfigsRepoUrl } from "./market/my-repo.js";
+import { MyRepoError, MyRepoService, USER_CONFIGS_REPO, userConfigsRepoUrl } from "./market/my-repo.js";
 import { createGitFileWriter } from "./market/git-file-writer.js";
 import { redact } from "./security/redaction.js";
 import { sha256Hex } from "./utils/hashing.js";
@@ -87,9 +88,11 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-const PLUGIN_VERSION = '0.1.39';
+const PLUGIN_VERSION = '0.1.41';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
+/** 缓存自动清理周期：24 小时（启动即清一次 + 此后每日一次；与 cache-cleaner 保留期独立） */
+const CACHE_CLEANUP_INTERVAL_MS = 24 * 60 * 60 * 1000;
 /**
  * 内置 GitHub OAuth App 的 client_id（「使用 GitHub 登录」device flow 缺省值）。
  * Client ID 是公开标识（GitHub 官方明确非机密）：内置后所有安装者开箱即用，
@@ -120,6 +123,8 @@ const API = {
     syncGithubStart: '/api/dsh-config-manager/sync/github/start',
     syncGithubPoll: '/api/dsh-config-manager/sync/github/poll',
     syncGithubCancel: '/api/dsh-config-manager/sync/github/cancel',
+    // m-sync-github-valid：校验已存 token 是否有效（决定「已登录」→ 隐藏登录区块）
+    syncGithubValidate: '/api/dsh-config-manager/sync/github/validate',
     // P2：同步历史 / 自动应用 / 一键回滚
     syncHistory: '/api/dsh-config-manager/sync/history',
     syncRollback: '/api/dsh-config-manager/sync/rollback',
@@ -147,6 +152,9 @@ const API = {
     meUpload: '/api/dsh-config-manager/me/upload',
     meItems: '/api/dsh-config-manager/me/items',
     meUpdate: '/api/dsh-config-manager/me/update',
+    meListing: '/api/dsh-config-manager/me/listing',
+    meRelist: '/api/dsh-config-manager/me/relist',
+    meDelete: '/api/dsh-config-manager/me/delete',
 };
 /**
  * 同步 token 的 DSH credentials 引用名（POSIX env-var 形态，满足 CredentialRef 品牌要求）。
@@ -1095,6 +1103,10 @@ function parseMeForm(raw) {
     if (name === '')
         return null;
     const form = { name };
+    // update 模式的可选显式 id（「更新」按钮预填；upload 时省略）
+    const idRaw = obj['id'];
+    if (typeof idRaw === 'string' && idRaw.trim() !== '')
+        form.id = idRaw.trim();
     const description = obj['description'];
     if (typeof description === 'string' && description.trim() !== '')
         form.description = description.trim();
@@ -1268,6 +1280,12 @@ function makeRoutes(deps) {
     const marketCacheIndex = (url) => join(marketCacheRoot, urlHash(url), 'index.json');
     const marketCacheItemDir = (url) => join(marketCacheRoot, urlHash(url), 'items');
     const marketWorkDir = (url) => join(marketWorkRoot, urlHash(url));
+    /**
+     * 进程生命周期标记：本次 dsh 启动后市场是否已成功刷新过一次（内存态，dsh 重启后自动归零）。
+     * 供「首次打开市场页自动更新一次市场」：MarketPanel 挂载时读 status 返回的
+     * bootAutoRefreshed 判断是否要自动拉取；refresh（含手动「拉取最新」）成功后置位。
+     */
+    let marketBootAutoRefreshed = false;
     /** 请求级装配只读 GitMarketReader（公开市场无凭据；url = BUILTIN_MARKET_URL，已由 validateRepoUrl 拒绝 userinfo）。 */
     const makeMarketReader = () => new GitMarketReader({ msg, timeoutMs: 60_000 });
     /** 读缓存的 index.json（结构校验通过才返回，否则 null）。 */
@@ -2130,6 +2148,47 @@ function makeRoutes(deps) {
                 writeJson(res, 200, { ok: true });
             },
         },
+        // -------------------------------------------------- sync/github/validate
+        // m-sync-github-valid：校验 SYNC_CREDENTIAL_REF 中已存 token 是否有效（GET /user），
+        // 供 UI 判定「是否已登录」→ 已登录隐藏 GitHub 登录区块、token 失效则重新展示。
+        // 只回布尔 + 登录名（非敏感），token 值绝不回传；仅 401（无效/过期）→ valid:false，
+        // 其余错误（网络/限流）向上抛，由 UI 兜底（不误判登出）。
+        {
+            kind: 'exact',
+            path: API.syncGithubValidate,
+            handler: async (req, res) => {
+                if (!guard(req, res, 'POST'))
+                    return;
+                try {
+                    let configured = false;
+                    let valid = false;
+                    let login;
+                    const resolved = await meTokenProvider();
+                    configured = resolved !== '';
+                    if (configured) {
+                        try {
+                            const user = await meGitHubRest.getUser();
+                            valid = true;
+                            login = user.login;
+                        }
+                        catch (error) {
+                            // 仅 401（token 无效/过期）→ 视为未登录；其余错误（网络/限流）向上抛
+                            if (!(error instanceof GitHubApiError && error.code === 'unauthorized'))
+                                throw error;
+                        }
+                    }
+                    writeJson(res, 200, {
+                        ok: true,
+                        configured,
+                        valid,
+                        ...(login !== undefined ? { login } : {}),
+                    });
+                }
+                catch (error) {
+                    writeJson(res, 500, { error: redact(error instanceof Error ? error.message : String(error)) });
+                }
+            },
+        },
         // ------------------------------------------------------ sync/history
         // P2：列出本地祖先快照目录的 manifest.json（id/createdAt/sectionHashes），
         // 同时统计 review-queue 中关联到该 snapshotId 的项数。
@@ -2544,7 +2603,13 @@ function makeRoutes(deps) {
                     return;
                 try {
                     const summary = await buildMarketSummary({ url: BUILTIN_MARKET_URL, addedAt: '' });
-                    writeJson(res, 200, { ok: true, configured: true, markets: [summary] });
+                    writeJson(res, 200, {
+                        ok: true,
+                        configured: true,
+                        markets: [summary],
+                        // 首次打开市场页自动更新一次的判据：本次 dsh 启动后是否已刷新过（进程内存，重启重置）
+                        bootAutoRefreshed: marketBootAutoRefreshed,
+                    });
                 }
                 catch (error) {
                     writeJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
@@ -2574,6 +2639,8 @@ function makeRoutes(deps) {
                     // 写缓存 index（供离线重复浏览）。内容始终视为不可信，读取时再结构校验。
                     await fs.mkdir(dirname(marketCacheIndex(url)), { recursive: true });
                     await fs.writeFile(marketCacheIndex(url), text, 'utf8');
+                    // 刷新成功 → 置位「本次启动已刷新」标记（手动「拉取最新」同样生效；失败不置位，下次打开可重试）
+                    marketBootAutoRefreshed = true;
                     const summary = await buildMarketSummary({ url, addedAt: new Date().toISOString() });
                     writeJson(res, 200, { ok: true, items: parsed.index.items, market: { ...summary, lastFetchedAt: fetchedAt } });
                 }
@@ -2887,6 +2954,85 @@ function makeRoutes(deps) {
                 }
             },
         },
+        // ---------------------------------------------------- me/listing
+        // 查询收录/下架任务状态（结果卡轮询）：任务表命中 → 直接返回；未命中 → 回退 GitHub 实况推导；
+        // 无任务且无实况 → 200 null。401（token 过期）→ 401，UI 引导重新登录。
+        {
+            kind: 'exact',
+            path: API.meListing,
+            handler: async (req, res) => {
+                if (!guard(req, res, 'POST'))
+                    return;
+                const body = await readJsonBody(req);
+                const itemId = typeof body?.['itemId'] === 'string' ? body['itemId'] : '';
+                if (itemId === '') {
+                    writeJson(res, 400, { error: 'itemId is required' });
+                    return;
+                }
+                try {
+                    const status = await meService.listingStatus(itemId);
+                    writeJson(res, 200, status); // null → 200 null
+                }
+                catch (error) {
+                    const status = error instanceof GitHubApiError && error.code === 'unauthorized' ? 401 : 500;
+                    writeJson(res, status, { error: redact(error instanceof Error ? error.message : String(error)) });
+                }
+            },
+        },
+        // ---------------------------------------------------- me/relist
+        // 重新提交收录（收录失败 / 进程重启丢失后的一键重试）：幂等复用已存在 fork/open PR。
+        {
+            kind: 'exact',
+            path: API.meRelist,
+            handler: async (req, res) => {
+                if (!guard(req, res, 'POST'))
+                    return;
+                const body = await readJsonBody(req);
+                const itemId = typeof body?.['itemId'] === 'string' ? body['itemId'] : '';
+                if (itemId === '') {
+                    writeJson(res, 400, { error: 'itemId is required' });
+                    return;
+                }
+                try {
+                    const status = await meService.relist(itemId);
+                    writeJson(res, 200, status);
+                }
+                catch (error) {
+                    const code = error instanceof GitHubApiError && error.code === 'unauthorized' ? 401 : 500;
+                    const message = error instanceof MyRepoError && error.code === 'item_not_found'
+                        ? 404
+                        : code;
+                    writeJson(res, message, { error: redact(error instanceof Error ? error.message : String(error)) });
+                }
+            },
+        },
+        // ---------------------------------------------------- me/delete
+        // 删除条目：同步删用户仓库索引 + items/<id>/ 文件；已收录 → 后台异步提下架 PR；待审核 → 关闭收录 PR。
+        {
+            kind: 'exact',
+            path: API.meDelete,
+            handler: async (req, res) => {
+                if (!guard(req, res, 'POST'))
+                    return;
+                const body = await readJsonBody(req);
+                const itemId = typeof body?.['itemId'] === 'string' ? body['itemId'] : '';
+                if (itemId === '') {
+                    writeJson(res, 400, { error: 'itemId is required' });
+                    return;
+                }
+                try {
+                    const result = await meService.deleteItem(itemId);
+                    writeJson(res, 200, result);
+                }
+                catch (error) {
+                    const code = error instanceof GitHubApiError && error.code === 'unauthorized' ? 401 : 500;
+                    const message = error instanceof MyRepoError && error.code === 'item_not_found'
+                        ? 404
+                        : code;
+                    writeJson(res, message, { error: redact(error instanceof Error ? error.message : String(error)) });
+                }
+            },
+        },
     ];
     return { routes: routesList, scheduler };
 }
@@ -2915,6 +3061,29 @@ export function apply(ctx, config) {
     mkdirSync(syncDir, { recursive: true });
     mkdirSync(marketDir, { recursive: true });
     const host = new ConfigManagerHostContext(ctx, homeDir, resolveProfileName(config));
+    // 缓存自动清理：启动即清一次 + 每 24h 定时清一次。
+    // 只清「可重建/一次性」缓存与临时文件（tmp 暂存、exports 导出副本、market cache/work），
+    // 保留期内的文件不删（供刷新恢复导入/下载等窗口继续消费）；snapshots 与 sync 属用户数据/安全网不动。
+    // 尽力而为：任何失败仅记日志，不影响插件挂载与其他功能。
+    const runCacheCleanup = () => {
+        void cleanupCaches({
+            tmpDir,
+            exportsDir,
+            marketCacheRoot: join(marketDir, 'cache'),
+            marketWorkRoot: join(marketDir, 'work'),
+        })
+            .then((report) => {
+            if (report.removed > 0) {
+                host.log.info('缓存自动清理完成', { removed: report.removed, freedBytes: report.freedBytes });
+            }
+        })
+            .catch((error) => {
+            host.log.warn('缓存自动清理失败', { error: error instanceof Error ? error.message : String(error) });
+        });
+    };
+    runCacheCleanup();
+    const cacheCleanupTimer = setInterval(runCacheCleanup, CACHE_CLEANUP_INTERVAL_MS);
+    ctx.effect(() => () => clearInterval(cacheCleanupTimer), 'config-manager: cache cleanup scheduler');
     // self 分区目录（相对 ~/.dsh 根）：dataDir 在 homeDir 下 → 用相对路径挂载 self adapter；
     // 自定义 dataDir 位于 ~/.dsh 之外时 Host fs 门面无法覆盖（confined to home root），
     // 不挂 self 分区并告警（其余分区不受影响）。