@wu529778790/open-im 1.9.3-beta.7 → 1.9.3-beta.8

package/dist/config-web-page-i18n.d.ts

@@ -40,7 +40,7 @@ export declare const PAGE_TEXTS: {
         readonly serviceIdleMeta: "Bridge has not been started yet";
         readonly listSeparator: ", ";
         readonly platformsTitle: "Platforms";
-        readonly platformsHint: "Disabled platforms keep their saved values.";
+        readonly platformsHint: "Follow the setup checklist on Overview first. Disabled platforms still keep saved values.";
         readonly enabled: "Enabled";
         readonly readyState: "Ready";
         readonly setupRequired: "Setup required";
@@ -81,7 +81,7 @@ export declare const PAGE_TEXTS: {
         readonly optional: "Optional";
         readonly commaSeparatedIds: "Comma-separated IDs";
         readonly aiTitle: "AI Tooling";
-        readonly aiHint: "";
+        readonly aiHint: "Pick the default tool first. Claude SDK uses API keys in ~/.claude/settings.json (editable below). Codex / CodeBuddy need a CLI path.";
         readonly claudeNote: "Claude credentials are still read from environment variables or ~/.claude/settings.json. This page manages local bridge config, not Claude account auth.";
         readonly aiCommonTitle: "Shared defaults";
         readonly aiCommonHint: "Choose the default AI tool first. Tool-specific fields are shown below.";
@@ -134,6 +134,36 @@ export declare const PAGE_TEXTS: {
         readonly saveBtn: "Save";
         readonly jsonValid: "Valid JSON";
         readonly jsonInvalid: "Invalid JSON: {error}";
+        readonly wizardTitle: "First-time setup";
+        readonly wizardStep1Title: "Connect an IM channel";
+        readonly wizardStep1Desc: "Enable at least one platform below and fill every required field. Use Check config when available.";
+        readonly wizardStep2Title: "Set the default AI tool";
+        readonly wizardStep2Desc: "Claude SDK: API keys live in ~/.claude/settings.json (expand on this page). Codex / CodeBuddy: set the CLI path in the AI section.";
+        readonly wizardStep3Title: "Validate and save";
+        readonly wizardStep3Desc: "Click Validate, then Save config. Fix any errors shown in the banner above.";
+        readonly wizardStep4Title: "Start the bridge";
+        readonly wizardStep4Desc: "Open Service and click Start bridge. If it exits, read ~/.open-im/logs.";
+        readonly wizardStatusDone: "Done";
+        readonly wizardStatusTodo: "To do";
+        readonly wizardJumpPlatforms: "Open Platforms";
+        readonly wizardJumpAi: "Open AI";
+        readonly wizardJumpService: "Open Service";
+        readonly validationNoPlatformEnabled: "Enable at least one IM platform and fill its required credentials before saving.";
+        readonly validationPlatformIncomplete: "Platform \"{platform}\" is enabled but these required fields are empty: {fields}";
+        readonly validationAiCodexNoCli: "Default AI is Codex but Codex CLI path is empty. Set it under AI Tooling or change the default tool.";
+        readonly validationAiCodebuddyNoCli: "Default AI is CodeBuddy but CodeBuddy CLI path is empty. Set it under AI Tooling or change the default tool.";
+        readonly onboardingTitle: "Welcome to open-im";
+        readonly onboardingDismiss: "Got it";
+        readonly onboardingReadme: "README (setup)";
+        readonly onboardingBody: "<p><strong>open-im</strong> bridges Telegram, Feishu, QQ, WeWork, DingTalk, and WorkBuddy to Claude / Codex / CodeBuddy on your machine.</p><ol style=\"margin:12px 0 12px 18px;line-height:1.65\"><li>Pick <strong>one</strong> chat app in <strong>Platforms</strong> and paste credentials (see hints under each field).</li><li>Set the <strong>default AI</strong> and, for Claude SDK, API keys in <strong>~/.claude/settings.json</strong> on this page.</li><li>Use <strong>Validate</strong> then <strong>Save config</strong>, then <strong>Start bridge</strong> under Service.</li><li>CLI alternative: run <code style=\"background:var(--bg-tertiary);padding:2px 6px;border-radius:4px\">open-im init</code> in a terminal.</li></ol>";
+        readonly tipTelegramToken: "From Telegram, open <a href=\"https://t.me/BotFather\" target=\"_blank\" rel=\"noopener\">@BotFather</a> → /newbot → copy the token.";
+        readonly tipFeishuAppId: "Feishu Open Platform → your app → Credentials → App ID.";
+        readonly tipFeishuSecret: "Same page → App Secret (click show / reset if needed).";
+        readonly tipQqAppId: "<a href=\"https://bot.q.qq.com\" target=\"_blank\" rel=\"noopener\">QQ bot console</a> → your bot → App ID.";
+        readonly tipQqSecret: "Same console → App Secret.";
+        readonly tipWeworkCorp: "WeCom admin → app → view Corp ID (or smart-bot Bot ID) and Secret.";
+        readonly tipDingtalkClient: "<a href=\"https://open-dev.dingtalk.com\" target=\"_blank\" rel=\"noopener\">DingTalk Open Platform</a> → internal app → App Key & App Secret.";
+        readonly tipWorkbuddyToken: "Use terminal <code>open-im init</code> for WorkBuddy OAuth, or paste tokens from CodeBuddy login.";
     };
     readonly zh: {
         readonly pageTitle: "open-im 本地控制台";
@@ -174,7 +204,7 @@ export declare const PAGE_TEXTS: {
         readonly serviceIdleMeta: "桥接服务尚未启动";
         readonly listSeparator: "、";
         readonly platformsTitle: "平台配置";
-        readonly platformsHint: "禁用的平台会保留已保存的值。";
+        readonly platformsHint: "建议先在概览页按引导步骤操作。禁用的平台仍保留已保存的值。";
         readonly enabled: "启用";
         readonly readyState: "已就绪";
         readonly setupRequired: "需要完成配置";
@@ -214,7 +244,7 @@ export declare const PAGE_TEXTS: {
         readonly optional: "可选";
         readonly commaSeparatedIds: "多个 ID 用逗号分隔";
         readonly aiTitle: "AI 工具配置";
-        readonly aiHint: "";
+        readonly aiHint: "先选默认 AI。Claude SDK 的 API Key 写在 ~/.claude/settings.json（下方可编辑）。Codex / CodeBuddy 需填 CLI 路径。";
         readonly claudeNote: "Claude 凭证仍然从环境变量或 ~/.claude/settings.json 读取。这个页面只管理本地桥接配置，不负责 Claude 账号登录。";
         readonly aiCommonTitle: "公共默认配置";
         readonly aiCommonHint: "先选择默认 AI 工具，下方再显示对应的工具专属配置。";
@@ -264,5 +294,35 @@ export declare const PAGE_TEXTS: {
         readonly saveBtn: "保存";
         readonly jsonValid: "JSON 有效";
         readonly jsonInvalid: "JSON 无效：{error}";
+        readonly wizardTitle: "首次使用引导";
+        readonly wizardStep1Title: "接入一个 IM 渠道";
+        readonly wizardStep1Desc: "在下方启用至少一个平台，并填写所有必填项。有条件时用「校验配置」测试凭证。";
+        readonly wizardStep2Title: "设置默认 AI 工具";
+        readonly wizardStep2Desc: "Claude SDK：API Key 写在 ~/.claude/settings.json（本页可展开编辑）。Codex / CodeBuddy：在 AI 区填 CLI 路径。";
+        readonly wizardStep3Title: "校验并保存";
+        readonly wizardStep3Desc: "先点「校验」，再点「保存配置」。按顶部提示修复错误。";
+        readonly wizardStep4Title: "启动桥接";
+        readonly wizardStep4Desc: "到「服务」区点「启动桥接」。若马上退出，查 ~/.open-im/logs 日志。";
+        readonly wizardStatusDone: "已完成";
+        readonly wizardStatusTodo: "待完成";
+        readonly wizardJumpPlatforms: "打开平台配置";
+        readonly wizardJumpAi: "打开 AI 配置";
+        readonly wizardJumpService: "打开服务控制";
+        readonly validationNoPlatformEnabled: "保存前请至少启用一个 IM 平台，并填完必填凭证。";
+        readonly validationPlatformIncomplete: "平台「{platform}」已启用，但以下必填项为空：{fields}";
+        readonly validationAiCodexNoCli: "默认 AI 为 Codex，但 Codex CLI 路径为空。请在 AI 区填写，或改默认工具。";
+        readonly validationAiCodebuddyNoCli: "默认 AI 为 CodeBuddy，但 CodeBuddy CLI 路径为空。请在 AI 区填写，或改默认工具。";
+        readonly onboardingTitle: "欢迎使用 open-im";
+        readonly onboardingDismiss: "知道了";
+        readonly onboardingReadme: "README（部署说明）";
+        readonly onboardingBody: "<p><strong>open-im</strong> 在本机把 Telegram、飞书、QQ、企微、钉钉、WorkBuddy 等渠道连到 Claude / Codex / CodeBuddy。</p><ol style=\"margin:12px 0 12px 18px;line-height:1.65\"><li>在<strong>平台配置</strong>选一个聊天应用，按字段下方提示填凭证。</li><li>设<strong>默认 AI</strong>；用 Claude SDK 时把 API Key 写进<strong>~/.claude/settings.json</strong>（本页可编辑）。</li><li>先<strong>校验</strong>再<strong>保存配置</strong>，然后到<strong>服务</strong>启动桥接。</li><li>也可在终端运行 <code style=\"background:var(--bg-tertiary);padding:2px 6px;border-radius:4px\">open-im init</code> 交互配置。</li></ol>";
+        readonly tipTelegramToken: "在 Telegram 搜 <a href=\"https://t.me/BotFather\" target=\"_blank\" rel=\"noopener\">@BotFather</a>，发 /newbot 创建机器人后复制 Token。";
+        readonly tipFeishuAppId: "飞书开放平台 → 应用 → 凭证与基础信息 → App ID。";
+        readonly tipFeishuSecret: "同一页 App Secret（可重置后查看）。";
+        readonly tipQqAppId: "<a href=\"https://bot.q.qq.com\" target=\"_blank\" rel=\"noopener\">QQ 开放平台</a> → 机器人 → App ID。";
+        readonly tipQqSecret: "同一处获取 App Secret。";
+        readonly tipWeworkCorp: "企业微信管理后台 → 应用 → 查省 Corp ID / 智能机器人 Bot ID 与 Secret。";
+        readonly tipDingtalkClient: "<a href=\"https://open-dev.dingtalk.com\" target=\"_blank\" rel=\"noopener\">钉钉开放平台</a> → 企业内部应用 → AppKey / AppSecret。";
+        readonly tipWorkbuddyToken: "建议在终端运行 <code>open-im init</code> 完成 WorkBuddy 授权；或粘贴 CodeBuddy 登录后的 Token。";
     };
 };

package/dist/config-web-page-i18n.js

@@ -40,7 +40,7 @@ export const PAGE_TEXTS = {
         serviceIdleMeta: "Bridge has not been started yet",
         listSeparator: ", ",
         platformsTitle: "Platforms",
-        platformsHint: "Disabled platforms keep their saved values.",
+        platformsHint: "Follow the setup checklist on Overview first. Disabled platforms still keep saved values.",
         enabled: "Enabled",
         readyState: "Ready",
         setupRequired: "Setup required",
@@ -81,7 +81,7 @@ export const PAGE_TEXTS = {
         optional: "Optional",
         commaSeparatedIds: "Comma-separated IDs",
         aiTitle: "AI Tooling",
-        aiHint: "",
+        aiHint: "Pick the default tool first. Claude SDK uses API keys in ~/.claude/settings.json (editable below). Codex / CodeBuddy need a CLI path.",
         claudeNote: "Claude credentials are still read from environment variables or ~/.claude/settings.json. This page manages local bridge config, not Claude account auth.",
         aiCommonTitle: "Shared defaults",
         aiCommonHint: "Choose the default AI tool first. Tool-specific fields are shown below.",
@@ -134,6 +134,36 @@ export const PAGE_TEXTS = {
         saveBtn: "Save",
         jsonValid: "Valid JSON",
         jsonInvalid: "Invalid JSON: {error}",
+        wizardTitle: "First-time setup",
+        wizardStep1Title: "Connect an IM channel",
+        wizardStep1Desc: "Enable at least one platform below and fill every required field. Use Check config when available.",
+        wizardStep2Title: "Set the default AI tool",
+        wizardStep2Desc: "Claude SDK: API keys live in ~/.claude/settings.json (expand on this page). Codex / CodeBuddy: set the CLI path in the AI section.",
+        wizardStep3Title: "Validate and save",
+        wizardStep3Desc: "Click Validate, then Save config. Fix any errors shown in the banner above.",
+        wizardStep4Title: "Start the bridge",
+        wizardStep4Desc: "Open Service and click Start bridge. If it exits, read ~/.open-im/logs.",
+        wizardStatusDone: "Done",
+        wizardStatusTodo: "To do",
+        wizardJumpPlatforms: "Open Platforms",
+        wizardJumpAi: "Open AI",
+        wizardJumpService: "Open Service",
+        validationNoPlatformEnabled: "Enable at least one IM platform and fill its required credentials before saving.",
+        validationPlatformIncomplete: "Platform \"{platform}\" is enabled but these required fields are empty: {fields}",
+        validationAiCodexNoCli: "Default AI is Codex but Codex CLI path is empty. Set it under AI Tooling or change the default tool.",
+        validationAiCodebuddyNoCli: "Default AI is CodeBuddy but CodeBuddy CLI path is empty. Set it under AI Tooling or change the default tool.",
+        onboardingTitle: "Welcome to open-im",
+        onboardingDismiss: "Got it",
+        onboardingReadme: "README (setup)",
+        onboardingBody: "<p><strong>open-im</strong> bridges Telegram, Feishu, QQ, WeWork, DingTalk, and WorkBuddy to Claude / Codex / CodeBuddy on your machine.</p><ol style=\"margin:12px 0 12px 18px;line-height:1.65\"><li>Pick <strong>one</strong> chat app in <strong>Platforms</strong> and paste credentials (see hints under each field).</li><li>Set the <strong>default AI</strong> and, for Claude SDK, API keys in <strong>~/.claude/settings.json</strong> on this page.</li><li>Use <strong>Validate</strong> then <strong>Save config</strong>, then <strong>Start bridge</strong> under Service.</li><li>CLI alternative: run <code style=\"background:var(--bg-tertiary);padding:2px 6px;border-radius:4px\">open-im init</code> in a terminal.</li></ol>",
+        tipTelegramToken: 'From Telegram, open <a href="https://t.me/BotFather" target="_blank" rel="noopener">@BotFather</a> → /newbot → copy the token.',
+        tipFeishuAppId: "Feishu Open Platform → your app → Credentials → App ID.",
+        tipFeishuSecret: "Same page → App Secret (click show / reset if needed).",
+        tipQqAppId: '<a href="https://bot.q.qq.com" target="_blank" rel="noopener">QQ bot console</a> → your bot → App ID.',
+        tipQqSecret: "Same console → App Secret.",
+        tipWeworkCorp: "WeCom admin → app → view Corp ID (or smart-bot Bot ID) and Secret.",
+        tipDingtalkClient: '<a href="https://open-dev.dingtalk.com" target="_blank" rel="noopener">DingTalk Open Platform</a> → internal app → App Key & App Secret.',
+        tipWorkbuddyToken: 'Use terminal <code>open-im init</code> for WorkBuddy OAuth, or paste tokens from CodeBuddy login.',
     },
     zh: {
         pageTitle: "open-im \u672c\u5730\u63a7\u5236\u53f0",
@@ -174,7 +204,7 @@ export const PAGE_TEXTS = {
         serviceIdleMeta: "\u6865\u63a5\u670d\u52a1\u5c1a\u672a\u542f\u52a8",
         listSeparator: "\u3001",
         platformsTitle: "\u5e73\u53f0\u914d\u7f6e",
-        platformsHint: "\u7981\u7528\u7684\u5e73\u53f0\u4f1a\u4fdd\u7559\u5df2\u4fdd\u5b58\u7684\u503c\u3002",
+        platformsHint: "\u5efa\u8bae\u5148\u5728\u6982\u89c8\u9875\u6309\u5f15\u5bfc\u6b65\u9aa4\u64cd\u4f5c\u3002\u7981\u7528\u7684\u5e73\u53f0\u4ecd\u4fdd\u7559\u5df2\u4fdd\u5b58\u7684\u503c\u3002",
         enabled: "\u542f\u7528",
         readyState: "\u5df2\u5c31\u7eea",
         setupRequired: "\u9700\u8981\u5b8c\u6210\u914d\u7f6e",
@@ -214,7 +244,7 @@ export const PAGE_TEXTS = {
         optional: "\u53ef\u9009",
         commaSeparatedIds: "\u591a\u4e2a ID \u7528\u9017\u53f7\u5206\u9694",
         aiTitle: "AI \u5de5\u5177\u914d\u7f6e",
-        aiHint: "",
+        aiHint: "\u5148\u9009\u9ed8\u8ba4 AI\u3002Claude SDK \u7684 API Key \u5199\u5728 ~/.claude/settings.json\uff08\u4e0b\u65b9\u53ef\u7f16\u8f91\uff09\u3002Codex / CodeBuddy \u9700\u586b CLI \u8def\u5f84\u3002",
         claudeNote: "Claude \u51ed\u8bc1\u4ecd\u7136\u4ece\u73af\u5883\u53d8\u91cf\u6216 ~/.claude/settings.json \u8bfb\u53d6\u3002\u8fd9\u4e2a\u9875\u9762\u53ea\u7ba1\u7406\u672c\u5730\u6865\u63a5\u914d\u7f6e\uff0c\u4e0d\u8d1f\u8d23 Claude \u8d26\u53f7\u767b\u5f55\u3002",
         aiCommonTitle: "\u516c\u5171\u9ed8\u8ba4\u914d\u7f6e",
         aiCommonHint: "\u5148\u9009\u62e9\u9ed8\u8ba4 AI \u5de5\u5177\uff0c\u4e0b\u65b9\u518d\u663e\u793a\u5bf9\u5e94\u7684\u5de5\u5177\u4e13\u5c5e\u914d\u7f6e\u3002",
@@ -264,5 +294,35 @@ export const PAGE_TEXTS = {
         saveBtn: "\u4fdd\u5b58",
         jsonValid: "JSON \u6709\u6548",
         jsonInvalid: "JSON \u65e0\u6548\uff1a{error}",
+        wizardTitle: "\u9996\u6b21\u4f7f\u7528\u5f15\u5bfc",
+        wizardStep1Title: "\u63a5\u5165\u4e00\u4e2a IM \u6e20\u9053",
+        wizardStep1Desc: "\u5728\u4e0b\u65b9\u542f\u7528\u81f3\u5c11\u4e00\u4e2a\u5e73\u53f0\uff0c\u5e76\u586b\u5199\u6240\u6709\u5fc5\u586b\u9879\u3002\u6709\u6761\u4ef6\u65f6\u7528\u300c\u6821\u9a8c\u914d\u7f6e\u300d\u6d4b\u8bd5\u51ed\u8bc1\u3002",
+        wizardStep2Title: "\u8bbe\u7f6e\u9ed8\u8ba4 AI \u5de5\u5177",
+        wizardStep2Desc: "Claude SDK\uff1aAPI Key \u5199\u5728 ~/.claude/settings.json\uff08\u672c\u9875\u53ef\u5c55\u5f00\u7f16\u8f91\uff09\u3002Codex / CodeBuddy\uff1a\u5728 AI \u533a\u586b CLI \u8def\u5f84\u3002",
+        wizardStep3Title: "\u6821\u9a8c\u5e76\u4fdd\u5b58",
+        wizardStep3Desc: "\u5148\u70b9\u300c\u6821\u9a8c\u300d\uff0c\u518d\u70b9\u300c\u4fdd\u5b58\u914d\u7f6e\u300d\u3002\u6309\u9876\u90e8\u63d0\u793a\u4fee\u590d\u9519\u8bef\u3002",
+        wizardStep4Title: "\u542f\u52a8\u6865\u63a5",
+        wizardStep4Desc: "\u5230\u300c\u670d\u52a1\u300d\u533a\u70b9\u300c\u542f\u52a8\u6865\u63a5\u300d\u3002\u82e5\u9a6c\u4e0a\u9000\u51fa\uff0c\u67e5 ~/.open-im/logs \u65e5\u5fd7\u3002",
+        wizardStatusDone: "\u5df2\u5b8c\u6210",
+        wizardStatusTodo: "\u5f85\u5b8c\u6210",
+        wizardJumpPlatforms: "\u6253\u5f00\u5e73\u53f0\u914d\u7f6e",
+        wizardJumpAi: "\u6253\u5f00 AI \u914d\u7f6e",
+        wizardJumpService: "\u6253\u5f00\u670d\u52a1\u63a7\u5236",
+        validationNoPlatformEnabled: "\u4fdd\u5b58\u524d\u8bf7\u81f3\u5c11\u542f\u7528\u4e00\u4e2a IM \u5e73\u53f0\uff0c\u5e76\u586b\u5b8c\u5fc5\u586b\u51ed\u8bc1\u3002",
+        validationPlatformIncomplete: "\u5e73\u53f0\u300c{platform}\u300d\u5df2\u542f\u7528\uff0c\u4f46\u4ee5\u4e0b\u5fc5\u586b\u9879\u4e3a\u7a7a\uff1a{fields}",
+        validationAiCodexNoCli: "\u9ed8\u8ba4 AI \u4e3a Codex\uff0c\u4f46 Codex CLI \u8def\u5f84\u4e3a\u7a7a\u3002\u8bf7\u5728 AI \u533a\u586b\u5199\uff0c\u6216\u6539\u9ed8\u8ba4\u5de5\u5177\u3002",
+        validationAiCodebuddyNoCli: "\u9ed8\u8ba4 AI \u4e3a CodeBuddy\uff0c\u4f46 CodeBuddy CLI \u8def\u5f84\u4e3a\u7a7a\u3002\u8bf7\u5728 AI \u533a\u586b\u5199\uff0c\u6216\u6539\u9ed8\u8ba4\u5de5\u5177\u3002",
+        onboardingTitle: "\u6b22\u8fce\u4f7f\u7528 open-im",
+        onboardingDismiss: "\u77e5\u9053\u4e86",
+        onboardingReadme: "README\uff08\u90e8\u7f72\u8bf4\u660e\uff09",
+        onboardingBody: "<p><strong>open-im</strong> \u5728\u672c\u673a\u628a Telegram\u3001\u98de\u4e66\u3001QQ\u3001\u4f01\u5fae\u3001\u9489\u9489\u3001WorkBuddy \u7b49\u6e20\u9053\u8fde\u5230 Claude / Codex / CodeBuddy\u3002</p><ol style=\"margin:12px 0 12px 18px;line-height:1.65\"><li>\u5728<strong>\u5e73\u53f0\u914d\u7f6e</strong>\u9009\u4e00\u4e2a\u804a\u5929\u5e94\u7528\uff0c\u6309\u5b57\u6bb5\u4e0b\u65b9\u63d0\u793a\u586b\u51ed\u8bc1\u3002</li><li>\u8bbe<strong>\u9ed8\u8ba4 AI</strong>\uff1b\u7528 Claude SDK \u65f6\u628a API Key \u5199\u8fdb<strong>~/.claude/settings.json</strong>\uff08\u672c\u9875\u53ef\u7f16\u8f91\uff09\u3002</li><li>\u5148<strong>\u6821\u9a8c</strong>\u518d<strong>\u4fdd\u5b58\u914d\u7f6e</strong>\uff0c\u7136\u540e\u5230<strong>\u670d\u52a1</strong>\u542f\u52a8\u6865\u63a5\u3002</li><li>\u4e5f\u53ef\u5728\u7ec8\u7aef\u8fd0\u884c <code style=\"background:var(--bg-tertiary);padding:2px 6px;border-radius:4px\">open-im init</code> \u4ea4\u4e92\u914d\u7f6e\u3002</li></ol>",
+        tipTelegramToken: '\u5728 Telegram \u641c <a href="https://t.me/BotFather" target="_blank" rel="noopener">@BotFather</a>\uff0c\u53d1 /newbot \u521b\u5efa\u673a\u5668\u4eba\u540e\u590d\u5236 Token\u3002',
+        tipFeishuAppId: "\u98de\u4e66\u5f00\u653e\u5e73\u53f0 \u2192 \u5e94\u7528 \u2192 \u51ed\u8bc1\u4e0e\u57fa\u7840\u4fe1\u606f \u2192 App ID\u3002",
+        tipFeishuSecret: "\u540c\u4e00\u9875 App Secret\uff08\u53ef\u91cd\u7f6e\u540e\u67e5\u770b\uff09\u3002",
+        tipQqAppId: '<a href="https://bot.q.qq.com" target="_blank" rel="noopener">QQ \u5f00\u653e\u5e73\u53f0</a> \u2192 \u673a\u5668\u4eba \u2192 App ID\u3002',
+        tipQqSecret: "\u540c\u4e00\u5904\u83b7\u53d6 App Secret\u3002",
+        tipWeworkCorp: "\u4f01\u4e1a\u5fae\u4fe1\u7ba1\u7406\u540e\u53f0 \u2192 \u5e94\u7528 \u2192 \u67e5\u7701 Corp ID / \u667a\u80fd\u673a\u5668\u4eba Bot ID \u4e0e Secret\u3002",
+        tipDingtalkClient: '<a href="https://open-dev.dingtalk.com" target="_blank" rel="noopener">\u9489\u9489\u5f00\u653e\u5e73\u53f0</a> \u2192 \u4f01\u4e1a\u5185\u90e8\u5e94\u7528 \u2192 AppKey / AppSecret\u3002',
+        tipWorkbuddyToken: "\u5efa\u8bae\u5728\u7ec8\u7aef\u8fd0\u884c <code>open-im init</code> \u5b8c\u6210 WorkBuddy \u6388\u6743\uff1b\u6216\u7c98\u8d34 CodeBuddy \u767b\u5f55\u540e\u7684 Token\u3002",
     }
 };

package/dist/config-web-page-script.js

@@ -10,6 +10,8 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
       const aiTools = ["claude", "codex", "codebuddy"];
       const STORAGE_KEY_LANG = "open-im-web-lang";
       const STORAGE_KEY_DARK_MODE = "open-im-web-dark-mode";
+      const STORAGE_KEY_ONBOARDING = "open-im-dashboard-onboarding-v1";
+      const STORAGE_KEY_SAVED_SESSION = "open-im-setup-saved-session";
       const POLLING_INTERVAL = 10000;
       const toolLabels = { claude: "Claude", codex: "Codex", codebuddy: "CodeBuddy" };
 
@@ -67,6 +69,7 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
       const texts = __PAGE_TEXTS__;
       let currentMeta = null;
       let cachedServiceData = null;
+      let lastHealthPayload = null;
       let currentLang = (localStorage.getItem(STORAGE_KEY_LANG) || "").startsWith("zh") ? "zh" : ((navigator.language || "").startsWith("zh") ? "zh" : "en");
 
       // Translation helper
@@ -166,6 +169,22 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
           { id: "resetJsonButtonText", key: "resetJson" },
           { id: "saveClaudeSettingsBtnText", key: "saveBtn" },
           { id: "saveOpenImConfigBtnText", key: "saveBtn" },
+          { id: "wizardTitle", key: "wizardTitle" },
+          { id: "wizardStep1Title", key: "wizardStep1Title" },
+          { id: "wizardStep1Desc", key: "wizardStep1Desc" },
+          { id: "wizardStep2Title", key: "wizardStep2Title" },
+          { id: "wizardStep2Desc", key: "wizardStep2Desc" },
+          { id: "wizardStep3Title", key: "wizardStep3Title" },
+          { id: "wizardStep3Desc", key: "wizardStep3Desc" },
+          { id: "wizardStep4Title", key: "wizardStep4Title" },
+          { id: "wizardStep4Desc", key: "wizardStep4Desc" },
+          { id: "wizardJumpPlatforms", key: "wizardJumpPlatforms" },
+          { id: "wizardJumpAi", key: "wizardJumpAi" },
+          { id: "wizardJumpService", key: "wizardJumpService" },
+          { id: "wizardJumpService2", key: "wizardJumpService" },
+          { id: "onboardingTitle", key: "onboardingTitle" },
+          { id: "onboardingDismiss", key: "onboardingDismiss" },
+          { id: "onboardingReadme", key: "onboardingReadme" },
         ],
         platformLabels: {
           enabled: { suffix: "-label", key: "enabled" },
@@ -274,6 +293,24 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
           if (helpBlock) helpBlock.innerHTML = t(key);
         });
 
+        // Short per-field tips (HTML)
+        [
+          ["telegram-botToken-tip", "tipTelegramToken"],
+          ["feishu-appId-tip", "tipFeishuAppId"],
+          ["feishu-appSecret-tip", "tipFeishuSecret"],
+          ["qq-appId-tip", "tipQqAppId"],
+          ["qq-secret-tip", "tipQqSecret"],
+          ["wework-corpId-tip", "tipWeworkCorp"],
+          ["dingtalk-clientId-tip", "tipDingtalkClient"],
+          ["workbuddy-accessToken-tip", "tipWorkbuddyToken"],
+        ].forEach(([tipId, tipKey]) => {
+          const tipEl = el(tipId);
+          if (tipEl) tipEl.innerHTML = t(tipKey);
+        });
+
+        const onboardBody = el("onboardingBody");
+        if (onboardBody) onboardBody.innerHTML = t("onboardingBody");
+
         // AI labels
         LANGUAGE_UPDATES.aiLabels.forEach(({ id, key }) => {
           const label = el(id + "-label");
@@ -300,6 +337,14 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
         // Dark mode toggle aria-label
         const darkModeToggle = el("darkModeToggle");
         if (darkModeToggle) darkModeToggle.setAttribute("aria-label", t("darkModeToggle"));
+
+        const readmeLink = el("onboardingReadmeLink");
+        if (readmeLink && readmeLink instanceof HTMLAnchorElement) {
+          readmeLink.href = isZh
+            ? "https://github.com/wu529778790/open-im/blob/main/README.zh-CN.md"
+            : "https://github.com/wu529778790/open-im/blob/main/README.md";
+        }
+        updateSetupWizard();
       }
 
       // AI tool switcher
@@ -331,6 +376,66 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
         const liveSummary = el("liveSummary");
         if (liveSummary) liveSummary.textContent = summary;
         updateAiToolVisibility();
+        updateSetupWizard();
+      }
+
+      function hasReadyPlatform() {
+        return platformDefinitions.some((platform) => {
+          if (!getChecked(platform.key + "-enabled")) return false;
+          return platform.requiredFields.every((field) => getValue(platform.key + "-" + field).trim().length > 0);
+        });
+      }
+
+      function aiStepComplete() {
+        const cmd = getValue("ai-aiCommand");
+        if (cmd === "codex") return getValue("ai-codexCliPath").trim().length > 0;
+        if (cmd === "codebuddy") return getValue("ai-codebuddyCliPath").trim().length > 0;
+        return true;
+      }
+
+      function updateSetupWizard() {
+        const s1 = hasReadyPlatform();
+        const s2 = aiStepComplete();
+        const s3 = sessionStorage.getItem(STORAGE_KEY_SAVED_SESSION) === "1";
+        const s4 = Boolean(lastHealthPayload && lastHealthPayload.serviceStatus && lastHealthPayload.serviceStatus.running);
+        const done = [s1, s2, s3, s4];
+        for (let i = 0; i < 4; i += 1) {
+          const step = el("wizard-step-" + (i + 1));
+          if (step) step.classList.toggle("wizard-step--done", done[i]);
+          setText("wizardStep" + (i + 1) + "Status", done[i] ? t("wizardStatusDone") : t("wizardStatusTodo"));
+        }
+      }
+
+      function collectClientValidationErrors() {
+        const errors = [];
+        const anyEnabled = platformDefinitions.some((p) => getChecked(p.key + "-enabled"));
+        if (!anyEnabled) {
+          errors.push(t("validationNoPlatformEnabled"));
+        }
+        platformDefinitions.forEach((platform) => {
+          if (!getChecked(platform.key + "-enabled")) return;
+          const missing = platform.requiredFields.filter((field) => !getValue(platform.key + "-" + field).trim());
+          if (missing.length > 0) {
+            errors.push(t("validationPlatformIncomplete", { platform: platform.label, fields: missing.join(", ") }));
+          }
+        });
+        const cmd = getValue("ai-aiCommand");
+        if (cmd === "codex" && !getValue("ai-codexCliPath").trim()) {
+          errors.push(t("validationAiCodexNoCli"));
+        }
+        if (cmd === "codebuddy" && !getValue("ai-codebuddyCliPath").trim()) {
+          errors.push(t("validationAiCodebuddyNoCli"));
+        }
+        return errors;
+      }
+
+      function validateClientSideOrAbort() {
+        const errors = collectClientValidationErrors();
+        if (errors.length > 0) {
+          setMessage(errors.join(" "), "error");
+          return false;
+        }
+        return true;
       }
 
       // Update dashboard with health status
@@ -386,6 +491,9 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
           el("statEnabledValue").textContent = String(enabledCount);
           el("statServiceValue").textContent = serviceStatus.running ? t("serviceRunningShort") : t("serviceIdleShort");
 
+          lastHealthPayload = data;
+          updateSetupWizard();
+
           return data;
         } catch (error) {
           console.error("Failed to update dashboard:", error);
@@ -684,6 +792,26 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
         el("navAiBtn").onclick = () => scrollToSection("aiSection", "navAiBtn");
         el("navServiceBtn").onclick = () => scrollToSection("serviceSection", "navServiceBtn");
 
+        document.querySelectorAll(".wizard-jump").forEach((jumpBtn) => {
+          jumpBtn.addEventListener("click", () => {
+            const sec = jumpBtn.getAttribute("data-section");
+            const nav = jumpBtn.getAttribute("data-nav");
+            if (sec && nav) scrollToSection(sec, nav);
+          });
+        });
+
+        const onboardBackdrop = el("onboardingBackdrop");
+        const onboardDismiss = el("onboardingDismiss");
+        if (onboardBackdrop && onboardDismiss) {
+          if (!localStorage.getItem(STORAGE_KEY_ONBOARDING)) {
+            onboardBackdrop.classList.remove("hidden");
+          }
+          onboardDismiss.onclick = () => {
+            localStorage.setItem(STORAGE_KEY_ONBOARDING, "1");
+            onboardBackdrop.classList.add("hidden");
+          };
+        }
+
         // Language toggle
         el("langButton").onclick = () => {
           currentLang = currentLang === "zh" ? "en" : "zh";
@@ -700,12 +828,12 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
         // Service buttons
         el("validateButton").onclick = validate;
         el("saveButton").onclick = async () => {
-          // 先保存 JSON，再保存主配置
+          if (!validateClientSideOrAbort()) return;
           await saveClaudeSettings();
           await save();
         };
         el("startButton").onclick = async () => {
-          // 启动前也顺带保存 JSON
+          if (!validateClientSideOrAbort()) return;
           await saveClaudeSettings();
           await startService();
         };
@@ -725,6 +853,7 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
       async function validate() {
         setBusy(true);
         try {
+          if (!validateClientSideOrAbort()) return;
           await request("/api/config/validate", { method: "POST", body: JSON.stringify(payload()) });
           setMessage(t("validationOk"), "success");
         } catch (error) {
@@ -737,11 +866,14 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
       async function save() {
         setBusy(true);
         try {
+          if (!validateClientSideOrAbort()) return;
           // First save JSON editor content if changed
           await saveOpenImConfig();
           // Then save form data
           await request("/api/config/save?final=1", { method: "POST", body: JSON.stringify(payload()) });
+          sessionStorage.setItem(STORAGE_KEY_SAVED_SESSION, "1");
           setMessage(t("saveOk"), "success");
+          updateSetupWizard();
         } catch (error) {
           setMessage(error.message || String(error), "error");
         } finally {
@@ -778,9 +910,11 @@ export const PAGE_SCRIPT = String.raw `      const platformDefinitions = [
       async function startService() {
         setBusy(true);
         try {
+          if (!validateClientSideOrAbort()) return;
           await request("/api/config/save", { method: "POST", body: JSON.stringify(payload()) });
           await request("/api/service/start", { method: "POST" });
           await refreshStatus();
+          await updateDashboard();
           setMessage(t("startOk"), "success");
         } catch (error) {
           setMessage(error.message || String(error), "error");

package/dist/config-web-page-template.js

@@ -356,6 +356,149 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
         line-height: 1;
       }
 
+      /* Setup wizard (overview) */
+      .setup-wizard-card {
+        background: var(--bg-card);
+        border: 1px solid var(--border-subtle);
+        border-radius: var(--radius-lg);
+        padding: 20px 24px;
+        margin-bottom: 24px;
+        box-shadow: var(--shadow-sm);
+      }
+      .setup-wizard-card h2 {
+        margin: 0 0 16px;
+        font-size: 16px;
+        font-weight: 600;
+        color: var(--text-primary);
+      }
+      .wizard-steps {
+        display: grid;
+        gap: 12px;
+      }
+      @media (min-width: 900px) {
+        .wizard-steps {
+          grid-template-columns: repeat(2, 1fr);
+        }
+      }
+      .wizard-step {
+        display: flex;
+        gap: 14px;
+        align-items: flex-start;
+        padding: 14px 16px;
+        border-radius: var(--radius-md);
+        border: 1px solid var(--border-subtle);
+        background: var(--bg-secondary);
+        transition: border-color var(--transition-fast), background var(--transition-fast);
+      }
+      .wizard-step--done {
+        border-color: var(--success-border);
+        background: var(--success-bg);
+      }
+      .wizard-step-badge {
+        flex-shrink: 0;
+        width: 28px;
+        height: 28px;
+        border-radius: 999px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-size: 13px;
+        font-weight: 700;
+        background: var(--bg-tertiary);
+        color: var(--text-secondary);
+      }
+      .wizard-step--done .wizard-step-badge {
+        background: var(--success-text);
+        color: #fff;
+      }
+      .wizard-step-body {
+        flex: 1;
+        min-width: 0;
+      }
+      .wizard-step-title {
+        font-weight: 600;
+        font-size: 14px;
+        color: var(--text-primary);
+        margin-bottom: 4px;
+      }
+      .wizard-step-desc {
+        font-size: 13px;
+        color: var(--text-secondary);
+        line-height: 1.5;
+        margin-bottom: 8px;
+      }
+      .wizard-step-status {
+        font-size: 11px;
+        font-weight: 600;
+        text-transform: uppercase;
+        letter-spacing: 0.04em;
+        margin-bottom: 6px;
+        color: var(--text-tertiary);
+      }
+      .wizard-step--done .wizard-step-status {
+        color: var(--success-text);
+      }
+      .field-inline-tip {
+        font-size: 12px;
+        color: var(--text-tertiary);
+        line-height: 1.45;
+        margin-top: 6px;
+      }
+      .field-inline-tip a {
+        color: var(--accent-primary);
+      }
+      .field-inline-tip code {
+        font-size: 11px;
+        background: var(--bg-tertiary);
+        padding: 1px 5px;
+        border-radius: var(--radius-xs);
+      }
+
+      /* First-visit onboarding */
+      .onboarding-backdrop {
+        position: fixed;
+        inset: 0;
+        background: rgba(15, 23, 42, 0.45);
+        z-index: 100;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        padding: 24px;
+      }
+      .onboarding-backdrop.hidden {
+        display: none;
+      }
+      .onboarding-card {
+        background: var(--bg-card);
+        color: var(--text-primary);
+        border-radius: var(--radius-xl);
+        max-width: 520px;
+        width: 100%;
+        padding: 28px 28px 24px;
+        box-shadow: var(--shadow-lg);
+        border: 1px solid var(--border-subtle);
+      }
+      .onboarding-card h2 {
+        margin: 0 0 12px;
+        font-size: 20px;
+        font-weight: 700;
+      }
+      .onboarding-card .onboarding-body {
+        font-size: 14px;
+        color: var(--text-secondary);
+        line-height: 1.55;
+      }
+      .onboarding-card .onboarding-body p {
+        margin: 0 0 8px;
+      }
+      .onboarding-actions {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 10px;
+        margin-top: 20px;
+        align-items: center;
+      }
+
       /* Platform Cards */
       .platform-grid {
         display: grid;
@@ -839,6 +982,48 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                 <div class="stat-value" id="statServiceValue">Idle</div>
               </div>
             </div>
+
+            <div class="setup-wizard-card">
+              <h2 id="wizardTitle">First-time setup</h2>
+              <div class="wizard-steps" id="wizardSteps">
+                <div class="wizard-step" id="wizard-step-1">
+                  <div class="wizard-step-badge">1</div>
+                  <div class="wizard-step-body">
+                    <div class="wizard-step-status" id="wizardStep1Status">To do</div>
+                    <div class="wizard-step-title" id="wizardStep1Title">Connect an IM channel</div>
+                    <div class="wizard-step-desc" id="wizardStep1Desc"></div>
+                    <button type="button" class="btn btn-secondary btn-sm wizard-jump" data-section="configSection" data-nav="navPlatformsBtn" id="wizardJumpPlatforms">Open Platforms</button>
+                  </div>
+                </div>
+                <div class="wizard-step" id="wizard-step-2">
+                  <div class="wizard-step-badge">2</div>
+                  <div class="wizard-step-body">
+                    <div class="wizard-step-status" id="wizardStep2Status">To do</div>
+                    <div class="wizard-step-title" id="wizardStep2Title">Set the default AI tool</div>
+                    <div class="wizard-step-desc" id="wizardStep2Desc"></div>
+                    <button type="button" class="btn btn-secondary btn-sm wizard-jump" data-section="aiSection" data-nav="navAiBtn" id="wizardJumpAi">Open AI</button>
+                  </div>
+                </div>
+                <div class="wizard-step" id="wizard-step-3">
+                  <div class="wizard-step-badge">3</div>
+                  <div class="wizard-step-body">
+                    <div class="wizard-step-status" id="wizardStep3Status">To do</div>
+                    <div class="wizard-step-title" id="wizardStep3Title">Validate and save</div>
+                    <div class="wizard-step-desc" id="wizardStep3Desc"></div>
+                    <button type="button" class="btn btn-secondary btn-sm wizard-jump" data-section="serviceSection" data-nav="navServiceBtn" id="wizardJumpService">Open Service</button>
+                  </div>
+                </div>
+                <div class="wizard-step" id="wizard-step-4">
+                  <div class="wizard-step-badge">4</div>
+                  <div class="wizard-step-body">
+                    <div class="wizard-step-status" id="wizardStep4Status">To do</div>
+                    <div class="wizard-step-title" id="wizardStep4Title">Start the bridge</div>
+                    <div class="wizard-step-desc" id="wizardStep4Desc"></div>
+                    <button type="button" class="btn btn-secondary btn-sm wizard-jump" data-section="serviceSection" data-nav="navServiceBtn" id="wizardJumpService2">Open Service</button>
+                  </div>
+                </div>
+              </div>
+            </div>
           </section>
 
           <!-- Platforms Section -->
@@ -864,6 +1049,7 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                   <div class="form-group">
                     <label class="form-label" id="telegram-botToken-label">Bot Token</label>
                     <input id="telegram-botToken" class="form-input mono" type="password" />
+                    <div class="field-inline-tip" id="telegram-botToken-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="telegram-proxy-label">Proxy (optional)</label>
@@ -906,10 +1092,12 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                   <div class="form-group">
                     <label class="form-label" id="feishu-appId-label">App ID</label>
                     <input id="feishu-appId" class="form-input mono" type="text" />
+                    <div class="field-inline-tip" id="feishu-appId-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="feishu-appSecret-label">App Secret</label>
                     <input id="feishu-appSecret" class="form-input mono" type="password" />
+                    <div class="field-inline-tip" id="feishu-appSecret-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="feishu-aiCommand-label">AI Tool</label>
@@ -947,10 +1135,12 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                   <div class="form-group">
                     <label class="form-label" id="qq-appId-label">App ID</label>
                     <input id="qq-appId" class="form-input mono" type="text" />
+                    <div class="field-inline-tip" id="qq-appId-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="qq-secret-label">App Secret</label>
                     <input id="qq-secret" class="form-input mono" type="password" />
+                    <div class="field-inline-tip" id="qq-secret-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="qq-aiCommand-label">AI Tool</label>
@@ -988,6 +1178,7 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                   <div class="form-group">
                     <label class="form-label" id="wework-corpId-label">Corp ID / Bot ID</label>
                     <input id="wework-corpId" class="form-input mono" type="text" />
+                    <div class="field-inline-tip" id="wework-corpId-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="wework-secret-label">Secret</label>
@@ -1029,6 +1220,7 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                   <div class="form-group">
                     <label class="form-label" id="dingtalk-clientId-label">Client ID / AppKey</label>
                     <input id="dingtalk-clientId" class="form-input mono" type="password" />
+                    <div class="field-inline-tip" id="dingtalk-clientId-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="dingtalk-clientSecret-label">Client Secret / AppSecret</label>
@@ -1083,6 +1275,7 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
                   <div class="form-group">
                     <label class="form-label" id="workbuddy-accessToken-label">Access Token</label>
                     <input id="workbuddy-accessToken" class="form-input mono" type="password" autocomplete="off" />
+                    <div class="field-inline-tip" id="workbuddy-accessToken-tip"></div>
                   </div>
                   <div class="form-group">
                     <label class="form-label" id="workbuddy-refreshToken-label">Refresh Token</label>
@@ -1259,6 +1452,17 @@ export const PAGE_HTML_PREFIX = String.raw `<!doctype html>
             </div>
           </section>
 
+          <div id="onboardingBackdrop" class="onboarding-backdrop hidden" role="dialog" aria-modal="true" aria-labelledby="onboardingTitle">
+            <div class="onboarding-card">
+              <h2 id="onboardingTitle">Welcome</h2>
+              <div id="onboardingBody" class="onboarding-body"></div>
+              <div class="onboarding-actions">
+                <button type="button" class="btn btn-primary" id="onboardingDismiss">Got it</button>
+                <a href="https://github.com/wu529778790/open-im/blob/main/README.zh-CN.md" target="_blank" rel="noopener" class="btn btn-ghost" id="onboardingReadmeLink"><span id="onboardingReadme">README</span></a>
+              </div>
+            </div>
+          </div>
+
         </div>
       </main>
     </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wu529778790/open-im",
-  "version": "1.9.3-beta.7",
+  "version": "1.9.3-beta.8",
   "description": "Multi-platform IM bridge for AI CLI tools (Claude, Codex, CodeBuddy)",
   "type": "module",
   "main": "dist/index.js",