feat(bot): add beta label to bot feature

john-zhh · claude · john-zhh · commit ee36515d5d5e · 2026-02-25T12:18:18.000+08:00
Mark the bot gateway as beta across the codebase: config struct
comments, route comments, web UI badge, and amber beta notice card.
Add betaNotice i18n translations for all 6 locales.

Co-Authored-By: Claude (claude-opus-4-6) &lt;noreply@anthropic.com&gt;
diff --git a/internal/config/compat.go b/internal/config/compat.go
@@ -274,7 +274,7 @@ func SetAgent(ac *AgentConfig) error {
 	return DefaultStore().SetAgent(ac)
 }
 
-// --- Bot convenience functions ---
+// --- Bot convenience functions (BETA) ---
 
 // GetBot returns the bot configuration.
 func GetBot() *BotConfig {
diff --git a/internal/config/config.go b/internal/config/config.go
@@ -561,11 +561,12 @@ type RuntimeConfig struct {
 	MaxTokens       int    `json:"max_tokens,omitempty"`       // max total tokens (default: 500000)
 }
 
-// --- Bot Configuration ---
+// --- Bot Configuration (BETA) ---
 
 // BotConfig holds bot gateway settings.
+// [BETA] This feature is experimental and disabled by default.
 type BotConfig struct {
-	Enabled     bool                    `json:"enabled"`
+	Enabled     bool                    `json:"enabled"`          // default: false (BETA)
 	Profile     string                  `json:"profile,omitempty"`     // profile for NLU (recommend small model)
 	Model       string                  `json:"model,omitempty"`       // LLM model ID (default: "claude-3-haiku-20240307")
 	SocketPath  string                  `json:"socket_path,omitempty"` // IPC socket path
@@ -704,7 +705,7 @@ type OpenCCConfig struct {
 	Compression     *CompressionConfig          `json:"compression,omitempty"`       // [BETA] context compression
 	Middleware      *MiddlewareConfig           `json:"middleware,omitempty"`        // [BETA] middleware pipeline
 	Agent           *AgentConfig                `json:"agent,omitempty"`             // [BETA] agent infrastructure
-	Bot             *BotConfig                  `json:"bot,omitempty"`               // bot gateway configuration
+	Bot             *BotConfig                  `json:"bot,omitempty"`               // [BETA] bot gateway configuration
 }
 
 // UnmarshalJSON supports multiple config versions:
diff --git a/internal/config/store.go b/internal/config/store.go
@@ -982,6 +982,8 @@ func (s *Store) SetAgent(ac *AgentConfig) error {
 	return s.saveLocked()
 }
 
+// --- Bot (BETA) ---
+
 // GetBot returns the bot configuration.
 func (s *Store) GetBot() *BotConfig {
 	s.mu.Lock()
diff --git a/internal/web/server.go b/internal/web/server.go
@@ -117,7 +117,7 @@ func NewServer(version string, logger *log.Logger, portOverride int) *Server {
 	s.mux.HandleFunc("/api/v1/middleware/reload", s.handleMiddlewareReload)
 	s.mux.HandleFunc("/api/v1/middleware/upload", s.handleMiddlewareUpload)
 
-	// Bot routes
+	// Bot routes (BETA)
 	s.mux.HandleFunc("/api/v1/bot", s.handleBot)
 	s.mux.HandleFunc("/api/v1/bot/chat", s.handleBotChat)
 
diff --git a/web/src/i18n/locales/en.json b/web/src/i18n/locales/en.json
@@ -310,7 +310,9 @@
     "quietHoursStart": "Quiet Hours Start",
     "quietHoursEnd": "Quiet Hours End",
     "quietHoursZone": "Timezone",
-    "recentPaths": "Recent Paths"
+    "recentPaths": "Recent Paths",
+    "betaNotice": "Beta Feature:",
+    "betaNoticeDesc": "The bot gateway is currently in beta. Configuration options may change in future releases."
   },
   "middleware": {
     "title": "Middleware",
diff --git a/web/src/i18n/locales/es.json b/web/src/i18n/locales/es.json
@@ -231,7 +231,9 @@
     "quietHoursStart": "Inicio de Horas Silenciosas",
     "quietHoursEnd": "Fin de Horas Silenciosas",
     "quietHoursZone": "Zona Horaria",
-    "recentPaths": "Rutas Recientes"
+    "recentPaths": "Rutas Recientes",
+    "betaNotice": "Función Beta:",
+    "betaNoticeDesc": "La pasarela de bot está actualmente en beta. Las opciones de configuración pueden cambiar en futuras versiones."
   },
   "middleware": {
     "title": "Middleware",
diff --git a/web/src/i18n/locales/ja.json b/web/src/i18n/locales/ja.json
@@ -273,6 +273,8 @@
     "quietHoursStart": "静音時間開始",
     "quietHoursEnd": "静音時間終了",
     "quietHoursZone": "タイムゾーン",
-    "recentPaths": "最近使用したパス"
+    "recentPaths": "最近使用したパス",
+    "betaNotice": "ベータ機能：",
+    "betaNoticeDesc": "ボットゲートウェイは現在ベータ版です。設定オプションは今後のリリースで変更される可能性があります。"
   }
 }
diff --git a/web/src/i18n/locales/ko.json b/web/src/i18n/locales/ko.json
@@ -273,6 +273,8 @@
     "quietHoursStart": "조용한 시간 시작",
     "quietHoursEnd": "조용한 시간 종료",
     "quietHoursZone": "시간대",
-    "recentPaths": "최근 사용한 경로"
+    "recentPaths": "최근 사용한 경로",
+    "betaNotice": "베타 기능:",
+    "betaNoticeDesc": "봇 게이트웨이는 현재 베타 단계입니다. 향후 릴리스에서 구성 옵션이 변경될 수 있습니다."
   }
 }
