@tbox.cn/app-template-agent 0.1.0

package/apps/client/src/platform/agent-runtime.ts

@@ -0,0 +1,15 @@
+/**
+ * 平台运行时装配（client 平台轴，已下沉 @tbox.cn/app-sdk/client）。
+ * 模板唯一的 SDK 单例持有点：authClient（鉴权）+ platformApi（能力凭证/会话/历史）。
+ * 环境值（VITE_API_URL / VITE_AUTH_PROVIDER）由 main.tsx 经 configureRuntime / 选项注入（H1）。
+ */
+import { createAuthClient, createPlatformApi } from '@tbox.cn/app-sdk/client';
+
+/** VITE_AUTH_PROVIDER=external 时壳内换码登录转发外部（服务端需同步配置 AUTH_EXTERNAL_*） */
+const AUTH_PROVIDER = import.meta.env.VITE_AUTH_PROVIDER as string | undefined;
+
+export const authClient = createAuthClient({
+  ...(AUTH_PROVIDER === 'external' ? { loginPlatform: 'external' } : {}),
+});
+
+export const platformApi = createPlatformApi();

package/apps/client/src/platform/state/createPersistedStore.ts

@@ -0,0 +1,19 @@
+import { create, type StateCreator } from 'zustand';
+import { createJSONStorage, persist, type PersistOptions } from 'zustand/middleware';
+
+interface PersistedStoreOptions<T> extends Omit<PersistOptions<T>, 'name' | 'storage'> {
+  name: string;
+}
+
+/** 创建使用 localStorage 的业务 store，并统一保留 Zustand 的版本迁移能力。 */
+export function createPersistedStore<T>(
+  stateCreator: StateCreator<T, [], []>,
+  options: PersistedStoreOptions<T>,
+) {
+  return create<T>()(
+    persist(stateCreator, {
+      ...options,
+      storage: createJSONStorage(() => localStorage),
+    }),
+  );
+}

package/apps/client/src/shims/node-stub.ts

@@ -0,0 +1,14 @@
+/**
+ * 浏览器端 fs / path 桩。
+ *
+ * @tbox-dev-js/sdk 的 ESM 顶层静态 import 了 Node 的 fs/path（用于 Node 环境的代码路径，
+ * 浏览器不会执行到），但静态 import 会让 vite 生产构建因"命名导出不存在"而失败。
+ * 用本桩 alias 掉 fs/path，提供同名空实现即可（浏览器永不调用这些路径）。
+ */
+export const existsSync = (): boolean => false;
+export const readFileSync = (): string => '';
+export const resolve = (...p: string[]): string => p.join('/');
+export const join = (...p: string[]): string => p.join('/');
+export const dirname = (p = ''): string => p.split('/').slice(0, -1).join('/');
+
+export default { existsSync, readFileSync, resolve, join, dirname };

package/apps/client/src/store/chat-config.ts

@@ -0,0 +1,29 @@
+import { create } from 'zustand';
+import chatConfigJson from '../../../../config/chat.json';
+
+export interface QuickCommand {
+  /** 纯文案；前导星标/图标由 QuickCommands 组件渲染，不要写进 label */
+  label: string;
+  query: string;
+  icon?: string;
+}
+
+interface ChatConfigStore {
+  enableImageUpload: boolean;
+  enableVideoUpload: boolean;
+  enableTTS: boolean;
+  enableVoiceInput: boolean;
+  defaultInputMode: 'TEXT' | 'VOICE';
+  quickCommands: QuickCommand[];
+}
+
+const cfg = chatConfigJson as Record<string, unknown>;
+
+export const useChatConfigStore = create<ChatConfigStore>()(() => ({
+  enableImageUpload: (cfg.enableImageUpload as boolean) ?? true,
+  enableVideoUpload: (cfg.enableVideoUpload as boolean) ?? true,
+  enableTTS: (cfg.enableTTS as boolean) ?? true,
+  enableVoiceInput: (cfg.enableVoiceInput as boolean) ?? true,
+  defaultInputMode: (cfg.defaultInputMode as 'TEXT' | 'VOICE') ?? 'TEXT',
+  quickCommands: (cfg.quickCommands as QuickCommand[]) ?? [],
+}));

package/apps/client/src/store/chat.ts

