@zhin.js/scaffold-wizard 0.2.6 → 1.1.1

package/lib/zhin-stack-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zhin-stack-deps.d.ts","sourceRoot":"","sources":["../src/zhin-stack-deps.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsF,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7I;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AA+ChE,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,gCAAgC;AAChC,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIpF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIrE;AAED,oDAAoD;AACpD,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB5G;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,EAAE,CAYV;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,wBAAwB,EAAE,CA0B5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,EAAE,wBAAwB,EAAE,CAAC;IAClD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,EAAE,CASnF;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,CAAC,EAAE,eAAe,GACpB,kBAAkB,CAkBpB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAItG"}
+{"version":3,"file":"zhin-stack-deps.d.ts","sourceRoot":"","sources":["../src/zhin-stack-deps.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsF,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7I;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAC;AA0DhE,4DAA4D;AAC5D,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,qCAAqC,CAAC;AAEnE,gCAAgC;AAChC,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIpF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKrE;AAED,oDAAoD;AACpD,wBAAgB,oCAAoC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB5G;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,EAAE,CAYV;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,wBAAwB,EAAE,CA0B5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,EAAE,wBAAwB,EAAE,CAAC;IAClD,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,EAAE,CASnF;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,CAAC,EAAE,eAAe,GACpB,kBAAkB,CAkBpB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAItG"}

package/lib/zhin-stack-deps.js

@@ -22,6 +22,7 @@ export const ZHIN_STACK_VERSIONS = {
     '@zhin.js/layout': 'latest',
     '@zhin.js/page': 'latest',
     '@zhin.js/prompt-section': 'latest',
+    '@zhin.js/skill': 'latest',
     '@zhin.js/tool': 'latest',
     '@zhin.js/client': 'latest',
     '@zhin.js/contract': 'latest',
@@ -58,6 +59,12 @@ function parseMajor(versionSpec) {
     const match = versionSpec.trim().replace(/^[\^~>=<]+/, '').match(/^(\d+)/);
     return match ? Number(match[1]) : undefined;
 }
+function parseMajorMinor(versionSpec) {
+    if (!versionSpec?.trim())
+        return undefined;
+    const match = versionSpec.trim().replace(/^[\^~>=<]+/, '').match(/^(\d+)\.(\d+)/);
+    return match ? [Number(match[1]), Number(match[2])] : undefined;
+}
 function getDeclaredPackageVersion(pkg, name) {
     return pkg.dependencies?.[name] ?? pkg.devDependencies?.[name];
 }
@@ -74,25 +81,32 @@ function readInstalledMajor(cwd, packageName) {
         return undefined;
     }
 }
+function readInstalledVersion(cwd, packageName) {
+    const pkgJson = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgJson))
+        return undefined;
+    try {
+        const req = createRequire(pkgJson);
+        const installed = req(`${packageName}/package.json`);
+        return installed.version;
+    }
+    catch {
+        return undefined;
+    }
+}
 function resolvePackageMajor(cwd, pkg, packageName) {
     return readInstalledMajor(cwd, packageName) ?? parseMajor(getDeclaredPackageVersion(pkg, packageName));
 }
+function supportsSplitAiInstallation(versionSpec) {
+    const version = parseMajorMinor(versionSpec);
+    if (!version)
+        return undefined;
+    const [major, minor] = version;
+    return major >= 4 || (major === 1 && minor >= 1);
+}
 function resolveStackVersion(packageName) {
     return ZHIN_STACK_VERSIONS[packageName] ?? 'latest';
 }
-function collectZhinPluginsFromConfig(config) {
-    // legacy 数组形式：条目即包名
-    if (Array.isArray(config.plugins)) {
-        const plugins = config.plugins.filter((p) => typeof p === 'string');
-        return [...new Set(plugins.filter((p) => p.startsWith('@zhin.js/')))];
-    }
-    // 新 runtime：plugins 为 instanceKey 映射，包名在 package.json zhin.plugins 清单中，
-    // 无法从配置推导；仅收集直接以包名出现的键（防御性）
-    if (config.plugins && typeof config.plugins === 'object') {
-        return Object.keys(config.plugins).filter((key) => key.startsWith('@zhin.js/'));
-    }
-    return [];
-}
 /** create-zhin / minimal-bot 默认 Host 端口（避免与常见 8086 占用冲突） */
 export const DEFAULT_CREATE_BOT_HTTP_PORT = 8068;
 /** create-zhin 生成项目的 .npmrc（避免全局 strict-peer-dependencies 阻断 AI 栈安装） */
