@dsh-workbench/shared 0.1.14 → 0.1.16

package/dist/host/browser-read.js

@@ -0,0 +1,240 @@
+import { parseJsonLoose, tailLines } from '../lib/text.js';
+import { backgroundLine } from './opencli-window.js';
+import { runShell } from './shell.js';
+export const BROWSER_BRIDGE_SESSION = 'workbench';
+const DEFAULT_TIMEOUT_MS = 25000;
+const DEFAULT_RETRY_MS = 1200;
+const DEFAULT_SETTLE_MS = 900;
+const AUTH_CODES = new Set([
+    'NOT_LOGGED_IN',
+    'NOT_LOGIN',
+    'AUTH_FAILED',
+    'AUTH_REQUIRED',
+    'UNAUTHENTICATED',
+    'UNAUTHORIZED',
+    'TOKEN_EXPIRED',
+]);
+const PERMISSION_CODES = new Set(['FORBIDDEN', 'PERMISSION_DENIED', 'NO_PERMISSION', 'EACCES']);
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+function textOf(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function codeOf(page) {
+    const record = asRecord(page);
+    return record === undefined ? '' : textOf(record['code']);
+}
+function messageOf(page) {
+    const record = asRecord(page);
+    return record === undefined ? '' : textOf(record['message']);
+}
+function hintOf(page) {
+    const record = asRecord(page);
+    const hint = record === undefined ? '' : textOf(record['hint']);
+    return hint === '' ? undefined : hint;
+}
+function pageFailed(page) {
+    const record = asRecord(page);
+    return record !== undefined && record['ok'] === false;
+}
+function blockerFor(code) {
+    const normalized = code.trim().toUpperCase().replace(/-/g, '_');
+    if (normalized === '')
+        return undefined;
+    const matches = (set) => [...set].some((one) => normalized === one || normalized.endsWith(`_${one}`));
+    if (matches(PERMISSION_CODES))
+        return 'permission-denied';
+    if (matches(AUTH_CODES) || normalized.includes('UNAUTH'))
+        return 'auth-required';
+    return undefined;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function shellRun(shell, command, argv, timeoutMs) {
+    const result = await runShell(shell, backgroundLine(command, argv), { timeoutMs });
+    if (result.timedOut) {
+        return { kind: 'timeout', detail: `没在 ${Math.round(timeoutMs / 1000)} 秒内返回`, stderr: result.stderr };
+    }
+    if (result.exitCode !== 0) {
+        return { kind: 'failed', detail: tailLines(result.stderr || result.stdout, 4), stderr: result.stderr };
+    }
+    return { kind: 'ok', stdout: result.stdout };
+}
+async function evalOnce(shell, command, session, script, timeoutMs, retryMs) {
+    const run = async () => {
+        let attempt;
+        try {
+            attempt = await shellRun(shell, command, ['browser', session, 'eval', script, '--window', 'background'], timeoutMs);
+        }
+        catch (error) {
+            return {
+                kind: 'failure',
+                result: {
+                    ok: false,
+                    code: 'cli-exec-failed',
+                    message: '读不了：opencli 起不来',
+                    hint: '确认这台机器上 opencli 能跑（工作台会自己把它挂好）',
+                    detail: error instanceof Error ? error.message : String(error),
+                },
+            };
+        }
+        if (attempt.kind === 'timeout') {
+            return {
+                kind: 'failure',
+                result: {
+                    ok: false,
+                    code: 'cli-timeout',
+                    message: '这次没读到（等超时了）',
+                    hint: '稍后重试',
+                    detail: attempt.detail,
+                },
+            };
+        }
+        if (attempt.kind === 'failed') {
+            const normalized = attempt.stderr.trim().toUpperCase().replace(/-/g, '_');
+            const forbidden = [...PERMISSION_CODES].some((one) => normalized.includes(one));
+            return {
+                kind: 'failure',
+                result: {
+                    ok: false,
+                    code: forbidden ? 'permission-denied' : 'cli-exec-failed',
+                    message: forbidden ? '没有权限在这台机器上读' : '读不了（命令失败）',
+                    hint: forbidden ? '换一个有权限的账号，或让用户开权限' : '把下面这段原始输出看一眼再重试',
+                    detail: attempt.detail,
+                },
+            };
+        }
+        const value = parseJsonLoose(attempt.stdout);
+        if (value === undefined) {
+            return {
+                kind: 'failure',
+                result: {
+                    ok: false,
+                    code: 'cli-exec-failed',
+                    message: '读到了、但不是 JSON',
+                    hint: '脚本必须回 JSON',
+                    detail: tailLines(attempt.stdout, 4),
+                },
+            };
+        }
+        return { kind: 'value', value };
+    };
+    const first = await run();
+    if (first.kind === 'value')
+        return first;
+    if (first.result.code !== 'cli-exec-failed')
+        return first;
+    await sleep(retryMs);
+    return run();
+}
+async function openOnce(shell, command, session, url, timeoutMs) {
+    let attempt;
+    try {
+        attempt = await shellRun(shell, command, ['browser', session, 'open', url, '--window', 'background'], timeoutMs);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            code: 'cli-exec-failed',
+            message: '打不开那个页面',
+            hint: '确认 opencli 能跑起来',
+            detail: error instanceof Error ? error.message : String(error),
+            helpUrl: url,
+        };
+    }
+    if (attempt.kind === 'ok')
+        return undefined;
+    return {
+        ok: false,
+        code: attempt.kind === 'timeout' ? 'cli-timeout' : 'cli-exec-failed',
+        message: '打不开那个页面',
+        hint: '在浏览器里手动打开一次，然后重试',
+        detail: attempt.detail,
+        helpUrl: url,
+    };
+}
+export async function browserRead(options) {
+    const { shell, script, url, loginUrl, open = true } = options;
+    const command = options.command ?? 'opencli';
+    const session = options.session ?? BROWSER_BRIDGE_SESSION;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
+    const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;
+    const at = Date.now();
+    const first = await evalOnce(shell, command, session, script, timeoutMs, retryMs);
+    if (first.kind === 'failure')
+        return { ...first.result, at };
+    let page = first.value;
+    if (codeOf(page) === 'not-on-site') {
+        if (!open || url === undefined) {
+            return {
+                ok: false,
+                code: 'cli-exec-failed',
+                at,
+                message: '没停在那套系统上',
+                hint: '先在那个浏览器里把它打开，再读一次',
+                detail: JSON.stringify(page),
+                ...(url === undefined ? {} : { helpUrl: url }),
+            };
+        }
+        const opened = await openOnce(shell, command, session, url, timeoutMs);
+        if (opened !== undefined)
+            return { ...opened, at };
+        await sleep(settleMs);
+        const second = await evalOnce(shell, command, session, script, timeoutMs, retryMs);
+        if (second.kind === 'failure')
+            return { ...second.result, at };
+        page = second.value;
+        if (codeOf(page) === 'not-on-site') {
+            return {
+                ok: false,
+                code: 'cli-exec-failed',
+                at,
+                message: '打开了页面、又读了一遍，仍然不在那套系统上',
+                hint: '确认这个地址就是那套系统（或者它跳到了别的域）',
+                detail: JSON.stringify(page),
+                helpUrl: url,
+            };
+        }
+    }
+    if (!pageFailed(page))
+        return { ok: true, code: 'ok', at, value: page, message: '读到了' };
+    const pageCode = codeOf(page) || 'read-failed';
+    const message = messageOf(page) || `读不到（${pageCode}）`;
+    const blocker = blockerFor(pageCode);
+    if (blocker === 'auth-required') {
+        return {
+            ok: false,
+            code: blocker,
+            at,
+            pageCode,
+            message,
+            hint: '去登录一次，再重试',
+            detail: JSON.stringify(page),
+            ...(loginUrl === undefined && url === undefined ? {} : { helpUrl: loginUrl ?? url }),
+        };
+    }
+    if (blocker === 'permission-denied') {
+        return {
+            ok: false,
+            code: blocker,
+            at,
+            pageCode,
+            message,
+            hint: '这个账号没有权限',
+            detail: JSON.stringify(page),
+            ...(loginUrl === undefined && url === undefined ? {} : { helpUrl: loginUrl ?? url }),
+        };
+    }
+    return {
+        ok: false,
+        code: pageCode,
+        at,
+        pageCode,
+        message,
+        detail: JSON.stringify(page),
+        ...(hintOf(page) === undefined ? {} : { hint: hintOf(page) }),
+    };
+}

package/dist/host/http.d.ts

@@ -31,6 +31,11 @@ export declare function preflightHandler(preflight: {
     snapshot(): unknown;
 }): RouteHandler;
 export declare function capabilityHandler(probe: (unit: string | undefined, force: boolean) => Promise<unknown> | unknown): RouteHandler;
-export declare function healthHandler(ctx: DshHostContext): RouteHandler;
+export interface OpencliHealth {
+    readonly command: string;
+    readonly source: 'env' | 'isolated' | 'path';
+    readonly isolated: string | null;
+}
+export declare function healthHandler(ctx: DshHostContext, opencli?: OpencliHealth): RouteHandler;
 export declare function registerPrefs(ctx: DshHostContext, resources: readonly PostResource[], wrote?: ((resource: string, write: PostWrite) => void) | undefined): () => void;
 export declare function registerActions(ctx: DshHostContext, resources: readonly PostResource[], wrote?: ((resource: string, write: PostWrite) => void) | undefined): () => void;

package/dist/host/http.js

@@ -192,7 +192,7 @@ export function capabilityHandler(probe) {
         return { ok: true, ...result };
     };
 }