@@ -0,0 +1,201 @@
+/**
+ * 对话状态（Zustand）。
+ * 使用 createCoreChatState 在同一个 create() 中合并核心状态与业务方法，
+ * 共用同一份 set/get，避免双 store 断裂。
+ */
+import { create } from 'zustand';
+import { createCoreChatState, getWsUrl } from '@tbox.cn/app-sdk/client';
+import type { CoreChatState } from '@tbox.cn/app-sdk/client';
+import type { CardSnapshot, TboxCardPayload } from '@tbox.cn/app-contracts';
+import type { ChatMessage } from '@/types/chat';
+import type { IFeedbackAdapter } from '@tbox.cn/app-sdk/client';
+import type { AdapterContextValue } from '@tbox.cn/app-sdk/client';
+import { isSessionExpiredError } from '@/utils/session-error';
+import { toast } from '@/utils/toast';
+import { authClient, platformApi } from '@/platform/agent-runtime';
+
+interface HistoryMessageInfo {
+  messageId?: string;
+  query?: string;
+  answer?: string;
+  content?: string;
+  outerBusinessId?: string;
+  createTime?: number;
+  multiModalInputs?: Record<string, unknown>;
+  /** P3 W1：服务端已恢复（migrate + isHistory=true）的卡片快照 */
+  cards?: CardSnapshot[];
+}
+
+function convertHistoryMessages(messages: HistoryMessageInfo[]): ChatMessage[] {
+  let idSeq = 0;
+  const nextId = (prefix: string) => `${prefix}_${Date.now()}_${idSeq++}`;
+  const result: ChatMessage[] = [];
+  for (const info of messages) {
+    if (info.query) {
+      const userMsg: ChatMessage = {
+        id: `history-user-${info.messageId}`,
+        role: 'user',
+        content: info.query,
+        status: 'done',
+        createdAt: info.createTime || Date.now(),
+        ...(info.outerBusinessId && { requestId: info.outerBusinessId }),
+      };
+      const imageUrls = info.multiModalInputs?.imageUrls as string[] | undefined;
+      if (imageUrls && imageUrls.length > 0) {
+        userMsg.mediaItems = imageUrls.map((url) => ({
+          id: nextId('history-img'),
+          type: 'image' as const,
+          src: url,
+        }));
+      }
+      result.push(userMsg);
+    }
+    if (info.answer || info.content) {
+      result.push({
+        id: `history-asst-${info.messageId}`,
+        role: 'assistant',
+        content: info.answer || info.content || '',
+        status: 'done',
+        createdAt: info.createTime || Date.now(),
+        ...(info.outerBusinessId && { requestId: info.outerBusinessId }),
+      });
+    }
+  }
+  return result;
+}
+
+interface ChatState extends CoreChatState {
+  historyMessages: ChatMessage[];
+  historyHasMore: boolean;
+  isLoadingHistory: boolean;
+  initConversation: () => Promise<void>;
+  loadMoreHistory: () => Promise<void>;
+  submitFeedback: (
+    messageId: string,
+    type: 'like' | 'dislike' | 'cancel',
+    adapter: IFeedbackAdapter,
+    refreshSession?: () => Promise<AdapterContextValue>,
+  ) => Promise<void>;
+}
+
+export const useChatStore = create<ChatState>((set, get) => ({
+  // 核心状态：所有 set/get 闭包绑定到此 store（006：不再创建客户端 sessionId）
+  ...createCoreChatState(
+    { getWsUrl: () => getWsUrl(), toast },
+    set as (partial: any) => void,
+    get as () => any,
+  ),
+  // 业务扩展状态
+  historyMessages: [],
+  historyHasMore: true,
+  isLoadingHistory: false,
+
+  initConversation: async () => {
+    const userId = await authClient.resolveUserId();
+    set({ userId });
+    try {
+      let conversationId: string | null = null;
+      // 006：create 的 userId 只来自 token 身份（body 废弃）；匿名（无 token）不可建会话 → 直接走 no-conv 分支
+      if (!authClient.getAuthState()?.token) {
+        console.warn('[CONVERSATION] anonymous: skip create conversation (no-conv)');
+      } else {
+        for (let i = 0; i < 2 && !conversationId; i++) {
+          try {
+            const { status, data } = await platformApi.createConversation();
+            if (status === 200 && data?.conversationId) conversationId = data.conversationId;
+          } catch {
+            // retry
+          }
+        }
+      }
+      if (conversationId) set({ conversationId });
+      get().init();
+    } catch (err) {
+      console.error('[CONVERSATION] init error:', err);
+      get().init();
+    }
+  },
+
+  loadMoreHistory: async () => {
+    const { isLoadingHistory, historyHasMore, historyMessages } = get();
+    if (isLoadingHistory || !historyHasMore) return;
+    set({ isLoadingHistory: true });
+
+    const pageSize = 5;
+    const earliestRequestId =
+      historyMessages.length > 0
+        ? historyMessages[0].requestId
+        : get().messages.find((m) => m.requestId)?.requestId;
+
+    // 006：有 token 身份时服务端按 token 取归属；无 token（匿名/兼容）保留 query userId
+    try {
+      const { status, data } = await platformApi.listMessages({
+        pageSize,
+        ...(authClient.getAuthState()?.token
+          ? {}
+          : { userId: get().userId }),
+        ...(earliestRequestId ? { beforeId: earliestRequestId } : {}),
+      });
+      if (status === 200 && data) {
+        const rawList: HistoryMessageInfo[] = (data.data as HistoryMessageInfo[]) || [];
+        const currentRequestIds = new Set(get().messages.map((m) => m.requestId).filter(Boolean));
+        const filtered = rawList.filter(
+          (item) => !item.outerBusinessId || !currentRequestIds.has(item.outerBusinessId),
+        );
+        const newMessages = convertHistoryMessages(filtered.reverse());
+        // P3 W1：历史卡片按 messageId 挂载到 assistant 气泡（isHistory 已由服务端标记）
+        const cardsByMessageId: Record<string, TboxCardPayload[]> = {};
+        for (const info of filtered) {
+          if (!info.messageId || !info.cards || info.cards.length === 0) continue;
+          cardsByMessageId[`history-asst-${info.messageId}`] = info.cards.map((s) => ({
+            ...s,
+            isHistory: true,
+          }));
+        }
+        set((s) => ({
+          historyMessages: [...newMessages, ...s.historyMessages],
+          historyHasMore: rawList.length >= pageSize,
+          isLoadingHistory: false,
+          cardsByMessageId: { ...s.cardsByMessageId, ...cardsByMessageId },
+        }));
+      } else {
+        set({ isLoadingHistory: false });
+      }
+    } catch (err) {
+      console.error('[HISTORY] load more error:', err);
+      set({ isLoadingHistory: false });
+    }
+  },
+
+  submitFeedback: async (messageId, type, adapter, refreshSession) => {
+    const oldMsg = get().messages.find((m) => m.id === messageId);
+    const oldFeedbackState = oldMsg?.feedbackState ?? 'none';
+    const feedbackRequestId = oldMsg?.requestId;
+    if (!feedbackRequestId) {
+      console.warn('[FEEDBACK] no requestId for message', messageId);
+      return;
+    }
+    const newFeedbackState = type === 'cancel' ? 'none' : type;
+    get().updateMessage(messageId, { feedbackState: newFeedbackState as 'none' | 'like' | 'dislike' });
+
+    const feedbackMap = { like: 'LIKE' as const, dislike: 'DISLIKE' as const, cancel: 'CANCEL' as const };
+    try {
+      const result = await adapter.addTag(feedbackRequestId, feedbackMap[type]);
+      if (!result.success) get().updateMessage(messageId, { feedbackState: oldFeedbackState });
+    } catch (err) {
+      if (isSessionExpiredError(err) && refreshSession) {
+        try {
+          const newAdapters = await refreshSession();
+          if (newAdapters.feedback) {
+            const retry = await newAdapters.feedback.addTag(feedbackRequestId, feedbackMap[type]);
+            if (!retry.success) get().updateMessage(messageId, { feedbackState: oldFeedbackState });
+            return;
+          }
+        } catch (retryErr) {
+          console.error('[FEEDBACK] retry failed:', retryErr);
+        }
+      }
+      get().updateMessage(messageId, { feedbackState: oldFeedbackState });
+    }
+  },
+}));

