made-market 0.1.1 → 0.2.0

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/capabilities.mjs

@@ -0,0 +1,208 @@
+/**
+ * 管控插件的开放能力清单（apiVersion 1 的能力面真源）。
+ *
+ * 单一真源，三处消费：init 脚手架把它生成进包里（capabilities.json +
+ * contracts.d.ts，作者写插件时编辑器直接有提示）、市场网站说明页按它排版、
+ * 桥接器侧的实现（made 仓库 enhance.mjs）是它的运行时对应物。改能力面时
+ * 先改这里，再同步 made 仓库 AGENTS.md 的清单表与 site/capabilities.html。
+ *
+ * 两条供给线：
+ * - board：事件与命令，清单由固件上报（announceBoardCatalog），扩清单要刷固件；
+ * - bridge：桥接器进程内露出的句柄（enhance.mjs），重启桥接器即生效。
+ */
+
+export const CAPABILITIES = {
+  apiVersion: 1,
+  /** 能力清单版本：加能力不升它；改既有能力的语义/形状才升，并同步桥接器。 */
+  schemaVersion: 1,
+  board: {
+    events: [
+      { name: 'boot.click', cadence: 'edge', desc: '按键短按（语音意图）' },
+      { name: 'boot.double', cadence: 'edge', desc: '双击（确认）' },
+      { name: 'boot.triple', cadence: 'edge', desc: '三击（取消）' },
+      { name: 'boot.long', cadence: 'edge', desc: '长按（回主页）' },
+    ],
+    commands: [
+      { name: 'caption.show', desc: '屏幕字幕，fields.text 为正文' },
+      { name: 'audio.play', desc: '播放音频，可附带 WAV：16-bit PCM、单声道、8k–48kHz、≤256KB' },
+      { name: 'theme.apply', desc: '应用主题插件' },
+      { name: 'volume.set', desc: '设置音量' },
+      { name: 'agent.select', desc: '切换当前助手' },
+      { name: 'session.create', desc: '新建会话' },
+      { name: 'session.select', desc: '切换会话' },
+      { name: 'session.delete', desc: '删除会话' },
+      { name: 'voice.start', desc: '主动点亮录音' },
+      { name: 'task.confirm', desc: '批准待确认任务' },
+      { name: 'task.cancel', desc: '取消任务' },
+    ],
+  },
+  /** onJob 收到的任务生命周期，type 字段的全部取值（按典型顺序排列）。 */
+  jobLifecycle: ['created', 'confirmed', 'started', 'progress', 'completed', 'handed_off', 'failed', 'cancelled'],
+  /** 回合管道：按插件注册顺序成链，返回字符串即 override，最后一个说话的算数。 */
+  turnPipes: [
+    { name: 'onTurnInput', context: ['instruction', 'job', 'agentId', 'config', 'bridge'], desc: '改写本轮实际执行的指令；存储里的任务原文不动' },
+    { name: 'onTurnOutput', context: ['result', 'job', 'agentId', 'status', 'config', 'bridge'], desc: '仅在任务完成时调用，改写回给用户的结果' },
+  ],
+  /** bridge 门面：事件、钩子、通知的上下文里都拿得到。 */
+  bridge: [
+    { name: 'agents', signature: 'agents()', desc: '全部助手（含可用性与探测原因）' },
+    { name: 'agent', signature: 'agent(id)', desc: '按 id 查单个助手' },
+    { name: 'jobs', signature: 'jobs()', desc: '全部任务' },
+    { name: 'job', signature: 'job(id)', desc: '按 id 查单个任务' },
+    { name: 'sessions', signature: 'sessions(agentId?)', desc: '会话清单，可按助手过滤' },
+    { name: 'createTask', signature: 'createTask({instruction, agentId?, projectId?, title?})', desc: '建会话并落一个待确认任务，返回 {job, session}；限流 10 次/分钟' },
+    { name: 'submitTurn', signature: 'submitTurn({instruction, sessionId})', desc: '向既有会话追加一轮（同样落待确认）' },
+    { name: 'confirmJob', signature: 'confirmJob(id)', desc: '批准待确认任务，批准后立即执行' },
+    { name: 'cancelJob', signature: 'cancelJob(id)', desc: '取消任务' },
+    { name: 'themes', signature: 'themes()', desc: '已安装主题清单' },
+    { name: 'devices', signature: 'devices()', desc: '当前在线设备 id 列表' },
+    { name: 'send', signature: 'send(deviceId, command, audio?)', desc: '向指定设备入队一条板侧命令（须在板侧清单内）' },
+    { name: 'pending', signature: 'pending(deviceId)', desc: '该设备尚未取走的命令队列' },
+  ],
+  limits: {
+    hookTimeoutMs: 1500,
+    createTaskPerMinute: 10,
+    audioFormat: '16-bit PCM WAV，单声道，8k–48kHz，≤256KB',
+  },
+};
+
+/** 生成进包里的 capabilities.json（作者可读，也方便脚本化消费）。 */
+export const capabilitiesJson = () => `${JSON.stringify(CAPABILITIES, null, 2)}\n`;
+
+/**
+ * 生成进包里的 contracts.d.ts：只描述插件作者看得见、用得上的接口面。
+ * 类型仅给编辑器提示，运行时不加载（plugin.mjs 是纯 JS）。
+ */
+export const contractsDts = () => `/**
+ * 码得管控插件 · 接口契约（apiVersion ${CAPABILITIES.apiVersion}）。
+ * 由 npx made-market init 生成，运行时对应桥接器的 bridge/src/plugins/enhance.mjs。
+ * 能力清单（事件/命令/句柄/限制）见同目录 capabilities.json。
+ */
+
+export interface BoardEvent {
+  name: string;
+  fields: Record<string, string>;
+}
+
+export interface BoardCommand {
+  name: string;
+  fields?: Record<string, string>;
+}
+
+export interface PluginConfig {
+  /** 各插件的设置：pluginSettings[<你的插件 id>] */
+  pluginSettings: Record<string, Record<string, string>>;
+  /** 用户当前默认助手 id */
+  defaultProvider: string;
+  [key: string]: unknown;
+}
+
+export interface JobView {
+  id: string;
+  sessionId: string;
+  instruction: string;
+  status: string;
+  /** 执行该任务的助手 id */
+  provider: string;
+  projectId?: string;
+  /** 任务来源：'voice' | 'plugin' | ... */
+  source?: string;
+  result?: string;
+  progress?: string;
+  createdAt: string;
+  updatedAt: string;
+  [key: string]: unknown;
+}
+
+export interface SessionView {
+  id: string;
+  provider: string;
+  title?: string;
+  [key: string]: unknown;
+}
+
+export interface AgentView {
+  id: string;
+  label: string;
+  available: boolean;
+  reason: string;
+  mode: string;
+  capabilities?: unknown;
+}
+
+/** 桥接器句柄：事件、钩子、通知的上下文里都拿得到（context.bridge）。 */
+export interface Bridge {
+  agents(): AgentView[];
+  agent(id: string): AgentView | undefined;
+  jobs(): JobView[];
+  job(id: string): JobView | undefined;
+  sessions(agentId?: string): SessionView[];
+  createTask(options: { instruction: string; agentId?: string; projectId?: string; title?: string }):
+    { job: JobView; session: SessionView };
+  submitTurn(options: { instruction: string; sessionId: string }): JobView;
+  confirmJob(id: string): JobView;
+  cancelJob(id: string): JobView;
+  themes(): Array<Record<string, unknown>>;
+  devices(): string[];
+  send(deviceId: string, command: BoardCommand, audio?: Uint8Array): unknown;
+  pending(deviceId: string): unknown[];
+}
+
+export type JobEventType =
+  | 'created' | 'confirmed' | 'started' | 'progress'
+  | 'completed' | 'handed_off' | 'failed' | 'cancelled';
+
+export interface PluginBase {
+  apiVersion: 1;
+  kind: 'board-plugin';
+  id: string;
+  label: string;
+  /** 健康探测：工作台据此显示 available / reason。 */
+  probe: (config: PluginConfig) => { available: boolean; reason?: string };
+
+  /** 板侧事件：events 里登记过的才会被上报。返回 {commands} 或调 context.send 入队。 */
+  onEvent(context: {
+    event: BoardEvent;
+    deviceId: string;
+    config: PluginConfig;
+    send: (command: BoardCommand, audio?: Uint8Array) => unknown;
+    bridge: Bridge;
+  }): Promise<{ commands?: BoardCommand[] } | void> | { commands?: BoardCommand[] } | void;
+
+  onConnect?(context: {
+    deviceId: string;
+    config: PluginConfig;
+    send: (command: BoardCommand, audio?: Uint8Array) => unknown;
+    bridge: Bridge;
+  }): Promise<void> | void;
+
+  onDisconnect?(context: { deviceId: string }): Promise<void> | void;
+
+  /** 任务生命周期通知（${CAPABILITIES.jobLifecycle.join(' / ')}）。 */
+  onJob?(context: {
+    type: JobEventType;
+    job: JobView;
+    config: PluginConfig;
+    bridge: Bridge;
+  }): Promise<void> | void;
+
+  /** 回合管道：返回字符串即 override。超时 ${CAPABILITIES.limits.hookTimeoutMs}ms 或抛错则沿用上一环。 */
+  onTurnInput?(context: {
+    instruction: string;
+    job: JobView;
+    agentId: string;
+    config: PluginConfig;
+    bridge: Bridge;
+  }): Promise<string | void> | string | void;
+
+  /** 仅在任务完成时调用；返回字符串即改写回给用户的结果。 */
+  onTurnOutput?(context: {
+    result: string;
+    job: JobView;
+    agentId: string;
+    status: 'completed';
+    config: PluginConfig;
+    bridge: Bridge;
+  }): Promise<string | void> | string | void;
+}
+`;

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.2.0",
   "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,291 @@
