tanmi-dock 0.9.0 → 0.9.1

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

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/commands/link.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,OAAO,KAAK,EAAuE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOzH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAiC3C;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AA6gCD;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqZ1F;AAuKD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,OAAO,EAClB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,CA0CvD;AAw+BD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyCnD;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,UAAU,CAAC,CAStB;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/commands/link.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,OAAO,KAAK,EAAuE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOzH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAiC3C;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AA4+BD;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwZ1F;AAmSD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,OAAO,EAClB,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC,CA0CvD;AAwhCD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EAAE,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyCnD;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,UAAU,CAAC,CAStB;AAED,eAAe,iBAAiB,CAAC"}

package/dist/commands/link.js

@@ -7,13 +7,13 @@ import { Command } from 'commander';
 import { ensureInitialized } from '../core/guard.js';
 import * as config from '../core/config.js';
 import { setLogLevel } from '../utils/logger.js';
-import { parseProjectDependencies, getRelativeConfigPath, parseCodepacDep, extractActions, parseActionCommand, extractNestedDependencies, normalizeProjectRoot, findAllCodepacConfigs, extractDependencies, } from '../core/parser.js';
+import { parseProjectDependencies, getRelativeConfigPath, parseCodepacDep, extractActions, parseActionCommand, extractNestedDependencies, findAllCodepacConfigs, extractDependencies, resolveProjectRootPath, } from '../core/parser.js';
 import { getRegistry } from '../core/registry.js';
 import * as store from '../core/store.js';
 import * as linker from '../core/linker.js';
 import * as codepac from '../core/codepac.js';
 import { setProxyConfig } from '../core/codepac.js';
-import { resolvePath, getPlatformHelpText, GENERAL_PLATFORM, SHARED_PLATFORM, pathsEqual, isSparseOnlyCommon, KNOWN_PLATFORM_VALUES } from '../core/platform.js';
+import { getPlatformHelpText, GENERAL_PLATFORM, SHARED_PLATFORM, pathsEqual, isSparseOnlyCommon, KNOWN_PLATFORM_VALUES } from '../core/platform.js';
 import { Transaction } from '../core/transaction.js';
 import { formatSize, checkDiskSpace } from '../utils/disk.js';
 import { getDirSize } from '../utils/fs-utils.js';
@@ -289,13 +289,11 @@ async function linkScope(params) {
                             const { existing: allExisting } = await store.checkPlatformCompleteness(dependency.libName, dependency.commit, platforms);
                             tx.recordOp('link', localPath, linkedCommitPath);
                             await linker.linkLib(localPath, linkedCommitPath, allExisting);
-                            for (const platform of allExisting) {
-                                const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, platform);
-                                registry.addStoreReference(storeKey, projectHash);
-                            }
+                            await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, allExisting, projectHash, false);
                             success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - 已补充平台 [${supplementResult.downloaded.join(', ')}]`);
                         }
                     }
+                    await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, isLinkedGeneral ? [GENERAL_PLATFORM] : platforms, projectHash, isLinkedGeneral);
                     break;
                 }
                 case DependencyStatus.RELINK: {
@@ -307,6 +305,7 @@ async function linkScope(params) {
                         const sharedPath = path.join(relinkCommitPath, '_shared');
                         tx.recordOp('link', localPath, sharedPath);
                         await linker.linkGeneral(localPath, sharedPath);
+                        await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, [GENERAL_PLATFORM], projectHash, true);
                         generalLibs.add(dependency.libName);
                         success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - General 库，重建链接`);
                     }
@@ -337,10 +336,7 @@ async function linkScope(params) {
                         await linker.unlink(localPath);
                         tx.recordOp('link', localPath, relinkCommitPath);
                         await linker.linkLib(localPath, relinkCommitPath, relinkExisting);
-                        for (const platform of relinkExisting) {
-                            const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, platform);
-                            registry.addStoreReference(storeKey, projectHash);
-                        }
+                        await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, relinkExisting, projectHash, false);
                         if (relinkSupplementResult.downloaded.length > 0) {
                             success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - 重建链接并补充平台 [${relinkExisting.join(', ')}]`);
                         }
@@ -359,6 +355,7 @@ async function linkScope(params) {
                         tx.recordOp('replace', localPath, sharedPath);
                         await linker.linkGeneral(localPath, sharedPath);
                         savedBytes += replaceSize;
+                        await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, [GENERAL_PLATFORM], projectHash, true);
                         generalLibs.add(dependency.libName);
                         success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - General 库，创建链接`);
                     }