package/apps/client/src/styles/global.less

@@ -0,0 +1,60 @@
+@import './tokens.less';
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body,
+#root {
+  margin: 0;
+  padding: 0;
+  height: 100%;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  font-size: var(--tbox-fs-body);
+  color: var(--tbox-text-primary);
+  background: var(--tbox-bg-subtle);
+  -webkit-font-smoothing: antialiased;
+}
+
+/* 顶层容器全宽（渐变底铺满），内容区由各处 max-width:800px 居中（对齐原模板 #app）。 */
+#root {
+  width: 100%;
+  position: relative;
+}
+
+/* 去掉移动端点击高亮 */
+* {
+  -webkit-tap-highlight-color: transparent;
+}
+
+/* 卡片统一外层 = 卡片「卡框」。所有卡片共有的框在这里，单卡组件别重复写：
+   - 间距：卡片与上下元素（工具调用 / 气泡）的间距，与 .tool-calls 一致；
+   - 外观：默认背景(白) / 圆角 / 阴影；`overflow:hidden` 把内容裁进圆角。
+   值为源码 px（2x 基线、折半渲染）：圆角 40≈20、阴影 0 4px 16px≈0 2px 8px。
+   ⚠️ **内边距不在卡框里**——由卡片自己写。卡框给 padding 会让「自带背景色的卡」在外面露一圈白边（卡里套卡）。
+   宽度也不在卡框里：默认占满整列（≈移动端 350~400px 设计宽），紧凑卡自己写 max-width。
+   单卡组件（.tbox-<type>）只画内容；**要整卡换底色 / 出血图，直接在自己 root 上 `background:<色>` 或铺满图**——
+   会铺满卡框、裁进圆角、不出白边（别再自己设圆角，卡框已裁）。不写背景则露卡框默认白底，不透明。 */
+.tbox-card {
+  margin-bottom: 12px;
+  background: var(--tbox-bg-card);
+  border-radius: 40px;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.1);
+  overflow: hidden;
+}
+
+/* 兜底态（未知 cardType / 渲染出错，由 CardRenderer 给外层加此修饰类）：
+   复用卡框，弱化成无阴影的虚线提示框（内边距自带，因为卡框不再给 padding） */
+.tbox-card--fallback {
+  max-width: 80%;
+  padding: 32px 24px;
+  background: var(--tbox-bg-subtle);
+  border: 1px dashed var(--tbox-border);
+  box-shadow: none;
+  color: var(--tbox-text-muted);
+  font-size: var(--tbox-fs-caption);
+}

