made-market 0.1.1 → 0.1.2

package/bin/made-market.mjs

@@ -13,10 +13,11 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { ROOT } from '../lib/market.mjs';
-import { install, loadRegistry, resolveHome, resolveRegistry } from '../src/install.mjs';
+import { ROOT, validatePackage } from '../lib/market.mjs';
+import { DEFAULT_SERVER, install, loadRegistry, resolveHome, resolveRegistry } from '../src/install.mjs';
 import { publish } from '../src/publish.mjs';
 import { login, logout, register, resolvePassword, whoami } from '../src/account.mjs';
+import { scaffold } from '../src/init.mjs';
 
 // 版本号读 CLI 自己的 package.json（cli/），发布后即 node_modules/made-market/package.json。
 const CLI_PACKAGE_JSON = fileURLToPath(new URL('../package.json', import.meta.url));
@@ -30,6 +31,8 @@ const USAGE = `码得 · 插件市场  (made-market)
   npx made-market <命令> [参数] [选项]
 
 命令
+  init <目录> --kind <类型>    生成插件脚手架（可直接 publish 的最小包，SDK 入口）
+  validate <包目录>            本地校验一个包（与市场服务端同一套规则）
   list                        列出索引里的全部包
   search <关键词>              在包名、简介和标签里搜索
   info <包 ID>                 看一个包的详情：文件、校验和、安装位置、创建人
@@ -39,17 +42,18 @@ const USAGE = `码得 · 插件市场  (made-market)
   login <用户名>               登录市场服务（发布的前提；90 天会话）
   whoami                      看当前登录的账号
   logout                      退出登录（吊销服务端会话并删除本地凭证）
-  rebuild-from-store           管理命令：从存储 manifests 全量重建 PG 索引
+  rebuild-from-store           管理命令：从存储 manifests 全量重建 SQLite 索引
 
 选项
   --home <目录>                包目录根，默认 $MADE_HOME 或 ~/made
-  --registry <路径|URL>        索引来源。默认优先 $MADE_MARKET_REGISTRY（如市场服务的索引），
-                               不可用或未设置时回落到本包自带的索引（离线可用）
-  --server <URL>              市场服务地址（register/login/publish；默认 $MADE_MARKET_SERVER，
-                               已登录时也可从凭证读取）
+  --registry <路径|URL>        索引来源。默认 $MADE_MARKET_REGISTRY > 官方市场（联网拉实时索引，
+                               失败回落本包自带索引，离线可装示例包）
+  --server <URL>              市场服务地址（register/login/publish/install；install 默认官方市场，
+                               可用 $MADE_MARKET_SERVER 覆盖，已登录时 publish 也可从凭证读取）
   --token <t>                 发布 token（publish；默认 $MADE_MARKET_TOKEN 或登录凭证）
   --password <pw>             密码（register/login；缺省在 TTY 下不回显输入）
-  --kind theme|control|agent   只列某一类（list / search）
+选项
+  --kind theme|control|agent   init 的包类型 / list、search 只列某一类
   --json                       以 JSON 输出
   --force                      目标目录已存在时覆盖
   --dry-run                    只校验并列出将要写入的文件
@@ -178,8 +182,25 @@ async function main() {
     return;
   }
 
