@dsh-workbench/adapter-profile 1.1.14-beta.2 → 1.1.14

package/dist/config-sync-assets.d.ts

@@ -0,0 +1,32 @@
+import type { ConfigSyncAsset } from '@dsh-workbench/shared/contract/protocol/config-sync';
+export interface CopyPlan {
+    readonly source: string;
+    readonly target: string;
+    readonly path: string;
+    readonly overwrite: boolean;
+}
+export interface AssetBlock {
+    readonly insert: boolean;
+    readonly body: string;
+}
+export declare function assetsOf(block: AssetBlock, sourceDir: string, targetDir: string): readonly ConfigSyncAsset[];
+export declare function assetMapOf(blocks: readonly AssetBlock[], sourceDir: string, targetDir: string): Map<string, ConfigSyncAsset>;
+export declare function planCopies(assets: readonly ConfigSyncAsset[], sourceDir: string, targetDir: string, overwriteAssets: ReadonlySet<string>): {
+    ok: true;
+    plans: readonly CopyPlan[];
+} | {
+    ok: false;
+    text: string;
+};
+export declare function cleanupFiles(created: readonly string[], backups: ReadonlyMap<string, Buffer>): void;
+export declare function copyPlans(plans: readonly CopyPlan[]): {
+    ok: true;
+    files: string[];
+    created: string[];
+    backups: Map<string, Buffer>;
+} | {
+    ok: false;
+    text: string;
+    created: string[];
+    backups: Map<string, Buffer>;
+};

package/dist/config-sync-assets.js

