Merge branch 'feat/ai-chat' into canary

Author: twosugar

.gitignore

@@ -38,6 +38,7 @@ old_docs
 .superpowers
 docs/superpowers
 .claude/worktrees
+.worktrees
 
 # generated at build time by fetch-mcp-tools plugin
 docs/.vitepress/data/mcp-tools.json

.vscode/settings.json

@@ -35,5 +35,16 @@
     "editor.quickSuggestions": {
       "strings": true
     }
-  }
+  },
+  "cSpell.words": [
+    "Helora",
+    "helora",
+    "Longbridge",
+    "longbridge",
+    "longport",
+    "vitepress",
+    "VITE",
+    "lbkrs",
+    "lbctrl"
+  ]
 }

README.md

@@ -75,7 +75,7 @@ pip install longbridge
 {
   "mcpServers": {
     "longbridge": {
-      "url": "https://openapi.longbridge.com/mcp"
+      "url": "https://mcp.longbridge.com"
     }
   }
 }

docs/.vitepress/config.mts

@@ -15,7 +15,7 @@ import yaml from 'js-yaml'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const docsRoot = resolve(__dirname, '..')
-const MCP_TOOLS_URL = 'https://openapi.longbridge.com/mcp/tools.json'
+const MCP_TOOLS_URL = 'https://mcp.longbridge.com/mcp/tools.json'
 const MCP_TOOLS_DATA_PATH = resolve(__dirname, 'data/mcp-tools.json')
 const regionCfg = getRegionConfig()
 const regionSrcExclude = computeSrcExclude(docsRoot)
