trove-cli 0.0.0-stage → 0.3.2

package/dist/core/library/schema.d.ts

@@ -0,0 +1,78 @@
+import type { HarnessId } from '../../adapters/index.js';
+/** library 里的会话变体:同一 (harness, session) 来自一台设备的一份事件流。 */
+export interface SessionVariant {
+    device: string;
+    /** 相对 library 根: sessions/<harness>/<session>/<device>.jsonl */
+    path: string;
+    hash: string;
+    events: number;
+}
+/** 统一索引里的会话条目(合并后的视图)。 */
+export interface MergedSession {
+    harness: HarnessId;
+    session: string;
+    title?: string;
+    firstText?: string;
+    cwd?: string;
+    model?: string;
+    startedAt?: string;
+    canonical: SessionVariant;
+    variants: SessionVariant[];
+    /** 参与的设备 */
+    sources: string[];
+}
+/** 每设备发布的索引分片。 */
+export interface IndexShard {
+    v: 1;
+    device: string;
+    mapper: string;
+    updatedAt: string;
+    sessions: Record<string, SessionVariant & {
+        title?: string;
+        firstText?: string;
+        cwd?: string;
+        model?: string;
+        startedAt?: string;
+        rawSources: string[];
+    }>;
+    skills: Record<string, SkillEntry>;
+}
+export type SkillSource = 'self' | 'github' | 'skillsh' | 'unknown';
+export interface SkillFile {
+    /** 相对 skill 版本目录 */
+    rel: string;
+    size: number;
+}
+export interface SkillEntry {
+    name: string;
+    hash: string;
+    version?: string;
+    source: SkillSource;
+    origin?: string;
+    updatedAt?: string;
+    /** 版本目录内的文件清单: versions/<name>/<hash>/<rel> */
+    files: SkillFile[];
+}
+export interface MergedSkill {
+    name: string;
+    latest: string;
+    versions: Array<SkillEntry & {
+        devices: string[];
+    }>;
+}
+export interface LibraryIndex {
+    v: 1;
+    generatedAt: string;
+    hash: string;
+    sessions: Record<string, MergedSession>;
+    skills: Record<string, MergedSkill>;
+}
+export declare function sessionKeyOf(harness: string, session: string): string;
+/** 技能版本比较:能解析 semver 的优先,semver 大的更新;都不能解析返回 0。 */
+export declare function compareVersions(a?: string, b?: string): number;
+/** 从候选版本里选“最新”:semver → updatedAt → hash,保证确定性。 */
+export declare function pickLatestHash(versions: Array<{
+    hash: string;
+    version?: string;
+    updatedAt?: string;
+}>): string;

package/dist/core/library/schema.js

