tanmi-dock 0.4.0-beta.1

package/dist/index.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createInitCommand } from './commands/init.js';
+import { createLinkCommand } from './commands/link.js';
+import { createStatusCommand } from './commands/status.js';
+import { createProjectsCommand } from './commands/projects.js';
+import { createCleanCommand } from './commands/clean.js';
+import { createUnlinkCommand } from './commands/unlink.js';
+import { createConfigCommand } from './commands/config.js';
+import { createMigrateCommand } from './commands/migrate.js';
+import { createDoctorCommand } from './commands/doctor.js';
+import { createVerifyCommand } from './commands/verify.js';
+import { createRepairCommand } from './commands/repair.js';
+import { Transaction } from './core/transaction.js';
+// 信号处理：优雅退出
+let isShuttingDown = false;
+async function gracefulShutdown(signal, exitCode) {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    console.log(`\n[info] 收到 ${signal} 信号，正在清理...`);
+    try {
+        const pending = await Transaction.findPending();
+        if (pending) {
+            console.log('[info] 正在回滚未完成事务...');
+            const errors = await pending.rollback();
+            if (errors.length > 0) {
+                console.error('[warn] 部分回滚失败:');
+                errors.forEach((e) => console.error(`  - ${e}`));
+            }
+            else {
+                console.log('[ok] 事务已回滚');
+            }
+        }
+    }
+    catch (err) {
+        console.error('[err] 清理失败:', err.message);
+    }
+    process.exit(exitCode);
+}
+process.on('SIGINT', () => gracefulShutdown('SIGINT', 130));
+process.on('SIGTERM', () => gracefulShutdown('SIGTERM', 143));
+// 全局异常捕获
+process.on('uncaughtException', (err) => {
+    console.error('[err] 发生未预期错误:', err.message);
+    if (process.env.DEBUG) {
+        console.error(err.stack);
+    }
+    console.error('[hint] 如问题持续，请运行 tanmi-dock doctor 诊断');
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason) => {
+    console.error('[err] 未处理的 Promise 拒绝:', reason);
+    if (process.env.DEBUG) {
+        console.error(reason);
+    }
+    process.exit(1);
+});
+const program = new Command();
+program
+    .name('tanmi-dock')
+    .description('集中型第三方库链接管理工具')
+    .version('0.1.0')
+    .option('-v, --verbose', '输出详细信息')
+    .hook('preAction', (thisCommand) => {
+    const opts = thisCommand.optsWithGlobals();
+    if (opts.verbose) {
+        process.env.VERBOSE = '1';
+    }
+});
+// 注册命令
+program.addCommand(createInitCommand());
+program.addCommand(createLinkCommand());
+program.addCommand(createStatusCommand());
+program.addCommand(createProjectsCommand());
+program.addCommand(createCleanCommand());
+program.addCommand(createUnlinkCommand());
+program.addCommand(createConfigCommand());
+program.addCommand(createMigrateCommand());
+program.addCommand(createDoctorCommand());
+program.addCommand(createVerifyCommand());
+program.addCommand(createRepairCommand());
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,174 @@
+/**
+ * TanmiDock 核心类型定义
+ */
+/** 当前配置版本 */
+export declare const CURRENT_CONFIG_VERSION = "1.1.0";
+/** 最低支持版本 */
+export declare const MIN_SUPPORTED_VERSION = "1.0.0";
+/**
+ * 全局配置
+ */
+export interface DockConfig {
+    version: string;
+    initialized: boolean;
+    storePath: string;
+    cleanStrategy: CleanStrategy;
+    unusedDays: number;
+    maxStoreSize?: number;
+    autoDownload: boolean;
+}
+export type CleanStrategy = 'unreferenced' | 'unused' | 'manual';
+/**
+ * 默认配置
+ */
+export declare const DEFAULT_CONFIG: Omit<DockConfig, 'storePath'>;
+/**
+ * 注册表
+ */
+export interface Registry {
+    version: string;
+    projects: Record<string, ProjectInfo>;
+    libraries: Record<string, LibraryInfo>;
+    stores: Record<string, StoreEntry>;
+}
+/**
+ * 项目信息
+ */
+export interface ProjectInfo {
+    path: string;
+    configPath: string;
+    lastLinked: string;
+    platforms: string[];
+    dependencies: DependencyRef[];
+}
+/**
+ * 依赖引用
+ */
+export interface DependencyRef {
+    libName: string;
+    commit: string;
+    platform: string;
+    linkedPath: string;
+}
+/**
+ * 库信息 (旧版，保留兼容)
+ * @deprecated 使用 StoreEntry 替代
+ */
+export interface LibraryInfo {
+    libName: string;
+    commit: string;
+    branch: string;
+    url: string;
+    platforms: string[];
+    size: number;
+    referencedBy: string[];
+    createdAt: string;
+    lastAccess: string;
+}
+/**
+ * Store 条目 (新版，按平台存储)
+ * key 格式: lib:commit:platform
+ */
+export interface StoreEntry {
+    libName: string;
+    commit: string;
+    platform: string;
+    branch: string;
+    url: string;
+    size: number;
+    usedBy: string[];
+    unlinkedAt?: number;
+    createdAt: string;
+    lastAccess: string;
+}
+/**
+ * 空注册表
+ */
+export declare const EMPTY_REGISTRY: Registry;
+/**
+ * codepac-dep.json 配置
+ */
+export interface CodepacDep {
+    version: string;
+    vars?: Record<string, string>;
+    repos: {
+        common: RepoConfig[];
+    };
+    actions?: {
+        common: ActionConfig[];
+    };
+}
+/**
+ * 仓库配置
+ */
+export interface RepoConfig {
+    url: string;
+    commit: string;
+    branch: string;
+    dir: string;
+    sparse?: object | string;
+}
+/**
+ * 动作配置
+ */
+export interface ActionConfig {
+    command: string;
+    dir: string;
+}
+/**
+ * 解析后的依赖
+ */
+export interface ParsedDependency {
+    libName: string;
+    commit: string;
+    branch: string;
+    url: string;
+    sparse?: object | string;
+}
+/**
+ * 依赖分类状态
+ */
+export declare enum DependencyStatus {
+    /** Store 有，项目链接正确 */
+    LINKED = "LINKED",
+    /** Store 有，项目链接错误 */
+    RELINK = "RELINK",
+    /** Store 有，项目是目录 */
+    REPLACE = "REPLACE",
+    /** Store 没有，项目有目录 */
+    ABSORB = "ABSORB",
+    /** Store 没有，项目也没有 */
+    MISSING = "MISSING",
+    /** Store 有，项目没有 */
+    LINK_NEW = "LINK_NEW"
+}
+/**
+ * 分类后的依赖
+ */
+export interface ClassifiedDependency {
+    dependency: ParsedDependency;
+    status: DependencyStatus;
+    localPath: string;
+    storePath: string;
+}
+export type Platform = 'mac' | 'win';
+/**
+ * 磁盘信息
+ */
+export interface DiskInfo {
+    path: string;
+    label?: string;
+    total: number;
+    free: number;
+    isSystem: boolean;
+}
+/**
+ * 初始化状态
+ */
+export interface InitStatus {
+    initialized: boolean;
+    configExists: boolean;
+    storePathExists: boolean;
+    storePath?: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,47 @@
+/**
+ * TanmiDock 核心类型定义
+ */
+// ============ 版本常量 ============
+/** 当前配置版本 */
+export const CURRENT_CONFIG_VERSION = '1.1.0';
+/** 最低支持版本 */
+export const MIN_SUPPORTED_VERSION = '1.0.0';
+/**
+ * 默认配置
+ */
+export const DEFAULT_CONFIG = {
+    version: '1.0.0',
+    initialized: false,
+    cleanStrategy: 'unreferenced',
+    unusedDays: 30,
+    autoDownload: true,
+};
+/**
+ * 空注册表
+ */
+export const EMPTY_REGISTRY = {
+    version: '1.0.0',
+    projects: {},
+    libraries: {},
+    stores: {},
+};
+// ============ 依赖状态 ============
+/**
+ * 依赖分类状态
+ */
+export var DependencyStatus;
+(function (DependencyStatus) {
+    /** Store 有，项目链接正确 */
+    DependencyStatus["LINKED"] = "LINKED";
+    /** Store 有，项目链接错误 */
+    DependencyStatus["RELINK"] = "RELINK";
+    /** Store 有，项目是目录 */
+    DependencyStatus["REPLACE"] = "REPLACE";
+    /** Store 没有，项目有目录 */
+    DependencyStatus["ABSORB"] = "ABSORB";
+    /** Store 没有，项目也没有 */
+    DependencyStatus["MISSING"] = "MISSING";
+    /** Store 有，项目没有 */
+    DependencyStatus["LINK_NEW"] = "LINK_NEW";
+})(DependencyStatus || (DependencyStatus = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iCAAiC;AAEjC,aAAa;AACb,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,aAAa;AACb,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAmB7C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkC;IAC3D,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,cAAc;IAC7B,UAAU,EAAE,EAAE;IACd,YAAY,EAAE,IAAI;CACnB,CAAC;AAoEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;CACX,CAAC;AAgDF,iCAAiC;AAEjC;;GAEG;AACH,MAAM,CAAN,IAAY,gBAaX;AAbD,WAAY,gBAAgB;IAC1B,qBAAqB;IACrB,qCAAiB,CAAA;IACjB,qBAAqB;IACrB,qCAAiB,CAAA;IACjB,oBAAoB;IACpB,uCAAmB,CAAA;IACnB,qBAAqB;IACrB,qCAAiB,CAAA;IACjB,qBAAqB;IACrB,uCAAmB,CAAA;IACnB,mBAAmB;IACnB,yCAAqB,CAAA;AACvB,CAAC,EAbW,gBAAgB,KAAhB,gBAAgB,QAa3B"}

package/dist/utils/disk.d.ts

@@ -0,0 +1,57 @@
+import type { DiskInfo } from '../types/index.js';
+/**
+ * 获取所有磁盘信息
+ */
+export declare function getDiskInfo(): Promise<DiskInfo[]>;
+/**
+ * 格式化文件大小
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * 解析大小字符串为字节数
+ */
+export declare function parseSize(sizeStr: string): number;
+/**
+ * 检查路径所在磁盘是否有足够空间
+ */
+export declare function hasEnoughSpace(targetPath: string, requiredBytes: number): Promise<boolean>;
+/**
+ * 获取路径所在磁盘的可用空间
+ */
+export declare function getFreeSpace(targetPath: string): Promise<number>;
+/**
+ * 磁盘空间检查结果
+ */
+export interface DiskSpaceCheckResult {
+    sufficient: boolean;
+    available: number;
+    required: number;
+    safetyMargin: number;
+}
+/**
+ * 检查磁盘空间是否充足
+ * @param targetPath 目标路径
+ * @param requiredBytes 需要的字节数
+ * @param safetyMarginGB 安全余量（GB），默认 1GB
+ */
+export declare function checkDiskSpace(targetPath: string, requiredBytes: number, safetyMarginGB?: number): Promise<DiskSpaceCheckResult>;
+/**
+ * 获取默认 Store 路径建议
+ */
+export declare function getDefaultStorePaths(): Promise<Array<{
+    path: string;
+    label: string;
+    free: number;
+    recommended: boolean;
+}>>;
+declare const _default: {
+    getDiskInfo: typeof getDiskInfo;
+    formatSize: typeof formatSize;
+    parseSize: typeof parseSize;
+    hasEnoughSpace: typeof hasEnoughSpace;
+    getFreeSpace: typeof getFreeSpace;
+    checkDiskSpace: typeof checkDiskSpace;
+    getDefaultStorePaths: typeof getDefaultStorePaths;
+};
+export default _default;
+//# sourceMappingURL=disk.d.ts.map

package/dist/utils/disk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk.d.ts","sourceRoot":"","sources":["../../src/utils/disk.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAIlD;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAKvD;AAmMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,cAAc,SAAI,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAsB/B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CACnD,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAC3E,CAuCA;;;;;;;;;;AAED,wBAQE"}

package/dist/utils/disk.js

@@ -0,0 +1,313 @@
+/**
+ * 磁盘空间检测工具
+ * - macOS: 读取 / 和 /Volumes/*
+ * - Windows: 读取 C:\, D:\ 等盘符
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { isWindows } from '../core/platform.js';
+const execAsync = promisify(exec);
+/**
+ * 获取所有磁盘信息
+ */
+export async function getDiskInfo() {
+    if (isWindows()) {
+        return getWindowsDisks();
+    }
+    return getMacDisks();
+}
+/**
+ * macOS: 获取磁盘信息
+ */
+async function getMacDisks() {
+    const disks = [];
+    // 获取根分区
+    try {
+        const rootInfo = await getDiskUsage('/');
+        if (rootInfo) {
+            disks.push({
+                path: '/',
+                label: '系统盘',
+                total: rootInfo.total,
+                free: rootInfo.free,
+                isSystem: true,
+            });
+        }
+    }
+    catch {
+        // 忽略错误
+    }
+    // 获取 /Volumes 下的其他卷
+    try {
+        const volumes = await fs.readdir('/Volumes');
+        for (const volume of volumes) {
+            const volumePath = path.join('/Volumes', volume);
+            // 跳过系统盘链接
+            try {
+                const stat = await fs.lstat(volumePath);
+                if (stat.isSymbolicLink())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            try {
+                const info = await getDiskUsage(volumePath);
+                if (info) {
+                    disks.push({
+                        path: volumePath,
+                        label: volume,
+                        total: info.total,
+                        free: info.free,
+                        isSystem: false,
+                    });
+                }
+            }
+            catch {
+                // 忽略无法访问的卷
+            }
+        }
+    }
+    catch {
+        // /Volumes 不存在或无法访问
+    }
+    return disks;
+}
+/**
+ * Windows: 获取磁盘信息
+ */
+async function getWindowsDisks() {
+    const disks = [];
+    try {
+        // 使用 wmic 获取磁盘信息
+        const { stdout } = await execAsync('wmic logicaldisk get caption,freespace,size,volumename /format:csv', { encoding: 'utf8' });
+        const lines = stdout.trim().split('\n').slice(1); // 跳过表头
+        for (const line of lines) {
+            const parts = line.trim().split(',');
+            if (parts.length < 5)
+                continue;
+            const [, caption, freeSpace, size, volumeName] = parts;
+            if (!caption || !size)
+                continue;
+            const drivePath = caption + '\\';
+            const total = parseInt(size, 10);
+            const free = parseInt(freeSpace, 10) || 0;
+            // C: 通常是系统盘
+            const isSystem = caption.toUpperCase() === 'C:';
+            disks.push({
+                path: drivePath,
+                label: volumeName || (isSystem ? '系统盘' : '本地磁盘'),
+                total: isNaN(total) ? 0 : total,
+                free: isNaN(free) ? 0 : free,
+                isSystem,
+            });
+        }
+    }
+    catch {
+        // wmic 命令失败，尝试备用方法
+        try {
+            const drives = ['C:', 'D:', 'E:', 'F:', 'G:', 'H:'];
+            for (const drive of drives) {
+                try {
+                    const info = await getDiskUsage(drive + '\\');
+                    if (info) {
+                        disks.push({
+                            path: drive + '\\',
+                            label: drive === 'C:' ? '系统盘' : '本地磁盘',
+                            total: info.total,
+                            free: info.free,
+                            isSystem: drive === 'C:',
+                        });
+                    }
+                }
+                catch {
+                    // 磁盘不存在
+                }
+            }
+        }
+        catch {
+            // 忽略错误
+        }
+    }
+    return disks;
+}
+/**
+ * 获取指定路径的磁盘使用情况
+ */
+async function getDiskUsage(targetPath) {
+    if (isWindows()) {
+        return getWindowsDiskUsage(targetPath);
+    }
+    return getMacDiskUsage(targetPath);
+}
+/**
+ * macOS: 使用 df 命令获取磁盘使用情况
+ */
+async function getMacDiskUsage(targetPath) {
+    try {
+        const { stdout } = await execAsync(`df -k "${targetPath}"`, { encoding: 'utf8' });
+        const lines = stdout.trim().split('\n');
+        if (lines.length < 2)
+            return null;
+        // 解析 df 输出: Filesystem 1K-blocks Used Available Use% Mounted
+        const parts = lines[1].split(/\s+/);
+        if (parts.length < 4)
+            return null;
+        const totalBlocks = parseInt(parts[1], 10);
+        const availableBlocks = parseInt(parts[3], 10);
+        return {
+            total: totalBlocks * 1024,
+            free: availableBlocks * 1024,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Windows: 获取磁盘使用情况
+ */
+async function getWindowsDiskUsage(targetPath) {
+    try {
+        // 提取盘符
+        const drive = targetPath.match(/^([A-Za-z]:)/)?.[1];
+        if (!drive)
+            return null;
+        const { stdout } = await execAsync(`wmic logicaldisk where "caption='${drive}'" get freespace,size /format:csv`, { encoding: 'utf8' });
+        const lines = stdout.trim().split('\n').slice(1);
+        if (lines.length === 0)
+            return null;
+        const parts = lines[0].trim().split(',');
+        if (parts.length < 3)
+            return null;
+        const [, freeSpace, size] = parts;
+        return {
+            total: parseInt(size, 10) || 0,
+            free: parseInt(freeSpace, 10) || 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 格式化文件大小
+ */
+export function formatSize(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const k = 1024;
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const size = bytes / Math.pow(k, i);
+    return `${size.toFixed(1)} ${units[i]}`;
+}
+/**
+ * 解析大小字符串为字节数
+ */
+export function parseSize(sizeStr) {
+    const match = sizeStr.match(/^([\d.]+)\s*(B|KB|MB|GB|TB)?$/i);
+    if (!match)
+        return 0;
+    const value = parseFloat(match[1]);
+    const unit = (match[2] || 'B').toUpperCase();
+    const units = {
+        B: 1,
+        KB: 1024,
+        MB: 1024 * 1024,
+        GB: 1024 * 1024 * 1024,
+        TB: 1024 * 1024 * 1024 * 1024,
+    };
+    return Math.floor(value * (units[unit] || 1));
+}
+/**
+ * 检查路径所在磁盘是否有足够空间
+ */
+export async function hasEnoughSpace(targetPath, requiredBytes) {
+    const usage = await getDiskUsage(targetPath);
+    if (!usage)
+        return true; // 无法获取时假设足够
+    return usage.free >= requiredBytes;
+}
+/**
+ * 获取路径所在磁盘的可用空间
+ */
+export async function getFreeSpace(targetPath) {
+    const usage = await getDiskUsage(targetPath);
+    return usage?.free ?? 0;
+}
+/**
+ * 检查磁盘空间是否充足
+ * @param targetPath 目标路径
+ * @param requiredBytes 需要的字节数
+ * @param safetyMarginGB 安全余量（GB），默认 1GB
+ */
+export async function checkDiskSpace(targetPath, requiredBytes, safetyMarginGB = 1) {
+    const safetyMargin = safetyMarginGB * 1024 * 1024 * 1024;
+    const available = await getFreeSpace(targetPath);
+    // 如果无法获取磁盘信息（available 为 0），放行操作
+    if (available === 0) {
+        return {
+            sufficient: true,
+            available: 0,
+            required: requiredBytes,
+            safetyMargin,
+        };
+    }
+    const sufficient = available > requiredBytes + safetyMargin;
+    return {
+        sufficient,
+        available,
+        required: requiredBytes,
+        safetyMargin,
+    };
+}
+/**
+ * 获取默认 Store 路径建议
+ */
+export async function getDefaultStorePaths() {
+    const disks = await getDiskInfo();
+    const home = os.homedir();
+    const suggestions = [];
+    // 默认路径: ~/.tanmi-dock/store
+    const defaultPath = path.join(home, '.tanmi-dock', 'store');
+    const homeDisk = disks.find((d) => defaultPath.startsWith(d.path) || d.isSystem);
+    suggestions.push({
+        path: defaultPath,
+        label: '默认位置',
+        free: homeDisk?.free ?? 0,
+        recommended: false,
+    });
+    // 非系统盘的建议
+    const nonSystemDisks = disks.filter((d) => !d.isSystem && d.free > 10 * 1024 * 1024 * 1024); // 至少 10GB
+    for (const disk of nonSystemDisks) {
+        const storePath = path.join(disk.path, '.tanmi-dock', 'store');
+        suggestions.push({
+            path: storePath,
+            label: disk.label || disk.path,
+            free: disk.free,
+            recommended: true, // 非系统盘通常空间更大
+        });
+    }
+    // 按可用空间排序，推荐的排前面
+    suggestions.sort((a, b) => {
+        if (a.recommended !== b.recommended) {
+            return a.recommended ? -1 : 1;
+        }
+        return b.free - a.free;
+    });
+    return suggestions;
+}
+export default {
+    getDiskInfo,
+    formatSize,
+    parseSize,
+    hasEnoughSpace,
+    getFreeSpace,
+    checkDiskSpace,
+    getDefaultStorePaths,
+};
+//# sourceMappingURL=disk.js.map