-  // 索引来源按需加载：--registry > $MADE_MARKET_REGISTRY > 包内自带（远端失败自动回落，离线可用）。
-  // rebuild-from-store 与 install --server（API 模式）不依赖全量索引。
+  // 脚手架：不依赖索引。
+  if (options.command === 'init') {
+    const dir = options.args[0];
+    if (!dir) throw new Error('init 需要一个包目录名，例如：npx made-market init my-theme --kind theme');
+    const written = scaffold({ dir, kind: options.kind, force: options.force });
+    console.log(`脚手架已生成（${options.kind || '?'} 包，共 ${written.length} 个文件）：`);
+    for (const file of written) console.log(`  ${file}`);
+    console.log('\n下一步：');
+    console.log('  1. 改掉 market.json / theme.json（或 plugin.mjs）里的占位文案');
+    console.log(`  2. 本地校验：npx made-market validate ${dir}`);
+    console.log(`  3. 注册并发布：npx made-market register <用户名> --server https://made-market.link`);
+    console.log(`     npx made-market publish ${dir} --server https://made-market.link`);
+    console.log('  开发文档见市场主页「开发者指南」。');
+    return;
+  }
+
+  // 索引来源按需加载：--registry > $MADE_MARKET_REGISTRY > 官方市场实时索引
+  // （远端失败自动回落包内自带索引，离线可装示例包）。
+  // rebuild-from-store 不依赖全量索引。
   const loadIndex = () => loadRegistry(resolveRegistry(options.registry));
 
   if (options.command === 'list') {
@@ -232,11 +253,17 @@ async function main() {
 
   if (options.command === 'install') {
     if (!options.args.length) throw new Error('install 需要至少一个包 ID');
-    // 配了 --server / $MADE_MARKET_SERVER：按包直查 API，不拉全量索引（大市场友好）。
-    if (options.server || process.env.MADE_MARKET_SERVER) {
-      const { packages, base } = await resolveViaApi(options.args, options.server || process.env.MADE_MARKET_SERVER);
-      await install(options.args, { home: options.home, registry: base, index: { packages }, force: options.force, dryRun: options.dryRun });
-      return;
+    // 默认走市场 API：按包直查最新版本，不拉全量索引（大市场友好），
+    // 新发布的包立即可装。显式 --registry 才按索引文件走（自建源/精确复现用）。
+    if (!options.registry) {
+      const server = options.server || process.env.MADE_MARKET_SERVER || DEFAULT_SERVER;
+      try {
+        const { packages, base } = await resolveViaApi(options.args, server);
+        await install(options.args, { home: options.home, registry: base, index: { packages }, force: options.force, dryRun: options.dryRun });
+        return;
+      } catch (error) {
+        console.error(`线上市场不可用（${error.message}），改用包内自带索引（仅示例包，离线兜底）。`);
+      }
     }
     // 归档从索引所在的位置取：远端索引配远端归档，自带索引配包内归档，可离线。
     const { source, index } = await loadIndex();
@@ -244,6 +271,27 @@ async function main() {
     return;
   }
 
+  // 本地校验：与服务端同一套规则（cli/lib/market.mjs 的 validatePackage），
+  // 上架前先在本地把错误清零，省一轮发布失败。
+  if (options.command === 'validate') {
+    const dir = options.args[0];
+    if (!dir) throw new Error('validate 需要一个包目录');
+    const marketPath = path.join(dir, 'market.json');
+    if (!fs.existsSync(marketPath)) throw new Error(`${dir} 里没有 market.json`);
+    const market = JSON.parse(fs.readFileSync(marketPath, 'utf8'));
+    const pkg = { id: path.basename(path.resolve(dir)), kind: market.kind, dir, market };
+    const result = validatePackage(pkg);
+    for (const message of result.errors) console.error(`  错误：${message}`);
+    for (const message of result.warnings) console.warn(`  警告：${message}`);
+    if (result.errors.length) {
+      console.error(`校验未通过：${result.errors.length} 个错误，${result.warnings.length} 个警告。`);
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`校验通过：${pkg.id} v${market.version}（${result.warnings.length} 个警告）。可以 publish。`);
+    return;
+  }
+
   if (options.command === 'publish') {
     const dir = options.args[0];
     if (!dir) throw new Error('publish 需要一个包目录');
@@ -278,16 +326,16 @@ async function main() {
   }
 
   if (options.command === 'rebuild-from-store') {
-    const { createPool, initSchema, rebuildFromStore } = await import('../server/db.mjs');
-    const { createStore } = await import('../server/store.mjs');
-    if (!process.env.DATABASE_URL) throw new Error('rebuild-from-store 需要 DATABASE_URL 指向 PG 索引库');
-    const db = createPool(process.env.DATABASE_URL);
+    // 索引库是服务端配套能力，rebuild-from-store 属管理命令，仅在仓库内可用（npm 包不含 server/）。
+    const { openDatabase, initSchema, rebuildFromStore } = await import('../../server/db.mjs');
+    const { createStore } = await import("../../server/store.mjs");
+    const db = openDatabase();
     try {
       await initSchema(db);
       const count = await rebuildFromStore(db, createStore(), { log: (key) => console.log(`  同步 ${key}`) });
       console.log(`索引重建完成：${count} 条版本事实。`);
     } finally {
-      await db.close();
+      db.close();
     }
     return;
   }

package/lib/market.mjs

@@ -12,7 +12,14 @@ import { checkTheme, THEME_NAME } from './theme.mjs';
 import { BOARD_COMMANDS, BOARD_EVENTS, PACKAGE_DIR, checkNames, parseSettingsSpec, scanPluginSource } from './plugin.mjs';
 import { MAX_JSON_BYTES, validateIcon } from './icon.mjs';
 
+/** 仓库根（dev 时 = 仓库根；发布包里没有 packages/，这个只给仓库内工具与测试用）。 */
 export const ROOT = path.resolve(fileURLToPath(new URL('../..', import.meta.url)));
+/**
+ * 包根：lib/ 的上一级。仓库里是 cli/（自带 registry/index.json 的生成物），
+ * 发布包里就是包根（npm 包无 cli/ 前缀）。找包内自带资源一律用它，不能用 ROOT——
+ * 发布后 ROOT 会落到 node_modules/，这就是「找不到索引」bug 的根源。
+ */
+export const PKG_ROOT = path.resolve(fileURLToPath(new URL('..', import.meta.url)));
 export const API_VERSION = 1;
 export const SEMVER = /^\d+\.\d+\.\d+$/;
 export const MAX_DESCRIPTION = 4000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "made-market",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "码得（made）公开插件市场的命令行工具：列出、搜索、安装主题/管控/agent 包，以及登录后发布新包。市场服务端在 github.com/jobop/made-market 仓库内，不随本包分发。",
   "type": "module",
   "license": "MIT",

package/registry/index.json

@@ -80,7 +80,7 @@
       ],
       "payloadBytes": 209717,
       "archiveBytes": 39822,
-      "sha256": "f99ab016bda97781fba979cf5d31ffec18edf1ea91a2339c1d7e4cf63f36a0a7",
+      "sha256": "b656724a6be3466c0ad52010bfa9f2a3b043595b6b7b6bed90a01bdfcca3ba95",
       "download": "packages/sunset-1.0.0.tar.gz",
       "swatch": [
         "#e0834a",
@@ -153,7 +153,7 @@
       ],
       "payloadBytes": 212917,
       "archiveBytes": 44910,
-      "sha256": "a48c12c45c83185041a25ea0f408f8ce15a1632d4473440a0a1fbc7b5f674cd1",
+      "sha256": "3894aadcfdba77eb351abc4381d3b76141ed0d6a15d8b75a982a64092e1300fa",
       "download": "packages/ocean-1.0.0.tar.gz",
       "swatch": [
         "#2fa3b8",
@@ -226,7 +226,7 @@
       ],
       "payloadBytes": 198517,
       "archiveBytes": 31125,
-      "sha256": "9dd6037414f9303ecc507c4348380baeaf8dd2a97c98c58748410c18b37c014e",
+      "sha256": "ff66fd400882e4ce3017b32782825aca59e60e5a407c793b175d2c4500c1cb97",
       "download": "packages/graphite-1.0.0.tar.gz",
       "swatch": [
         "#8e9aa6",
@@ -299,7 +299,7 @@
       ],
       "payloadBytes": 206517,
       "archiveBytes": 34163,
-      "sha256": "76095ce19587f8e0bc7ba5aeb7ca62f1e622bc8ef14847fdb3479dbf0ea87b29",
+      "sha256": "24dbf64bb96520a16efbfbb553ccff91190ae4fde5b18444f3c6a7ee97b0993f",
       "download": "packages/bamboo-1.0.0.tar.gz",
       "swatch": [
         "#5aa85e",
@@ -367,7 +367,7 @@
       ],
       "payloadBytes": 1576,
       "archiveBytes": 1067,
-      "sha256": "35c4768f607bb936b2e263e972895920c66cce74a8829d944cd86c6d2e5b0030",
+      "sha256": "c3f6afae9ef5f47b622c74c2faf7174ba2ba38a9db2d19651a992874fd6f5f9a",
       "download": "packages/theme-cycler-1.0.0.tar.gz",
       "sourcePath": "packages/control/theme-cycler"
     },
@@ -430,7 +430,7 @@
       ],
       "payloadBytes": 3023,
       "archiveBytes": 1808,
-      "sha256": "0c7c6453b78a76c327282dfd62f6d023e90dc12a2c7458a67b1b43e5e20e15ba",
+      "sha256": "ab7acdc88895a391596182fa9425e1e81d0b7ec5de73c035b9fe0ee2a7a3a123",
       "download": "packages/webhook-notify-1.0.0.tar.gz",
       "sourcePath": "packages/control/webhook-notify"
     },
@@ -492,7 +492,7 @@
       ],
       "payloadBytes": 2370,
       "archiveBytes": 1450,