package/apps/client/src/styles/tokens.less

@@ -0,0 +1,60 @@
+/**
+ * 设计 token —— 从原 server `cards/_shared/tokens.css` 搬家到 client。
+ *
+ * C 方案下卡片是 client React 组件、不再有 iframe 下发 tokens，
+ * 所以这些设计变量必须落在 client。卡片组件与页面统一用 var(--tbox-*) 引用，
+ * 禁止硬编码十六进制色值 / px 字号。
+ *
+ * 注：这里的 px 会被 postcss-px-to-viewport（750 基准）转成 vw。
+ */
+:root {
+  /* 主色 */
+  --tbox-primary: #1677ff;
+  --tbox-primary-dark: #0958d9;
+  --tbox-primary-light: #e6f4ff;
+
+  /* 文本 */
+  --tbox-text-primary: #1f1f1f;
+  --tbox-text-secondary: #595959;
+  --tbox-text-muted: #8c8c8c;
+
+  /* 背景 */
+  --tbox-bg-card: #ffffff;
+  --tbox-bg-subtle: #f5f7fa;
+
+  /* 边框 */
+  --tbox-border: #e8ebed;
+
+  /* 状态色 */
+  --tbox-success: #52c41a;
+  --tbox-warning: #faad14;
+  --tbox-error: #ff4d4f;
+
+  /* 字号——按 750/2x 设计稿基线，对标消息气泡（MessageBubble）：
+       正文 .msg-markdown / __text = 25px，次要信息(时间/角色) = 18~19px，标题 h1~h4 = 36/32/30/28px。
+     注意：rootValue 100 + 根字号脚本会把 px 折半渲染（750 稿 → ≈375 手机列），
+     所以这里写的是 2x 值，别按普通 web 的 12/14/16 写（那样渲染出来只有一半、发虚）。
+     价格等强调大号字单独硬编（~32，≈气泡 h2），不挤进这 3 档。 */
+  --tbox-fs-heading: 30px; /* ≈气泡 h3：商品名 / 店名 */
+  --tbox-fs-body: 25px;    /* =气泡正文 */
+  --tbox-fs-caption: 20px; /* ≈气泡次要信息(时间/角色) */
+
+  /* 圆角 */
+  --tbox-radius-sm: 4px;
+  --tbox-radius-md: 8px;
+
+  /* 内容最大宽度（对齐原模板）：全宽渐变底 + 内容区 800px 居中。
+     大写 PX 不被 postcss-pxtorem 转换（正则大小写敏感），保持固定像素。 */
+  --tbox-content-max-width: 800PX;
+
+  /* 媒体缩略图 */
+  --tbox-media-item-size: 174px;
+  --tbox-media-item-radius: 12px;
+
+  /* 输入框（对齐原模板 AdvancedChatInput） */
+  --tbox-input-bg: rgba(255, 255, 255, 0.7);
+  --tbox-input-radius: 50px;
+  --tbox-input-padding: 20px 24px;
+  --tbox-send-btn-size: 44px;
+  --tbox-icon-color: #4b6282;
+}

