@dsh-workbench/module-tools 1.0.1 → 1.1.0

package/README.md

@@ -26,6 +26,8 @@ pnpm design check # 设计底稿有没有空格、README 有没有落后
 （沿用记录里的出口、版本与索引计划，产物没变就不重跑门禁）。
 这一版在 `CHANGELOG.md` 里没有记录、或 `package.json` 缺 `files` 里的 `CHANGELOG.md` 时，
 `release` 直接拦下并给出补的命令；`author` 没写时从本机 `git config` 补进 manifest，索引与产物都带上。
+要换署名时带 `--author "姓名 <邮箱>"`（或只给姓名）：它写回 `package.json`，索引、产物与提交都用它，
+`--refresh` 时也一样。
 
 骨架自带脚本，日常不用记长命令：`build` · `typecheck` · `test` · `selfcheck` · `check` · `lint` · `design`。
 
@@ -231,9 +233,10 @@ dsh-wb-module design accept   # 在真卡片上逐条走通后打勾
 
 ```jsonc
 "workbench": {
-  "apiVersion": 2,
+  "apiVersion": 3,
   "unit": "hello",
-  "card": { "titleKey": "hello.cardTitle", "order": 90 },
+  "title": { "zh": "示例模块", "en": "Sample module" },
+  "card": { "order": 90 },
   "tools": [{ "name": "hello_read", "writes": false }],
   "host": { "inject": [] },
   "needs": [
@@ -252,8 +255,9 @@ dsh-wb-module design accept   # 在真卡片上逐条走通后打勾
 
 五条口径：
 
-1. **声明了 `apiVersion` = 静态半写全了**：`unit` / `card` / `tools` / `host` 四个键都要有
-   （没有卡片写 `null`），`needs` 没有外部需要时省略。
+1. **声明了 `apiVersion` = 静态半写全了**：`unit` / `title` / `card` / `tools` / `host` 五个键都要有
+   （没有卡片写 `null`），`needs` 没有外部需要时省略。名字是包里的字面量（中英各一份），
+   不是词表键 —— 宿主在模块载入之前就读得到它。
    `needs` 四种 `kind`：`bin` / `extension` / `lib` / `env`；每条必写 `purpose`；
    未知 `kind` 或 `sources[].kind` 判红，need 里未知字段只算警告（`x-` 前缀忽略）。
 2. **不许有协议不认识的键**：生字段会被外壳静默忽略（拼错一个键就等于那句话没写），

package/bin/dsh-wb-module.mjs

@@ -60,6 +60,7 @@ const RELEASE_HELP = `
   --version patch|minor|major|x.y.z                     版本；省略时已存在就自动 patch
   --registry <url> --access restricted|public --npmrc <文件>
   --license <id> --out <目录> --git <remote>
+  --author <署名>                                       换署名（姓名，或 姓名 <邮箱>）；写回 package.json
   --index auto|none|<目录|git 地址>                     发布后要更新的索引源
   --index-ref <分支> --index-path <索引路径> --index-policy artifacts-in-repo|catalog-only
   --resume                                              上次中断后接着发（用记录里的出口与版本）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/module-tools",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "模块包的构建与门禁工具：build（单文件 ESM 宿主侧 + 套 loader 壳的浏览器侧）、check（契约/产物边界/源码边界/卡片渲染）。模块包不再各带一份构建脚本。",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
     "semver": "^7.8.5",
     "typescript": "5.9.3",
     "typescript-eslint": "^8.71.0",
