@dsh-workbench/shared 1.0.0-beta.0 → 1.0.0

package/dist/i18n/settings.js

@@ -1,17 +1,13 @@
 /** 「工作台设置」这一组的词条：配置同步 / 新建工作台。 */
 export const zhSettings = {
     'profileCreate.nav': '新建工作台',
-    'profileCreate.lead': '以已有 profile 为模板，建一个独立的新工作台。建好后关掉当前实例，再启动新的。',
+    'profileCreate.lead': '以已有 profile 为模板，建一个独立的新工作台。会话 / 项目 / 附件跟 web 共用，这里只复制设置。建好后关掉当前实例，再启动新的。',
     'profileCreate.name': '新工作台的名字',
     'profileCreate.nameHint': '例如 wb2（只用字母、数字、点、下划线或短横线）',
     'profileCreate.source': '来源 profile',
     'profileCreate.current': '当前',
     'profileCreate.copy': '从来源复制',
     'profileCreate.settings': '设置（模型、主题等）',
-    'profileCreate.plugins': '本地插件文件',
-    'profileCreate.pluginsRequired': '设置里引用了，不能单独去掉',
-    'profileCreate.projects': '项目列表',
-    'profileCreate.sessions': '会话记录',
     'profileCreate.create': '创建',
     'profileCreate.creating': '正在创建…',
     'profileCreate.created': '已建好 {profile}。',
@@ -22,25 +18,16 @@ export const zhSettings = {
     'profileCreate.noProfiles': '这台机器上还没有可用的来源 profile。',
     'profileCreate.failed': '创建没有成功，看看下面的输出。',
     'configSync.nav': '配置同步',
-    'configSync.lead': '只搬设置行和它们引用的本地文件；不搬项目列表和会话记录 —— 要整套新建工作台用「新建工作台」。',
+    'configSync.lead': '只同步「改已有插件的设置」的行；挂新插件的行不同步。会话 / 项目 / 附件本来就共用，不用同步。要整套新建工作台用「新建工作台」。',
     'configSync.source': '来源',
     'configSync.sourceBroken': '读不到它的配置',
-    'configSync.sourceRows': '{name} 这份里你有 {count} 行可搬',
+    'configSync.sourceRows': '{name} 这份里你有 {count} 行可同步',
     'configSync.sourceDead': '读不到',
     'configSync.refresh': '重新读一遍',
     'configSync.loading': '正在读来源的配置…',
     'configSync.readHint': '换个来源，或再读一遍。',
     'configSync.tag.new': '新增',
     'configSync.tag.differs': '差异',
-    'configSync.tag.asset': '缺文件',
-    'configSync.tag.fileDiffers': '文件不同',
-    'configSync.assetOnly': '设置内容一样，只差文件。',
-    'configSync.assetMissingOne': '还要 1 个文件：{path}',
-    'configSync.assetMissingMany': '还要 {count} 个文件：{path}',
-    'configSync.assetDiffers': '文件不一样：{path}',
-    'configSync.assetDiffersMany': '文件有差异：{path}（{count} 个）',
-    'configSync.assetExternal': '这个文件搬不过来：{path}（{reason}）',
-    'configSync.assetOverwrite': '覆盖工作台里的同名文件',
     'configSync.conflictNote': '应用后工作台这份会被来源覆盖',
     'configSync.code.lang': 'yaml',
     'configSync.code.copy': '复制',
@@ -51,35 +38,30 @@ export const zhSettings = {
     'configSync.code.collapseAria': '收起这一行的配置',
     'configSync.code.expandAria': '展开差异（还有 {count} 行）',
     'configSync.code.expand': '展开剩余 {count} 行',
-    'configSync.missing': '{pkg} 还没装：这一行搬过来也不会生效 —— 先在模块市场里装它',
+    'configSync.missing': '{pkg} 还没装：这一行同步过来也不会生效 —— 先在模块市场里装它',
     'configSync.apply': '同步选中的 {count} 项',
     'configSync.applyNone': '请选择同步内容',
     'configSync.applying': '正在写入…',
     'configSync.applied': '已写入并检查通过',
     'configSync.appliedUnverified': '已写入；重启后检查是否生效',
-    'configSync.appliedFiles': '复制了 {count} 个文件',
     'configSync.appliedIds': '这次写进去：{ids}',
     'configSync.skippedIds': '这几行工作台自己已有，没动：{ids}',
     'configSync.nothing': '没有需要同步的内容',
     'configSync.unreadable': '读不到 {path}：{reason}',
     'configSync.noSource': '这台机器上只有工作台这一个 profile，没有可同步的来源',
-    'configSync.emptyProviders': '工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把模型供应商那几行搬过来，或自己去「模型」里配。',
+    'configSync.emptyProviders': '工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把模型供应商那几行同步过来，或自己去「模型」里配。',
     'configSync.failed': '同步没成功，再试一次。',
 };
 /** 上面那组的中文对照。 */
 export const enSettings = {
     'profileCreate.nav': 'New workbench',
-    'profileCreate.lead': 'Create a separate workbench from an existing profile. Stop this instance, then start the new one.',
+    'profileCreate.lead': 'Create a separate workbench from an existing profile. Chats, projects and attachments are shared with web; only settings are copied. Stop this instance, then start the new one.',
     'profileCreate.name': 'New workbench name',
     'profileCreate.nameHint': 'e.g. wb2 (letters, digits, dot, underscore or dash)',
     'profileCreate.source': 'Source profile',
     'profileCreate.current': 'current',
     'profileCreate.copy': 'Copy from the source',
     'profileCreate.settings': 'Settings (models, theme, …)',
-    'profileCreate.plugins': 'Local plugin files',
-    'profileCreate.pluginsRequired': 'Referenced by settings; copied together',
-    'profileCreate.projects': 'Project list',
-    'profileCreate.sessions': 'Chat history',
     'profileCreate.create': 'Create',
     'profileCreate.creating': 'Creating…',
     'profileCreate.created': 'Created {profile}.',
@@ -90,7 +72,7 @@ export const enSettings = {
     'profileCreate.noProfiles': 'This machine has no source profile yet.',
     'profileCreate.failed': 'The workbench was not created; see the output below.',
     'configSync.nav': 'Config sync',
-    'configSync.lead': 'Only setting rows and the local files they reference are copied; project lists and sessions are not. Use “New workbench” to create a full profile.',
+    'configSync.lead': 'Only rows that change settings of plugins the workbench already has are copied. Rows that mount a new plugin are not; chats, projects and attachments are shared already. Use “New workbench” to create a full profile.',
     'configSync.source': 'Source',
     'configSync.sourceBroken': 'its config is unreadable',
     'configSync.sourceRows': '{name}: {count} rows are new or different for the workbench',
@@ -100,15 +82,6 @@ export const enSettings = {
     'configSync.readHint': 'Pick another source, or read again.',
     'configSync.tag.new': 'New',
     'configSync.tag.differs': 'Differs',
-    'configSync.tag.asset': 'File missing',
-    'configSync.tag.fileDiffers': 'File differs',
-    'configSync.assetOnly': 'The setting is the same; only its file is missing.',
-    'configSync.assetMissingOne': '1 file is still needed: {path}',
-    'configSync.assetMissingMany': '{count} files are still needed: {path}',
-    'configSync.assetDiffers': 'The file differs: {path}',
-    'configSync.assetDiffersMany': 'The files differ: {path} ({count} files)',
-    'configSync.assetExternal': 'This file cannot be copied: {path} ({reason})',
-    'configSync.assetOverwrite': 'Overwrite the workbench copy',
     'configSync.conflictNote': 'Applying replaces this workbench copy with the source',
     'configSync.code.lang': 'yaml',
     'configSync.code.copy': 'Copy',
@@ -125,7 +98,6 @@ export const enSettings = {
     'configSync.applying': 'Writing…',
     'configSync.applied': 'Written and checked',
     'configSync.appliedUnverified': 'Written; restart to check whether it took effect',
-    'configSync.appliedFiles': 'Copied {count} files',
     'configSync.appliedIds': 'Written this time: {ids}',
     'configSync.skippedIds': 'Left alone (already here): {ids}',
     'configSync.nothing': 'Nothing to sync',

package/dist/i18n/zh.d.ts

@@ -275,6 +275,7 @@ export declare const zh: {
     readonly 'panels.discover.loading': "正在读取索引";
     readonly 'panels.discover.lead': "从索引源浏览模块；装上就能用。";
     readonly 'panels.discover.addSource': "添加";
+    readonly 'panels.discover.addingSource': "正在添加…";
     readonly 'panels.discover.addFirstSource': "添加索引源";
     readonly 'panels.discover.removeSource': "移除";
     readonly 'panels.discover.removeSourceNamed': "移除 {url}";
@@ -375,7 +376,6 @@ export declare const zh: {
     readonly 'panels.discover.tabOverview': "概览";
     readonly 'panels.discover.tabReadme': "说明";
     readonly 'panels.discover.tabChangelog': "更新日志";
-    readonly 'panels.discover.docTitle': "{version} 的{kind}";
     readonly 'panels.discover.docReadme': "说明";
     readonly 'panels.discover.docChangelog': "更新日志";
     readonly 'panels.discover.docLoading': "正在读取…";
@@ -612,6 +612,8 @@ export declare const zh: {
     readonly 'approval.publish.module': "模块";
     readonly 'approval.publish.target': "目标";
     readonly 'approval.publish.version': "版本";
+    readonly 'approval.publish.author': "作者";
+    readonly 'approval.publish.authorMissing': "未署名（提交用本机 git 身份）";
     readonly 'approval.publish.registry': "源";
     readonly 'approval.publish.repo': "仓库";
     readonly 'approval.publish.branch': "分支";
@@ -634,17 +636,13 @@ export declare const zh: {
     readonly 'markdown.copied': "已复制";
     readonly 'markdown.footnotes': "脚注";
     readonly 'profileCreate.nav': "新建工作台";
-    readonly 'profileCreate.lead': "以已有 profile 为模板，建一个独立的新工作台。建好后关掉当前实例，再启动新的。";
+    readonly 'profileCreate.lead': "以已有 profile 为模板，建一个独立的新工作台。会话 / 项目 / 附件跟 web 共用，这里只复制设置。建好后关掉当前实例，再启动新的。";
     readonly 'profileCreate.name': "新工作台的名字";
     readonly 'profileCreate.nameHint': "例如 wb2（只用字母、数字、点、下划线或短横线）";
     readonly 'profileCreate.source': "来源 profile";
     readonly 'profileCreate.current': "当前";
     readonly 'profileCreate.copy': "从来源复制";
     readonly 'profileCreate.settings': "设置（模型、主题等）";
-    readonly 'profileCreate.plugins': "本地插件文件";
-    readonly 'profileCreate.pluginsRequired': "设置里引用了，不能单独去掉";
-    readonly 'profileCreate.projects': "项目列表";
-    readonly 'profileCreate.sessions': "会话记录";
     readonly 'profileCreate.create': "创建";
     readonly 'profileCreate.creating': "正在创建…";
     readonly 'profileCreate.created': "已建好 {profile}。";
@@ -655,25 +653,16 @@ export declare const zh: {
     readonly 'profileCreate.noProfiles': "这台机器上还没有可用的来源 profile。";
     readonly 'profileCreate.failed': "创建没有成功，看看下面的输出。";
     readonly 'configSync.nav': "配置同步";
-    readonly 'configSync.lead': "只搬设置行和它们引用的本地文件；不搬项目列表和会话记录 —— 要整套新建工作台用「新建工作台」。";
+    readonly 'configSync.lead': "只同步「改已有插件的设置」的行；挂新插件的行不同步。会话 / 项目 / 附件本来就共用，不用同步。要整套新建工作台用「新建工作台」。";
     readonly 'configSync.source': "来源";
     readonly 'configSync.sourceBroken': "读不到它的配置";
-    readonly 'configSync.sourceRows': "{name} 这份里你有 {count} 行可搬";
+    readonly 'configSync.sourceRows': "{name} 这份里你有 {count} 行可同步";
     readonly 'configSync.sourceDead': "读不到";
     readonly 'configSync.refresh': "重新读一遍";
     readonly 'configSync.loading': "正在读来源的配置…";
     readonly 'configSync.readHint': "换个来源，或再读一遍。";
     readonly 'configSync.tag.new': "新增";
     readonly 'configSync.tag.differs': "差异";
-    readonly 'configSync.tag.asset': "缺文件";
-    readonly 'configSync.tag.fileDiffers': "文件不同";
-    readonly 'configSync.assetOnly': "设置内容一样，只差文件。";
-    readonly 'configSync.assetMissingOne': "还要 1 个文件：{path}";
-    readonly 'configSync.assetMissingMany': "还要 {count} 个文件：{path}";
-    readonly 'configSync.assetDiffers': "文件不一样：{path}";
-    readonly 'configSync.assetDiffersMany': "文件有差异：{path}（{count} 个）";
-    readonly 'configSync.assetExternal': "这个文件搬不过来：{path}（{reason}）";
-    readonly 'configSync.assetOverwrite': "覆盖工作台里的同名文件";
     readonly 'configSync.conflictNote': "应用后工作台这份会被来源覆盖";
     readonly 'configSync.code.lang': "yaml";
     readonly 'configSync.code.copy': "复制";
@@ -684,19 +673,18 @@ export declare const zh: {
     readonly 'configSync.code.collapseAria': "收起这一行的配置";
     readonly 'configSync.code.expandAria': "展开差异（还有 {count} 行）";
     readonly 'configSync.code.expand': "展开剩余 {count} 行";
-    readonly 'configSync.missing': "{pkg} 还没装：这一行搬过来也不会生效 —— 先在模块市场里装它";
+    readonly 'configSync.missing': "{pkg} 还没装：这一行同步过来也不会生效 —— 先在模块市场里装它";
     readonly 'configSync.apply': "同步选中的 {count} 项";
     readonly 'configSync.applyNone': "请选择同步内容";
     readonly 'configSync.applying': "正在写入…";
     readonly 'configSync.applied': "已写入并检查通过";
     readonly 'configSync.appliedUnverified': "已写入；重启后检查是否生效";
-    readonly 'configSync.appliedFiles': "复制了 {count} 个文件";
     readonly 'configSync.appliedIds': "这次写进去：{ids}";
     readonly 'configSync.skippedIds': "这几行工作台自己已有，没动：{ids}";
     readonly 'configSync.nothing': "没有需要同步的内容";
     readonly 'configSync.unreadable': "读不到 {path}：{reason}";
     readonly 'configSync.noSource': "这台机器上只有工作台这一个 profile，没有可同步的来源";
-    readonly 'configSync.emptyProviders': "工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把模型供应商那几行搬过来，或自己去「模型」里配。";
+    readonly 'configSync.emptyProviders': "工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把模型供应商那几行同步过来，或自己去「模型」里配。";
     readonly 'configSync.failed': "同步没成功，再试一次。";
 };
 /** 中文词表的键类型：`en` 与模块词表都得覆盖同一批键。 */

package/dist/i18n/zh.js

@@ -267,6 +267,7 @@ export const zh = {
     'panels.discover.loading': '正在读取索引',
     'panels.discover.lead': '从索引源浏览模块；装上就能用。',
     'panels.discover.addSource': '添加',
+    'panels.discover.addingSource': '正在添加…',
     'panels.discover.addFirstSource': '添加索引源',
     'panels.discover.removeSource': '移除',
     'panels.discover.removeSourceNamed': '移除 {url}',
@@ -367,7 +368,6 @@ export const zh = {
     'panels.discover.tabOverview': '概览',
     'panels.discover.tabReadme': '说明',
     'panels.discover.tabChangelog': '更新日志',
-    'panels.discover.docTitle': '{version} 的{kind}',
     'panels.discover.docReadme': '说明',
     'panels.discover.docChangelog': '更新日志',
     'panels.discover.docLoading': '正在读取…',
@@ -604,6 +604,8 @@ export const zh = {
     'approval.publish.module': '模块',
     'approval.publish.target': '目标',
     'approval.publish.version': '版本',
+    'approval.publish.author': '作者',
+    'approval.publish.authorMissing': '未署名（提交用本机 git 身份）',
     'approval.publish.registry': '源',
     'approval.publish.repo': '仓库',
     'approval.publish.branch': '分支',

package/dist/index.d.ts

@@ -37,6 +37,10 @@ export * from './config/constants.js';
 export * from './config/storage.js';
 export * from './contract/blocker.js';
 export * from './contract/data.js';
+export * from './contract/extension.js';
+export * from './contract/lib.js';
+export * from './contract/git.js';
+export * from './contract/command.js';
 export * from './contract/facts.js';
 export * from './contract/long-task.js';
 export * from './contract/protocol/bundle-install.js';

package/dist/index.js

@@ -37,6 +37,10 @@ export * from './config/constants.js';
 export * from './config/storage.js';
 export * from './contract/blocker.js';
 export * from './contract/data.js';
+export * from './contract/extension.js';
+export * from './contract/lib.js';
+export * from './contract/git.js';
+export * from './contract/command.js';
 export * from './contract/facts.js';
 export * from './contract/long-task.js';
 export * from './contract/protocol/bundle-install.js';

package/dist/lib/version.d.ts

@@ -0,0 +1,4 @@
+export declare function isValidVersion(value: string): boolean;
+export declare function isPrereleaseVersion(value: string): boolean;
+export declare function compareVersions(left: string, right: string): number | undefined;
+export declare function isNewerVersion(latest: string, installed: string): boolean;

package/dist/lib/version.js

@@ -0,0 +1,21 @@
+import semver from 'semver';
+export function isValidVersion(value) {
+    return semver.valid(value.trim()) !== null;
+}
+export function isPrereleaseVersion(value) {
+    const parsed = semver.valid(value.trim());
+    return parsed !== null && semver.prerelease(parsed) !== null;
+}
+export function compareVersions(left, right) {
+    const a = semver.valid(left.trim());
+    const b = semver.valid(right.trim());
+    if (a === null || b === null)
+        return undefined;
+    return semver.compare(a, b);
+}
+export function isNewerVersion(latest, installed) {
+    if (latest === installed)
+        return false;
+    const compared = compareVersions(latest, installed);
+    return compared === undefined ? true : compared > 0;
+}

package/dist/testing/git.d.ts

@@ -0,0 +1,3 @@
+import type { DshShell } from '../api/dsh.js';
+import type { GitReader } from '../contract/git.js';
+export declare function createFakeGit(shell: DshShell): GitReader;

package/dist/testing/git.js

@@ -0,0 +1,36 @@
+import { quoteShellArg, tailLines } from '../host/shell-text.js';
+import { runShell } from '../host/shell.js';
+export function createFakeGit(shell) {
+    return {
+        async origin(path) {
+            const key = path.trim();
+            if (!key)
+                return { kind: 'unknown', reason: 'no-path' };
+            const result = await runShell(shell, `git -C ${quoteShellArg(key)} remote get-url origin`);
+            if (result.exitCode !== 0)
+                return { kind: 'no-origin', detail: tailLines(result.stderr, 3) };
+            return { kind: 'ok', remote: result.stdout.trim() };
+        },
+        async branch(path) {
+            const key = path.trim();
+            if (!key)
+                return { kind: 'unknown', reason: 'no-path' };
+            const result = await runShell(shell, `git -C ${quoteShellArg(key)} rev-parse --abbrev-ref HEAD`);
+            const name = result.stdout.trim();
+            if (result.exitCode !== 0)
+                return { kind: 'no-branch', detail: tailLines(result.stderr, 3) };
+            if (name === '' || name === 'HEAD')
+                return { kind: 'no-branch', detail: name };
+            return { kind: 'ok', branch: name };
+        },
+        async head(path) {
+            const key = path.trim();
+            if (!key)
+                return { kind: 'unknown', reason: 'no-path' };
+            const result = await runShell(shell, `git -C ${quoteShellArg(key)} rev-parse HEAD`);
+            if (result.exitCode !== 0)
+                return { kind: 'no-head', detail: tailLines(result.stderr, 3) };
+            return { kind: 'ok', commit: result.stdout.trim() };
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",
@@ -37,13 +37,15 @@
     "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
     "@types/node": "^24.19.0",
     "@types/react": "^19.0.0",
+    "@types/semver": "^7.8.0",
     "@vitest/coverage-v8": "^5.0.2",
     "react": "^18.0.0",
     "typescript": "5.9",
     "vitest": "^5.0.2"
   },
   "dependencies": {
-    "dayjs": "^1.11.23"
+    "dayjs": "^1.11.23",
+    "semver": "^7.8.5"
   },
   "repository": {
     "type": "git",
@@ -55,12 +57,12 @@
     "url": "https://github.com/novaeth/dsh-workbench/issues"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
+    "build": "node scripts/gen-release-packages.mjs && tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
     "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/tsconfig.tsbuildinfo",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
     "barrels": "node scripts/barrels.mjs",
-    "selfcheck": "node scripts/check-state.mjs",
+    "selfcheck": "node scripts/check-state.mjs && node scripts/gen-release-packages.mjs --check",
     "arch:report": "arch-guard --report-only",
     "arch": "arch-guard"
   }

package/src/components/Form.test.tsx

@@ -403,6 +403,12 @@ describe('formRowsOf', () => {
     expect(propsOf(rows[0])['children']).toBe('env:wb-form-env:true:false');
   });
 
+  it('★ 标签挂到同一格的控件上（htmlFor 与绑定 id 同一个值）', () => {
+    const rows = formRowsOf({ fields: [field('env', 'prod')], problems, showProblem: true, busy: false });
+
+    expect(propsOf(rows[0])['htmlFor']).toBe('wb-form-env');
+  });
+
   it('★ 这一格的 value / onChange 从字段配置原样进绑定（值只写一处）', () => {
     const onChange = (): void => {};
     const probe: FormField = {

package/src/components/FormNodes.tsx

@@ -193,6 +193,7 @@ export function formRowsOf<Values extends object>(args: {
     h(FormRow, {
       key: field.key,
       label: field.label,
+      htmlFor: controlIdOf(field.key),
       hint: field.hint,
       problem: args.showProblem ? args.problems[field.key] : undefined,
       layout: field.layout,
@@ -200,6 +201,10 @@ export function formRowsOf<Values extends object>(args: {
   );
 }
 
+function controlIdOf(key: string): string {
+  return `wb-form-${key}`;
+}
+
 function controlOf<K extends string, V, Vals extends object>(
   field: FormField<K, V, Vals>,
   problems: Readonly<Record<string, ReactNode | undefined>>,
@@ -207,7 +212,7 @@ function controlOf<K extends string, V, Vals extends object>(
   busy: boolean,
 ): ReactNode {
   return field.control({
-    id: `wb-form-${field.key}`,
+    id: controlIdOf(field.key),
     name: field.key,
     invalid: showProblem && Boolean(problems[field.key]),
     disabled: busy || field.disabled === true,

package/src/components/FormRows.css

@@ -29,6 +29,7 @@
 }
 
 .wb-formLabel {
+  justify-self: start;
   min-width: 0;
   font-size: var(--dsw-font-xs-13-font-size);
   color: var(--dsw-alias-label-secondary);

package/src/components/FormRows.test.tsx

@@ -48,6 +48,35 @@ describe('FormRow', () => {
     expect(childrenOf(node).filter((one) => one !== null)).toHaveLength(2);
   });
 
+  it('★ 行是 <div>，<label> 只包标签文字 —— 控件、提示与整行空白都不在标签里', () => {
+    const node = FormRow({
+      label: '项目',
+      htmlFor: 'wb-form-project',
+      hint: '选错了也能改',
+      children: '下拉',
+    }) as unknown as { type: unknown; props: { children: unknown[] } };
+    const [labelNode, controlNode, hintNode] = node.props.children as {
+      type: unknown;
+      props: Record<string, unknown>;
+    }[];
+
+    expect(node.type).toBe('div');
+    expect(labelNode?.type).toBe('label');
+    expect(labelNode?.props['htmlFor']).toBe('wb-form-project');
+    expect(texts(labelNode)).toEqual(['项目']);
+    expect(controlNode?.props['className']).toBe('wb-formControl');
+    expect(hintNode?.props['className']).toBe('wb-formHint');
+  });
+
+  it('没给 htmlFor 就不挂 for（排布照旧，只是点标签不聚焦）', () => {
+    const node = FormRow({ label: '项目', children: '下拉' }) as unknown as {
+      props: { children: unknown[] };
+    };
+    const labelNode = node.props.children[0] as { props: Record<string, unknown> };
+
+    expect(labelNode.props['htmlFor']).toBeUndefined();
+  });
+
   it('有 problem 就顶掉 hint（同一格，二选一），错误行挂 data-wb-problem 给聚焦那件找', () => {
     const node = FormRow({
       label: '项目',
@@ -150,6 +179,7 @@ describe('标签列：同一个 FormRows 共用一列（ADR-0052 §11）', () =>
 
   it('★ 标签不折行；stacked 还是单列、标签照常换行', () => {
     expect(declarations('.wb-formLabel')).toContain('white-space: nowrap');
+    expect(declarations('.wb-formLabel')).toContain('justify-self: start');
     expect(declarations(".wb-formRow[data-layout='stacked'] .wb-formLabel")).toContain(
       'white-space: normal',
     );

package/src/components/FormRows.tsx

@@ -23,6 +23,7 @@ export function FormRows({ children }: FormRowsProps) {
  */
 export interface FormRowProps {
   readonly label: ReactNode;
+  readonly htmlFor?: string | undefined;
   readonly hint?: ReactNode | undefined;
   readonly problem?: ReactNode | undefined;
   readonly layout?: 'inline' | 'stacked' | undefined;
@@ -32,20 +33,23 @@ export interface FormRowProps {
 /**
  * 表单一行：左边标签、右边控件，提示与错误占控件下面那一格。
  * @param props.label - 这一行的标签；进了这一行，控件自己就别再给 `label`，否则会多一个标签。
+ * @param props.htmlFor - 标签挂到哪个控件（同一个 `id`）；不给就只是排布，点标签不聚焦 —— `Form` 会自己接好。
  * @param props.hint - 控件下的说明；给了 `problem` 就不画它 —— 同一格不叠两段话。
  * @param props.problem - 校验失败那句话；给了就顶掉 `hint` 并给整行加上出错标记。
  * @param props.layout - `stacked` 才是标签在上、控件在下（默认 `inline`：标签在左）。
  * @param props.children - 控件本体。
- * @returns 一个 `<label>`。
+ * @returns 一个 `<div>`：里面的 `<label>` 只包标签文字，不包控件、提示与整行的空白。
  */
-export function FormRow({ label, hint, problem, layout = 'inline', children }: FormRowProps) {
+export function FormRow({ label, htmlFor, hint, problem, layout = 'inline', children }: FormRowProps) {
   return (
-    <label
+    <div
       className="wb-formRow"
       data-layout={layout}
       data-wb-problem={problem === undefined ? undefined : ''}
     >
-      <span className="wb-formLabel">{label}</span>
+      <label className="wb-formLabel" htmlFor={htmlFor}>
+        {label}
+      </label>
       <span className="wb-formControl">{children}</span>
       {problem === undefined ? (
         hint === undefined ? null : (
@@ -54,6 +58,6 @@ export function FormRow({ label, hint, problem, layout = 'inline', children }: F
       ) : (
         <span className="wb-formProblem">{problem}</span>
       )}
-    </label>
+    </div>
   );
 }

package/src/config/constants.ts

@@ -1,12 +1,6 @@
 /** 外壳插件的包名：浏览器模块表与宿主按它注册、认领这枚插件。 */
 export const PLUGIN_ID = "@dsh-workbench/core";
 
-/** 与外壳同批发布的兄弟包名：`release.ts` 用它判一版三包是否都已在源上。 */
-export const RELEASE_SIBLINGS = [
-  "@dsh-workbench/shared",
-  "@dsh-workbench/module-tools",
-] as const;
-
 /** 外壳宿主 HTTP API 的根前缀；prefs / actions / provision 等路由都挂在它下面。 */
 export const API_PREFIX = "/workbench/api";
 

package/src/contract/command.ts

@@ -0,0 +1,25 @@
+export interface CommandFile {
+  readonly content: string;
+  readonly suffix?: string | undefined;
+}
+
+export interface CommandRequest {
+  readonly argv: readonly string[];
+  readonly timeoutMs?: number | undefined;
+  readonly cwd?: string | undefined;
+  readonly files?: readonly CommandFile[] | undefined;
+  readonly appendFileArgs?: string | undefined;
+}
+
+export interface CommandResult {
+  readonly stdout: string;
+  readonly stderr: string;
+  readonly exitCode: number;
+  readonly timedOut: boolean;
+  readonly filePaths: readonly string[];
+  readonly error?: string | undefined;
+}
+
+export interface CommandReader {
+  run(request: CommandRequest): Promise<CommandResult>;
+}

package/src/contract/data.ts

@@ -19,7 +19,8 @@ export interface BrowserDataRequest extends DataRequestBase {
 
 export interface CommandDataRequest extends DataRequestBase {
   readonly kind: 'command';
-  readonly command: string;
+  readonly adapter: string;
+  readonly argv: readonly string[];
 }
 
 export type DataRequest = HttpDataRequest | BrowserDataRequest | CommandDataRequest;

package/src/contract/extension.ts

@@ -0,0 +1,20 @@
+export type ExtensionSession = 'persistent' | 'ephemeral' | 'none';
+
+export interface ExtensionCallOptions {
+  readonly key?: string;
+  readonly workdir?: string;
+  readonly session?: ExtensionSession;
+  readonly timeoutMs?: number;
+}
+
+export interface ExtensionValue<T = unknown> {
+  readonly value: T;
+  readonly at: number;
+}
+
+export interface ExtensionCaller {
+  json(
+    args: readonly string[],
+    options?: ExtensionCallOptions,
+  ): Promise<ExtensionValue>;
+}

package/src/contract/git.ts

@@ -0,0 +1,20 @@
+export type OriginRead =
+  | { readonly kind: 'ok'; readonly remote: string }
+  | { readonly kind: 'no-origin'; readonly detail?: string }
+  | { readonly kind: 'unknown'; readonly reason: string; readonly detail?: string };
+
+export type BranchRead =
+  | { readonly kind: 'ok'; readonly branch: string }
+  | { readonly kind: 'no-branch'; readonly detail?: string | undefined }
+  | { readonly kind: 'unknown'; readonly reason: string; readonly detail?: string | undefined };
+
+export type HeadRead =
+  | { readonly kind: 'ok'; readonly commit: string }
+  | { readonly kind: 'no-head'; readonly detail?: string }
+  | { readonly kind: 'unknown'; readonly reason: string; readonly detail?: string };
+
+export interface GitReader {
+  origin(path: string): Promise<OriginRead>;
+  branch(path: string): Promise<BranchRead>;
+  head(path: string): Promise<HeadRead>;
+}

package/src/contract/lib.ts

@@ -0,0 +1,5 @@
+import type { LibNeed } from './needs.js';
+
+export interface LibReader {
+  load<T = unknown>(need: LibNeed, entry: string): Promise<T>;
+}