package/apps/client/src/types/chat.ts

@@ -0,0 +1,29 @@
+/** 媒体 / 消息类型（协议类型已下沉 @tbox.cn/app-sdk/client，此处 re-export 保持单一来源） */
+export type {
+  MediaType,
+  InputMethod,
+  MediaItem,
+  ChatInputMessage,
+  MessageRole,
+  MessageStatus,
+  ToolCallInfo,
+  ChatMessage,
+} from '@tbox.cn/app-sdk/client';
+
+/** 单种媒体的上传约束（对齐原模板 FileTypeConfig，UI 层约定，留在模板） */
+export interface FileTypeConfig {
+  /** 该类型最多数量 */
+  maxCount: number;
+  /** 单文件最大字节数 */
+  maxSize: number;
+  /** 允许的扩展名/类型（仅约定，校验以 maxCount/maxSize 为主） */
+  accept?: string[];
+}
+
+/** 媒体上传分类型配置（不配的类型只受总数 maxTotal 约束） */
+export interface MediaConfig {
+  image?: FileTypeConfig;
+  video?: FileTypeConfig;
+  audio?: FileTypeConfig;
+  file?: FileTypeConfig;
+}

package/apps/client/src/utils/copyText.ts

@@ -0,0 +1,11 @@
+/** 复制消息文本；平台预览 iframe 需开放 clipboard-write 权限。 */
+export async function copyText(text: string): Promise<boolean> {
+  if (!text || !navigator.clipboard?.writeText) return false;
+
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/apps/client/src/utils/imagePreview.ts

@@ -0,0 +1,10 @@
+/**
+ * 图片预览（懒加载 antd-mobile 的 ImageViewer）。
+ * ImageViewer 带捏合/缩放/手势依赖较重——用动态 import 切成单独 chunk，
+ * 仅在用户首次点开图片时加载，不占首屏体积。
+ */
+export async function previewImages(images: string[], defaultIndex = 0): Promise<void> {
+  if (!images.length) return;
+  const { ImageViewer } = await import('antd-mobile');
+  ImageViewer.Multi.show({ images, defaultIndex: Math.max(0, defaultIndex) });
+}

package/apps/client/src/utils/session-error.ts

@@ -0,0 +1,5 @@
+/** 判断错误是否为 session 过期（保守策略：宁可多重试一次）。 */
+export function isSessionExpiredError(err: unknown): boolean {
+  const msg = String((err as Error)?.message || err || '');
+  return /过期|expired|PARAM_INVALID|unauthorized|token/i.test(msg);
+}

package/apps/client/src/utils/toast.ts

@@ -0,0 +1,15 @@
+/** 提示语气（对齐原模板 TboxCard.toast 的 tone）：info 无图标、success/error 带图标 */
+export type ToastTone = 'info' | 'success' | 'error';
+
+/**
+ * 轻提示（懒加载 antd-mobile 的 Toast）。
+ * 与 imagePreview 共用同一个 antd-mobile 动态 chunk——首次弹提示/看大图时才加载，
+ * 不占首屏体积。错误反馈等延迟一帧无感。
+ *
+ * @param tone 语气：success → 成功图标，error → 失败图标，info/省略 → 无图标（对齐旧模板映射）
+ */
+export async function toast(content: string, tone: ToastTone = 'info'): Promise<void> {
+  const { Toast } = await import('antd-mobile');
+  const icon = tone === 'success' ? 'success' : tone === 'error' ? 'fail' : undefined;
+  Toast.show(icon ? { content, icon } : { content });
+}

package/apps/client/src/vite-env.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="vite/client" />
+
+declare module 'postcss-pxtorem';

package/apps/client/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "jsx": "react-jsx",
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/apps/client/vite.config.ts

@@ -0,0 +1,40 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import pxToRem from 'postcss-pxtorem';
+import { resolve } from 'node:path';
+// 平台微调配套 babel plugin：给每个 JSX 注入 data-code-inspect-* 源码位置属性，
+// 供 inspector runtime(/__vs_inspector__.js) 点选元素→定位源码。仅 dev 启用（见下）。
+// @ts-expect-error 平台 babel plugin（CJS、无类型声明），运行时由 esbuild 解析。
+import codeInspectPlugin from './babel-plugins/code-inspect.cjs';
+
+const pxToRemPlugin = pxToRem({
+  rootValue: 100,
+  unitPrecision: 5,
+  propList: ['*'],
+  selectorBlackList: ['.no-rem'],
+  minPixelValue: 1,
+  mediaQuery: false,
+  exclude: /node_modules/,
+});
+
+export default defineConfig(({ command }) => ({
+  plugins: [
+    react({
+      babel: { plugins: command === 'serve' ? [codeInspectPlugin] : [] },
+    }),
+  ],
+  resolve: {
+    alias: {
+      '@': resolve(__dirname, 'src'),
+      fs: resolve(__dirname, 'src/shims/node-stub.ts'),
+      path: resolve(__dirname, 'src/shims/node-stub.ts'),
+    },
+  },
+  css: {
+    postcss: { plugins: [pxToRemPlugin] },
+  },
+  build: {
+    rollupOptions: { input: { index: resolve(__dirname, 'index.html') } },
+  },
+  // middlewareMode 下不需要 server 配置（由 server 端 vite middleware 托管）
+}));

package/apps/server/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@app/server",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch --exclude ../../apps/client src/index.ts",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@app/module-weather": "workspace:*",
+    "@ag-ui/core": "catalog:",
+    "@tbox.cn/agent-plugin": "catalog:",
+    "@tbox.cn/app-sdk": "catalog:",
+    "@tbox.cn/app-contracts": "catalog:",
+    "@tbox-dev-js/sdk": "catalog:",
+    "ai": "catalog:",
+    "cors": "catalog:",
+    "express": "catalog:",
+    "ws": "catalog:",
+    "zod": "catalog:"
+  },
+  "peerDependencies": {
+    "vite": "catalog:"
+  },
+  "devDependencies": {
+    "@types/cors": "catalog:",
+    "@types/express": "catalog:",
+    "@types/node": "catalog:",
+    "@types/ws": "catalog:",
+    "tsx": "catalog:",
+    "tsup": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vitest": "catalog:"
+  }
+}