@@ -110,6 +124,7 @@ export function getCreateBotPnpmConfig(_aiEnabled) {
 export function getCreateBotBaseDependencies() {
     return {
         'zhin.js': ZHIN_STACK_VERSIONS['zhin.js'],
+        '@zhin.js/skill': ZHIN_STACK_VERSIONS['@zhin.js/skill'],
     };
 }
 /** 根据 zhin.config 推导应声明的 @zhin.js/* / zhin.js 依赖 */
@@ -117,9 +132,6 @@ export function getRequiredZhinDependenciesForConfig(config) {
     const deps = {
         'zhin.js': ZHIN_STACK_VERSIONS['zhin.js'],
     };
-    for (const plugin of collectZhinPluginsFromConfig(config)) {
-        deps[plugin] = resolveStackVersion(plugin);
-    }
     const database = config.database;
     if (database && typeof database === 'object' && !Array.isArray(database)) {
         deps['@zhin.js/database'] = ZHIN_STACK_VERSIONS['@zhin.js/database'];
@@ -147,13 +159,13 @@ export function findOutdatedZhinStackInPackageJson(pkg, required) {
 }
 export function findInstalledZhinStackIncompatibilities(cwd, pkg, config) {
     const issues = [];
-    const zhinMajor = resolvePackageMajor(cwd, pkg, 'zhin.js');
+    const zhinVersion = readInstalledVersion(cwd, 'zhin.js') ?? getDeclaredPackageVersion(pkg, 'zhin.js');
     const agentDeclared = getDeclaredPackageVersion(pkg, '@zhin.js/agent');
     const aiEnabled = isAiEnabledInConfig(config);
-    if (zhinMajor != null && zhinMajor < 4 && (aiEnabled || agentDeclared)) {
+    if (supportsSplitAiInstallation(zhinVersion) === false && (aiEnabled || agentDeclared)) {
         issues.push({
             package: 'zhin.js',
-            reason: 'zhin.js 4.x 才支持 @zhin.js/agent 与 AI 安装分层（ADR 0019），请升级 zhin.js',
+            reason: 'zhin.js 1.1.x 稳定线才支持当前 @zhin.js/agent 与 AI 安装分层，请升级 zhin.js',
         });
     }
     if (aiEnabled && !agentDeclared) {
@@ -163,7 +175,7 @@ export function findInstalledZhinStackIncompatibilities(cwd, pkg, config) {
     if (agentMajor != null && agentMajor < 1 && aiEnabled) {
         issues.push({
             package: '@zhin.js/agent',
-            reason: '@zhin.js/agent 1.x 与 zhin.js 4.x / AI SDK 7 配套，请升级 @zhin.js/agent',
+            reason: '@zhin.js/agent 1.x 与 zhin.js 1.1.x 稳定线 / AI SDK 7 配套，请升级 @zhin.js/agent',
         });
     }
     return issues;

package/lib/zhin-stack-deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"zhin-stack-deps.js","sourceRoot":"","sources":["../src/zhin-stack-deps.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zhin-stack-deps.js","sourceRoot":"","sources":["../src/zhin-stack-deps.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/scaffold-wizard",
-  "version": "0.2.6",
+  "version": "1.1.1",
   "description": "Shared interactive scaffold wizard for create-zhin-app and @zhin.js/cli",
   "type": "module",
   "main": "./lib/index.js",
@@ -21,8 +21,8 @@
     "fs-extra": "^11.4.0",
     "inquirer": "^14.0.2",
     "qrcode": "^1.5.4",
-    "smol-toml": "^1.7.1",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.0",
+    "@zhin.js/plugin-runtime": "1.1.10"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/src/adapter-configurers.ts

@@ -371,7 +371,7 @@ export async function configureQQBot(ctx: EndpointConfigureContext): Promise<Rec
     {
       type: 'select',
       name: 'botKind',
-      message: '  公域 / 私域（决定频道消息 intents；群聊两边都有）:',
+      message: '  公域 / 私域（决定频道消息 intents；群聊与群成员事件两边都有）:',
       choices: [
         {
           name: 'public — 公域（频道仅 @；+ 群聊/私聊）',
@@ -388,6 +388,7 @@ export async function configureQQBot(ctx: EndpointConfigureContext): Promise<Rec
 
   const sharedIntents = [
     'GROUP_AND_C2C_EVENT',
+    'GROUP_MEMBER',
     'GUILDS',
     'GUILD_MEMBERS',
     'DIRECT_MESSAGE',

package/src/adapter.ts

@@ -413,7 +413,7 @@ export async function configureAdapters(): Promise<AdapterSetupResult> {
         package: adapterDef.package,
         instanceKey: 'sandbox',
         config: {
-          endpoints: [{ context: 'sandbox', id: 'sandbox-bot', owner: 'sandbox-user' }],
+          endpoints: [{ id: 'sandbox-bot', owner: 'sandbox-user' }],
         },
       });
       continue;

package/src/ai.ts

@@ -5,8 +5,6 @@ import { formatEnvValue } from './env.js';
 export interface AISetupConfig {
   enabled: boolean;
   agentProvider?: string;
-  /** @deprecated Use agentProvider. Kept for one compatibility cycle. */
-  defaultProvider?: string;
   providers?: Record<string, {
     sdk?: string;
     apiKey?: string;
@@ -134,9 +132,8 @@ function defaultModelForProvider(driver: string): string {
   return entry?.defaultModel ?? '';
 }
 
-export function resolveAISetupAgentProvider(config: Pick<AISetupConfig, 'agentProvider' | 'defaultProvider' | 'providers'>): string {
+export function resolveAISetupAgentProvider(config: Pick<AISetupConfig, 'agentProvider' | 'providers'>): string {
   return config.agentProvider
-    ?? config.defaultProvider
     ?? Object.keys(config.providers ?? {})[0]
     ?? 'openai';
 }
@@ -529,72 +526,6 @@ export function generateAIConfigYaml(config: AISetupConfig): string {
   return lines.join('\n');
 }
 
-/**
- * 生成 TOML 格式的 AI 配置段
- */
-export function generateAIConfigToml(config: AISetupConfig): string {
-  if (!config.enabled) return '';
-
-  const lines: string[] = [
-    '',
-    '[ai]',
-    `memoryMcp = ${config.memoryMcp ?? false}`,
-  ];
-
-  if (config.providers) {
-    for (const [name, providerConfig] of Object.entries(config.providers)) {
-      lines.push('', `[ai.providers.${name}]`);
-      lines.push(`sdk = "${providerConfig.sdk ?? providerSdkFor(name)}"`);
-      if (providerConfig.apiKey) lines.push(`apiKey = "${providerConfig.apiKey}"`);
-      if (providerConfig.host) lines.push(`host = "${providerConfig.host}"`);
-      if (providerConfig.models?.length) {
-        lines.push(`models = ${JSON.stringify(providerConfig.models)}`);
-      }
-      if (providerConfig.baseUrl) lines.push(`baseUrl = "${providerConfig.baseUrl}"`);
-    }
-  }
-
-  const providerAlias = resolveAISetupAgentProvider(config);
-  lines.push('', '[ai.agents.zhin]');
-  lines.push(`provider = "${providerAlias}"`);
-  const zhinModel = resolveAISetupAgentModel(config, providerAlias);
-  if (zhinModel) lines.push(`model = "${zhinModel}"`);
-
-  if (config.trigger) {
-    lines.push('', '[ai.trigger]');
-    lines.push(`respondToAt = ${config.trigger.respondToAt}`);
-    lines.push(`respondToPrivate = ${config.trigger.respondToPrivate}`);
-    lines.push(`prefixes = ${JSON.stringify(config.trigger.prefixes)}`);
-    lines.push(`ignorePrefixes = ${JSON.stringify(config.trigger.ignorePrefixes)}`);
-    lines.push(`timeout = ${config.trigger.timeout}`);
-  }
-
-  if (config.sessions) {
-    lines.push('', '[ai.sessions]');
-    lines.push(`useDatabase = ${config.sessions.useDatabase}`);
-    lines.push(`maxHistory = ${config.sessions.maxHistory}`);
-    lines.push(`expireMs = ${config.sessions.expireMs}`);
-  }
-
-  if (config.context) {
-    lines.push('', '[ai.context]');
-    lines.push(`enabled = ${config.context.enabled}`);
-    lines.push(`maxRecentMessages = ${config.context.maxRecentMessages}`);
-    lines.push(`summaryThreshold = ${config.context.summaryThreshold}`);
-    lines.push(`keepAfterSummary = ${config.context.keepAfterSummary}`);
-  }
-
-  if (config.agent) {
-    lines.push('', '[ai.agent]');
-    lines.push(`execSecurity = "${config.agent.execSecurity}"`);
-    lines.push(`execPreset = "${config.agent.execPreset}"`);
-    lines.push(`execAllowlist = ${JSON.stringify(config.agent.execAllowlist)}`);
-    lines.push(`phaseTrace = ${config.agent.phaseTrace}`);
-  }
-
-  return lines.join('\n');
-}
-
 /**
  * 生成 JSON 格式的 AI 配置段
  */

package/src/apply.ts

@@ -1,7 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import yaml from 'yaml';
-import { stringify as stringifyToml } from 'smol-toml';
+import { readPluginConfigurationMap } from '@zhin.js/plugin-runtime';
 import type { AdapterSetupResult, AISetupConfig, DatabaseConfig, InitOptions } from './types.js';
 import {
   collectAdapterPluginConfigs,
@@ -13,31 +13,21 @@ import { generateAIEnvVars, materializeAIConfig } from './ai.js';
 import { generateDatabaseEnvVars, mergeEnvText } from './env.js';
 import { ensureDatabaseForAdapters, ensureDatabaseForAI, getAIDependencies } from './project-deps.js';
 import { DEFAULT_CREATE_BOT_HTTP_PORT, ZHIN_STACK_VERSIONS } from './zhin-stack-deps.js';
-import { packageToInstanceKey } from './project-config-plan.js';
 
 export function applyDatabaseToConfig(config: Record<string, unknown>, database: DatabaseConfig): void {
   // 物化为可落盘对象：非 SQLite 连接参数引用 .env（${VAR}），明文密码不进配置文件
   config.database = materializeDatabaseConfig(database);
 }
 
-/** 将 legacy 数组形式 plugins 归一化为新 runtime 的 instanceKey 映射 */
-export function normalizePluginsMap(value: unknown): Record<string, unknown> {
-  if (Array.isArray(value)) {
-    const map: Record<string, unknown> = {};
-    for (const entry of value) {
-      if (typeof entry !== 'string') continue;
-      map[packageToInstanceKey(entry)] ??= {};
-    }
-    return map;
-  }
-  if (value && typeof value === 'object') {
-    return { ...(value as Record<string, unknown>) };
-  }
-  return {};
+/** Returns a mutable copy of the canonical Plugin instance configuration map. */
+export function clonePluginConfigurationMap(
+  config: Readonly<Record<string, unknown>>,
+): Record<string, unknown> {
+  return { ...readPluginConfigurationMap(config) };
 }
 
 export function applyAdaptersToConfig(config: Record<string, unknown>, result: AdapterSetupResult): void {
-  const plugins = normalizePluginsMap(config.plugins);
+  const plugins = clonePluginConfigurationMap(config);
   for (const instance of result.instances) {
     plugins[instance.instanceKey] = mergeAdapterInstanceConfig(
       instance.instanceKey,
@@ -46,8 +36,6 @@ export function applyAdaptersToConfig(config: Record<string, unknown>, result: A
     );
   }
   config.plugins = plugins;
-  // legacy endpoints 列表不被 runtime 配置 schema 接受（additionalProperties: false）
-  delete config.endpoints;
 }
 
 function endpointId(endpoint: unknown): string | undefined {
@@ -327,12 +315,11 @@ export function buildRuntimeConfigDocument(options: InitOptions): Record<string,
   return doc;
 }
 
-/** 序列化配置文档为 zhin.config.yml / json / toml 文本 */
+/** Serialize a Root Runtime YAML or JSON configuration document. */
 export function serializeRuntimeConfig(
   doc: Record<string, unknown>,
-  format: 'yaml' | 'json' | 'toml',
+  format: 'yaml' | 'json',
 ): string {
   if (format === 'json') return `${JSON.stringify(doc, null, 2)}\n`;
-  if (format === 'toml') return stringifyToml(doc);
   return yaml.stringify(doc);
 }

package/src/index.ts

@@ -27,7 +27,6 @@ export {
   generateAIEnvVars,
   generateAIConfigYaml,
   generateAIConfigJSON,
-  generateAIConfigToml,
   RECOMMENDED_AI_DEFAULTS,
 } from './ai.js';
 
@@ -46,7 +45,7 @@ export {
   listAIDependencyNames,
   formatAIDependencyHint,
   isAiEnabledInConfig,
-  resolveDefaultProviderFromConfig,
+  resolveAgentProviderFromConfig,
   getRequiredAIDependenciesForConfig,
   diagnoseAIDependencies,
   formatAIDependencyFixCommand,
@@ -119,7 +118,7 @@ export {
   mergePluginManifestIntoPackageJson,
   finalizeWizardOptions,
   applyWizardOptionsToConfig,
-  normalizePluginsMap,
+  clonePluginConfigurationMap,
   materializeDatabaseConfig,
   buildRuntimeConfigDocument,
   serializeRuntimeConfig,

package/src/optional-peers.ts

@@ -1,5 +1,6 @@
 import fs from 'fs-extra';
 import path from 'node:path';
+import { readPluginConfigurationMap } from '@zhin.js/plugin-runtime';
 import { findMissingPackageDependencies, findUnresolvedPackageInstalls, type PackageJsonLike } from './project-deps.js';
 
 export const SPEECH_PACKAGE = '@zhin.js/speech';
@@ -38,21 +39,10 @@ function readSpeechStrategy(config: Record<string, unknown>): string | undefined
 }
 
 function configUsesHtmlImageAdapter(config: Record<string, unknown>): boolean {
-  const plugins = Array.isArray(config.plugins)
-    ? config.plugins.filter((p): p is string => typeof p === 'string')
-    : [];
-  for (const plugin of plugins) {
+  for (const instanceKey of Object.keys(readPluginConfigurationMap(config))) {
+    if (ADAPTERS_PREFER_HTML_IMAGE.has(instanceKey)) return true;
     for (const ctx of ADAPTERS_PREFER_HTML_IMAGE) {
-      if (plugin.includes(`adapter-${ctx}`)) return true;
-    }
-  }
-  // 新 runtime 配置形态：plugins 为 instanceKey → 配置 的映射，instanceKey 即适配器 context
-  if (config.plugins && typeof config.plugins === 'object' && !Array.isArray(config.plugins)) {
-    for (const instanceKey of Object.keys(config.plugins as Record<string, unknown>)) {
-      if (ADAPTERS_PREFER_HTML_IMAGE.has(instanceKey)) return true;
-      for (const ctx of ADAPTERS_PREFER_HTML_IMAGE) {
-        if (instanceKey.includes(`adapter-${ctx}`)) return true;
-      }
+      if (instanceKey.includes(`adapter-${ctx}`)) return true;
     }
   }
   const endpoints = Array.isArray(config.endpoints) ? config.endpoints : [];

package/src/project-config-plan.ts

@@ -1,17 +1,16 @@
 import fs from 'fs-extra';
 import path from 'node:path';
 import yaml from 'yaml';
-import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
+import {
+  readPluginConfigurationMap,
+  ROOT_CONFIG_FILE_NAMES,
+  rootConfigFormat,
+  selectRootConfigFile,
+  type RootConfigFormat,
+} from '@zhin.js/plugin-runtime';
 import { providerSdkFor } from './ai.js';
 
 const CONSOLE_URL = 'https://console.zhin.dev';
-const CONFIG_CANDIDATES = [
-  'zhin.config.yml',
-  'zhin.config.yaml',
-  'zhin.config.json',
-  'zhin.config.toml',
-  'zhin.config.ts',
-] as const;
 const SANDBOX_PLUGIN = '@zhin.js/adapter-sandbox';
 const LEGACY_AI_PROVIDER_FIELDS = ['driver', 'api', 'preset', 'spec'] as const;
 
@@ -23,7 +22,7 @@ export function packageToInstanceKey(packageName: string): string {
   return name.replace(/^(adapter|plugin|service)-/, '');
 }
 
-export type ProjectConfigFormat = 'yaml' | 'json' | 'toml' | 'ts';
+export type ProjectConfigFormat = RootConfigFormat;
 
 export interface LoadedProjectConfig {
   status: 'loaded' | 'missing' | 'unsupported';
@@ -70,12 +69,7 @@ export interface ConsoleConfigDiagnosis {
 }
 
 function configFormatFromPath(filePath: string): ProjectConfigFormat | null {
-  const ext = path.extname(filePath).toLowerCase();
-  if (ext === '.yml' || ext === '.yaml') return 'yaml';
-  if (ext === '.json') return 'json';
-  if (ext === '.toml') return 'toml';
-  if (ext === '.ts') return 'ts';
-  return null;
+  return rootConfigFormat(filePath) ?? null;
 }
 
 function cloneConfig(config: Record<string, unknown>): Record<string, unknown> {
@@ -83,39 +77,28 @@ function cloneConfig(config: Record<string, unknown>): Record<string, unknown> {
 }
 
 function parseConfig(content: string, format: ProjectConfigFormat): Record<string, unknown> {
-  if (format === 'yaml') {
-    const parsed = yaml.parse(content) as unknown;
-    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-      ? parsed as Record<string, unknown>
-      : {};
-  }
   if (format === 'json') {
     const parsed = JSON.parse(content) as unknown;
     return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
       ? parsed as Record<string, unknown>
       : {};
   }
-  if (format === 'toml') {
-    const parsed = parseToml(content) as unknown;
-    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-      ? parsed as Record<string, unknown>
-      : {};
-  }
-  return {};
+  const parsed = yaml.parse(content) as unknown;
+  return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+    ? parsed as Record<string, unknown>
+    : {};
 }
 
 function serializeConfig(config: Record<string, unknown>, format: ProjectConfigFormat): string {
   if (format === 'json') return `${JSON.stringify(config, null, 2)}\n`;
-  if (format === 'toml') return stringifyToml(config as Record<string, unknown>);
   return yaml.stringify(config);
 }
 
 function findProjectConfigPath(cwd: string): string | null {
-  for (const candidate of CONFIG_CANDIDATES) {
-    const configPath = path.join(cwd, candidate);
-    if (fs.existsSync(configPath)) return configPath;
-  }
-  return null;
+  const existing = ROOT_CONFIG_FILE_NAMES
+    .map((candidate) => path.join(cwd, candidate))
+    .filter((configPath) => fs.existsSync(configPath));
+  return selectRootConfigFile(existing) ?? null;
 }
 
 export function loadProjectConfig(cwd = process.cwd(), configPath?: string): LoadedProjectConfig {
@@ -126,7 +109,7 @@ export function loadProjectConfig(cwd = process.cwd(), configPath?: string): Loa
       cwd,
       config: {},
       writable: false,
-      message: '未找到 zhin.config.yml/json/toml',
+      message: '未找到 Root YAML/JSON 配置文件',
     };
   }
 
@@ -144,51 +127,35 @@ export function loadProjectConfig(cwd = process.cwd(), configPath?: string): Loa
     };
   }
 
-  if (format === 'ts') {
+  const content = fs.readFileSync(resolvedPath, 'utf8');
+  const config = parseConfig(content, format);
+  try {
+    readPluginConfigurationMap(config, relativePath);
+  } catch (error) {
     return {
       status: 'unsupported',
       cwd,
       configPath: resolvedPath,
       relativePath,
       format,
-      config: {},
+      config,
       writable: false,
-      message: 'zhin.config.ts 只读；请迁移为 zhin.config.yml/json/toml 后自动修复',
+      message: `${error instanceof Error ? error.message : String(error)}；请先运行 zhin migrate`,
     };
   }
-
-  const content = fs.readFileSync(resolvedPath, 'utf8');
   return {
     status: 'loaded',
     cwd,
     configPath: resolvedPath,
     relativePath,
     format,
-    config: parseConfig(content, format),
+    config,
     writable: true,
   };
 }
 
 function ensurePlugins(config: Record<string, unknown>, pluginsToAdd: readonly string[], mutations: string[]): void {
-  if (Array.isArray(config.plugins)) {
-    // legacy 数组形式：保持原形态追加，避免改写旧项目结构
-    const plugins = config.plugins.filter((p): p is string => typeof p === 'string');
-    let changed = false;
-    for (const plugin of pluginsToAdd) {
-      if (plugins.includes(plugin)) continue;
-      plugins.push(plugin);
-      mutations.push(`added ${plugin} to plugins`);
-      changed = true;
-    }
-    if (changed) {
-      config.plugins = plugins;
-    }
-    return;
-  }
-  // 新 Plugin Runtime：plugins 为 <instanceKey>: <配置> 映射
-  const plugins = config.plugins && typeof config.plugins === 'object'
-    ? { ...(config.plugins as Record<string, unknown>) }
-    : {};
+  const plugins = { ...readPluginConfigurationMap(config) };
   let changed = false;
   for (const pkg of pluginsToAdd) {
     const instanceKey = packageToInstanceKey(pkg);
@@ -197,7 +164,7 @@ function ensurePlugins(config: Record<string, unknown>, pluginsToAdd: readonly s
     mutations.push(`added ${instanceKey} (${pkg}) to plugins`);
     changed = true;
   }
-  if (changed || !config.plugins || typeof config.plugins !== 'object') {
+  if (changed || config.plugins === undefined) {
     config.plugins = plugins;
   }
 }
@@ -321,6 +288,8 @@ function applyAiLegacyMigration(config: Record<string, unknown>, mutations: stri
 
 export function createProjectConfigPlan(options: ProjectConfigPlanOptions): ProjectConfigPlan {
   const cwd = options.cwd ?? options.loaded?.cwd ?? process.cwd();
+  const configuredFormat = options.format
+    ?? (options.configPath ? configFormatFromPath(options.configPath) ?? undefined : undefined);
   const loaded = options.loaded ?? (
     options.config
       ? {
@@ -328,9 +297,9 @@ export function createProjectConfigPlan(options: ProjectConfigPlanOptions): Proj
         cwd,
         configPath: options.configPath,
         relativePath: options.configPath ? path.relative(cwd, options.configPath) : undefined,
-        format: options.format ?? (options.configPath ? configFormatFromPath(options.configPath) ?? undefined : undefined),
+        format: configuredFormat,
         config: options.config,
-        writable: Boolean(options.configPath && (options.format ?? configFormatFromPath(options.configPath)) !== 'ts'),
+        writable: Boolean(options.configPath && configuredFormat),
       }
       : loadProjectConfig(cwd, options.configPath)
   );
@@ -373,7 +342,7 @@ export function createProjectConfigPlan(options: ProjectConfigPlanOptions): Proj
 
 export function renderProjectConfigPatch(plan: ProjectConfigPlan): string {
   if (!plan.changed) return '配置无需改动。';
-  const format = plan.format && plan.format !== 'ts' ? plan.format : 'yaml';
+  const format = plan.format ?? 'yaml';
   const name = plan.relativePath ?? 'zhin.config.yml';
   return [
     `# ${name}`,
@@ -384,7 +353,7 @@ export function renderProjectConfigPatch(plan: ProjectConfigPlan): string {
 
 export async function applyProjectConfigPlan(plan: ProjectConfigPlan): Promise<boolean> {
   if (!plan.changed) return false;
-  if (!plan.writable || !plan.configPath || !plan.format || plan.format === 'ts') return false;
+  if (!plan.writable || !plan.configPath || !plan.format) return false;
   await fs.writeFile(plan.configPath, serializeConfig(plan.after, plan.format));
   return true;
 }
@@ -395,20 +364,7 @@ export function diagnoseConsoleConfig(config: Record<string, unknown>): ConsoleC
     : {};
   const corsOrigins = Array.isArray(http.corsOrigins) ? http.corsOrigins : [];
 
-  if (Array.isArray(config.plugins)) {
-    // legacy 数组形式配置
-    const plugins = config.plugins.filter((p): p is string => typeof p === 'string');
-    return {
-      missingSandboxPlugin: !plugins.includes(SANDBOX_PLUGIN),
-      missingConsoleOrigin: !hasConsoleOrigin(corsOrigins.filter((origin): origin is string => typeof origin === 'string')),
-      missingHttpToken: typeof http.token !== 'string' || http.token.trim().length === 0,
-    };
-  }
-
-  // 新 Plugin Runtime：Console Host 由 CLI 装配，无需 host 插件；Sandbox 为 plugins.sandbox 实例
-  const plugins = config.plugins && typeof config.plugins === 'object'
-    ? config.plugins as Record<string, unknown>
-    : {};
+  const plugins = readPluginConfigurationMap(config);
   return {
     missingSandboxPlugin: !('sandbox' in plugins),
     missingConsoleOrigin: !hasConsoleOrigin(corsOrigins.filter((origin): origin is string => typeof origin === 'string')),