-      "sha256": "cea53eedab0232272ed6f5ebd5c6b8a7250ff08240fb2d754b16b1e7c9088d7a",
+      "sha256": "43512f16e9559f5984ab9cf827b9b8e0e7c5671bc1cd1cf211adc0b0344e9f37",
       "download": "packages/key-chime-1.0.0.tar.gz",
       "sourcePath": "packages/control/key-chime"
     },
@@ -554,7 +554,7 @@
       ],
       "payloadBytes": 3940,
       "archiveBytes": 1959,
-      "sha256": "bd4c7ae744be6a99dacaf663a0624e61e568f8da5e83566eb104127d39ddf11d",
+      "sha256": "c131b7a0e67a9e0a1e4ab23b9dcf5ec05f7bb73c8b43621fe849c6762009c4e0",
       "download": "packages/alarm-clock-1.0.0.tar.gz",
       "sourcePath": "packages/control/alarm-clock"
     },
@@ -621,7 +621,7 @@
       ],
       "payloadBytes": 3793,
       "archiveBytes": 1612,
-      "sha256": "aaf99b7ab9af49712f9ff5da37695c4d41cf89e09ae6ec5168057dede7075546",
+      "sha256": "7f3d1045be427b2d4cbe0b070cb63ca0fc1fe127c63201f9423f23970d37f736",
       "download": "packages/demo-echo-1.0.0.tar.gz",
       "icon": {
         "format": "indexed4",
@@ -702,7 +702,7 @@
       ],
       "payloadBytes": 6098,
       "archiveBytes": 2672,