package/apps/server/src/cli/collect-registry.ts

@@ -0,0 +1,26 @@
+import { createServerContext, buildToolCardBindings } from '@tbox.cn/app-sdk/server';
+import { registerAll } from '../modules.js';
+import { translateTool } from '../tools/translate.js';
+
+export interface RegistryState {
+  staticToolIds: string[];
+  cardTypes: string[];
+  bindings: ReturnType<typeof buildToolCardBindings>;
+}
+
+/**
+ * 从自注册闭环收集当前注册状态（静态工具 id / cardType / tool→card 绑定）。
+ * 供 plugin-doctor / plugin-inspect 复用——替代已删除的手写 tools/registry.ts + cards/registry.ts。
+ * 与运行时（apps/server/src/index.ts start()）保持一致的注册面：registerAll + 模板演示工具 translate。
+ */
+export async function collectRegistryState(): Promise<RegistryState> {
+  const ctx = createServerContext();
+  await registerAll(ctx);
+  ctx.tools.register(translateTool); // 与运行时一致（index.ts 中 translate 为 apps 级演示工具）
+  const cards = ctx.cards.getAll();
+  return {
+    staticToolIds: Object.keys(ctx.tools.getAll()),
+    cardTypes: Object.keys(cards),
+    bindings: buildToolCardBindings(cards),
+  };
+}