tanmi-dock 0.4.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tanmi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,302 @@
+# TanmiDock
+
+集中型第三方库链接管理工具 - 通过符号链接统一管理多项目共享的第三方依赖库。
+
+## 特性
+
+- **集中存储**: 所有第三方库统一存储在一个 Store 目录，避免重复下载
+- **符号链接**: 通过 symlink 将 Store 中的库链接到项目目录，节省磁盘空间
+- **多平台支持**: 支持 macOS/iOS/Android/Windows/Linux/WASM/OHOS 等平台，可同时选择多个平台
+- **按平台下载**: 仅下载所需平台的内容，节省带宽和存储空间
+- **智能识别**: 自动识别已有库，支持吸收本地库到 Store
+- **事务安全**: link 操作支持事务回滚，中断后可恢复
+- **文件锁**: 防止并发操作导致数据损坏
+
+## 安装
+
+```bash
+# 克隆仓库
+git clone <repo-url>
+cd tanmi-dock
+
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 全局安装（可选）
+npm link
+```
+
+## 快速开始
+
+```bash
+# 1. 初始化（首次使用）
+tanmi-dock init
+
+# 2. 在项目目录执行链接
+cd your-project
+tanmi-dock link
+
+# 3. 查看状态
+tanmi-dock status
+```
+
+## 命令
+
+### `init` - 初始化
+
+首次使用前初始化 TanmiDock，设置 Store 存储路径。
+
+```bash
+tanmi-dock init [options]
+
+选项:
+  --store-path <path>  直接指定存储路径（跳过交互）
+  -y, --yes            使用默认设置
+```
+
+### `link` - 链接依赖
+
+解析项目的 `codepac-dep.json` 配置，将依赖库链接到项目。
+
+```bash
+tanmi-dock link [path] [options]
+
+参数:
+  path                       项目路径（默认当前目录）
+
+选项:
+  -p, --platform <platforms...>  指定平台，可多选 (mac/ios/android/win/linux/wasm/ohos)
+  -y, --yes                      跳过确认提示
+  --no-download                  不自动下载缺失库
+  --dry-run                      只显示将要执行的操作
+
+示例:
+  tanmi-dock link                    # 交互式选择平台
+  tanmi-dock link -p mac             # 仅 macOS
+  tanmi-dock link -p mac ios         # macOS + iOS
+  tanmi-dock link -p mac ios android # 多平台
+```
+
+依赖状态处理:
+- **LINKED**: 已正确链接，跳过
+- **RELINK**: 链接目标错误，重建链接
+- **REPLACE**: 本地是目录但 Store 已有，替换为链接
+- **ABSORB**: 本地有目录但 Store 没有，移入 Store 并创建链接
+- **MISSING**: 本地和 Store 都没有，需要下载
+- **LINK_NEW**: Store 有但本地没有，创建链接
+
+### `status` - 查看状态
+
+显示当前项目或 Store 的状态信息。
+
+```bash
+tanmi-dock status [options]
+
+选项:
+  -s, --store   显示 Store 状态
+  -a, --all     显示所有详细信息
+```
+
+### `projects` - 项目管理
+
+列出所有已注册的项目。
+
+```bash
+tanmi-dock projects [options]
+
+选项:
+  -a, --all     显示详细信息
+```
+
+### `clean` - 清理
+
+清理未被引用的库，释放磁盘空间。
+
+```bash
+tanmi-dock clean [options]
+
+选项:
+  -y, --yes     跳过确认提示
+  --dry-run     只显示将要清理的内容
+```
+
+### `unlink` - 解除链接
+
+解除项目依赖的符号链接，恢复为普通目录。
+
+```bash
+tanmi-dock unlink [path] [options]
+
+参数:
+  path          项目路径（默认当前目录）
+
+选项:
+  -y, --yes     跳过确认提示
+```
+
+### `config` - 配置管理
+
+查看或修改配置。
+
+```bash
+tanmi-dock config [key] [value]
+
+参数:
+  key           配置项名称
+  value         配置值（不提供则显示当前值）
+
+示例:
+  tanmi-dock config              # 显示所有配置
+  tanmi-dock config storePath    # 显示 storePath
+  tanmi-dock config autoDownload false  # 设置 autoDownload
+```
+
+### `migrate` - 迁移 Store
+
+将 Store 迁移到新位置。
+
+```bash
+tanmi-dock migrate <newPath> [options]
+
+参数:
+  newPath       新的 Store 路径
+
+选项:
+  --force       跳过确认提示
+  --keep-old    保留旧目录（默认删除）
+```
+
+### `doctor` - 环境诊断
+
+检测运行环境问题。
+
+```bash
+tanmi-dock doctor [options]
+
+选项:
+  --json        输出 JSON 格式
+```
+
+检测内容:
+- codepac 是否已安装
+- 配置文件是否存在
+- Store 目录是否可访问
+- 磁盘空间是否充足
+
+### `verify` - 完整性验证
+
+验证 Store 和 Registry 的完整性。
+
+```bash
+tanmi-dock verify
+```
+
+检测内容:
+- **悬挂链接**: 符号链接指向的目标不存在
+- **孤立库**: Store 中存在但 Registry 未记录的库
+- **缺失库**: Registry 记录但 Store 中不存在的库
+- **无效项目**: 已注册但路径不存在的项目
+
+### `repair` - 修复问题
+
+修复 verify 检测到的问题。
+
+```bash
+tanmi-dock repair [options]
+
+选项:
+  --dry-run     只显示将执行的操作
+  --prune       删除孤立库（默认登记到 Registry）
+  --force       跳过确认提示
+```
+
+修复操作:
+- 清理过期项目记录
+- 移除悬挂的符号链接
+- 登记或删除孤立库
+
+## 配置文件
+
+### codepac-dep.json
+
+项目依赖配置文件，定义需要链接的第三方库。
+
+```json
+{
+  "version": "1.0.0",
+  "vars": {
+    "LIBS_ROOT": "../3rdparty"
+  },
+  "repos": {
+    "common": [
+      {
+        "url": "https://github.com/user/repo.git",
+        "commit": "abc1234",
+        "branch": "main",
+        "dir": "${LIBS_ROOT}/repo"
+      }
+    ]
+  }
+}
+```
+
+### 全局配置
+
+配置文件位置:
+- macOS/Linux: `~/.tanmi-dock/config.json`
+- Windows: `%USERPROFILE%\.tanmi-dock\config.json`
+
+配置项:
+- `storePath`: Store 存储路径
+- `cleanStrategy`: 清理策略 (`unreferenced` | `lru` | `manual`)
+- `autoDownload`: 是否自动下载缺失库
+
+## 目录结构
+
+```
+Store/
+├── lib-name-1/
+│   └── abc1234/           # commit hash
+│       ├── macOS/         # macOS 平台内容
+│       ├── iOS/           # iOS 平台内容
+│       └── android/       # Android 平台内容
+└── lib-name-2/
+    └── def5678/
+        ├── macOS/
+        └── Win/
+```
+
+> **说明**: 每个库按 `库名/commit/平台` 的结构存储，支持同一库多平台共存。
+
+## 开发
+
+```bash
+# 开发模式运行
+npm run dev
+
+# 运行测试
+npm test
+
+# 测试覆盖率
+npm run test:coverage
+
+# 代码检查
+npm run lint
+
+# 代码格式化
+npm run format
+```
+
+## 技术栈
+
+- TypeScript
+- Commander.js (CLI 框架)
+- Vitest (测试框架)
+- ESLint + Prettier (代码质量)
+
+## 许可
+
+MIT