-      "sha256": "8da05c474aa4b0d3d8913e16109b0ed887a4bab2d1d136527bb85bd798860cff",
+      "sha256": "0a33b62f6f186a80d370012ddd146f9c504daf182503cc23cb4c13bd9c7e35d3",
       "download": "packages/ollama-agent-1.0.0.tar.gz",
       "icon": {
         "format": "indexed4",
@@ -786,7 +786,7 @@
       ],
       "payloadBytes": 5814,
       "archiveBytes": 2456,
-      "sha256": "12de415fa0bb0bfaa3eb119c5e0930b3d3239836d184eab781dc1b36be93d06a",
+      "sha256": "541eef0c992b636cfe5d0b8f1f03dffa15a58b414f061ed392971bd3723a6c0f",
       "download": "packages/shell-agent-1.0.0.tar.gz",
       "icon": {
         "format": "indexed4",

package/src/init.mjs

@@ -0,0 +1,257 @@
+/**
+ * 脚手架：`npx made-market init <目录> --kind theme|control|agent`。
+ *
+ * 生成的就是一个能通过服务端校验、可直接 publish 的最小包——模板里每个
+ * 字段都带中文注释说明"这里填什么、有什么约束"，开发者改掉占位文案就能上架。
+ * 资产（锁屏图/图标/提示音）给的是尺寸合法的占位二进制，替换成真图即可。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { PACKAGE_DIR } from '../lib/plugin.mjs';
+import { renderIcon } from '../lib/icon.mjs';
+
+const THEME_NAME = /^[A-Za-z0-9_-]{1,64}$/;
+
+/** 240×320 锁屏底图：深灰纯色 RGB565（0x2104 → 字节序 04 21）。 */
+function placeholderRgb565(width, height) {
+  const buffer = Buffer.alloc(width * height * 2);
+  for (let i = 0; i < width * height; i++) buffer.writeUInt16LE(0x2104, i * 2);
+  return buffer;
+}
+
+/** 0.3 秒 16 kHz 16-bit 单声道静音 WAV（尺寸与格式合法，替换成真音频即可）。 */
+function placeholderWav() {
+  const sampleRate = 16000;
+  const frames = Math.round(sampleRate * 0.3);
+  const pcm = Buffer.alloc(frames * 2);
+  const header = Buffer.alloc(44);
+  header.write('RIFF', 0, 'ascii');
+  header.writeUInt32LE(36 + pcm.length, 4);
+  header.write('WAVE', 8, 'ascii');
+  header.write('fmt ', 12, 'ascii');
+  header.writeUInt32LE(16, 16);
+  header.writeUInt16LE(1, 20);      // PCM
+  header.writeUInt16LE(1, 22);      // 单声道
+  header.writeUInt32LE(sampleRate, 24);
+  header.writeUInt32LE(sampleRate * 2, 28);
+  header.writeUInt16LE(2, 32);
+  header.writeUInt16LE(16, 34);
+  header.write('data', 36, 'ascii');
+  header.writeUInt32LE(pcm.length, 40);
+  return Buffer.concat([header, pcm]);
+}
+
+const THEME_COLORS = {
+  accent: '5B8DEF', btn_normal: '2E3A4E', btn_cancel: '3A4658', border: '6C8CC7',
+  text_primary: 'EDF3FF', text_secondary: 'B9C8E2', text_hint: '8395B4', text_accent: 'A8C6FF',
+  title: 'F2F7FF', bg_page: '141C29', bg_panel: '1D2836', bg_row: '263344', danger: 'D06A6A', lock_bg: '0F1620',
+};
+
+function themeMarketJson(id) {
+  return {
+    id,
+    kind: 'theme',
+    version: '0.1.0',
+    name: '我的主题',
+    nameEn: 'My Theme',
+    summary: '一句话简介（不超过 200 字节），会显示在市场目录里。',
+    summaryEn: 'One-line summary shown in the market listing.',
+    description: '详细描述：配色思路、锁屏图内容、提示音风格。支持多段。\n\n锁屏图为 240×320 的 RGB565（bg.bin），锁屏图标为 112×112（icon.bin），都随包提供，不需要刷固件。',
+    descriptionEn: 'Long description in English.',
+    author: '你的名字',
+    license: 'MIT',
+    tags: ['示例'],
+    glyph: 'palette',
+    highlights: ['14 项配色一次替换，圆屏上保持高对比'],
+    requires: { apiVersion: 1 },
+    changelog: [{ version: '0.1.0', notes: '首个版本', notesEn: 'First release' }],
+  };
+}
+
+function themeJson() {
+  return {
+    title: '我的主题',
+    colors: { ...THEME_COLORS },
+    sound: { file: 'chime.wav' },
+    lock: { icon: 'icon.bin', icon_w: 112, icon_h: 112, bg: 'bg.bin', bg_w: 240, bg_h: 320 },
+  };
+}
+
+function controlMarketJson(id, pluginId) {
+  return {
+    id,
+    kind: 'control',
+    version: '0.1.0',
+    pluginId,
+    name: '我的管控插件',
+    nameEn: 'My Control Plugin',
+    summary: '一句话简介：这个插件响应板子的什么事件、下发什么命令。',
+    summaryEn: 'One-line summary shown in the market listing.',
+    description: '详细描述工作方式。事件（events）与命令（commands）都只能用板侧公开清单里的名字，写别的设备不会执行。',
+    descriptionEn: 'Long description in English.',
+    author: '你的名字',
+    license: 'MIT',
+    tags: ['示例'],
+    glyph: 'terminal',
+    highlights: ['至少登记一个事件（管控插件的要求）'],
+    requires: { apiVersion: 1 },
+    changelog: [{ version: '0.1.0', notes: '首个版本', notesEn: 'First release' }],
+  };
+}
+
+function controlPluginMjs(pluginId) {
+  return `/**
+ * 管控插件模板：改掉 id/label，实现 onConnect / onEvent，就能发布。
+ *
+ * events 只能填板侧公开清单里的名字（boot.click / boot.double / boot.triple /
+ * boot.long）；commands 只能填 caption.show / audio.play / theme.apply /
+ * volume.set / agent.select / session.* / voice.start / task.*。
+ * 语音通过 send({ name: 'audio.play' }, wav) 入队，send 在 onEvent 返回后仍有效。
+ */
+export default {
+  apiVersion: 1,
+  kind: 'board-plugin',
+  id: '${pluginId}',
+  label: '我的插件',
+  events: ['boot.click'],
+  commands: ['caption.show'],
+  probe: (config) => {
+    // 健康探测：桥接器会显示 available / reason。
+    return { available: true, reason: '模板插件，尚未实现逻辑' };
+  },
+  onConnect({ deviceId, config, send }) {
+    // 设备连上来时触发（可选实现）。
+  },
+  onEvent({ event, deviceId, config, send }) {
+    if (event.name === 'boot.click') {
+      return { commands: [{ name: 'caption.show', fields: { text: '你好，码得！' } }] };
+    }
+    return null;
+  },
+  onDisconnect({ deviceId }) {
+    // 设备断开时触发（可选实现）。
+  },
+};
+`;
+}
+
+function controlPluginJson(pluginId) {
+  return {
+    id: pluginId,
+    settings: [],
+  };
+}
+
+function agentMarketJson(id, pluginId) {
+  return {
+    id,
+    kind: 'agent',
+    version: '0.1.0',
+    pluginId,
+    name: '我的 Agent 运行时',
+    nameEn: 'My Agent Runtime',
+    summary: '一句话简介：接的是哪个模型服务、怎么驱动码得。',
+    summaryEn: 'One-line summary shown in the market listing.',
+    description: '详细描述会话建立方式、模型接入与取消行为。',
+    descriptionEn: 'Long description in English.',
+    author: '你的名字',
+    license: 'MIT',
+    tags: ['示例'],
+    glyph: 'spark',
+    highlights: ['capabilities 需要覆盖 session / model / cancel / progress'],
+    requires: { apiVersion: 1 },
+    changelog: [{ version: '0.1.0', notes: '首个版本', notesEn: 'First release' }],
+  };
+}
+
+/** agent 模板的 capabilities：四个键写成一行字面量，静态扫描（scanPluginSource）才认得。 */
+function agentPluginMjs(pluginId) {
+  return `/**
+ * agent 运行时模板：把云端模型会话接到码得。capabilities 静态扫描会检查
+ * session / model / cancel / progress 四个键是否齐全（缺了只是告警，但建议补全）。
+ * agent 包不接收板侧事件。
+ */
+const createSession = async ({ deviceId, config }) => {
+  // 建立（或复用）一个模型会话，返回会话句柄。
+  return { id: \`demo-\${deviceId}\`, model: 'demo-model' };
+};
+const currentModel = async ({ config }) => 'demo-model';
+const cancelTask = async () => { /* 取消当前任务 */ };
+const reportProgress = ({ state }) => { /* 上报进度 */ };
+
+export default {
+  apiVersion: 1,
+  kind: 'coding-agent',
+  id: '${pluginId}',
+  label: '我的 Agent',
+  capabilities: { session: createSession, model: currentModel, cancel: cancelTask, progress: reportProgress },
+};
+`;
+}
+
+function agentIconJson() {
+  // 与桥接器同一套 renderIcon：画一个 48×48 圆角方块占位图标（合法 indexed4）。
+  return renderIcon({ background: '#141C29', accent: '#5B8DEF', shapes: [[12, 12, 18, 18, '5B8DEF', 5]] });
+}
+
+const SCHEMAS = {
+  theme: {
+    label: '主题',
+    files(id) {
+      return [
+        { name: 'market.json', data: `${JSON.stringify(themeMarketJson(id), null, 2)}\n` },
+        { name: 'theme.json', data: `${JSON.stringify(themeJson(), null, 2)}\n` },
+        { name: 'bg.bin', data: placeholderRgb565(240, 320) },
+        { name: 'icon.bin', data: placeholderRgb565(112, 112) },
+        { name: 'chime.wav', data: placeholderWav() },
+      ];
+    },
+  },
+  control: {
+    label: '管控',
+    files(id) {
+      const pluginId = id.replace(/-/g, '_');
+      return [
+        { name: 'market.json', data: `${JSON.stringify(controlMarketJson(id, pluginId), null, 2)}\n` },
+        { name: 'plugin.mjs', data: controlPluginMjs(pluginId) },
+        { name: 'plugin.json', data: `${JSON.stringify(controlPluginJson(pluginId), null, 2)}\n` },
+        { name: 'settings.json', data: '{}\n' },
+      ];
+    },
+  },
+  agent: {
+    label: 'agent 运行时',
+    files(id) {
+      const pluginId = id.replace(/-/g, '_');
+      return [
+        { name: 'market.json', data: `${JSON.stringify(agentMarketJson(id, pluginId), null, 2)}\n` },
+        { name: 'plugin.mjs', data: agentPluginMjs(pluginId) },
+        { name: 'plugin.json', data: `${JSON.stringify({ id: pluginId, settings: [] }, null, 2)}\n` },
+        { name: 'icon.json', data: `${JSON.stringify(agentIconJson(), null, 2)}\n` },
+      ];
+    },
+  },
+};
+
+/**
+ * 生成脚手架。目录不存在则创建；已存在且非空时拒绝（除非 force）。
+ * @returns {string[]} 写入的文件路径列表
+ */
+export function scaffold({ dir, kind, force = false }) {
+  const schema = SCHEMAS[kind];
+  if (!schema) throw new Error(`kind 必须是 theme / control / agent 之一`);
+  const id = path.basename(path.resolve(dir));
+  if (!PACKAGE_DIR.test(id)) throw new Error(`包目录名 ${id} 必须符合 ^[a-z0-9][a-z0-9_-]{0,39}$（它会成为包 ID）`);
+  if (kind === 'theme' && !THEME_NAME.test(id)) throw new Error(`主题目录名 ${id} 不符合 ^[A-Za-z0-9_-]{1,64}$`);
+  if (fs.existsSync(dir) && fs.readdirSync(dir).length && !force) {
+    throw new Error(`目录 ${dir} 不是空的；确认要覆盖就加 --force`);
+  }
+  fs.mkdirSync(dir, { recursive: true });
+  return schema.files(id).map((file) => {
+    const target = path.join(dir, file.name);
+    fs.writeFileSync(target, file.data);
+    return target;
+  });
+}
+
+export const SCAFFOLD_KINDS = Object.keys(SCHEMAS);

package/src/install.mjs

@@ -15,17 +15,24 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import zlib from 'node:zlib';
-import { KINDS, ROOT, sha256 } from '../lib/market.mjs';
+import { KINDS, PKG_ROOT, ROOT, sha256 } from '../lib/market.mjs';
 import { extractTar } from '../lib/tar.mjs';
 
-const BUNDLED_REGISTRY = path.join(ROOT, 'registry', 'index.json');
+/** 自带索引：仓库里是 cli/registry/（build 生成物），发布包里就是包根下的 registry/。 */
+const BUNDLED_REGISTRY = path.join(PKG_ROOT, 'registry', 'index.json');
+
+/** 官方市场：install/list/search 不带参数时的默认来源。 */
+export const DEFAULT_SERVER = 'https://made-market.link';
 
 /**
- * 默认远端索引：显式 --registry > 环境变量 MADE_MARKET_REGISTRY > 包内自带索引。
- * 桥接包发布到 OSS 后，把 OSS 索引地址写进环境变量或作为 --registry 传入即可。
+ * 索引来源：显式 --registry > $MADE_MARKET_REGISTRY > $MADE_MARKET_SERVER > 官方市场。
+ * 全部指向远端；远端不可用时 loadRegistry 自动回落包内自带索引（离线可用）。
  */
 export function resolveRegistry(explicit = '') {
-  return explicit || process.env.MADE_MARKET_REGISTRY || BUNDLED_REGISTRY;
+  if (explicit) return explicit;
+  if (process.env.MADE_MARKET_REGISTRY) return process.env.MADE_MARKET_REGISTRY;
+  const server = (process.env.MADE_MARKET_SERVER || DEFAULT_SERVER).replace(/\/+$/, '');
+  return `${server}/registry/index.json`;
 }
 
 /** 包目录根：--home > MADE_HOME > ~/made。与桥接器 packagesHome() 保持同一套规则。 */
@@ -53,7 +60,7 @@ const usage = `用法：node tools/install.mjs <包 ID…> [选项]
 
 选项
   --home <目录>          包目录根，默认 $MADE_HOME 或 ~/made
-  --registry <路径|URL>  索引来源。默认优先 $MADE_MARKET_REGISTRY（远端），不可用或未设置时用包内自带索引（离线可用）
+  --registry <路径|URL>  索引来源。默认官方市场实时索引（$MADE_MARKET_REGISTRY / $MADE_MARKET_SERVER 可覆盖），远端不可用时回落包内自带索引（离线可装示例包）
   --force                目标目录已存在时覆盖
   --dry-run              只校验并列出将要写入的文件
   --list                 列出索引里的全部包