diff --git a/web/src/i18n/locales/zh-CN.json b/web/src/i18n/locales/zh-CN.json
@@ -295,7 +295,9 @@
     "quietHoursStart": "静默时段开始",
     "quietHoursEnd": "静默时段结束",
     "quietHoursZone": "时区",
-    "recentPaths": "最近使用的路径"
+    "recentPaths": "最近使用的路径",
+    "betaNotice": "Beta 功能：",
+    "betaNoticeDesc": "机器人网关目前处于 Beta 阶段，配置选项可能会在未来版本中更改。"
   },
   "middleware": {
     "title": "中间件",
diff --git a/web/src/i18n/locales/zh-TW.json b/web/src/i18n/locales/zh-TW.json
@@ -295,7 +295,9 @@
     "quietHoursStart": "靜默時段開始",
     "quietHoursEnd": "靜默時段結束",
     "quietHoursZone": "時區",
-    "recentPaths": "最近使用的路徑"
+    "recentPaths": "最近使用的路徑",
+    "betaNotice": "Beta 功能：",
+    "betaNoticeDesc": "機器人閘道目前處於 Beta 階段，設定選項可能會在未來版本中變更。"
   },
   "middleware": {
     "title": "中介軟體",
diff --git a/web/src/pages/bot/index.tsx b/web/src/pages/bot/index.tsx
@@ -2,9 +2,11 @@ import { useState, useEffect } from 'react'
 import { useSearchParams } from 'react-router-dom'
 import { useTranslation } from 'react-i18next'
 import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
+import { Card, CardContent } from '@/components/ui/card'
+import { Badge } from '@/components/ui/badge'
 import { useBot } from '@/hooks/use-bot'
 import type { BotConfig } from '@/types/api'
-import { GeneralTab, PlatformsTab, InteractionTab, AliasesTab, NotifyTab } from './tabs'
+import { GeneralTab, PlatformsTab, InteractionTab, AliasesTab, NotifyTab, ChatTab } from './tabs'
 
 export function BotPage() {
   const { t } = useTranslation()
@@ -34,13 +36,17 @@ export function BotPage() {
   return (
     <div className="space-y-6">
       <div>
-        <h1 className="text-3xl font-bold">{t('bot.title')}</h1>
+        <div className="flex items-center gap-2">
+          <h1 className="text-3xl font-bold">{t('bot.title')}</h1>
+          <Badge variant="warning">Beta</Badge>
+        </div>
         <p className="text-muted-foreground">{t('bot.description')}</p>
       </div>
 
       <Tabs value={currentTab} onValueChange={setCurrentTab}>
         <TabsList>
           <TabsTrigger value="general">{t('bot.general')}</TabsTrigger>
+          <TabsTrigger value="chat">{t('bot.chat', 'Chat')}</TabsTrigger>
           <TabsTrigger value="platforms">{t('bot.platforms')}</TabsTrigger>
           <TabsTrigger value="interaction">{t('bot.interaction')}</TabsTrigger>
           <TabsTrigger value="aliases">{t('bot.aliases')}</TabsTrigger>
@@ -51,6 +57,10 @@ export function BotPage() {
           <GeneralTab config={localConfig} setConfig={setLocalConfig} />
         </TabsContent>
 
+        <TabsContent value="chat" className="mt-4">
+          <ChatTab />
+        </TabsContent>
+
         <TabsContent value="platforms" className="mt-4">
           <PlatformsTab config={localConfig} setConfig={setLocalConfig} />
         </TabsContent>
@@ -67,6 +77,15 @@ export function BotPage() {
           <NotifyTab config={localConfig} setConfig={setLocalConfig} />
         </TabsContent>
       </Tabs>
+
+      {/* Beta Notice */}
+      <Card className="border-amber-500/50 bg-amber-500/5">
+        <CardContent className="pt-6">
+          <p className="text-sm text-amber-600 dark:text-amber-400">
+            <strong>{t('bot.betaNotice')}</strong> {t('bot.betaNoticeDesc')}
+          </p>
+        </CardContent>
+      </Card>
     </div>
   )
 }

Original file line number	Diff line number	Diff line change
`@@ -274,7 +274,7 @@ func SetAgent(ac *AgentConfig) error {`
`274`	`274`	`return DefaultStore().SetAgent(ac)`
`275`	`275`	`}`
`276`	`276`
`277`		`-// --- Bot convenience functions ---`
	`277`	`+// --- Bot convenience functions (BETA) ---`
`278`	`278`
`279`	`279`	`// GetBot returns the bot configuration.`
`280`	`280`	`func GetBot() *BotConfig {`
Original file line number	Diff line number	Diff line change
`@@ -982,6 +982,8 @@ func (s Store) SetAgent(ac AgentConfig) error {`
`982`	`982`	`return s.saveLocked()`
`983`	`983`	`}`
`984`	`984`
	`985`	`+// --- Bot (BETA) ---`
	`986`	`+`
`985`	`987`	`// GetBot returns the bot configuration.`
`986`	`988`	`func (s Store) GetBot() BotConfig {`
`987`	`989`	`s.mu.Lock()`
Original file line number	Diff line number	Diff line change
`@@ -273,6 +273,8 @@`
`273`	`273`	`"quietHoursStart": "静音時間開始",`
`274`	`274`	`"quietHoursEnd": "静音時間終了",`
`275`	`275`	`"quietHoursZone": "タイムゾーン",`
`276`		`- "recentPaths": "最近使用したパス"`
	`276`	`+ "recentPaths": "最近使用したパス",`
	`277`	`+ "betaNotice": "ベータ機能：",`
	`278`	`+ "betaNoticeDesc": "ボットゲートウェイは現在ベータ版です。設定オプションは今後のリリースで変更される可能性があります。"`
`277`	`279`	`}`
`278`	`280`	`}`