+/**
+ * 脚手架：`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';
+import { capabilitiesJson, contractsDts } from '../lib/capabilities.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，挑需要的钩子实现，就能发布。
+ *
+ * 能力清单（板侧事件/命令、任务生命周期、bridge 句柄、限流）见同目录
+ * capabilities.json；接口类型见 contracts.d.ts（编辑器自动提示）。
+ *
+ * events/commands 只能填板侧清单里的名字：
+ * - 事件：boot.click / boot.double / boot.triple / boot.long
+ * - 命令：caption.show / audio.play / theme.apply / volume.set / agent.select /
+ *   session.create / session.select / session.delete / voice.start / task.confirm / task.cancel
+ */
+export default {
+  apiVersion: 1,
+  kind: 'board-plugin',
+  id: '${pluginId}',
+  label: '我的插件',
+  events: ['boot.click'],
+  commands: ['caption.show'],
+  probe: (config) => {
+    // 健康探测：桥接器会显示 available / reason。
+    return { available: true, reason: '模板插件，尚未实现逻辑' };
+  },
+
+  // ── 触发面一：板侧事件 ────────────────────────────────────────────
+  onEvent({ event, deviceId, config, send, bridge }) {
+    if (event.name === 'boot.click') {
+      // 两条出命令的路：返回 {commands}，或稍后调 send(command, audio?)。
+      return { commands: [{ name: 'caption.show', fields: { text: '你好，码得！' } }] };
+    }
+    return null;
+  },
+
+  // ── 触发面二：任务生命周期（可选）────────────────────────────────
+  // type: created / confirmed / started / progress / completed / handed_off /
+  //       failed / cancelled。注意：插件自建的任务不广播 created（防自激）。
+  // onJob({ type, job, bridge }) {
+  //   if (type === 'completed' && job.provider === '某助手id') {
+  //     // 例：把操作日志上报远端、或在板上播报完成。
+  //   }
+  // },
+
+  // ── 触发面三：回合管道（可选，override 权限最高）─────────────────
+  // 按插件注册顺序成链，返回字符串即改写，最后一个说话的算数；
+  // 超时 1500ms 或抛错则沿用上一环，绝不阻断任务本身。
+  // onTurnOutput({ result, job, agentId }) {
+  //   if (agentId !== '某助手id') return;          // 只加工目标助手
+  //   return \`\${result}\\n—— 由我的插件加工\`;
+  // },
+
+  // ── 自主行为：bridge 句柄（可选）────────────────────────────────
+  // bridge.agents() / bridge.createTask({...})（落待确认任务，限流 10 次/分钟）/
+  // bridge.confirmJob(id) / bridge.send(deviceId, {name:'audio.play'}, wav) ……
+  // 全部句柄与签名见 capabilities.json 的 bridge 一节。
+
+  onConnect({ deviceId, config, send, bridge }) {
+    // 设备连上来时触发（可选实现）。
+  },
+  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' },
+        // 能力 SDK：清单（机器可读）+ 类型契约（编辑器提示）。随包发布，
+        // 装到 ~/made/plugins/<id>/ 后依然在，作者与使用者都能查。
+        { name: 'capabilities.json', data: capabilitiesJson() },
+        { name: 'contracts.d.ts', data: contractsDts() },
+      ];
+    },
+  },
+  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                 列出索引里的全部包