@@ -0,0 +1,290 @@
+import { createHash } from 'node:crypto';
+import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const ASSET_MAX_BYTES = 8 * 1024 * 1024;
+const ASSET_MAX_TOTAL = 32 * 1024 * 1024;
+const ASSET_MAX_FILES = 500;
+const ASSET_SKIP = new Set(['node_modules', '.git', '.DS_Store']);
+function matched(text, pattern) {
+    const found = pattern.exec(text);
+    return found === null ? undefined : found[1];
+}
+function looksLikeAssetName(value) {
+    return value.startsWith('./') || value.startsWith('../') || value.startsWith('file://') || isAbsolute(value);
+}
+function insertNamesOf(body) {
+    if (!INSERT_LINE.test(body.split('\n')[0] ?? ''))
+        return [];
+    return body
+        .split('\n')
+        .flatMap((line) => {
+        const name = matched(line, NAME_LINE);
+        return name !== undefined && looksLikeAssetName(name) ? [name] : [];
+    });
+}
+function assetLocationOf(name, profileDir) {
+    let abs = null;
+    if (name.startsWith('file://')) {
+        try {
+            abs = fileURLToPath(name);
+        }
+        catch {
+            return null;
+        }
+    }
+    else if (name.startsWith('./') || name.startsWith('../')) {
+        abs = resolve(profileDir, name);
+    }
+    else if (isAbsolute(name)) {
+        abs = resolve(name);
+    }
+    if (abs === null)
+        return null;
+    const rel = relative(profileDir, abs);
+    if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || isAbsolute(rel)) {
+        return { kind: 'outside', path: name };
+    }
+    return { kind: 'inside', rel: rel.split(sep).join('/'), abs };
+}
+function hashOf(path) {
+    return createHash('sha1').update(readFileSync(path)).digest('hex');
+}
+function fileStateOf(source, target) {
+    try {
+        const sourceStat = statSync(source);
+        if (sourceStat.size > ASSET_MAX_BYTES)
+            return 'external';
+        let targetStat;
+        try {
+            targetStat = statSync(target);
+        }
+        catch {
+            return 'missing';
+        }
+        if (!targetStat.isFile() || targetStat.size !== sourceStat.size)
+            return 'differs';
+        return hashOf(source) === hashOf(target) ? 'same' : 'differs';
+    }
+    catch {
+        return 'external';
+    }
+}
+function collectDirFiles(dir, profileDir, found, budget) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        if (ASSET_SKIP.has(entry.name))
+            continue;
+        const abs = join(dir, entry.name);
+        const rel = relative(profileDir, abs).split(sep).join('/');
+        if (entry.isSymbolicLink())
+            return false;
+        if (entry.isDirectory()) {
+            if (!collectDirFiles(abs, profileDir, found, budget))
+                return false;
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        let size;
+        try {
+            size = statSync(abs).size;
+        }
+        catch {
+            return false;
+        }
+        if (size > ASSET_MAX_BYTES)
+            return false;
+        budget.bytes += size;
+        if (budget.bytes > ASSET_MAX_TOTAL || found.length >= ASSET_MAX_FILES)
+            return false;
+        found.push(rel);
+    }
+    return true;
+}
+function aggregateAssetState(files) {
+    if (files.some((file) => file.state === 'external'))
+        return 'external';
+    if (files.some((file) => file.state === 'differs'))
+        return 'differs';
+    if (files.some((file) => file.state === 'missing'))
+        return 'missing';
+    return 'same';
+}
+function externalAsset(path, reason) {
+    return {
+        key: `asset:${path}`,
+        path,
+        kind: 'file',
+        state: 'external',
+        files: [],
+        bytes: 0,
+        reason,
+    };
+}
+function assetOf(name, sourceDir, targetDir) {
+    const location = assetLocationOf(name, sourceDir);
+    if (location === null)
+        return null;
+    if (location.kind === 'outside')
+        return externalAsset(location.path, '这个文件在 profile 外面');
+    let sourceStat;
+    try {
+        sourceStat = lstatSync(location.abs);
+    }
+    catch {
+        return externalAsset(location.rel, '来源里没有这个文件');
+    }
+    if (sourceStat.isSymbolicLink())
+        return externalAsset(location.rel, '符号链接不会跟着搬');
+    if (sourceStat.isDirectory()) {
+        const found = [];
+        if (!collectDirFiles(location.abs, sourceDir, found, { bytes: 0 })) {
+            return externalAsset(location.rel, '目录太大或含符号链接，先手动复制');
+        }
+        const files = found.map((path) => {
+            const source = join(sourceDir, path);
+            const bytes = statSync(source).size;
+            return { path, state: fileStateOf(source, join(targetDir, path)), bytes };
+        });
+        return {
+            key: `asset:${location.rel}`,
+            path: location.rel,
+            kind: 'dir',
+            state: aggregateAssetState(files),
+            files,
+            bytes: files.reduce((sum, file) => sum + (file.bytes ?? 0), 0),
+        };
+    }
+    if (!sourceStat.isFile())
+        return externalAsset(location.rel, '不是普通文件');
+    const state = fileStateOf(location.abs, join(targetDir, location.rel));
+    return {
+        key: `asset:${location.rel}`,
+        path: location.rel,
+        kind: 'file',
+        state,
+        files: [{ path: location.rel, state, bytes: sourceStat.size }],
+        bytes: sourceStat.size,
+    };
+}
+export function assetsOf(block, sourceDir, targetDir) {
+    if (!block.insert)
+        return [];
+    const seen = new Set();
+    const assets = [];
+    for (const name of insertNamesOf(block.body)) {
+        const asset = assetOf(name, sourceDir, targetDir);
+        if (asset === null || seen.has(asset.key))
+            continue;
+        seen.add(asset.key);
+        assets.push(asset);
+    }
+    return assets;
+}
+export function assetMapOf(blocks, sourceDir, targetDir) {
+    const map = new Map();
+    for (const block of blocks) {
+        for (const asset of assetsOf(block, sourceDir, targetDir))
+            map.set(asset.key, asset);
+    }
+    return map;
+}
+function insideTarget(targetDir, path) {
+    const target = resolve(targetDir, path);
+    const rel = relative(targetDir, target);
+    return rel !== '' && rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
+}
+export function planCopies(assets, sourceDir, targetDir, overwriteAssets) {
+    const plans = [];
+    let total = 0;
+    for (const asset of assets) {
+        if (asset.state === 'external') {
+            return { ok: false, text: `这个文件搬不过来：${asset.path}${asset.reason === undefined ? '' : `（${asset.reason}）`}` };
+        }
+        for (const file of asset.files) {
+            if (file.state === 'same')
+                continue;
+            if (file.state === 'external') {
+                return { ok: false, text: `这个文件搬不过来：${file.path}${asset.reason === undefined ? '' : `（${asset.reason}）`}` };
+            }
+            const overwrite = file.state === 'differs';
+            if (overwrite && !overwriteAssets.has(asset.key)) {
+                return { ok: false, text: `文件不一样：${file.path}。勾上覆盖再试` };
+            }
+            if (!insideTarget(targetDir, file.path)) {
+                return { ok: false, text: `这个文件会写到 profile 外面：${file.path}` };
+            }
+            total += file.bytes ?? 0;
+            if (total > ASSET_MAX_TOTAL) {
+                return { ok: false, text: `这次要复制的文件太大（超过 ${String(ASSET_MAX_TOTAL / 1024 / 1024)} MB），先手动复制` };
+            }
+            plans.push({
+                source: join(sourceDir, file.path),
+                target: join(targetDir, file.path),
+                path: file.path,
+                overwrite,
+            });
+        }
+    }
+    return { ok: true, plans };
+}
+export function cleanupFiles(created, backups) {
+    for (const file of [...created].reverse()) {
+        try {
+            unlinkSync(file);
+        }
+        catch {
+            continue;
+        }
+    }
+    for (const [file, body] of backups) {
+        try {
+            writeFileSync(file, body);
+        }
+        catch {
+            continue;
+        }
+    }
+}
+export function copyPlans(plans) {
+    const created = [];
+    const backups = new Map();
+    const files = [];
+    for (const plan of plans) {
+        try {
+            mkdirSync(dirname(plan.target), { recursive: true });
+            if (existsSync(plan.target)) {
+                if (!plan.overwrite)
+                    continue;
+                backups.set(plan.target, readFileSync(plan.target));
+            }
+            else {
+                created.push(plan.target);
+            }
+            const mode = statSync(plan.source).mode & 0o777;
+            const tmp = `${plan.target}.wb-sync-${String(process.pid)}-${String(files.length)}`;
+            copyFileSync(plan.source, tmp);
+            chmodSync(tmp, mode);
+            renameSync(tmp, plan.target);
+            files.push(plan.path);
+        }
+        catch (error) {
+            return {
+                ok: false,
+                text: `写不进去：${error instanceof Error ? error.message : String(error)}`,
+                created,
+                backups,
+            };
+        }
+    }
+    return { ok: true, files, created, backups };
+}

package/dist/config-sync.d.ts