@@ -0,0 +1,37 @@
+export function sessionKeyOf(harness, session) {
+    return `${harness}:${session}`;
+}
+/** 技能版本比较:能解析 semver 的优先,semver 大的更新;都不能解析返回 0。 */
+export function compareVersions(a, b) {
+    const parse = (v) => {
+        const m = /^v?(\d+)\.(\d+)\.(\d+)/.exec(v ?? '');
+        return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+    };
+    const pa = parse(a);
+    const pb = parse(b);
+    if (pa && pb) {
+        for (let i = 0; i < 3; i++)
+            if (pa[i] !== pb[i])
+                return pa[i] - pb[i];
+        return 0;
+    }
+    if (pa)
+        return 1;
+    if (pb)
+        return -1;
+    return 0;
+}
+/** 从候选版本里选“最新”:semver → updatedAt → hash,保证确定性。 */
+export function pickLatestHash(versions) {
+    const sorted = [...versions].sort((a, b) => {
+        const v = compareVersions(b.version, a.version);
+        if (v !== 0)
+            return v;
+        const t = (b.updatedAt ?? '').localeCompare(a.updatedAt ?? '');
+        if (t !== 0)
+            return t;
+        return a.hash.localeCompare(b.hash);
+    });
+    return sorted[0].hash;
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/library/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/core/library/schema.ts"],"names":[],"mappings":"AAqEA,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,OAAe;IAC3D,OAAO,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;AACjC,CAAC;AAGD,mDAAmD;AACnD,MAAM,UAAU,eAAe,CAAC,CAAU,EAAE,CAAU;IACpD,MAAM,KAAK,GAAG,CAAC,CAAU,EAAmC,EAAE;QAC5D,MAAM,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC,CAAC;IACF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,CAAC,CAAE,KAAK,EAAE,CAAC,CAAC,CAAE;gBAAE,OAAO,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC;QAC1E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,EAAE;QAAE,OAAO,CAAC,CAAC,CAAC;IAClB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAC5B,QAAuE;IAEvE,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzC,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACtB,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;AACzB,CAAC"}

package/dist/core/library/skills.d.ts

@@ -0,0 +1,26 @@
+import type { State } from '../state.js';
+import { type SkillEntry, type SkillSource } from './schema.js';
+/** 解析 SKILL.md 的简单 frontmatter(不引入 YAML 依赖)。 */
+export declare function parseFrontmatter(text: string): Record<string, string>;
+/** 从 .git/config 里取 origin URL。 */
+export declare function parseOrigin(gitConfig: string): string | undefined;
+export declare function classifySource(origin?: string, declared?: string): SkillSource;
+export interface BuildSkillsOptions {
+    vaultRoot: string;
+    deviceId: string;
+    state: State;
+    now?: () => number;
+}
+export interface BuildSkillsResult {
+    /** 每个技能的最新版本(供索引分片展示) */
+    entries: Record<string, SkillEntry>;
+    versions: number;
+    written: number;
+}
+/**
+ * 从本设备 raw 里的 `skills/**` 汇总技能:
+ *   library/skills/<name>/versions/<hash>/…   内容寻址,保留各版本
+ *   library/skills/<name>/meta/<device>.json  本设备看到的版本与来源
+ * 同名按内容 hash 去重,来源由 frontmatter / .git/config 判定。
+ */
+export declare function buildSkills(opts: BuildSkillsOptions): Promise<BuildSkillsResult>;

package/dist/core/library/skills.js

@@ -0,0 +1,168 @@
+import { createHash } from 'node:crypto';
+import { mkdir, readdir, readFile, rename, stat, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { librarySkillsDir, rawDeviceDir, safeSessionName } from '../layout.js';
+import { pickLatestHash } from './schema.js';
+const SKILL_HARNESSES = ['claude-code', 'codex'];
+const SKIP_DIRS = new Set(['.git', 'node_modules']);
+async function walk(root, rel = '') {
+    let entries;
+    try {
+        entries = await readdir(rel ? join(root, rel) : root, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        const p = rel ? `${rel}/${e.name}` : e.name;
+        if (e.isDirectory()) {
+            if (SKIP_DIRS.has(e.name))
+                continue;
+            out.push(...(await walk(root, p)));
+        }
+        else if (e.isFile()) {
+            if (e.name === '.DS_Store')
+                continue;
+            out.push(p);
+        }
+    }
+    return out;
+}
+/** 解析 SKILL.md 的简单 frontmatter(不引入 YAML 依赖)。 */
+export function parseFrontmatter(text) {
+    const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+    if (!m)
+        return {};
+    const out = {};
+    for (const line of m[1].split(/\r?\n/)) {
+        if (!line.trim() || line.trimStart().startsWith('#'))
+            continue;
+        const i = line.indexOf(':');
+        if (i < 0)
+            continue;
+        const key = line.slice(0, i).trim();
+        const value = line.slice(i + 1).trim().replace(/^["']|["']$/g, '');
+        if (key)
+            out[key] = value;
+    }
+    return out;
+}
+/** 从 .git/config 里取 origin URL。 */
+export function parseOrigin(gitConfig) {
+    const m = /\[remote "origin"\][\s\S]*?url\s*=\s*(.+)/.exec(gitConfig);
+    return m?.[1]?.trim();
+}
+export function classifySource(origin, declared) {
+    if (declared === 'github' || declared === 'skillsh' || declared === 'self')
+        return declared;
+    if (!origin)
+        return 'self';
+    if (/github\.com/i.test(origin))
+        return 'github';
+    if (/skills?\.sh/i.test(origin))
+        return 'skillsh';
+    return 'unknown';
+}
+function contentHash(files) {
+    const hash = createHash('sha256');
+    for (const f of files) {
+        hash.update(f.rel).update('\0').update(f.bytes).update('\0');
+    }
+    return hash.digest('hex');
+}
+async function writeAtomic(path, text) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await writeFile(tmp, text, 'utf8');
+    await rename(tmp, path);
+}
+/**
+ * 从本设备 raw 里的 `skills/**` 汇总技能:
+ *   library/skills/<name>/versions/<hash>/…   内容寻址,保留各版本
+ *   library/skills/<name>/meta/<device>.json  本设备看到的版本与来源
+ * 同名按内容 hash 去重,来源由 frontmatter / .git/config 判定。
+ */
+export async function buildSkills(opts) {
+    const { vaultRoot, deviceId, state } = opts;
+    const now = opts.now ?? Date.now;
+    const byName = new Map();
+    let written = 0;
+    for (const harness of SKILL_HARNESSES) {
+        const root = join(rawDeviceDir(vaultRoot, deviceId), harness, 'skills');
+        let dirs;
+        try {
+            dirs = (await readdir(root, { withFileTypes: true })).filter((e) => e.isDirectory());
+        }
+        catch {
+            continue;
+        }
+        for (const dir of dirs) {
+            const skillRoot = join(root, dir.name);
+            const relFiles = (await walk(skillRoot)).sort();
+            if (!relFiles.length)
+                continue;
+            const files = [];
+            for (const rel of relFiles) {
+                files.push({ rel, bytes: await readFile(join(skillRoot, rel)) });
+            }
+            const hash = contentHash(files);
+            const skillMd = files.find((f) => /(^|\/)SKILL\.md$/i.test(f.rel));
+            const fm = skillMd ? parseFrontmatter(skillMd.bytes.toString('utf8')) : {};
+            // .git 不进入版本目录,但来源判定需要读它的 origin
+            let origin;
+            try {
+                origin = parseOrigin(await readFile(join(skillRoot, '.git/config'), 'utf8'));
+            }
+            catch {
+                origin = undefined;
+            }
+            const name = fm['name'] || dir.name;
+            const source = classifySource(origin, fm['source']);
+            const version = fm['version'] || undefined;
+            const mtimes = relFiles
+                .map((rel) => state.sources[harness]?.[`skills/${dir.name}/${rel}`]?.mtimeMs)
+                .filter((v) => typeof v === 'number');
+            const updatedAt = new Date(mtimes.length ? Math.max(...mtimes) : now()).toISOString();
+            const entry = {
+                name,
+                hash,
+                ...(version ? { version } : {}),
+                source,
+                ...(origin ? { origin } : {}),
+                updatedAt,
+                files: files.map((f) => ({ rel: f.rel, size: f.bytes.length })),
+            };
+            const safe = safeSessionName(name);
+            const versionDir = join(librarySkillsDir(vaultRoot), safe, 'versions', hash);
+            try {
+                await stat(versionDir);
+            }
+            catch {
+                for (const f of files) {
+                    const target = join(versionDir, ...f.rel.split('/'));
+                    await mkdir(dirname(target), { recursive: true });
+                    await writeFile(target, f.bytes);
+                }
+                written++;
+            }
+            const versions = byName.get(name) ?? new Map();
+            versions.set(hash, entry);
+            byName.set(name, versions);
+        }
+    }
+    const entries = {};
+    for (const [name, versions] of [...byName.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        const list = [...versions.values()];
+        const latest = pickLatestHash(list);
+        entries[name] = versions.get(latest);
+        const meta = {
+            name,
+            device: deviceId,
+            versions: list.sort((a, b) => a.hash.localeCompare(b.hash)),
+        };
+        await writeAtomic(join(librarySkillsDir(vaultRoot), safeSessionName(name), 'meta', `${deviceId}.json`), JSON.stringify(meta, null, 2) + '\n');
+    }
+    return { entries, versions: Object.keys(entries).length, written };
+}
+//# sourceMappingURL=skills.js.map

package/dist/core/library/skills.js.map

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

package/dist/core/library/sync.d.ts

@@ -0,0 +1,48 @@
+import { type Progress } from '../../progress.js';
+import type { RemoteStore } from '../../remote/store.js';
+import type { State } from '../state.js';
+export interface PushLibraryOptions {
+    remote: RemoteStore;
+    vaultRoot: string;
+    deviceId: string;
+    state: State;
+    /** 当前远端身份;变了说明推送水位属于旧后端,必须整份重推。 */
+    remoteId?: string;
+    /** 用于周期性落盘进度:中断后已完成文件不会被重推 */
+    statePath: string;
+    progress?: Progress;
+    signal?: AbortSignal;
+}
+export interface PushLibraryResult {
+    uploaded: number;
+    bytes: number;
+    skipped: number;
+}
+/**
+ * 推送 library 里本设备负责的文件:
+ *   sessions/**、skills/**、lessons/**、index/<device>.json
+ * 每台设备只写自己的分片;会话文件按大小+mtime 判断是否变化。
+ * lessons 是共享沉淀,没有设备分片,多设备会互相覆盖(最后写赢)。
+ */
+/** library 里需要推送的文件(相对 library 根);status 的待同步计数复用同一口径。 */
+export declare function listLibraryFiles(vaultRoot: string): Promise<string[]>;
+export declare function pushLibrary(opts: PushLibraryOptions): Promise<PushLibraryResult>;
+export interface PullLibraryOptions {
+    remote: RemoteStore;
+    vaultRoot: string;
+    deviceId: string;
+    state: State;
+    progress?: Progress;
+    signal?: AbortSignal;
+}
+export interface PullLibraryResult {
+    downloaded: number;
+    bytes: number;
+    skipped: number;
+}
+/**
+ * 拉取所有设备的 library 分片与文件:
+ *   index/*.json → 会话文件、技能版本
+ * 已存在且 hash 一致的文件不重复下载;下载后校验 sha256。
+ */
+export declare function pullLibrary(opts: PullLibraryOptions): Promise<PullLibraryResult>;

package/dist/core/library/sync.js

@@ -0,0 +1,271 @@
+import { mkdir, readdir, rename, stat, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { hashFile } from '../chunker.js';
+import { throwIfAborted } from '../collect.js';
+import { libraryDir, safeSessionName } from '../layout.js';
+import { silentProgress } from '../../progress.js';
+import { rebuildUnifiedIndex } from './index-file.js';
+import { saveState } from '../state.js';
+async function walk(root, rel = '') {
+    let entries;
+    try {
+        entries = await readdir(rel ? join(root, rel) : root, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        const p = rel ? `${rel}/${e.name}` : e.name;
+        if (e.isDirectory())
+            out.push(...(await walk(root, p)));
+        else if (e.isFile() && !e.name.includes('.tmp-'))
+            out.push(p);
+    }
+    return out;
+}
+async function writeAtomic(path, data) {
+    await mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
+    await writeFile(tmp, data);
+    await rename(tmp, path);
+}
+/** 检查点间隔(ms):中断最多损失一分钟的已推记录。 */
+const CHECKPOINT_MS = 60_000;
+/**
+ * 推送 library 里本设备负责的文件:
+ *   sessions/**、skills/**、lessons/**、index/<device>.json
+ * 每台设备只写自己的分片;会话文件按大小+mtime 判断是否变化。
+ * lessons 是共享沉淀,没有设备分片,多设备会互相覆盖(最后写赢)。
+ */
+/** library 里需要推送的文件(相对 library 根);status 的待同步计数复用同一口径。 */
+export async function listLibraryFiles(vaultRoot) {
+    const root = libraryDir(vaultRoot);
+    const rank = (rel) => (rel.startsWith('index/') ? 1 : 0);
+    return [
+        ...(await walk(root, 'sessions')),
+        ...(await walk(root, 'skills')),
+        ...(await walk(root, 'lessons')),
+        ...(await walk(root, 'index')).filter((rel) => rel.endsWith('.json')),
+        // index 分片是引用其他文件的提交点:必须最后传,否则中断会留下指向不存在文件的悬空引用
+    ].sort((a, b) => rank(a) - rank(b) || a.localeCompare(b));
+}
+export async function pushLibrary(opts) {
+    const { remote, vaultRoot, state } = opts;
+    const progress = opts.progress ?? silentProgress;
+    const root = libraryDir(vaultRoot);
+    const files = await listLibraryFiles(vaultRoot);
+    let uploaded = 0;
+    let bytes = 0;
+    let skipped = 0;
+    let n = 0;
+    let lastCheckpoint = Date.now();
+    // 换后端时旧后端的推送记账对新远端无效:就地清空并立刻落盘。
+    // 这样即使进程中途被杀,下次也只会补传未完成的文件,而不是把整份 library 重推。
+    if (opts.remoteId && state.library.remoteId !== opts.remoteId) {
+        state.library.pushed = {};
+        state.library.remoteId = opts.remoteId;
+        await saveState(opts.statePath, state);
+    }
+    const sameRemote = !opts.remoteId || state.library.remoteId === opts.remoteId;
+    // 中断(abort/报错)时保住已完成文件的记账:重启后按 state 跳过,不整轮重推
+    const checkpoint = async () => {
+        await saveState(opts.statePath, state);
+        lastCheckpoint = Date.now();
+    };
+    try {
+        for (const rel of files) {
+            throwIfAborted(opts.signal);
+            n++;
+            const abs = join(root, ...rel.split('/'));
+            const st = await stat(abs);
+            const prev = state.library.pushed[rel];
+            if (sameRemote && prev && prev.size === st.size && prev.mtimeMs === Math.round(st.mtimeMs)) {
+                skipped++;
+                continue;
+            }
+            await remote.writeFile(`library/${rel}`, abs);
+            state.library.pushed[rel] = { size: st.size, mtimeMs: Math.round(st.mtimeMs) };
+            uploaded++;
+            bytes += st.size;
+            progress.item(rel, n, files.length, st.size);
+            if (Date.now() - lastCheckpoint >= CHECKPOINT_MS)
+                await checkpoint();
+        }
+    }
+    finally {
+        if (uploaded > 0)
+            await checkpoint();
+    }
+    return { uploaded, bytes, skipped };
+}
+async function localHash(path) {
+    try {
+        return await hashFile(path);
+    }
+    catch {
+        return null;
+    }
+}
+/** 远端 404:索引引用的文件不存在(分片悬空),可跳过而不是中断整轮同步。 */
+function isNotFound(err) {
+    const e = err;
+    return (e?.status ?? e?.statusCode ?? e?.response?.status) === 404;
+}
+/** 递归列远端目录下的文件(RemoteStore.list 只列一层)。 */
+async function walkRemote(remote, dir) {
+    const out = [];
+    for (const e of await remote.list(dir)) {
+        const p = `${dir}/${e.name}`;
+        if (e.type === 'directory')
+            out.push(...(await walkRemote(remote, p)));
+        else
+            out.push(p);
+    }
+    return out;
+}
+/**
+ * 拉取所有设备的 library 分片与文件:
+ *   index/*.json → 会话文件、技能版本
+ * 已存在且 hash 一致的文件不重复下载;下载后校验 sha256。
+ */
+export async function pullLibrary(opts) {
+    const { remote, vaultRoot, state } = opts;
+    const progress = opts.progress ?? silentProgress;
+    const root = libraryDir(vaultRoot);
+    let downloaded = 0;
+    let bytes = 0;
+    let skipped = 0;
+    const shards = (await remote.list('library/index')).filter((e) => e.type === 'file');
+    progress.phase('library', `${shards.length} 个设备分片`);
+    let itemNo = 0;
+    for (const shardEntry of shards) {
+        throwIfAborted(opts.signal);
+        const shardPath = `library/index/${shardEntry.name}`;
+        const raw = await remote.readJson(shardPath);
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const shard = raw;
+        if (shard.v !== 1 || !shard.sessions)
+            continue;
+        const device = shard.device;
+        const isSelf = device === opts.deviceId;
+        // 分片本身也要落地,统一索引才能离线重建;本机分片是权威,只在缺失时恢复
+        const shardAbs = join(root, 'index', shardEntry.name);
+        if (!isSelf || (await localHash(shardAbs)) === null) {
+            await writeAtomic(shardAbs, JSON.stringify(shard, null, 2) + '\n');
+        }
+        const pulled = (state.library.pulled[device] ??= {});
+        for (const entry of Object.values(shard.sessions)) {
+            throwIfAborted(opts.signal);
+            itemNo++;
+            const remotePath = `library/${entry.path}`;
+            const abs = join(root, ...entry.path.split('/'));
+            // 本机文件是权威:存在就不拿远端(可能是旧分片)覆盖,只在缺失时恢复
+            if (isSelf && (await localHash(abs)) !== null) {
+                skipped++;
+                continue;
+            }
+            if (pulled[entry.path] === entry.hash) {
+                skipped++;
+                continue;
+            }
+            if ((await localHash(abs)) === entry.hash) {
+                pulled[entry.path] = entry.hash;
+                skipped++;
+                continue;
+            }
+            const tmp = `${abs}.tmp-${process.pid}-${Date.now()}`;
+            try {
+                await mkdir(dirname(abs), { recursive: true });
+                await remote.readFile(remotePath, tmp);
+                const got = await hashFile(tmp);
+                if (got !== entry.hash)
+                    throw new Error(`library 文件校验失败: ${entry.path}`);
+                await rename(tmp, abs);
+            }
+            catch (err) {
+                await unlink(tmp).catch(() => { });
+                // 分片可能来自已离线设备或旧数据,引用了不存在的对象:跳过,不影响其他文件
+                if (isNotFound(err)) {
+                    console.warn(`[trove] 远端缺少索引引用的文件,已跳过: ${entry.path}`);
+                    continue;
+                }
+                throw err;
+            }
+            pulled[entry.path] = entry.hash;
+            downloaded++;
+            bytes += (await stat(abs)).size;
+            progress.item(entry.path, itemNo, shards.length * 100, bytes);
+        }
+        // 技能:meta 与版本文件
+        for (const name of Object.keys(shard.skills ?? {})) {
+            const safe = safeSessionName(name);
+            const metaFiles = (await remote.list(`library/skills/${safe}/meta`)).filter((e) => e.type === 'file' && e.name.endsWith('.json'));
+            for (const metaEntry of metaFiles) {
+                const remoteMeta = `library/skills/${safe}/meta/${metaEntry.name}`;
+                const localMeta = join(root, 'skills', safe, 'meta', metaEntry.name);
+                const metaRaw = await remote.readJson(remoteMeta);
+                if (!metaRaw || typeof metaRaw !== 'object')
+                    continue;
+                await writeAtomic(localMeta, JSON.stringify(metaRaw, null, 2) + '\n');
+                const versions = metaRaw
+                    .versions ?? [];
+                for (const v of versions) {
+                    for (const f of v.files ?? []) {
+                        const rel = `skills/${safe}/versions/${v.hash}/${f.rel}`;
+                        const target = join(root, ...rel.split('/'));
+                        if (await localHash(target)) {
+                            skipped++;
+                            continue;
+                        }
+                        const tmp = `${target}.tmp-${process.pid}-${Date.now()}`;
+                        try {
+                            await mkdir(dirname(target), { recursive: true });
+                            await remote.readFile(`library/${rel}`, tmp);
+                            await rename(tmp, target);
+                        }
+                        catch (err) {
+                            await unlink(tmp).catch(() => { });
+                            if (isNotFound(err)) {
+                                console.warn(`[trove] 远端缺少技能文件,已跳过: ${rel}`);
+                                continue;
+                            }
+                            throw err;
+                        }
+                        downloaded++;
+                        bytes += (await stat(target)).size;
+                    }
+                }
+            }
+        }
+    }
+    // lessons:共享沉淀,没有设备分片。本地已有就不覆盖(本机内容可能是刚 learn 的新版本),
+    // 只在缺失时从远端恢复 —— 新设备能拿到经验库,又不会丢掉本机刚生成的内容。
+    const remoteLessons = await walkRemote(remote, 'library/lessons');
+    for (const remotePath of remoteLessons) {
+        throwIfAborted(opts.signal);
+        const rel = remotePath.slice('library/'.length);
+        const target = join(root, ...rel.split('/'));
+        if (await localHash(target)) {
+            skipped++;
+            continue;
+        }
+        const tmp = `${target}.tmp-${process.pid}-${Date.now()}`;
+        try {
+            await mkdir(dirname(target), { recursive: true });
+            await remote.readFile(remotePath, tmp);
+            await rename(tmp, target);
+        }
+        catch (err) {
+            await unlink(tmp).catch(() => { });
+            throw err;
+        }
+        downloaded++;
+        bytes += (await stat(target)).size;
+        progress.item(rel, itemNo, remoteLessons.length, bytes);
+    }
+    await rebuildUnifiedIndex(vaultRoot);
+    return { downloaded, bytes, skipped };
+}
+//# sourceMappingURL=sync.js.map