@@ -49,10 +49,13 @@ export default defineConfig(
     markdown: markdownConfig,
     transformHtml(code) {
       let html = insertScript(code)
-      // Region URL rewriting: replace global hostname with region hostname in final HTML
+      // Region URL rewriting: replace global hostnames (site + API) with region hostnames in final HTML
       if (regionCfg?.siteHostname && regionCfg.siteHostname !== 'https://open.longbridge.com') {
         html = html.split('https://open.longbridge.com').join(regionCfg.siteHostname)
       }
+      if (regionCfg?.apiBaseUrl && regionCfg.apiBaseUrl !== 'https://openapi.longbridge.com') {
+        html = html.split('https://openapi.longbridge.com').join(regionCfg.apiBaseUrl)
+      }
       return html
     },
     transformHead(context) {
@@ -127,13 +130,23 @@ export default defineConfig(
 
       rmSync(tmpDir, { recursive: true, force: true })
 
-      // Region URL rewriting for static assets
+      // Region URL rewriting for static assets (site + API hostnames)
+      const staticReplacements: [string, string][] = []
       if (regionCfg?.siteHostname && regionCfg.siteHostname !== 'https://open.longbridge.com') {
+        staticReplacements.push(['https://open.longbridge.com', regionCfg.siteHostname])
+      }
+      if (regionCfg?.apiBaseUrl && regionCfg.apiBaseUrl !== 'https://openapi.longbridge.com') {
+        staticReplacements.push(['https://openapi.longbridge.com', regionCfg.apiBaseUrl])
+      }
+      if (staticReplacements.length > 0) {
         const installDir = resolve(siteConfig.outDir, 'longbridge-terminal')
         for (const file of ['install', 'install.ps1']) {
           const filePath = resolve(installDir, file)
-          const content = readFileSync(filePath, 'utf-8')
-          writeFileSync(filePath, content.split('https://open.longbridge.com').join(regionCfg.siteHostname))
+          let content = readFileSync(filePath, 'utf-8')
+          for (const [from, to] of staticReplacements) {
+            content = content.split(from).join(to)
+          }
+          writeFileSync(filePath, content)
         }
         console.log('✓ install scripts rewritten for region')
       }

docs/.vitepress/helora.d.ts

@@ -0,0 +1,37 @@
+// Helora 客服 SDK 的全局类型声明
+// 脚本通过 <script> 注入 window.Helora，需要给 TS 一个最小的形状
+// cSpell:words Helora helora
+
+interface HeloraHeaderAction {
+  id: string
+  label: string
+  icon?: string
+  intent?: 'event' | 'link' | string
+}
+
+interface HeloraBootConfig {
+  proxy: 'prod' | 'staging'
+  guest?: boolean
+  configPlatform: 'web' | string
+  configKey: string
+  source?: string
+  locale?: string
+  theme?: 'light' | 'dark'
+  headerActions?: HeloraHeaderAction[]
+  [key: string]: unknown
+}
+
+interface HeloraSDK {
+  boot: (config: HeloraBootConfig) => void
+  setTheme?: (theme: 'light' | 'dark') => void
+  /** 订阅运行时事件，返回取消函数 */
+  on?: (event: string, handler: (payload: any) => void) => () => void
+}
+
+declare global {
+  interface Window {
+    Helora?: HeloraSDK
+  }
+}
+
+export {}

docs/.vitepress/md-plugins/region-filter.ts

@@ -11,14 +11,23 @@ export function RegionFilterPlugin(md: MarkdownItAsync) {
   const config = getRegionConfig()
   if (!config) return
 
-  // URL rewriting: replace global hostname with region hostname in all inline tokens
+  // URL rewriting: replace global hostnames (site + API) with region hostnames in all inline tokens
+  const urlReplacements: [string, string][] = []
   if (config.siteHostname && config.siteHostname !== 'https://open.longbridge.com') {
+    urlReplacements.push(['https://open.longbridge.com', config.siteHostname])
+  }
+  if (config.apiBaseUrl && config.apiBaseUrl !== 'https://openapi.longbridge.com') {
+    urlReplacements.push(['https://openapi.longbridge.com', config.apiBaseUrl])
+  }
+  if (urlReplacements.length > 0) {
     md.core.ruler.push('region_url_rewrite', (state) => {
       for (const token of state.tokens) {
-        rewriteTokenUrls(token, 'https://open.longbridge.com', config.siteHostname)
-        if (token.children) {
-          for (const child of token.children) {
-            rewriteTokenUrls(child, 'https://open.longbridge.com', config.siteHostname)
+        for (const [from, to] of urlReplacements) {
+          rewriteTokenUrls(token, from, to)
+          if (token.children) {
+            for (const child of token.children) {
+              rewriteTokenUrls(child, from, to)
+            }
           }
         }
       }

docs/.vitepress/theme/components/AppFooter.vue

@@ -121,10 +121,7 @@ const year = new Date().getFullYear()
             }}</a>
           </li>
           <li>
-            <a :href="localePath('/docs/legal/user-data-authorization-hk')">{{ t('footer.dataAuthorisationHK') }}</a>
-          </li>
-          <li>
-            <a :href="localePath('/docs/legal/user-data-authorization-sg')">{{ t('footer.dataAuthorisationSG') }}</a>
+            <a :href="localePath('/docs/legal')">{{ t('footer.agreements') }}</a>
           </li>
           <li>
             <a

docs/.vitepress/theme/components/AppNav.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { ref, computed, onMounted, onUnmounted, defineAsyncComponent } from 'vue'
+import { ref, computed, onMounted, onUnmounted, defineAsyncComponent, watch } from 'vue'
 import { useData, useRoute } from 'vitepress'
 import { useI18n } from 'vue-i18n'
 import endsWith from 'lodash/endsWith'
@@ -97,6 +97,7 @@ const avatarCloseTimer = ref<ReturnType<typeof setTimeout> | null>(null)
 
 const avatarMenuItems = computed(() => [
   { title: 'Dashboard', href: '/dashboard' },
+  { title: 'Connect AI', href: '/connect' },
   { title: 'Log out', href: '/log-out' },
 ])
 
@@ -123,31 +124,109 @@ function openSearch() {
   )
 }
 
+// Helora 事件订阅的清理函数集（boot 之后由 on() 返回）
+const heloraDisposers: Array<() => void> = []
+let heloraReady = false
+
+function syncHeloraTheme(dark: boolean) {
+  if (!heloraReady) return
+  console.log(7777777, dark)
+  window.Helora?.setTheme?.(dark ? 'dark' : 'light')
+}
+
+function syncHeloraLocale(locale: string) {
+  if (!heloraReady) return
+  // Helora 暂未暴露 setLocale，重新 boot 即可让其拉新语种文案
+  window.Helora?.boot?.({
+    proxy: !endsWith(location.hostname, '.xyz') && !import.meta.env.DEV ? 'prod' : 'staging',
+    guest: true,
+    configPlatform: 'web',
+    configKey: 'helora-agent-openapi',
+    source: 'web_openapi',
+    locale,
+    theme: isDark.value ? 'dark' : 'light',
+    headerActions: [
+      {
+        id: 'issue',
+        label: t('helora.submitIssue'),
+        icon: 'alert-circle',
+        intent: 'event',
+      },
+    ],
+  })
+}
+
 onMounted(() => {
   initLoginState()
   document.addEventListener('click', onAvatarClickOutside)
 
-  if (!isCnDomain) {
-    const swSrc = 'https://assets.lbkrs.com/h5hub/support-widget/support-widget-1.0.7.iife.js'
-    const isProd = !endsWith(location.hostname, '.xyz') && !import.meta.env.DEV
-    window.SupportWidgetConfig = {
-      isLoggedIn: function () {
-        return isLogin.value
-      },
-      loginUrl: createLoginRedirectPath({ sw_open: '1' }),
+  // Helora 客服（接替旧的 support-widget）
+  // dev/staging 用 .dev 包 + proxy=staging；线上用 release 包 + proxy=prod
+  const isProd = !endsWith(location.hostname, '.xyz') && !import.meta.env.DEV
+  const heloraSrc = 'https://assets.lbkrs.com/h5hub/helora-embed/helora-embed-1.0.0.dev.iife.js'
+
+  const bootHelora = () => {
+    const Helora = window.Helora
+    if (!Helora) return
+    Helora.boot({
       proxy: isProd ? 'prod' : 'staging',
-    }
-    if (!document.querySelector(`script[src="${swSrc}"]`)) {
-      const script = document.createElement('script')
-      script.src = swSrc
-      script.async = true
-      document.head.appendChild(script)
-    }
+      guest: true,
+      configPlatform: 'web',
+      configKey: 'helora-agent-openapi',
+      source: 'web_openapi',
+      locale: currentLocale.value,
+      theme: isDark.value ? 'dark' : 'light',
+      headerActions: [
+        {
+          id: 'issue',
+          label: t('helora.submitIssue'),
+          icon: 'alert-circle',
+          intent: 'event',
+        },
+      ],
+    })
+    heloraReady = true
+
+    // 订阅 header action（提交问题按钮）—— headerActions 里 intent: 'event' 会通过事件回调通知宿主
+    const offAction = Helora.on?.('headerAction', (payload: { id?: string }) => {
+      if (payload?.id === 'issue') {
+        window.open('https://github.com/longbridge/openapi/issues/new', '_blank', 'noopener,noreferrer')
+      }
+    })
+    if (typeof offAction === 'function') heloraDisposers.push(offAction)
+  }
+
+  if (!document.querySelector(`script[src="${heloraSrc}"]`)) {
+    const script = document.createElement('script')
+    script.src = heloraSrc
+    script.async = true
+    script.onload = bootHelora
+    document.head.appendChild(script)
+  } else if (window.Helora) {
+    bootHelora()
   }
+
+  // 主题切换 → 通知 Helora
+  watch(isDark, (dark) => syncHeloraTheme(dark))
+
+  // 语言切换 → 通知 Helora
+  // 当前 switchLocale 走 location.href（整页刷新），下次 mount 直接以新 locale boot；
+  // 但 SPA 内若有路由级切换（不刷新），仍能命中这里
+  watch(currentLocale, (locale, prev) => {
+    if (locale && locale !== prev) syncHeloraLocale(locale)
+  })
 })
 onUnmounted(() => {
   document.removeEventListener('click', onAvatarClickOutside)
   if (avatarCloseTimer.value) clearTimeout(avatarCloseTimer.value)
+  heloraDisposers.splice(0).forEach((dispose) => {
+    try {
+      dispose()
+    } catch {
+      // ignore
+    }
+  })
+  heloraReady = false
 })
 </script>
 

docs/.vitepress/theme/components/NewHomePage/ProductMCP.vue

@@ -50,38 +50,38 @@ const clients = [
     name: 'Claude Code',
     logo: 'https://assets.lbctrl.com/uploads/6932dfac-0f9c-4577-bdd8-fc3d22d4223a/claude.svg',
     type: 'shell' as const,
-    cmd: 'claude mcp add --transport http longbridge https://openapi.longbridge.com/mcp',
+    cmd: 'claude mcp add --transport http longbridge https://mcp.longbridge.com',
   },
   {
     id: 'codex',
     name: 'Codex',
     logo: 'https://assets.lbctrl.com/uploads/88eb58fe-b3bb-4875-90c7-c97e6d8fcc9e/openai.svg',
     type: 'ui' as const,
     steps: ['Settings', 'MCP Servers', 'Add Server'],
-    fields: { Name: 'longbridge', Type: 'Streamable HTTP', URL: 'https://openapi.longbridge.com/mcp' },
+    fields: { Name: 'longbridge', Type: 'Streamable HTTP', URL: 'https://mcp.longbridge.com' },
   },
   {
     id: 'cursor',
     name: 'Cursor',
     logo: 'https://assets.lbctrl.com/uploads/f694478e-201b-4e74-a7b6-023639a27805/cursor.svg',
     type: 'ui' as const,
     steps: ['Settings', 'MCP Servers', 'Add Remote MCP Server'],
-    fields: { URL: 'https://openapi.longbridge.com/mcp' },
+    fields: { URL: 'https://mcp.longbridge.com' },
   },
   {
     id: 'zed',
     name: 'Zed',
     logo: 'https://assets.lbctrl.com/uploads/3418077a-9766-4514-bc8e-eef076309689/zed.svg',
     type: 'json' as const,
-    json: { mcpServers: { longbridge: { url: 'https://openapi.longbridge.com/mcp' } } },
+    json: { mcpServers: { longbridge: { url: 'https://mcp.longbridge.com' } } },
   },
   {
     id: 'cherry',
     name: 'Cherry Studio',
     logo: 'https://assets.lbctrl.com/uploads/df8f9467-91a5-4bdb-8dde-5127441f0b04/cherrystudio.svg',
     type: 'ui' as const,
     steps: ['Settings', 'MCP Servers', 'Add'],
-    fields: { URL: 'https://openapi.longbridge.com/mcp' },
+    fields: { URL: 'https://mcp.longbridge.com' },
   },
 ]