-    "@dsh-workbench/shared": "1.0.1"
+    "@dsh-workbench/shared": "1.1.0"
   },
   "repository": {
     "type": "git",

package/src/checks/cards.mjs

@@ -381,8 +381,7 @@ export async function run() {
     }
 
     const declared = pkg.manifest.dsh?.workbench?.card ?? null;
-    const declaresCard =
-      declared !== null && typeof declared.titleKey === 'string' && declared.titleKey !== '';
+    const declaresCard = declared !== null && typeof declared === 'object';
 
     const shellClient = shellClientPathOf(pkg.dir);
     const hasShell = shellClient !== undefined && existsSync(shellClient);
@@ -457,7 +456,7 @@ export async function run() {
       if (typeof card === 'function') {
         problems.push(
           `${name}: 清单写的是 "card": null，产物却登记了一张卡片 —— 两处说法不一致：` +
-            '要么把清单补成一张卡（titleKey + order），要么把这张卡从产物里去掉',
+            '要么把清单补成一张卡（`"card": { "order": … }`），要么把这张卡从产物里去掉',
         );
         continue;
       }
@@ -465,29 +464,10 @@ export async function run() {
       continue;
     }
     if (typeof card !== 'function') {
-      problems.push(`${name}: 清单写了 card.titleKey，apply 之后却没登记卡片（registerUnit 没拿到 card）`);
+      problems.push(`${name}: 清单写了 card，apply 之后却没登记卡片（registerUnit 没拿到 card）`);
       continue;
     }
 
-    const titleKey = pkg.manifest.dsh?.workbench?.card?.titleKey;
-    if (typeof titleKey === 'string' && titleKey !== '') {
-      const messages = registered?.messages;
-      if (messages === undefined || messages === null || typeof messages !== 'object') {
-        problems.push(
-          `${name}: 清单的 card.titleKey「${titleKey}」没有落点 —— registerUnit 交的面里没有 messages，` +
-            '面板上那一格会显示原始键名',
-        );
-      } else {
-        const missing = ['zh', 'en'].filter((one) => typeof messages[one]?.[titleKey] !== 'string');
-        if (missing.length > 0) {
-          problems.push(
-            `${name}: 清单的 card.titleKey「${titleKey}」在模块字典的 ${missing.join(' / ')} 里没有 —— ` +
-              '面板上那一格会显示原始键名。清单写了 titleKey，字典就得有这一条（zh / en 都要）',
-          );
-        }
-      }
-    }
-
     const props = {
       world: { current: { sessionId: null, workspace: null } },
       t: (key) => key,
@@ -664,7 +644,7 @@ export async function run() {
           ? `${SNAPSHOTS.length} 态 × zh/en 各渲染一遍`
           : `逐态那半这次有 ${degraded} 个模块跳过（没装外壳 / 取不出外壳，见下），其余 ${SNAPSHOTS.length} 态 × zh/en 各渲染一遍`) +
         ' —— 不抛、非空白、文字里没有 ' +
-        'undefined / NaN / [object Object] / null、没有裸键名、套了外壳的卡壳、清单的 titleKey 在两语字典里都有落点。' +
+        'undefined / NaN / [object Object] / null、没有裸键名、套了外壳的卡壳；名字来自清单顶层的 title（协议判据管它中英都有）。' +
         `（断言的是"${SNAPSHOTS.length} 种外壳侧输入下都退化得漂亮"，不是"画的是哪一态那一屏" —— 屏的对错归模块自己的 ` +
         'card-states.test.ts 与 design.json 状态矩阵）',
       ...(shellClients.length === 0

package/src/release.mjs

@@ -246,6 +246,11 @@ export async function runRelease({
   const json = hasFlag(args, '--json');
   const dryRun = hasFlag(args, '--dry-run');
   const verify = hasFlag(args, '--verify');
+  const askedAuthor = argValue(args, '--author');
+  const explicitAuthor = askedAuthor === undefined ? undefined : askedAuthor.trim();
+  if (askedAuthor !== undefined && (explicitAuthor === '' || /[\r\n]/u.test(explicitAuthor))) {
+    throw new ReleaseError('--author 只认一行署名：姓名，或 姓名 <邮箱>');
+  }
   const manifest = readManifest(root);
   const unit = manifest?.dsh?.workbench?.unit;
   if (typeof unit !== 'string' || unit === '') throw new ReleaseError('这不是一个 wb 模块包（没有 dsh.workbench.unit）');
@@ -297,6 +302,11 @@ export async function runRelease({
     emit(out, json, summary);
     return summary;
   }
+  const explicitApplied = explicitAuthor !== undefined && !verify && !dryRun;
+  if (explicitApplied) {
+    manifest.author = explicitAuthor;
+    writeManifest(root, manifest);
+  }
   if (target === 'market') {
     if (indexPlan === undefined) {
       throw new ReleaseError('没有可写的 git 索引源 —— 用 --index <仓库> 指定，或先在「模块市场 → 发现」里初始化索引');
@@ -329,7 +339,10 @@ export async function runRelease({
         ...(result.branch === undefined ? {} : { branch: result.branch }),
         ...(result.commit === undefined ? {} : { commit: result.commit }),
       },
-      changes: result.updated === true ? ['市集元数据已刷新'] : [],
+      changes:
+        result.updated === true
+          ? ['市集元数据已刷新', ...(explicitAuthor === undefined ? [] : ['author ← --author'])]
+          : [],
       install: '',
       text:
         result.updated === true
@@ -340,8 +353,8 @@ export async function runRelease({
     return summary;
   }
   const authored = authorChangeOf(root, manifest, exec);
-  const authorChange = authored.change;
-  if (!verify && !dryRun && authored.author !== undefined) {
+  const authorChange = explicitAuthor === undefined ? authored.change : 'author ← --author';
+  if (!explicitApplied && !verify && !dryRun && authored.author !== undefined) {
     manifest.author = authored.author;
     writeManifest(root, manifest);
   }

package/template/package.json.tpl

@@ -26,9 +26,10 @@
       "external": ["@dsh-workbench/core/client", "@deepseek-ai/dsh-client-ui-primitives"]
     },
     "workbench": {
-      "apiVersion": 2,
+      "apiVersion": 3,
       "unit": "__UNIT__",
-      "card": { "titleKey": "__UNIT__.cardTitle", "order": 90 },
+      "title": { "zh": "__UNIT__ 模块", "en": "__UNIT__ module" },
+      "card": { "order": 90 },
       "tools": [],
       "host": { "inject": [] }
     },

package/template-diy/package.json.tpl

@@ -27,9 +27,10 @@
       "external": ["@dsh-workbench/core/client", "@deepseek-ai/dsh-client-ui-primitives"]
     },
     "workbench": {
-      "apiVersion": 2,
+      "apiVersion": 3,
       "unit": "__UNIT__",
-      "card": { "titleKey": "__UNIT__.cardTitle", "order": 90 },
+      "title": { "zh": "__UNIT__ 模块", "en": "__UNIT__ module" },
+      "card": { "order": 90 },
       "tools": [],
       "host": { "inject": [] }
     },