@@ -388,10 +385,7 @@ async function linkScope(params) {
                         tx.recordOp('replace', localPath, replaceCommitPath);
                         await linker.linkLib(localPath, replaceCommitPath, replaceExisting);
                         savedBytes += replaceSize;
-                        for (const platform of replaceExisting) {
-                            const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, platform);
-                            registry.addStoreReference(storeKey, projectHash);
-                        }
+                        await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, replaceExisting, projectHash, false);
                         if (replaceSupplementResult.downloaded.length > 0) {
                             success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - Store 已有，创建链接并补充平台 [${replaceExisting.join(', ')}]`);
                         }
@@ -569,21 +563,7 @@ async function linkScope(params) {
                         const sharedPath = path.join(linkNewCommitPath, '_shared');
                         tx.recordOp('link', localPath, sharedPath);
                         await linker.linkGeneral(localPath, sharedPath);
-                        const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                        const existingEntry = registry.getStore(storeKey);
-                        if (!existingEntry) {
-                            const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                            registry.addStore({
-                                libName: dependency.libName, commit: dependency.commit, platform: GENERAL_PLATFORM,
-                                branch: dependency.branch, url: dependency.url, ...integrity,
-                                usedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                            });
-                        }
-                        else if (existingEntry.fileCount == null) {
-                            const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                            registry.updateStore(storeKey, integrity);
-                        }
-                        registry.addStoreReference(storeKey, projectHash);
+                        await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, [GENERAL_PLATFORM], projectHash, true);
                         generalLibs.add(dependency.libName);
                         success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - General 库，创建链接`);
                     }
@@ -609,29 +589,14 @@ async function linkScope(params) {
                     else {
                         tx.recordOp('link', localPath, linkNewCommitPath);
                         await linker.linkLib(localPath, linkNewCommitPath, linkNewExisting);
-                        for (const platform of linkNewExisting) {
-                            const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, platform);
-                            const existingPlatformEntry = registry.getStore(storeKey);
-                            if (!existingPlatformEntry) {
-                                const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, platform);
-                                registry.addStore({
-                                    libName: dependency.libName, commit: dependency.commit, platform,
-                                    branch: dependency.branch, url: dependency.url, ...integrity,
-                                    usedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                });
-                            }
-                            else if (existingPlatformEntry.fileCount == null) {
-                                const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, platform);
-                                registry.updateStore(storeKey, integrity);
-                            }
-                            registry.addStoreReference(storeKey, projectHash);
-                        }
-                        await registerSharedStore(dependency.libName, dependency.commit, dependency.branch, dependency.url);
+                        await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, linkNewExisting, projectHash, false);
                         success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - 创建链接 [${linkNewExisting.join(', ')}]`);
                     }
                     break;
                 }
             }
+            // 无论当前是跳过、补平台还是重建链接，都要把本地残留的平台目录清理到最终平台集合
+            await linker.cleanupLocalExtraPlatforms(localPath, finalLinkPlatforms);
             await tx.save();
         }
         // 8. 并行处理 MISSING 依赖
@@ -663,31 +628,7 @@ async function linkScope(params) {
                             pLog.info(`${dependency.libName} 所有平台已存在，直接链接...`);
                             tx.recordOp('link', localPath, storeCommitPath);
                             await linker.linkLib(localPath, storeCommitPath, platforms);
-                            for (const platform of platforms) {
-                                const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, platform);
-                                if (!registry.getStore(storeKey)) {
-                                    const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, platform);
-                                    registry.addStore({
-                                        libName: dependency.libName, commit: dependency.commit, platform,
-                                        branch: dependency.branch, url: dependency.url, ...integrity,
-                                        usedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                    });
-                                }
-                                registry.addStoreReference(storeKey, projectHash);
-                            }
-                            await registerSharedStore(dependency.libName, dependency.commit, dependency.branch, dependency.url);
-                            const dlLibKey = registry.getLibraryKey(dependency.libName, dependency.commit);
-                            if (!registry.getLibrary(dlLibKey)) {
-                                let totalSize = 0;
-                                for (const platform of platforms) {
-                                    totalSize += await store.getSize(dependency.libName, dependency.commit, platform);
-                                }
-                                registry.addLibrary({
-                                    libName: dependency.libName, commit: dependency.commit, branch: dependency.branch,
-                                    url: dependency.url, platforms, size: totalSize, referencedBy: [],
-                                    createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                });
-                            }
+                            await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, platforms, projectHash, false);
                             pLog.success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - 链接完成 [${platforms.join(', ')}]`);
                             return { success: true, name: dependency.libName, downloadedPlatforms: platforms, skippedPlatforms: [] };
                         }