package/dist/commands/clean.d.ts

@@ -0,0 +1,10 @@
+/**
+ * clean 命令 - 清理无引用库
+ */
+import { Command } from 'commander';
+/**
+ * 创建 clean 命令
+ */
+export declare function createCleanCommand(): Command;
+export default createCleanCommand;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAc5C;AAuND,eAAe,kBAAkB,CAAC"}

package/dist/commands/clean.js

@@ -0,0 +1,215 @@
+/**
+ * clean 命令 - 清理无引用库
+ */
+import { Command } from 'commander';
+import { ensureInitialized } from '../core/guard.js';
+import { getRegistry } from '../core/registry.js';
+import * as store from '../core/store.js';
+import * as config from '../core/config.js';
+import { formatSize } from '../utils/disk.js';
+import { info, warn, success, hint, blank, separator, title, error } from '../utils/logger.js';
+import { withGlobalLock } from '../utils/global-lock.js';
+import { confirmAction, checkboxSelect } from '../utils/prompt.js';
+/**
+ * 创建 clean 命令
+ */
+export function createCleanCommand() {
+    return new Command('clean')
+        .description('清理无引用的库')
+        .option('--dry-run', '只显示将要清理的内容')
+        .option('--force', '跳过确认')
+        .action(async (options) => {
+        await ensureInitialized();
+        try {
+            await withGlobalLock(() => cleanLibraries(options));
+        }
+        catch (err) {
+            error(err.message);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * 清理库
+ */
+async function cleanLibraries(options) {
+    const registry = getRegistry();
+    await registry.load();
+    // 获取清理策略配置
+    const cleanStrategy = await config.get('cleanStrategy');
+    const unusedDays = (await config.get('unusedDays')) ?? 30;
+    // 先清理无效项目
+    info('扫描 Store...');
+    const staleHashes = await registry.cleanStaleProjects();
+    if (staleHashes.length > 0) {
+        info(`清理了 ${staleHashes.length} 个无效项目记录`);
+    }
+    // 清理失效的 Store 引用
+    const staleRefs = await registry.cleanStaleReferences();
+    if (staleRefs > 0) {
+        info(`清理了 ${staleRefs} 个失效引用`);
+    }
+    // 根据策略获取待清理列表
+    let toCleanLibs = [];
+    let toCleanStores = [];
+    let strategyName;
+    if (cleanStrategy === 'unused') {
+        // unused 策略：基于 StoreEntry 和 unlinkedAt
+        toCleanStores = registry.getUnusedStores(unusedDays);
+        strategyName = `unused (超过 ${unusedDays} 天)`;
+        // 显示待清理的库
+        const pending = registry.getPendingUnusedStores(unusedDays);
+        if (pending.length > 0) {
+            blank();
+            info(`无引用但尚未达到清理条件的库 (${pending.length} 个):`);
+            for (const { entry, daysLeft } of pending) {
+                hint(`  - ${entry.libName}/${entry.commit.slice(0, 7)}/${entry.platform} - 还剩 ${daysLeft} 天`);
+            }
+        }
+    }
+    else if (cleanStrategy === 'manual') {
+        // manual 策略：交互式选择要清理的库
+        const allStores = registry.listStores();
+        if (allStores.length === 0) {
+            success('Store 为空');
+            return;
+        }
+        // 构建选项列表
+        const choices = allStores.map((entry) => {
+            const key = registry.getStoreKey(entry.libName, entry.commit, entry.platform);
+            const status = entry.usedBy.length === 0
+                ? '(无引用)'
+                : `(被 ${entry.usedBy.length} 个项目使用)`;
+            const size = formatSize(entry.size);
+            return {
+                name: `${entry.libName}/${entry.commit.slice(0, 7)}/${entry.platform} ${size} ${status}`,
+                value: key,
+                checked: entry.usedBy.length === 0, // 无引用的默认勾选
+            };
+        });
+        blank();
+        const selected = await checkboxSelect('选择要清理的库:', choices);
+        if (selected.length === 0) {
+            info('未选择任何库');
+            return;
+        }
+        // 警告有引用的库
+        const withRefs = selected.filter((key) => {
+            const entry = registry.getStore(key);
+            return entry && entry.usedBy.length > 0;
+        });
+        if (withRefs.length > 0) {
+            blank();
+            warn(`注意: ${withRefs.length} 个库仍被项目引用，删除后链接将失效`);
+            const confirmed = await confirmAction('确定继续?', false);
+            if (!confirmed) {
+                info('已取消清理');
+                return;
+            }
+        }
+        // 将选中的转为 StoreEntry
+        for (const key of selected) {
+            const entry = registry.getStore(key);
+            if (entry) {
+                toCleanStores.push(entry);
+            }
+        }
+        strategyName = 'manual';
+    }
+    else {
+        // unreferenced 策略（默认）：基于 LibraryInfo
+        toCleanLibs = registry.getUnreferencedLibraries();
+        strategyName = 'unreferenced';
+    }
+    // 检查是否有需要清理的内容
+    if (toCleanLibs.length === 0 && toCleanStores.length === 0) {
+        success('没有需要清理的库');
+        return;
+    }
+    // 计算总大小
+    let totalSize = 0;
+    if (toCleanStores.length > 0) {
+        for (const entry of toCleanStores) {
+            totalSize += entry.size;
+        }
+    }
+    else {
+        for (const lib of toCleanLibs) {
+            totalSize += lib.size;
+        }
+    }
+    blank();
+    title(`将清理 (${strategyName} 策略):`);
+    if (toCleanStores.length > 0) {
+        for (const entry of toCleanStores) {
+            const daysAgo = entry.unlinkedAt
+                ? Math.floor((Date.now() - entry.unlinkedAt) / 86400000)
+                : 0;
+            info(`  - ${entry.libName}/${entry.commit.slice(0, 7)}/${entry.platform} (${formatSize(entry.size)}) - 无引用 ${daysAgo} 天`);
+        }
+    }
+    else {
+        for (const lib of toCleanLibs) {
+            info(`  - ${lib.libName}/${lib.commit.slice(0, 7)} (${formatSize(lib.size)}) - 无项目引用`);
+        }
+    }
+    blank();
+    info(`总计释放: ${formatSize(totalSize)}`);
+    if (options.dryRun) {
+        blank();
+        hint('运行 tanmi-dock clean 执行清理');
+        return;
+    }
+    const cleanCount = toCleanStores.length > 0 ? toCleanStores.length : toCleanLibs.length;
+    if (!options.force) {
+        blank();
+        const confirmed = await confirmAction(`确认清理以上 ${cleanCount} 个库 (${formatSize(totalSize)})?`, false);
+        if (!confirmed) {
+            info('已取消清理');
+            return;
+        }
+    }
+    // 执行清理
+    blank();
+    separator();
+    info('正在清理...');
+    let cleaned = 0;
+    let freedSize = 0;
+    if (toCleanStores.length > 0) {
+        // unused 策略：清理 StoreEntry
+        for (const entry of toCleanStores) {
+            try {
+                await store.remove(entry.libName, entry.commit, entry.platform);
+                const storeKey = registry.getStoreKey(entry.libName, entry.commit, entry.platform);
+                registry.removeStore(storeKey);
+                freedSize += entry.size;
+                cleaned++;
+            }
+            catch (err) {
+                warn(`清理 ${entry.libName}/${entry.platform} 失败: ${err.message}`);
+            }
+        }
+    }
+    else {
+        // unreferenced 策略：清理 LibraryInfo
+        for (const lib of toCleanLibs) {
+            try {
+                for (const platform of lib.platforms) {
+                    await store.remove(lib.libName, lib.commit, platform);
+                }
+                const libKey = registry.getLibraryKey(lib.libName, lib.commit);
+                registry.removeLibrary(libKey);
+                freedSize += lib.size;
+                cleaned++;
+            }
+            catch (err) {
+                warn(`清理 ${lib.libName} 失败: ${err.message}`);
+            }
+        }
+    }
+    await registry.save();
+    blank();
+    success(`清理完成: 删除 ${cleaned} 个库，释放 ${formatSize(freedSize)}`);
+}
+export default createCleanCommand;
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * config 命令 - 查看/修改配置
+ */
+import { Command } from 'commander';
+/**
+ * 创建 config 命令
+ */
+export declare function createConfigCommand(): Command;
+export default createConfigCommand;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CA4B7C;AAkFD,eAAe,mBAAmB,CAAC"}

package/dist/commands/config.js

@@ -0,0 +1,105 @@
+/**
+ * config 命令 - 查看/修改配置
+ */
+import { Command } from 'commander';
+import { ensureInitialized } from '../core/guard.js';
+import * as config from '../core/config.js';
+import { shrinkHome } from '../core/platform.js';
+import { info, error, success, title, blank } from '../utils/logger.js';
+/**
+ * 创建 config 命令
+ */
+export function createConfigCommand() {
+    const cmd = new Command('config').description('查看或修改配置');
+    // 默认显示所有配置
+    cmd.action(async () => {
+        await ensureInitialized();
+        await showConfig();
+    });
+    // get 子命令
+    cmd
+        .command('get <key>')
+        .description('获取配置项的值')
+        .action(async (key) => {
+        await ensureInitialized();
+        await getConfigValue(key);
+    });
+    // set 子命令
+    cmd
+        .command('set <key> <value>')
+        .description('设置配置项的值')
+        .action(async (key, value) => {
+        await ensureInitialized();
+        await setConfigValue(key, value);
+    });
+    return cmd;
+}
+/**
+ * 显示所有配置
+ */
+async function showConfig() {
+    const cfg = await config.load();
+    if (!cfg) {
+        error('配置文件不存在');
+        process.exit(1);
+    }
+    title('TanmiDock 配置:');
+    blank();
+    info(`  version: ${cfg.version}`);
+    info(`  storePath: ${shrinkHome(cfg.storePath)}`);
+    info(`  cleanStrategy: ${cfg.cleanStrategy}`);
+    info(`  autoDownload: ${cfg.autoDownload}`);
+    if (cfg.maxStoreSize) {
+        info(`  maxStoreSize: ${cfg.maxStoreSize}`);
+    }
+    blank();
+    const { getConfigPath } = await import('../core/platform.js');
+    info(`配置文件: ${shrinkHome(getConfigPath())}`);
+}
+/**
+ * 获取配置项
+ */
+async function getConfigValue(key) {
+    if (!config.isValidConfigKey(key)) {
+        error(`无效的配置项: ${key}`);
+        info('有效的配置项: version, storePath, cleanStrategy, maxStoreSize, autoDownload');
+        process.exit(1);
+    }
+    const value = await config.get(key);
+    if (value === undefined) {
+        error(`配置项 ${key} 未设置`);
+        process.exit(1);
+    }
+    if (key === 'storePath' && typeof value === 'string') {
+        info(shrinkHome(value));
+    }
+    else {
+        info(String(value));
+    }
+}
+/**
+ * 设置配置项
+ */
+async function setConfigValue(key, value) {
+    if (!config.isValidConfigKey(key)) {
+        error(`无效的配置项: ${key}`);
+        info('有效的配置项: version, storePath, cleanStrategy, maxStoreSize, autoDownload');
+        process.exit(1);
+    }
+    // 只读配置项
+    if (key === 'version' || key === 'initialized') {
+        error(`配置项 ${key} 为只读`);
+        process.exit(1);
+    }
+    try {
+        const parsedValue = config.parseConfigValue(key, value);
+        await config.set(key, parsedValue);
+        success(`配置已更新: ${key} = ${value}`);
+    }
+    catch (err) {
+        error(err.message);
+        process.exit(1);
+    }
+}
+export default createConfigCommand;
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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