@@ -0,0 +1,48 @@
+import type { PostResource, RouteHandler } from '@dsh-workbench/shared/host';
+import type { ConfigSyncRow, ConfigSyncSnapshot } from '@dsh-workbench/shared/contract/protocol/config-sync';
+export interface PatchBlock {
+    readonly key: string;
+    readonly id: string;
+    readonly insert: boolean;
+    readonly body: string;
+    readonly names: readonly string[];
+}
+export declare function patchBlocks(text: string): PatchBlock[];
+export declare function normalizeBlock(body: string): string;
+export declare function syncRows(source: readonly PatchBlock[], own: readonly PatchBlock[], missing: (block: PatchBlock) => readonly string[]): ConfigSyncRow[];
+export declare function mergeBlocks(ownText: string, incoming: readonly PatchBlock[], overwrite: ReadonlySet<string>): {
+    ok: true;
+    text: string;
+    written: string[];
+    skipped: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function readPatchBlocks(path: string): {
+    ok: true;
+    text: string;
+    blocks: PatchBlock[];
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function writePatchFile(path: string, text: string): void;
+export interface ConfigSyncDeps {
+    readonly home: string;
+    readonly self: string;
+    readonly profileDir: string | null;
+    readonly reconcile?: (() => Promise<boolean | void>) | undefined;
+}
+export declare function configSyncHandler(deps: ConfigSyncDeps): RouteHandler;
+export declare function configSyncSnapshot(deps: ConfigSyncDeps, asked?: string): ConfigSyncSnapshot;
+export declare function configSyncApply(deps: ConfigSyncDeps, payload: unknown): Promise<{
+    ok: true;
+    written: string[];
+    skipped: string[];
+    verified: boolean;
+} | {
+    ok: false;
+    text: string;
+}>;
+export declare function configSyncAction(deps: ConfigSyncDeps): PostResource;

package/dist/config-sync.js

@@ -0,0 +1,342 @@
+import { existsSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONFIG_SYNC_RESOURCE } from '@dsh-workbench/shared/contract/protocol/config-sync';
+const ID_LINE = /^- id:[ \t]*"?([^"\s#]+)/;
+const INSERT_LINE = /^- insert:[ \t]*$/;
+const NESTED_ID = /^[ \t]+-[ \t]*id:[ \t]*"?([^"\s#]+)/;
+const NAME_LINE = /^[ \t]*-?[ \t]*name:[ \t]*['"]?([^'"\s#]+)/;
+const COMMENT_LINE = /^[ \t]*#/;
+const ISOLATION_IDS = new Set([
+    'session-persistence-jsonl',
+    'storage-json',
+    'attachment-local',
+    'sandbox-policy',
+]);
+function trimmedTail(lines) {
+    let end = lines.length;
+    while (end > 0 && (lines[end - 1] ?? '').trim() === '')
+        end -= 1;
+    return lines.slice(0, end);
+}
+function matched(text, pattern) {
+    const found = pattern.exec(text);
+    return found === null ? undefined : found[1];
+}
+function blockOf(body, index) {
+    const lines = body.split('\n');
+    const first = lines[0] ?? '';
+    const id = matched(first, ID_LINE);
+    const nested = lines.flatMap((line) => {
+        const one = matched(line, NESTED_ID);
+        return one === undefined ? [] : [one];
+    });
+    const insert = id === undefined && INSERT_LINE.test(first);
+    const label = id ?? nested.join(', ');
+    const key = id !== undefined ? `id:${id}` : insert ? `insert:${nested.join(', ')}` : `block:${String(index)}`;
+    const names = lines.flatMap((line) => {
+        const one = matched(line, NAME_LINE);
+        return one === undefined ? [] : [one];
+    });
+    return { key, id: label === '' ? key : label, insert, body, names };
+}
+function spannedBlocks(text) {
+    const lines = text.split('\n');
+    const starts = [];
+    lines.forEach((line, index) => {
+        if (/^- /.test(line) || line === '-')
+            starts.push(index);
+    });
+    const blocks = [];
+    for (let i = 0; i < starts.length; i += 1) {
+        const from = starts[i] ?? 0;
+        const to = i + 1 < starts.length ? (starts[i + 1] ?? lines.length) : lines.length;
+        const body = trimmedTail(lines.slice(from, to)).join('\n');
+        if (body.trim() === '')
+            continue;
+        blocks.push({ ...blockOf(body, blocks.length), from, to });
+    }
+    return blocks;
+}
+export function patchBlocks(text) {
+    return spannedBlocks(text).map(({ from: _from, to: _to, ...block }) => block);
+}
+export function normalizeBlock(body) {
+    return body
+        .split('\n')
+        .map((line) => line.replace(/\s+$/, ''))
+        .filter((line) => line.trim() !== '' && !COMMENT_LINE.test(line))
+        .join('\n');
+}
+function rewriteForTarget(body, self) {
+    if (self === '' || self === 'workbench')
+        return body;
+    return body.replace(/(dshHomePath\(\s*['"])workbench(?=[/'"])/g, `$1${self}`);
+}
+function syncable(block) {
+    return !block.insert && !ISOLATION_IDS.has(block.id);
+}
+export function syncRows(source, own, missing) {
+    const mine = new Map(own.map((block) => [block.key, block]));
+    const rows = [];
+    for (const block of source) {
+        if (!syncable(block))
+            continue;
+        const here = mine.get(block.key);
+        if (here !== undefined && normalizeBlock(here.body) === normalizeBlock(block.body))
+            continue;
+        rows.push({
+            key: block.key,
+            id: block.id,
+            state: here === undefined ? 'new' : 'differs',
+            body: block.body,
+            ownBody: here === undefined ? null : here.body,
+            missing: missing(block),
+        });
+    }
+    return rows;
+}
+function replaceBlocks(text, blocks) {
+    const wanted = new Map(blocks.map((block) => [block.key, block]));
+    const spans = spannedBlocks(text).filter((span) => wanted.has(span.key));
+    const lines = text.split('\n');
+    for (const span of [...spans].reverse()) {
+        const replacement = (wanted.get(span.key)?.body ?? '').split('\n');
+        lines.splice(span.from, span.to - span.from, ...replacement);
+    }
+    return lines.join('\n');
+}
+function appendBlocks(text, blocks) {
+    const kept = text
+        .split('\n')
+        .filter((line) => line.trim() !== '[]')
+        .join('\n')
+        .replace(/\s+$/, '');
+    let out = kept === '' ? '' : `${kept}\n`;
+    for (const block of blocks)
+        out += `\n${block.body}\n`;
+    return out;
+}
+export function mergeBlocks(ownText, incoming, overwrite) {
+    const own = patchBlocks(ownText);
+    const mine = new Set(own.map((block) => block.key));
+    const written = [];
+    const skipped = [];
+    const take = [];
+    for (const block of incoming) {
+        if (!mine.has(block.key) || overwrite.has(block.key)) {
+            take.push(block);
+            written.push(block.id);
+            continue;
+        }
+        skipped.push(block.id);
+    }
+    if (take.length === 0)
+        return { ok: true, text: ownText, written, skipped };
+    const replaced = replaceBlocks(ownText, take.filter((block) => mine.has(block.key)));
+    const text = appendBlocks(replaced, take.filter((block) => !mine.has(block.key)));
+    const check = patchBlocks(text);
+    const expected = new Set([...mine, ...take.map((block) => block.key)]);
+    if (check.length !== expected.size || new Set(check.map((block) => block.key)).size !== expected.size) {
+        return { ok: false, reason: '写入前的自检没过：行的 id 会重复或丢行' };
+    }
+    return { ok: true, text, written, skipped };
+}
+export function readPatchBlocks(path) {
+    try {
+        const text = readFileSync(path, 'utf8');
+        return { ok: true, text, blocks: patchBlocks(text) };
+    }
+    catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+function patchMode(path) {
+    try {
+        return statSync(path).mode & 0o777;
+    }
+    catch {
+        return 0o644;
+    }
+}
+export function writePatchFile(path, text) {
+    const mode = patchMode(path);
+    const tmp = `${path}.wb-sync-${String(process.pid)}`;
+    writeFileSync(tmp, text, { mode });
+    try {
+        renameSync(tmp, path);
+    }
+    catch (error) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+            throw error;
+        }
+        throw error;
+    }
+}
+export function configSyncHandler(deps) {
+    return (search) => ({ ok: true, ...configSyncSnapshot(deps, search.get('source') ?? undefined) });
+}
+function textOf(value) {
+    return typeof value === 'string' ? value : '';
+}
+function profileDependencies(dir) {
+    try {
+        const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        return new Set(Object.keys(manifest.dependencies ?? {}));
+    }
+    catch {
+        return new Set();
+    }
+}
+function profileNames(profilesDir) {
+    try {
+        return readdirSync(profilesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+            .map((entry) => entry.name)
+            .filter((name) => existsSync(join(profilesDir, name, 'package.json')))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export function configSyncSnapshot(deps, asked) {
+    const profilesDir = join(deps.home, 'profiles');
+    const names = profileNames(profilesDir);
+    const others = names.filter((name) => name !== deps.self);
+    const base = {
+        self: deps.self,
+        home: deps.home,
+    };
+    if (deps.profileDir === null) {
+        return {
+            ...base,
+            source: '',
+            profiles: [],
+            rows: [],
+            emptyProviders: false,
+            reason: '拿不到当前 profile 目录',
+        };
+    }
+    const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+    const emptyProviders = own.ok && !own.blocks.some((block) => block.key.startsWith('id:llm-'));
+    const ownBlocks = own.ok ? own.blocks : [];
+    const profiles = others.map((name) => {
+        const read = readPatchBlocks(join(profilesDir, name, 'cordis.patch.yml'));
+        const blocks = read.ok
+            ? read.blocks
+                .filter(syncable)
+                .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }))
+            : [];
+        return {
+            name,
+            readable: read.ok,
+            candidates: read.ok ? syncRows(blocks, ownBlocks, () => []).length : 0,
+        };
+    });
+    if (others.length === 0) {
+        return {
+            ...base,
+            source: '',
+            profiles,
+            rows: [],
+            emptyProviders,
+            reason: '这台机器上只有当前这个 profile，没有可同步的来源',
+        };
+    }
+    const source = others.includes(asked ?? '') ? (asked ?? '') : others.includes('web') ? 'web' : (others[0] ?? '');
+    const sourceDir = join(profilesDir, source);
+    const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+    if (!read.ok) {
+        return { ...base, source, profiles, rows: [], emptyProviders, reason: read.reason };
+    }
+    if (!own.ok) {
+        return { ...base, source, profiles, rows: [], emptyProviders, reason: own.reason };
+    }
+    const declared = profileDependencies(sourceDir);
+    const modulesDir = join(deps.profileDir, 'node_modules');
+    const sourceBlocks = read.blocks
+        .filter(syncable)
+        .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+    const rows = syncRows(sourceBlocks, own.blocks, (block) => block.names.filter((name) => declared.has(name) && !existsSync(join(modulesDir, name))));
+    return { ...base, source, profiles, rows, emptyProviders };
+}
+export async function configSyncApply(deps, payload) {
+    if (deps.profileDir === null)
+        return { ok: false, text: '拿不到当前 profile 目录，这次没写任何东西' };
+    const body = typeof payload === 'object' && payload !== null ? payload : {};
+    const source = textOf(body['source']);
+    const keys = new Set((Array.isArray(body['keys']) ? body['keys'] : []).map((item) => textOf(item)).filter((item) => item !== ''));
+    const overwrite = new Set((Array.isArray(body['overwrite']) ? body['overwrite'] : []).map((item) => textOf(item)));
+    if (source === '' || keys.size === 0) {
+        return { ok: false, text: '没说清从哪个 profile 同步哪几行' };
+    }
+    const profilesDir = join(deps.home, 'profiles');
+    if (!profileNames(profilesDir).includes(source))
+        return { ok: false, text: `没有这个 profile：${source}` };
+    if (source === deps.self)
+        return { ok: false, text: '来源不能是工作台自己' };
+    const sourceDir = join(profilesDir, source);
+    const read = readPatchBlocks(join(sourceDir, 'cordis.patch.yml'));
+    if (!read.ok)
+        return { ok: false, text: `读不到 ${source} 的配置：${read.reason}` };
+    const own = readPatchBlocks(join(deps.profileDir, 'cordis.patch.yml'));
+    if (!own.ok)
+        return { ok: false, text: `读不到工作台自己的配置：${own.reason}` };
+    if (read.blocks.some((block) => block.insert && keys.has(block.key))) {
+        return { ok: false, text: '插件行不同步：先把插件装到工作台这边，再同步它的设置' };
+    }
+    const picked = read.blocks
+        .filter((block) => keys.has(block.key) && syncable(block))
+        .map((block) => ({ ...block, body: rewriteForTarget(block.body, deps.self) }));
+    if (picked.length === 0) {
+        return { ok: false, text: '选中的行在来源里已经找不到了，重新读一遍再试' };
+    }
+    const merged = mergeBlocks(own.text, picked, overwrite);
+    if (!merged.ok)
+        return { ok: false, text: merged.reason };
+    const patchPath = join(deps.profileDir, 'cordis.patch.yml');
+    const patchChanged = merged.text !== own.text;
+    try {
+        if (patchChanged)
+            writePatchFile(patchPath, merged.text);
+    }
+    catch (error) {
+        return { ok: false, text: `写不进去：${error instanceof Error ? error.message : String(error)}` };
+    }
+    if (deps.reconcile === undefined) {
+        return { ok: true, written: merged.written, skipped: merged.skipped, verified: false };
+    }
+    try {
+        const verified = await deps.reconcile();
+        if (verified === false) {
+            return { ok: true, written: merged.written, skipped: merged.skipped, verified: false };
+        }
+    }
+    catch (error) {
+        if (patchChanged) {
+            try {
+                writePatchFile(patchPath, own.text);
+            }
+            catch {
+                return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。原来的设置没能恢复，手动检查一下` };
+            }
+        }
+        try {
+            await deps.reconcile();
+        }
+        catch {
+            return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+        }
+        return { ok: false, text: `写进去了，但启动检查没通过：${error instanceof Error ? error.message : String(error)}。已恢复原来的设置` };
+    }
+    return { ok: true, written: merged.written, skipped: merged.skipped, verified: true };
+}
+export function configSyncAction(deps) {
+    return {
+        resource: CONFIG_SYNC_RESOURCE,
+        handle: (payload) => configSyncApply(deps, payload),
+    };
+}

package/dist/host-actions.d.ts

@@ -1,7 +1,7 @@
-import type { HostActions, ProfileCreateDeps } from '@dsh-workbench/shared/host';
-export declare function runSetupAt(packageRoot: string, env: Readonly<Record<string, string>>): Promise<{
+import type { HostActions, ProfileCreateDeps, Seam } from '@dsh-workbench/shared/host';
+export declare function runSetupAt(seam: Seam, packageRoot: string, env: Readonly<Record<string, string>>): Promise<{
     ok: boolean;
     log: string;
 }>;
 export declare function createHostActions(): HostActions;
-export declare function profileCreateDepsOf(deps: Omit<ProfileCreateDeps, 'runSetup'>): ProfileCreateDeps;
+export declare function profileCreateDepsOf(seam: Seam, deps: Omit<ProfileCreateDeps, 'runSetup'>): ProfileCreateDeps;

package/dist/host-actions.js

@@ -1,28 +1,30 @@
-import { execa } from 'execa';
 import { join } from 'node:path';
 import { configSyncAction, configSyncHandler, profileCreateAction, profileCreateHandler, } from '@dsh-workbench/shared/host';
 const SETUP_TIMEOUT_MS = 10 * 60 * 1000;
-export function runSetupAt(packageRoot, env) {
+const LOG_TAIL_CHARS = 20_000;
+function tailOf(stdout, stderr) {
+    return `${stdout}${stderr}`.slice(-LOG_TAIL_CHARS);
+}
+export async function runSetupAt(seam, packageRoot, env) {
     const bin = join(packageRoot, 'bin', 'dsh-workbench');
-    let log = '';
-    const child = execa('bash', [bin, 'setup'], {
-        cwd: packageRoot,
-        env: { ...process.env, ...env },
-        stdio: ['ignore', 'pipe', 'pipe'],
-        timeout: SETUP_TIMEOUT_MS,
-        reject: false,
-        windowsHide: true,
-    });
-    const collect = (chunk) => {
-        log = `${log}${chunk.toString('utf8')}`.slice(-20_000);
-    };
-    child.stdout?.on('data', collect);
-    child.stderr?.on('data', collect);
-    return child.then((result) => (result.timedOut === true ? { ok: false, log: `${log}\n创建超时` } : { ok: result.exitCode === 0, log }), (error) => ({ ok: false, log: `${log}\n${error instanceof Error ? error.message : String(error)}` }));
+    try {
+        const outcome = await seam.run({
+            argv: ['bash', bin, 'setup'],
+            intent: { kind: 'host' },
+            workdir: packageRoot,
+            env,
+            timeoutMs: SETUP_TIMEOUT_MS,
+        });
+        const log = tailOf(outcome.stdout, outcome.stderr);
+        return outcome.timedOut ? { ok: false, log: `${log}\n创建超时` } : { ok: outcome.exitCode === 0, log };
+    }
+    catch (error) {
+        return { ok: false, log: `\n${error instanceof Error ? error.message : String(error)}` };
+    }
 }
 export function createHostActions() {
     return { configSyncAction, configSyncHandler, profileCreateAction, profileCreateHandler };
 }
-export function profileCreateDepsOf(deps) {
-    return { ...deps, runSetup: (env) => runSetupAt(deps.packageRoot, env) };
+export function profileCreateDepsOf(seam, deps) {
+    return { ...deps, runSetup: (env) => runSetupAt(seam, deps.packageRoot, env) };
 }

package/dist/profile-create.d.ts

@@ -0,0 +1,18 @@
+import type { PostResource, RouteHandler } from '@dsh-workbench/shared/host';
+import type { ProfileCreateApplied, ProfileCreateSnapshot } from '@dsh-workbench/shared/contract/protocol/profile-create';
+export interface ProfileCreateDeps {
+    readonly home: string;
+    readonly self: string;
+    readonly packageRoot: string;
+    readonly runSetup?: ((env: Readonly<Record<string, string>>) => Promise<{
+        ok: boolean;
+        log: string;
+    }>) | undefined;
+}
+export declare function profileCreateSnapshot(deps: ProfileCreateDeps): ProfileCreateSnapshot;
+export declare function profileCreateHandler(deps: ProfileCreateDeps): RouteHandler;
+export declare function profileCreateApply(deps: ProfileCreateDeps, payload: unknown): Promise<ProfileCreateApplied | {
+    ok: false;
+    text: string;
+}>;
+export declare function profileCreateAction(deps: ProfileCreateDeps): PostResource;

package/dist/profile-create.js

@@ -0,0 +1,143 @@
+import { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import { execa } from 'execa';
+import { quoteShellArg } from '@dsh-workbench/shared/host';
+import { PROFILE_CREATE_RESOURCE } from '@dsh-workbench/shared/contract/protocol/profile-create';
+const PROFILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;
+const BUNDLE = '@dsh-workbench/core';
+const SETUP_TIMEOUT_MS = 10 * 60 * 1000;
+function textOf(value) {
+    return typeof value === 'string' ? value : '';
+}
+function profileNames(profilesDir) {
+    try {
+        return readdirSync(profilesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+            .map((entry) => entry.name)
+            .filter((name) => existsSync(join(profilesDir, name, 'package.json')))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export function profileCreateSnapshot(deps) {
+    const profiles = profileNames(join(deps.home, 'profiles')).map((name) => ({
+        name,
+        current: name === deps.self,
+        readable: true,
+    }));
+    return { current: deps.self, profiles };
+}
+export function profileCreateHandler(deps) {
+    return () => ({ ok: true, ...profileCreateSnapshot(deps) });
+}
+function inside(base, path) {
+    const root = resolve(base);
+    const target = resolve(path);
+    return target === root ? false : target.startsWith(`${root}${sep}`);
+}
+async function defaultRunSetup(packageRoot, env) {
+    const bin = join(packageRoot, 'bin', 'dsh-workbench');
+    let log = '';
+    const collect = (chunk) => {
+        log = `${log}${chunk.toString('utf8')}`.slice(-20_000);
+    };
+    try {
+        const child = execa('bash', [bin, 'setup'], {
+            cwd: packageRoot,
+            env: { ...process.env, ...env },
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: SETUP_TIMEOUT_MS,
+            reject: false,
+            windowsHide: true,
+        });
+        child.stdout?.on('data', collect);
+        child.stderr?.on('data', collect);
+        const result = await child;
+        if (result.timedOut)
+            return { ok: false, log: `${log}\n创建超时` };
+        return { ok: result.exitCode === 0, log };
+    }
+    catch (error) {
+        return { ok: false, log: `${log}\n${error instanceof Error ? error.message : String(error)}` };
+    }
+}
+export async function profileCreateApply(deps, payload) {
+    const body = typeof payload === 'object' && payload !== null ? payload : {};
+    const profile = textOf(body['profile']).trim();
+    const source = textOf(body['source']).trim();
+    const copy = typeof body['copy'] === 'object' && body['copy'] !== null ? body['copy'] : {};
+    const flags = {
+        settings: copy['settings'] === true,
+    };
+    if (!PROFILE_NAME.test(profile))
+        return { ok: false, text: '新工作台的名字不合法：只用字母、数字、点、下划线或短横线' };
+    if (source === '')
+        return { ok: false, text: '先选一个来源 profile' };
+    if (source === profile)
+        return { ok: false, text: '来源不能是新工作台自己' };
+    const profilesDir = join(deps.home, 'profiles');
+    if (!profileNames(profilesDir).includes(source))
+        return { ok: false, text: `没有这个 profile：${source}` };
+    if (existsSync(join(profilesDir, profile)))
+        return { ok: false, text: `已经有一个叫 ${profile} 的 profile` };
+    const targetHome = join(deps.home, profile);
+    if (existsSync(targetHome))
+        return { ok: false, text: `运行时目录已经存在：${targetHome}` };
+    const env = {
+        DSH_HOME: deps.home,
+        DSH_WORKBENCH_HOME: targetHome,
+        WORKBENCH_PROFILE: profile,
+        WORKBENCH_SOURCE_PROFILE: source,
+        WB_CLONE: '1',
+        WB_COPY_SETTINGS: flags.settings ? '1' : '0',
+    };
+    const setup = deps.runSetup ?? ((next) => defaultRunSetup(deps.packageRoot, next));
+    const cleanup = () => {
+        try {
+            if (inside(profilesDir, join(profilesDir, profile)))
+                rmSync(join(profilesDir, profile), { recursive: true, force: true });
+            if (inside(deps.home, targetHome))
+                rmSync(targetHome, { recursive: true, force: true });
+        }
+        catch {
+            return;
+        }
+    };
+    const result = await setup(env);
+    if (!result.ok) {
+        cleanup();
+        return { ok: false, text: `创建失败：${result.log.trim().slice(-1200) || 'setup 没给出原因'}` };
+    }
+    try {
+        const manifest = JSON.parse(readFileSync(join(profilesDir, profile, 'package.json'), 'utf8'));
+        const bundles = manifest.dsh?.profile?.bundles;
+        if (!Array.isArray(bundles) || !bundles.includes(BUNDLE)) {
+            cleanup();
+            return { ok: false, text: 'profile 建好了，但工作台 bundle 没被选中；先跑一次 setup 修好它' };
+        }
+    }
+    catch (error) {
+        cleanup();
+        return { ok: false, text: `profile 建好了，但读不了清单：${error instanceof Error ? error.message : String(error)}` };
+    }
+    const copied = Object.entries(flags)
+        .filter(([, on]) => on)
+        .map(([name]) => name);
+    const bin = join(deps.packageRoot, 'bin', 'dsh-workbench');
+    return {
+        ok: true,
+        profile,
+        source,
+        home: targetHome,
+        command: `WORKBENCH_PROFILE=${quoteShellArg(profile)} ${quoteShellArg(bin)}`,
+        copied,
+    };
+}
+export function profileCreateAction(deps) {
+    return {
+        resource: PROFILE_CREATE_RESOURCE,
+        handle: (payload) => profileCreateApply(deps, payload),
+    };
+}

package/dist/profile-registries.d.ts

@@ -0,0 +1,32 @@
+export interface BundleChange {
+    readonly pkg?: string;
+    readonly registry?: string;
+    readonly application?: string;
+    readonly packageResult?: {
+        readonly kind?: string;
+        readonly output?: string;
+    };
+    readonly errorDetail?: string;
+}
+export interface RegistryEntry {
+    readonly scope: string;
+    readonly registry: string;
+}
+export interface RegistryNotebook {
+    sources(): readonly RegistryEntry[];
+    remember(entries: readonly RegistryEntry[]): readonly string[];
+    swapScope?(scope: string, registry: string): () => void;
+}
+export declare const REGISTRY_MARKER = "# dsh-workbench \u5199\u7684\uFF1A\u8FD9\u4E00\u884C\u7684\u5305\u53EA\u5728\u8FD9\u4E2A\u6E90\u4E0A\uFF08dsh \u5378\u8F7D\u6CA1\u6709\u6E90\u53C2\u6570\uFF0Cpnpm \u5F97\u95EE\u5F97\u5230\uFF09";
+export declare function scopeOf(pkg: string): string | null;
+export declare function normalizeRegistry(url: string): string;
+export declare function sameRegistry(a: string | null | undefined, b: string | null | undefined): boolean;
+export declare function sourcesFromLockfile(text: string): readonly RegistryEntry[];
+export interface RegistryConfigMerge {
+    readonly text: string;
+    readonly added: readonly string[];
+}
+export declare function mergeRegistryConfig(text: string, entries: readonly RegistryEntry[]): RegistryConfigMerge;
+export declare function replaceScopeRegistry(text: string, scope: string, registry: string): string;
+export declare function registryFailure(change: BundleChange): boolean;
+export declare function createRegistryNotebook(dir: string | null): RegistryNotebook;

package/dist/profile-registries.js

@@ -0,0 +1,172 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const REGISTRY_MARKER = '# dsh-workbench 写的：这一行的包只在这个源上（dsh 卸载没有源参数，pnpm 得问得到）';
+export function scopeOf(pkg) {
+    const slash = pkg.indexOf('/');
+    return pkg.startsWith('@') && slash > 1 ? pkg.slice(0, slash) : null;
+}
+export function normalizeRegistry(url) {
+    const trimmed = url.trim();
+    return trimmed.endsWith('/') ? trimmed : `${trimmed}/`;
+}
+export function sameRegistry(a, b) {
+    if (a === null || a === undefined || b === null || b === undefined)
+        return false;
+    if (a.trim() === '' || b.trim() === '')
+        return false;
+    return normalizeRegistry(a) === normalizeRegistry(b);
+}
+function registryRootOf(name, tarball) {
+    const at = tarball.indexOf(`/${name}/-/`);
+    if (at > 0)
+        return normalizeRegistry(tarball.slice(0, at));
+    try {
+        return normalizeRegistry(new URL(tarball).origin);
+    }
+    catch {
+        return null;
+    }
+}
+const PACKAGE_KEY = /^ {2}'?(\S+)'?:\s*$/;
+const PACKAGE_NAME = /^(?:@[^/\s]+\/)?[^/\s@]+$/;
+const TARBALL = /tarball:\s*(\S+?)\}?\s*$/;
+export function sourcesFromLockfile(text) {
+    const found = new Map();
+    let name = null;
+    for (const line of text.split('\n')) {
+        const key = PACKAGE_KEY.exec(line);
+        if (key !== null) {
+            const raw = key[1] ?? '';
+            const at = raw.lastIndexOf('@');
+            const candidate = at > 0 ? raw.slice(0, at) : '';
+            name = PACKAGE_NAME.test(candidate) ? candidate : null;
+            continue;
+        }
+        if (name === null)
+            continue;
+        const tarball = TARBALL.exec(line);
+        if (tarball === null)
+            continue;
+        const scope = scopeOf(name);
+        const root = registryRootOf(name, tarball[1] ?? '');
+        name = null;
+        if (scope === null || root === null)
+            continue;
+        const seen = found.get(scope);
+        if (seen === undefined)
+            found.set(scope, root);
+        else if (!sameRegistry(seen, root))
+            found.set(scope, null);
+    }
+    return [...found.entries()]
+        .filter((entry) => entry[1] !== null)
+        .map(([scope, registry]) => ({ scope, registry }));
+}
+export function mergeRegistryConfig(text, entries) {
+    const lines = text.split('\n');
+    const present = (key) => lines.some((line) => line.trim().startsWith(`${key}=`));
+    const appended = [];
+    const added = [];
+    for (const entry of entries) {
+        const key = `${entry.scope}:registry`;
+        if (entry.registry.trim() === '' || present(key))
+            continue;
+        lines.push(`${key}=${normalizeRegistry(entry.registry)}`);
+        appended.push(`${key}=${normalizeRegistry(entry.registry)}`);
+        added.push(key);
+    }
+    if (appended.length === 0)
+        return { text, added: [] };
+    const base = text === '' ? '' : text.endsWith('\n') ? text : `${text}\n`;
+    const marker = base.includes(REGISTRY_MARKER) ? '' : `${REGISTRY_MARKER}\n`;
+    return { text: `${base}${marker}${appended.join('\n')}\n`, added };
+}
+export function replaceScopeRegistry(text, scope, registry) {
+    const key = `${scope}:registry`;
+    const value = normalizeRegistry(registry);
+    let found = false;
+    const lines = text.split('\n').map((line) => {
+        if (!line.trim().startsWith(`${key}=`))
+            return line;
+        found = true;
+        return `${key}=${value}`;
+    });
+    if (found)
+        return lines.join('\n');
+    const base = text === '' ? '' : text.endsWith('\n') ? text : `${text}\n`;
+    return `${base}${key}=${value}\n`;
+}
+function readNpmrc(file) {
+    try {
+        return fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+function writeNpmrc(file, text) {
+    const temp = `${file}.dsh-workbench.tmp`;
+    fs.writeFileSync(temp, text, { mode: 0o600 });
+    fs.renameSync(temp, file);
+}
+export function registryFailure(change) {
+    if (change.application !== 'failed')
+        return false;
+    if (change.packageResult?.kind === 'not-found')
+        return true;
+    const output = change.packageResult?.output ?? change.errorDetail ?? '';
+    return /ERR_PNPM_[A-Z_]*FETCH/.test(output);
+}
+export function createRegistryNotebook(dir) {
+    return {
+        sources() {
+            if (dir === null)
+                return [];
+            try {
+                return sourcesFromLockfile(fs.readFileSync(path.join(dir, 'pnpm-lock.yaml'), 'utf8'));
+            }
+            catch {
+                return [];
+            }
+        },
+        remember(entries) {
+            if (dir === null || entries.length === 0)
+                return [];
+            const file = path.join(dir, '.npmrc');
+            const merged = mergeRegistryConfig(readNpmrc(file), entries);
+            if (merged.added.length === 0)
+                return [];
+            writeNpmrc(file, merged.text);
+            return merged.added;
+        },
+        swapScope(scope, registry) {
+            if (dir === null || scope.trim() === '' || registry.trim() === '')
+                return () => { };
+            const file = path.join(dir, '.npmrc');
+            const key = `${scope.trim()}:registry`;
+            const value = normalizeRegistry(registry);
+            const before = readNpmrc(file);
+            const previous = before.split('\n').find((line) => line.trim().startsWith(`${key}=`));
+            const after = replaceScopeRegistry(before, scope.trim(), registry);
+            if (after === before)
+                return () => { };
+            writeNpmrc(file, after);
+            return () => {
+                const now = readNpmrc(file);
+                if (now === after) {
+                    if (before === '')
+                        fs.rmSync(file, { force: true });
+                    else
+                        writeNpmrc(file, before);
+                    return;
+                }
+                if (!now.includes(`${key}=${value}`))
+                    return;
+                const restored = previous === undefined
+                    ? now.split('\n').filter((line) => !line.trim().startsWith(`${key}=`)).join('\n')
+                    : now.replace(`${key}=${value}`, previous);
+                writeNpmrc(file, restored);
+            };
+        },
+    };
+}

package/dist/release.d.ts

@@ -1,24 +1,24 @@
-import type { DshShell } from '@dsh-workbench/shared';
 import type { PluginRelease } from '@dsh-workbench/shared';
+import type { Seam } from '@dsh-workbench/shared/host';
 import { parseLedgerVersion } from '@dsh-workbench/shared/host';
 export { parseLedgerVersion };
 export { compareVersions, isNewerVersion } from '@dsh-workbench/shared/host';
 export interface ReleasePort {
     latestVersion(options: {
-        readonly shell: DshShell;
+        readonly seam: Seam;
         readonly name: string;
         readonly registry: string;
         readonly force?: boolean;
     }): Promise<string | undefined>;
     missingReleaseParts(options: {
-        readonly shell: DshShell;
+        readonly seam: Seam;
         readonly name: string;
         readonly registry: string;
         readonly version: string;
         readonly force?: boolean;
     }): Promise<readonly string[]>;
     probeRelease(options: {
-        readonly shell: DshShell;
+        readonly seam: Seam;
         readonly package: string;
         readonly registry?: string | undefined;
         readonly force?: boolean;
@@ -26,6 +26,5 @@ export interface ReleasePort {
     reset(): void;
 }
 export declare function createReleasePort(options: {
-    readonly cacheDir: string;
     readonly prefix: string;
 }): ReleasePort;

package/dist/release.js

@@ -4,9 +4,9 @@ export { compareVersions, isNewerVersion } from '@dsh-workbench/shared/host';
 export function createReleasePort(options) {
     const probe = createReleaseProbe();
     return {
-        latestVersion: (call) => probe.latestVersion({ ...call, cacheDir: options.cacheDir }),
-        missingReleaseParts: (call) => probe.missingReleaseParts({ ...call, cacheDir: options.cacheDir }),
-        probeRelease: (call) => probe.probeRelease({ ...call, cacheDir: options.cacheDir, prefix: options.prefix }),
+        latestVersion: (call) => probe.latestVersion(call),
+        missingReleaseParts: (call) => probe.missingReleaseParts(call),
+        probeRelease: (call) => probe.probeRelease({ ...call, prefix: options.prefix }),
         reset: () => {
             probe.reset();
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/adapter-profile",
-  "version": "1.1.14-beta.2",
+  "version": "1.1.14",
   "description": "Workbench profile adapter package.",
   "type": "module",
   "exports": {
@@ -24,15 +24,12 @@
   "devDependencies": {
     "@types/node": "^24.19.0",
     "@types/proper-lockfile": "^4.1.4",
-    "@types/write-file-atomic": "^4.0.3",
     "vitest": "^5.0.2",
     "@vitest/coverage-v8": "^5.0.2"
   },
   "dependencies": {
-    "execa": "^10.2.0",
     "proper-lockfile": "^4.1.2",
-    "write-file-atomic": "^8.0.0",
-    "@dsh-workbench/shared": "1.1.14-beta.2"
+    "@dsh-workbench/shared": "1.1.14"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",