@@ -732,25 +673,7 @@ async function linkScope(params) {
                                 const sharedPath = path.join(storeCommitPath, '_shared');
                                 tx.recordOp('link', localPath, sharedPath);
                                 await linker.linkGeneral(localPath, sharedPath);
-                                const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                                if (!registry.getStore(storeKey)) {
-                                    const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                                    registry.addStore({
-                                        libName: dependency.libName, commit: dependency.commit, platform: GENERAL_PLATFORM,
-                                        branch: dependency.branch, url: dependency.url, ...integrity,
-                                        usedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                    });
-                                }
-                                registry.addStoreReference(storeKey, projectHash);
-                                const genLibKey = registry.getLibraryKey(dependency.libName, dependency.commit);
-                                if (!registry.getLibrary(genLibKey)) {
-                                    const sharedSize = await getDirSize(sharedPath);
-                                    registry.addLibrary({
-                                        libName: dependency.libName, commit: dependency.commit, branch: dependency.branch,
-                                        url: dependency.url, platforms: [GENERAL_PLATFORM], size: sharedSize,
-                                        referencedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                    });
-                                }
+                                await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, [GENERAL_PLATFORM], projectHash, true);
                                 generalLibs.add(dependency.libName);
                                 pLog.success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - General 库，下载完成`);
                                 return { success: true, name: dependency.libName, downloadedPlatforms: [GENERAL_PLATFORM], skippedPlatforms: [], isGeneral: true };
@@ -784,25 +707,7 @@ async function linkScope(params) {
                                 const sharedPath = path.join(storeCommitPath, '_shared');
                                 tx.recordOp('link', localPath, sharedPath);
                                 await linker.linkGeneral(localPath, sharedPath);
-                                const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                                if (!registry.getStore(storeKey)) {
-                                    const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, GENERAL_PLATFORM);
-                                    registry.addStore({
-                                        libName: dependency.libName, commit: dependency.commit, platform: GENERAL_PLATFORM,
-                                        branch: dependency.branch, url: dependency.url, ...integrity,
-                                        usedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                    });
-                                }
-                                registry.addStoreReference(storeKey, projectHash);
-                                const genLibKey2 = registry.getLibraryKey(dependency.libName, dependency.commit);
-                                if (!registry.getLibrary(genLibKey2)) {
-                                    const sharedSize = await getDirSize(sharedPath);
-                                    registry.addLibrary({
-                                        libName: dependency.libName, commit: dependency.commit, branch: dependency.branch,
-                                        url: dependency.url, platforms: [GENERAL_PLATFORM], size: sharedSize,
-                                        referencedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                    });
-                                }
+                                await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, [GENERAL_PLATFORM], projectHash, true);
                                 generalLibs.add(dependency.libName);
                                 pLog.success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - General 库，下载完成`);
                                 return { success: true, name: dependency.libName, downloadedPlatforms: [GENERAL_PLATFORM], skippedPlatforms: [], isGeneral: true };
@@ -812,31 +717,7 @@ async function linkScope(params) {
                             }
                             tx.recordOp('link', localPath, storeCommitPath);
                             await linker.linkLib(localPath, storeCommitPath, linkPlatforms);