-export function healthHandler(ctx) {
+export function healthHandler(ctx, opencli) {
     return () => {
         const profile = ctx.get('profileContext');
         const dir = profile?.dir;
@@ -203,6 +203,7 @@ export function healthHandler(ctx) {
             profileDir: dir ?? null,
             pid: process.pid,
             now: new Date().toISOString(),
+            ...(opencli === undefined ? {} : { opencli }),
         };
     };
 }

package/dist/host/opencli-runtime.d.ts

@@ -7,6 +7,9 @@ export declare const OPENCLI_NPM_PACKAGE = "@jackwener/opencli";
 export declare function toolchainDir(): string;
 export declare function toolchainOpencliDir(): string;
 export declare function vendorPrefix(): string;
+export declare function vendorPluginsDir(): string;
+export declare const OPENCLI_CATALOG_ENV = "DSH_WB_OPENCLI_CATALOG";
+export declare function cliCatalogPath(): string;
 export declare function vendorPeerLink(): {
     readonly dir: string;
     readonly parent: string;

package/dist/host/opencli-runtime.js

@@ -18,6 +18,16 @@ export function toolchainOpencliDir() {
 export function vendorPrefix() {
     return `${isolatedRoot()}/plugins-npm`;
 }
+export function vendorPluginsDir() {
+    return `${vendorPrefix()}/node_modules`;
+}
+export const OPENCLI_CATALOG_ENV = 'DSH_WB_OPENCLI_CATALOG';
+export function cliCatalogPath() {
+    const override = process.env[OPENCLI_CATALOG_ENV]?.trim();
+    return override === undefined || override === ''
+        ? `${toolchainOpencliDir()}/cli-manifest.json`
+        : override;
+}
 export function vendorPeerLink() {
     const base = `${vendorPrefix()}/node_modules`;
     const [scope] = OPENCLI_NPM_PACKAGE.split('/');

package/dist/host/opencli-window.d.ts

@@ -0,0 +1,2 @@
+export declare function backgroundPrefix(): readonly string[];
+export declare function backgroundLine(command: string, argv: readonly string[]): string;

package/dist/host/opencli-window.js

@@ -0,0 +1,8 @@
+import { quoteShellArg } from '../lib/text.js';
+const OPENCLI_WINDOW_ENV = 'OPENCLI_WINDOW=background';
+export function backgroundPrefix() {
+    return [quoteShellArg('env'), quoteShellArg(OPENCLI_WINDOW_ENV)];
+}
+export function backgroundLine(command, argv) {
+    return [...backgroundPrefix(), quoteShellArg(command), ...argv.map(quoteShellArg)].join(' ');
+}

package/dist/host/opencli.js

@@ -1,6 +1,7 @@
 import { OPENCLI_MAX_CONCURRENT, OPENCLI_TIMEOUT_MS } from '../config/constants.js';
 import { parseJsonLoose, quoteShellArg, tailLines } from '../lib/text.js';
 import { helpUrlOf, parseCliErrorEnvelope } from './cli-error.js';
+import { backgroundPrefix } from './opencli-window.js';
 import { runShell } from './shell.js';
 const FORBIDDEN_CODES = new Set(['FORBIDDEN', 'PERMISSION_DENIED']);
 const SITE_SESSION_ARGS = ['--site-session', 'persistent'];
@@ -26,6 +27,7 @@ export class WorkbenchDataError extends Error {
 }
 export function opencliCommandLine(command, argv, session = 'persistent') {
     return [
+        ...backgroundPrefix(),
         quoteShellArg(command),
         ...argv.map(quoteShellArg),
         ...(session === 'persistent' ? SITE_SESSION_ARGS : []),

package/dist/host.d.ts

@@ -8,6 +8,8 @@ export * from './lib/ui.js';
 export * from './api/blocker-table.js';
 export * from './host/cli-error.js';
 export * from './host/data-root.js';
+export * from './host/browser-read.js';
+export * from './host/browser-find.js';
 export * from './host/facts.js';
 export * from './host/git.js';
 export * from './host/http.js';

package/dist/host.js

@@ -8,6 +8,8 @@ export * from './lib/ui.js';
 export * from './api/blocker-table.js';
 export * from './host/cli-error.js';
 export * from './host/data-root.js';
+export * from './host/browser-read.js';
+export * from './host/browser-find.js';
 export * from './host/facts.js';
 export * from './host/git.js';
 export * from './host/http.js';

package/dist/i18n/en.js

@@ -94,6 +94,8 @@ export const en = {
     'panels.market.badSource': 'The install method is incomplete — install it yourself',
     'panels.market.empty': 'No modules available',
     'panels.market.installedSection': 'Installed',
+    'panels.market.sectionLocal': 'Linked locally',
+    'panels.market.sectionUnlisted': 'Not from the market',
     'panels.market.moduleOutdated': 'update available',
     'panels.market.moduleRestartHint': 'installed but not active — restart dsh once to bring it up',
     'panels.market.restartNeeded': 'The new version is installed — restart once to pick it up.',
@@ -302,6 +304,7 @@ export const en = {
     'rightbar.refreshing': 'Refreshing…',
     'rightbar.updatedAt': 'updated {time}',
     'rightbar.noProject': 'The current session has no workspace',
+    'rightbar.openPlatform': 'Open on the platform',
     'coding.notARepo.title': 'This workspace is not a Coding repository',
     'error.unknown': 'Something went wrong',
     'board.title': 'Workbench panel',

package/dist/i18n/index.d.ts

@@ -61,7 +61,7 @@ export declare const dictionaries: {
         readonly 'panels.browseMarket': "浏览模块市场";
         readonly 'panels.noneInstalled': "这些模块要的插件都还没装";
         readonly 'panels.noneInstalledHint': "装好之后它们会回到这里，再由你决定放哪几个上板。";
-        readonly 'panels.market.installed': "已装";
+        readonly 'panels.market.installed': "已安装";
         readonly 'panels.market.outdated': "要更新";
         readonly 'panels.market.hasNew': "有新版本";
         readonly 'panels.market.missing': "未装";
@@ -95,7 +95,9 @@ export declare const dictionaries: {
         readonly 'panels.market.noSource': "这个模块没声明怎么装，只能自己动手";
         readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
         readonly 'panels.market.empty': "暂无可用模块";
-        readonly 'panels.market.installedSection': "已装";
+        readonly 'panels.market.installedSection': "已安装";
+        readonly 'panels.market.sectionLocal': "本地装的";
+        readonly 'panels.market.sectionUnlisted': "不是从市场装的";
         readonly 'panels.market.moduleOutdated': "有新版";
         readonly 'panels.market.moduleRestartHint': "装好了但还没生效 —— 重启一次 dsh 就会出来";
         readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
@@ -304,13 +306,14 @@ export declare const dictionaries: {
         readonly 'rightbar.refreshing': "刷新中…";
         readonly 'rightbar.updatedAt': "更新于 {time}";
         readonly 'rightbar.noProject': "当前会话没有所属项目";
+        readonly 'rightbar.openPlatform': "在平台上打开";
         readonly 'coding.notARepo.title': "这个项目不是 Coding 仓库";
         readonly 'error.unknown': "出错了";
         readonly 'board.title': "工作台面板";
         readonly 'panel.conversation': "对话";
         readonly 'panels.label': "全局面板";
     };
-    en: Record<"time.now" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.outdated" | "panels.market.hasNew" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.moduleOutdated" | "panels.market.moduleRestartHint" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
+    en: Record<"time.now" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.outdated" | "panels.market.hasNew" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.sectionLocal" | "panels.market.sectionUnlisted" | "panels.market.moduleOutdated" | "panels.market.moduleRestartHint" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
 };
 export type { WorkbenchMessages };
 export interface Dictionaries {

package/dist/i18n/zh.d.ts

@@ -59,7 +59,7 @@ export declare const zh: {
     readonly 'panels.browseMarket': "浏览模块市场";
     readonly 'panels.noneInstalled': "这些模块要的插件都还没装";
     readonly 'panels.noneInstalledHint': "装好之后它们会回到这里，再由你决定放哪几个上板。";
-    readonly 'panels.market.installed': "已装";
+    readonly 'panels.market.installed': "已安装";
     readonly 'panels.market.outdated': "要更新";
     readonly 'panels.market.hasNew': "有新版本";
     readonly 'panels.market.missing': "未装";
@@ -93,7 +93,9 @@ export declare const zh: {
     readonly 'panels.market.noSource': "这个模块没声明怎么装，只能自己动手";
     readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
     readonly 'panels.market.empty': "暂无可用模块";
-    readonly 'panels.market.installedSection': "已装";
+    readonly 'panels.market.installedSection': "已安装";
+    readonly 'panels.market.sectionLocal': "本地装的";
+    readonly 'panels.market.sectionUnlisted': "不是从市场装的";
     readonly 'panels.market.moduleOutdated': "有新版";
     readonly 'panels.market.moduleRestartHint': "装好了但还没生效 —— 重启一次 dsh 就会出来";
     readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
@@ -302,6 +304,7 @@ export declare const zh: {
     readonly 'rightbar.refreshing': "刷新中…";
     readonly 'rightbar.updatedAt': "更新于 {time}";
     readonly 'rightbar.noProject': "当前会话没有所属项目";
+    readonly 'rightbar.openPlatform': "在平台上打开";
     readonly 'coding.notARepo.title': "这个项目不是 Coding 仓库";
     readonly 'error.unknown': "出错了";
     readonly 'board.title': "工作台面板";

package/dist/i18n/zh.js

@@ -59,7 +59,7 @@ export const zh = {
     'panels.browseMarket': '浏览模块市场',
     'panels.noneInstalled': '这些模块要的插件都还没装',
     'panels.noneInstalledHint': '装好之后它们会回到这里，再由你决定放哪几个上板。',
-    'panels.market.installed': '已装',
+    'panels.market.installed': '已安装',
     'panels.market.outdated': '要更新',
     'panels.market.hasNew': '有新版本',
     'panels.market.missing': '未装',
@@ -93,7 +93,9 @@ export const zh = {
     'panels.market.noSource': '这个模块没声明怎么装，只能自己动手',
     'panels.market.badSource': '安装方式没写全，只能自己动手',
     'panels.market.empty': '暂无可用模块',
-    'panels.market.installedSection': '已装',
+    'panels.market.installedSection': '已安装',
+    'panels.market.sectionLocal': '本地装的',
+    'panels.market.sectionUnlisted': '不是从市场装的',
     'panels.market.moduleOutdated': '有新版',
     'panels.market.moduleRestartHint': '装好了但还没生效 —— 重启一次 dsh 就会出来',
     'panels.market.restartNeeded': '新版装好了，重启一次才生效。',
@@ -302,6 +304,7 @@ export const zh = {
     'rightbar.refreshing': '刷新中…',
     'rightbar.updatedAt': '更新于 {time}',
     'rightbar.noProject': '当前会话没有所属项目',
+    'rightbar.openPlatform': '在平台上打开',
     'coding.notARepo.title': '这个项目不是 Coding 仓库',
     'error.unknown': '出错了',
     'board.title': '工作台面板',

package/dist/index.d.ts

@@ -27,6 +27,8 @@ export * from './components/SettingsSection.js';
 export * from './components/Stack.js';
 export * from './components/StateBlock.js';
 export * from './components/TextField.js';
+export * from './components/Field.js';
+export * from './components/Link.js';
 export * from './components/board-module.js';
 export * from './components/icons.js';
 export * from './config/constants.js';

package/dist/index.js

@@ -27,6 +27,8 @@ export * from './components/SettingsSection.js';
 export * from './components/Stack.js';
 export * from './components/StateBlock.js';
 export * from './components/TextField.js';
+export * from './components/Field.js';
+export * from './components/Link.js';
 export * from './components/board-module.js';
 export * from './components/icons.js';
 export * from './config/constants.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/components/CardHead.test.tsx

@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+import { CardHead } from './CardHead.js';
+
+interface AnyElement {
+  readonly type: unknown;
+  readonly props: Record<string, unknown>;
+}
+
+const t = (key: string): string => key;
+
+function head(overrides: Record<string, unknown> = {}): AnyElement {
+  return CardHead({
+    t,
+    title: '套餐余额',
+    refreshing: false,
+    onRefresh: () => {},
+    ...overrides,
+  } as never) as unknown as AnyElement;
+}
+
+function allChildren(node: AnyElement): AnyElement[] {
+  const raw = node.props['children'];
+  return (Array.isArray(raw) ? raw : [raw]).filter(
+    (one): one is AnyElement => typeof one === 'object' && one !== null && 'props' in (one as AnyElement),
+  );
+}
+
+function find(root: AnyElement, hit: (node: AnyElement) => boolean): AnyElement | undefined {
+  for (const child of allChildren(root)) {
+    if (hit(child)) return child;
+    const deeper = find(child, hit);
+    if (deeper !== undefined) return deeper;
+  }
+  return undefined;
+}
+
+function byClass(root: AnyElement, needle: string): AnyElement | undefined {
+  return find(root, (node) => {
+    const className = node.props['className'];
+    return typeof className === 'string' && className.includes(needle);
+  });
+}
+
+function byLabel(root: AnyElement, label: string): AnyElement | undefined {
+  return find(root, (node) => node.props['aria-label'] === label);
+}
+
+describe('CardHead 的那颗 ↗：platformHref 一个人说了算', () => {
+  it('只给 platformHref 也画得出来（少给 platform 不再静默丢一颗按钮）', () => {
+    const anchor = byClass(head({ platformHref: 'https://example.com/wallet' }), 'wb-cardOpen');
+    expect(anchor).toBeDefined();
+    expect(anchor?.props['href']).toBe('https://example.com/wallet');
+    expect(anchor?.props['target']).toBe('_blank');
+    expect(anchor?.props['rel']).toBe('noreferrer noopener');
+  });
+
+  it('platformHref 不给就一颗都不画（不是画一颗没有链接的）', () => {
+    expect(byClass(head(), 'wb-cardOpen')).toBeUndefined();
+    expect(byClass(head({ platform: 'LLM Gateway' }), 'wb-cardOpen')).toBeUndefined();
+    expect(byClass(head({ platformTitle: '在 LLM Gateway 里打开钱包' }), 'wb-cardOpen')).toBeUndefined();
+  });
+
+  it('aria-label：platform 优先，其次 platformTitle，都没有就退回那句话', () => {
+    expect(byClass(head({ platformHref: '/x' }), 'wb-cardOpen')?.props['aria-label']).toBe(
+      'rightbar.openPlatform',
+    );
+    expect(byClass(head({ platformHref: '/x', platform: 'LLM Gateway' }), 'wb-cardOpen')?.props['aria-label']).toBe(
+      'LLM Gateway',
+    );
+    expect(
+      byClass(head({ platformHref: '/x', platformTitle: '在 LLM Gateway 里打开钱包' }), 'wb-cardOpen')?.props[
+        'aria-label'
+      ],
+    ).toBe('在 LLM Gateway 里打开钱包');
+  });
+
+  it('刷新那颗永远在（有没有 ↗ 都不影响它）', () => {
+    expect(byLabel(head(), 'rightbar.refresh')).toBeDefined();
+    expect(byLabel(head({ platformHref: '/x' }), 'rightbar.refresh')).toBeDefined();
+  });
+});

package/src/components/CardHead.tsx

@@ -38,18 +38,19 @@ export function CardHead({
   platformTitle,
 }: CardHeadProps) {
   const refreshLabel = refreshing ? t('rightbar.refreshing') : t('rightbar.refresh');
+  const platformLabel = platformTitle ?? platform ?? t('rightbar.openPlatform');
   return (
     <header className="wb-cardHead">
       <h2 className="wb-cardTitle">{title}</h2>
       {meta === undefined ? null : <span className="wb-cardMeta">{meta}</span>}
-      {platformHref === undefined || platform === undefined ? null : (
-        <Tooltip side="bottom" align="end" gap={6} portal label={platformTitle ?? platform}>
+      {platformHref === undefined ? null : (
+        <Tooltip side="bottom" align="end" gap={6} portal label={platformLabel}>
           <a
             className="wb-iconButton wb-cardOpen"
             href={platformHref}
             target="_blank"
             rel="noreferrer noopener"
-            aria-label={platform}
+            aria-label={platform ?? platformLabel}
           >
             <IconRightUpOutlineRegular size={14} />
           </a>