-                            for (const platform of linkPlatforms) {
-                                const storeKey = registry.getStoreKey(dependency.libName, dependency.commit, platform);
-                                if (!registry.getStore(storeKey)) {
-                                    const integrity = await store.captureIntegrity(dependency.libName, dependency.commit, platform);
-                                    registry.addStore({
-                                        libName: dependency.libName, commit: dependency.commit, platform,
-                                        branch: dependency.branch, url: dependency.url, ...integrity,
-                                        usedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                    });
-                                }
-                                registry.addStoreReference(storeKey, projectHash);
-                            }
-                            await registerSharedStore(dependency.libName, dependency.commit, dependency.branch, dependency.url);
-                            const finalLibKey = registry.getLibraryKey(dependency.libName, dependency.commit);
-                            if (!registry.getLibrary(finalLibKey)) {
-                                let totalSize = 0;
-                                for (const platform of linkPlatforms) {
-                                    totalSize += await store.getSize(dependency.libName, dependency.commit, platform);
-                                }
-                                registry.addLibrary({
-                                    libName: dependency.libName, commit: dependency.commit, branch: dependency.branch,
-                                    url: dependency.url, platforms: linkPlatforms, size: totalSize,
-                                    referencedBy: [], createdAt: new Date().toISOString(), lastAccess: new Date().toISOString(),
-                                });
-                            }
+                            await ensureLinkedRegistryState(dependency.libName, dependency.commit, dependency.branch, dependency.url, linkPlatforms, projectHash, false);
                             const notLinkedPlatforms = platforms.filter((p) => !linkPlatforms.includes(p));
                             pLog.success(`${dependency.libName} (${dependency.commit.slice(0, 7)}) - 下载完成 [${linkPlatforms.join(', ')}]`);
                             return { success: true, name: dependency.libName, downloadedPlatforms: linkPlatforms, skippedPlatforms: notLinkedPlatforms };
@@ -929,7 +810,7 @@ async function linkScope(params) {
  * 执行链接操作
  */
 export async function linkProject(projectPath, options) {
-    const absolutePath = resolvePath(projectPath);
+    const { absolutePath, normalizedPath, configPath: discoveredConfigPath, } = await resolveProjectRootPath(projectPath);
     // === 阶段 1: 初始化 ===
     const cfg = await config.load();
     if (cfg?.logLevel)
@@ -939,7 +820,7 @@ export async function linkProject(projectPath, options) {
     const concurrency = cfg?.concurrency ?? 5;
     const registry = getRegistry();
     await registry.load();
-    const existingProject = registry.getProjectByPath(absolutePath);
+    const existingProject = registry.getProjectByPath(normalizedPath);
     const rememberedPlatforms = existingProject?.platforms;
     // 确定平台列表
     let platforms;
@@ -976,7 +857,7 @@ export async function linkProject(projectPath, options) {
         process.exit(EXIT_CODES.NOINPUT);
     }
     // 发现可选配置文件
-    const thirdpartyDir = path.join(absolutePath, '3rdparty');
+    const thirdpartyDir = path.join(normalizedPath, '3rdparty');
     const configDiscovery = await findAllCodepacConfigs(thirdpartyDir);
     let selectedOptionalConfigs = [];
     if (configDiscovery && configDiscovery.optionalConfigs.length > 0) {
@@ -1016,8 +897,7 @@ export async function linkProject(projectPath, options) {
         }
     }
     // 查找主配置文件
-    const { findCodepacConfig } = await import('../core/parser.js');
-    const mainConfigPath = await findCodepacConfig(absolutePath);
+    const mainConfigPath = discoveredConfigPath;
     if (!mainConfigPath) {
         error(`找不到 codepac-dep.json 配置文件，已搜索: 3rdparty, .`);
         process.exit(EXIT_CODES.DATAERR);
@@ -1025,7 +905,7 @@ export async function linkProject(projectPath, options) {
     // === 阶段 2: Submodule 检测 ===
     let selectedSubmodules = [];
     if (options.submodules !== false) {
-        const submoduleConfigs = await findSubmoduleConfigs(absolutePath);
+        const submoduleConfigs = await findSubmoduleConfigs(normalizedPath);
         if (submoduleConfigs.length > 0) {
             selectedSubmodules = await selectSubmodules(submoduleConfigs, options, existingProject?.submodules);
             // 为选中的 submodule 处理可选配置
@@ -1041,7 +921,7 @@ export async function linkProject(projectPath, options) {
         }
     }
     // === 阶段 3: 规范化 + 事务准备 ===
-    const normalizedRoot = normalizeProjectRoot(absolutePath, mainConfigPath);
+    const normalizedRoot = normalizedPath;
     const wasNormalized = normalizedRoot !== absolutePath;
     if (wasNormalized) {
         info(`项目根目录规范化: ${absolutePath} → ${normalizedRoot}`);
@@ -1365,6 +1245,93 @@ async function registerSharedStore(libName, commit, branch = '', url = '') {
     debug(`注册 _shared: ${libName}:${commit.slice(0, 8)} (${formatSize(integrity.size)})`);
     return true;
 }
+async function ensureStoreInfo(libName, commit, platform, branch, url, projectHash) {
+    const registry = getRegistry();
+    const storeKey = registry.getStoreKey(libName, commit, platform);
+    const existingEntry = registry.getStore(storeKey);
+    if (!existingEntry) {
+        const integrity = await store.captureIntegrity(libName, commit, platform);
+        registry.addStore({
+            libName,
+            commit,
+            platform,
+            branch,
+            url,
+            ...integrity,
+            usedBy: [],
+            createdAt: new Date().toISOString(),
+            lastAccess: new Date().toISOString(),
+        });
+    }
+    else if (existingEntry.fileCount == null) {
+        const integrity = await store.captureIntegrity(libName, commit, platform);
+        registry.updateStore(storeKey, integrity);
+    }
+    if (projectHash) {
+        registry.addStoreReference(storeKey, projectHash);
+    }
+}
+async function syncLibraryInfo(libName, commit, branch, url, platforms) {
+    const registry = getRegistry();
+    const libKey = registry.getLibraryKey(libName, commit);
+    const existingLibrary = registry.getLibrary(libKey);
+    const normalizedPlatforms = [...new Set(platforms)];
+    let totalSize = 0;
+    for (const platform of normalizedPlatforms) {
+        totalSize += await store.getSize(libName, commit, platform);
+    }
+    if (!existingLibrary) {
+        registry.addLibrary({
+            libName,
+            commit,
+            branch,
+            url,
+            platforms: normalizedPlatforms,
+            size: totalSize,
+            referencedBy: [],
+            createdAt: new Date().toISOString(),
+            lastAccess: new Date().toISOString(),
+        });
+        return;
+    }
+    registry.updateLibrary(libKey, {
+        branch: branch || existingLibrary.branch,
+        url: url || existingLibrary.url,
+        platforms: normalizedPlatforms,
+        size: totalSize,
+        lastAccess: new Date().toISOString(),
+    });
+}
+async function resolveStoredPlatforms(libName, commit, fallbackPlatforms) {
+    const storePath = await config.getStorePath();
+    if (!storePath) {
+        return [...new Set(fallbackPlatforms)];
+    }
+    const commitPath = path.join(storePath, libName, commit);
+    try {
+        const entries = await fs.readdir(commitPath, { withFileTypes: true });
+        const storedPlatforms = entries
+            .filter(entry => entry.isDirectory() && KNOWN_PLATFORM_VALUES.includes(entry.name))
+            .map(entry => entry.name);
+        return storedPlatforms.length > 0 ? storedPlatforms : [...new Set(fallbackPlatforms)];
+    }
+    catch {
+        return [...new Set(fallbackPlatforms)];
+    }
+}
+async function ensureLinkedRegistryState(libName, commit, branch, url, platforms, projectHash, isGeneral) {
+    const linkedPlatforms = isGeneral ? [GENERAL_PLATFORM] : [...new Set(platforms)];
+    const libraryPlatforms = isGeneral
+        ? [GENERAL_PLATFORM]
+        : await resolveStoredPlatforms(libName, commit, linkedPlatforms);
+    for (const platform of linkedPlatforms) {
+        await ensureStoreInfo(libName, commit, platform, branch, url, projectHash);
+    }
+    if (!isGeneral) {
+        await registerSharedStore(libName, commit, branch, url);
+    }
+    await syncLibraryInfo(libName, commit, branch, url, libraryPlatforms);
+}
 /**
  * 注册嵌套依赖到 Registry
  * absorbLib 递归吸收嵌套依赖时只做文件操作，此函数负责 Registry 注册
@@ -2036,6 +2003,7 @@ async function linkNestedDependencies(dependencies, params) {
         if (localExists && (storeHas || isGeneral)) {
             const linkStatus = await classifyLinkStatus(localPath, storeCommitPath, isGeneral, existingPlatforms);
             if (linkStatus === 'linked') {
+                let linkedPlatforms = isGeneral ? [GENERAL_PLATFORM] : [...existingPlatforms];
                 // 已链接，但需要检查是否需要补充缺失平台（与顶层依赖逻辑一致）
                 if (!isGeneral) {
                     const supplementResult = await supplementMissingPlatforms(dep, platforms, registry, tx, { vars });
@@ -2052,6 +2020,7 @@ async function linkNestedDependencies(dependencies, params) {
                         }
                         // 合并所有平台并重新链接
                         const allPlatforms = [...existingPlatforms, ...supplementResult.downloaded];
+                        linkedPlatforms = allPlatforms;
                         if (!dryRun) {
                             tx.recordOp('link', localPath, storeCommitPath);
                             await linker.linkLib(localPath, storeCommitPath, allPlatforms);
@@ -2059,6 +2028,7 @@ async function linkNestedDependencies(dependencies, params) {
                         success(`${indent}  ${dep.libName} - 重新链接完成 [${allPlatforms.join(', ')}]`);
                     }
                 }
+                await ensureLinkedRegistryState(dep.libName, dep.commit, dep.branch, dep.url, linkedPlatforms, projectHash, isGeneral);
                 nestedLinkedDeps.push({
                     libName: dep.libName,
                     commit: dep.commit,
@@ -2094,6 +2064,7 @@ async function linkNestedDependencies(dependencies, params) {
                 const sharedPath = path.join(storeCommitPath, '_shared');
                 tx.recordOp('link', localPath, sharedPath);
                 await linker.linkGeneral(localPath, sharedPath);
+                await ensureLinkedRegistryState(dep.libName, dep.commit, dep.branch, dep.url, [GENERAL_PLATFORM], projectHash, true);
                 generalLibs.add(dep.libName);
                 // 记录到 nestedLinkedDeps
                 nestedLinkedDeps.push({
@@ -2119,6 +2090,7 @@ async function linkNestedDependencies(dependencies, params) {
                 }
                 tx.recordOp('link', localPath, storeCommitPath);
                 await linker.linkLib(localPath, storeCommitPath, allPlatforms);
+                await ensureLinkedRegistryState(dep.libName, dep.commit, dep.branch, dep.url, allPlatforms, projectHash, false);
                 // 记录到 nestedLinkedDeps
                 nestedLinkedDeps.push({
                     libName: dep.libName,
@@ -2174,6 +2146,7 @@ async function linkNestedDependencies(dependencies, params) {
                     const sharedPath = path.join(storeCommitPath, '_shared');
                     tx.recordOp('link', localPath, sharedPath);
                     await linker.linkGeneral(localPath, sharedPath);
+                    await ensureLinkedRegistryState(dep.libName, dep.commit, dep.branch, dep.url, [GENERAL_PLATFORM], projectHash, true);
                     generalLibs.add(dep.libName);
                     downloadedLibs.push(dep.libName);
                     // 记录到 nestedLinkedDeps
@@ -2192,6 +2165,7 @@ async function linkNestedDependencies(dependencies, params) {
                     await registerNestedLibraries(nestedAbsorbResult.nestedLibraries, projectHash);
                     tx.recordOp('link', localPath, storeCommitPath);
                     await linker.linkLib(localPath, storeCommitPath, downloadResult.platformDirs);
+                    await ensureLinkedRegistryState(dep.libName, dep.commit, dep.branch, dep.url, downloadResult.platformDirs, projectHash, false);
                     downloadedLibs.push(dep.libName);
                     // 记录到 nestedLinkedDeps
                     nestedLinkedDeps.push({