@openviking/react 0.1.4 → 0.1.5

package/README.md

@@ -2,7 +2,7 @@
 
 English / [中文](README_CN.md)
 
-All public UI components and composed modules require an explicit `locale: 'zh-CN' | 'en-US'` for built-in Chinese or English copy. Existing `labels` override individual fields; omitted fields follow the current locale and update when it changes. Hosts still provide business content, slots and callback messages.
+Public UI components, composed modules and standalone Hooks accept optional `locale: 'zh-CN' | 'en-US'`. Props override the nearest module or Provider; without a configured language, they use `en-US`. Existing `labels` override individual fields; omitted fields follow the current locale and update when it changes. Hosts still provide business content, slots and callback messages.
 
 React foundations for OpenViking AI application interfaces: build tooling, documentation, layered directories, and scoped styles. FileTree, Tui and FilePreview provide working views, alongside five file-type icons. FileBrowser supports early layout integration; Console provides a native command panel; ScopeCascade provides a working cascade Hook and composition.
 
@@ -94,3 +94,5 @@ Pass three stable API adapter functions to `useScopeCascade({ loadLibraries, loa
 Built-in translations live alongside each component or module in `locales/en-US.ts` and `locales/zh-CN.ts`. The internal `src/shared/locale.ts` contains only shared language types and resolution/override rules, with no business messages or public entry. Modules own workflow copy and reuse the defaults owned by their child components.
 
 Dynamic messages use typed formatter functions; dates and numbers use `Intl`. `npm test` checks matching keys, string placeholders and formatter arity across languages, while type checking validates parameter types. Undefined `labels` entries inherit the selected language; empty strings remain explicit overrides.
+
+Set `locale` on `OpenVikingProvider` for a subtree. Optional module and component Props override the nearest scope, then fall back to `en-US`. Standalone Hooks also inherit the Provider. The private `src/shared/locale-context.tsx` is shared across public entries and remains separate from request-client configuration, so language changes preserve requests and state.

package/dist/28~0.js

@@ -0,0 +1,15 @@
+import { jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+const LocaleContext = /*#__PURE__*/ createContext('en-US');
+function useLocale(locale) {
+    const inherited = useContext(LocaleContext);
+    return locale ?? inherited;
+}
+function LocaleProvider({ locale, children }) {
+    const value = useLocale(locale);
+    return /*#__PURE__*/ jsx(LocaleContext.Provider, {
+        value: value,
+        children: children
+    });
+}
+export { LocaleProvider, useLocale };

package/dist/2~0.js

@@ -7,6 +7,7 @@ import { __webpack_require__ } from "./rslib-runtime~0.js";
 import { resolveLocale } from "./nx~0.js";
 import { removereact } from "./4~0.js";
 import { usePortalTheme } from "./9~0.js";
+import { useLocale } from "./28~0.js";
 import { AgentConnect } from "./u~0.js";
 import * as __rspack_external_react from "react";
 __webpack_require__.add({
@@ -2274,7 +2275,8 @@ function ImportResourcesIcon() {
         })
     });
 }
-function FileBrowserEntries({ locale = 'en-US', agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }) {
+function FileBrowserEntries({ locale: localeProp, agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }) {
+    const locale = useLocale(localeProp);
     const triggerRef = useRef(null);
     const drawerId = useId();
     const [drawerOpen, setDrawerOpen] = useState(false);
@@ -2344,10 +2346,11 @@ function FileBrowserEntries({ locale = 'en-US', agentConnect, onConnectAgent, on
                 closeLabel: text.close,
                 triggerRef: triggerRef,
                 className: "ov-file-browser-entries__drawer",
-                lang: agentConnect.locale,
+                lang: agentConnect.locale ?? locale,
                 onClose: ()=>setDrawerOpen(false),
                 children: /*#__PURE__*/ jsx(AgentConnect, {
-                    ...agentConnect
+                    ...agentConnect,
+                    locale: agentConnect.locale ?? locale
                 })
             }) : null,
             showImport ? /*#__PURE__*/ jsx("span", {

package/dist/3c~0.js

@@ -6,6 +6,7 @@ import { ArrowRightIcon } from "./k~0.js";
 import { resolveLocale } from "./nx~0.js";
 import { checkreact } from "./0~0.js";
 import { Tooltip } from "./r~0.js";
+import { useLocale } from "./28~0.js";
 function getTuiCommandInputText(command) {
     return command.inputText?.trim() || command.name;
 }
@@ -2073,7 +2074,8 @@ function useTuiCompletion(value, enabled, commands, groups = [], paletteScope =
         showSuggestions: enabled && (query.automatic || null !== query.scope && paletteScope === query.scope)
     };
 }
-function Tui({ records, value, disabled = false, emptyState, quickCommands, locale = 'en-US', commands = [], commandGroups = [], onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }) {
+function Tui({ records, value, disabled = false, emptyState, quickCommands, locale: localeProp, commands = [], commandGroups = [], onValueChange, onSubmit, onOpenUri, onCopy, labels, className, ...rest }) {
+    const locale = useLocale(localeProp);
     const text = resolveTuiLabels(labels, locale);
     const bodyRef = useRef(null);
     const followOutput = useRef(true);

package/dist/3~0.js

@@ -2,6 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Fragment as external_react_Fragment, Suspense, forwardRef, lazy, useCallback, useId, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Tooltip } from "./r~0.js";
 import { resolveLocale, mergeLabels } from "./nx~0.js";
+import { useLocale } from "./28~0.js";
 function FilePreviewImageFrame({ children }) {
     const [dimensions, setDimensions] = useState('');
     return /*#__PURE__*/ jsxs("div", {
@@ -1214,7 +1215,8 @@ function useFilePreviewEditing(activeTabKey) {
 function isFileTab(tab) {
     return 'file' === tab.kind;
 }
-const file_preview_FilePreview = /*#__PURE__*/ forwardRef(function({ tabs, activeKey, defaultActiveKey, locale, labels, onActiveKeyChange, className, ...rest }, ref) {
+const file_preview_FilePreview = /*#__PURE__*/ forwardRef(function({ tabs, activeKey, defaultActiveKey, locale: localeProp, labels, onActiveKeyChange, className, ...rest }, ref) {
+    const locale = useLocale(localeProp);
     const text = resolveFilePreviewLabels(locale, labels);
     const [internalKey, setInternalKey] = useState(()=>defaultActiveKey ?? tabs[0].key);
     const currentKey = activeKey ?? internalKey;

package/dist/ae~0.js

@@ -1,5 +1,6 @@
 import { jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo } from "react";
+import { LocaleProvider } from "./28~0.js";
 class OvClientError extends Error {
     code;
     statusCode;
@@ -439,7 +440,7 @@ function createOvClient(options = {}) {
     return client;
 }
 const OvClientContext = /*#__PURE__*/ createContext(null);
-function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, children }) {
+function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, locale, children }) {
     const parent = useContext(OvClientContext);
     const value = useMemo(()=>{
         const base = mergeProviderConfig(parent?.base, {
@@ -475,7 +476,10 @@ function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, cr
     ]);
     return /*#__PURE__*/ jsx(OvClientContext.Provider, {
         value: value,
-        children: children
+        children: /*#__PURE__*/ jsx(LocaleProvider, {
+            locale: locale,
+            children: children
+        })
     });
 }
 function useOvClient() {

package/dist/a~0.js

@@ -3,6 +3,7 @@ import { useEffect, useId, useMemo, useRef, useState, useSyncExternalStore } fro
 import { createPortal } from "react-dom";
 import { resolveLocale, mergeLabels } from "./nx~0.js";
 import { useOvSignal, useOvClient, createOvClient, isOvClientError } from "./ae~0.js";
+import { useLocale, LocaleProvider } from "./28~0.js";
 import { new_sessionreact, historyreact } from "./lg~0.js";
 import { useOverlayPosition } from "./o~0.js";
 import { Tooltip } from "./r~0.js";
@@ -842,7 +843,8 @@ function createConsoleController(client, options = {}) {
         retry: (locale)=>state.failedCommand ? execute(state.failedCommand, locale) : Promise.resolve()
     };
 }
-function useConsole({ mode: controlledMode, defaultMode = 'conversation', locale = 'en-US', scopeKey, onModeChange, requestOptions = {} } = {}) {
+function useConsole({ mode: controlledMode, defaultMode = 'conversation', locale: localeProp, scopeKey, onModeChange, requestOptions = {} } = {}) {
+    const locale = useLocale(localeProp);
     const inherited = useOvClient();
     const inheritedSignal = useOvSignal();
     const [fallback] = useState(()=>createOvClient());
@@ -1204,7 +1206,8 @@ const DEFAULT_QUICK_COMMANDS = [
     'read',
     'status'
 ];
-function Console({ mode, defaultMode, locale = 'en-US', quickCommands = DEFAULT_QUICK_COMMANDS, scopeKey, requestOptions, onModeChange, onOpenUri, conversation, slots, labels: overrides, className, ...rest }) {
+function Console({ mode, defaultMode, locale: localeProp, quickCommands = DEFAULT_QUICK_COMMANDS, scopeKey, requestOptions, onModeChange, onOpenUri, conversation, slots, labels: overrides, className, ...rest }) {
+    const locale = useLocale(localeProp);
     const state = useConsole({
         mode,
         defaultMode,
@@ -1215,8 +1218,9 @@ function Console({ mode, defaultMode, locale = 'en-US', quickCommands = DEFAULT_
     });
     const labels = consoleLabels(locale, overrides);
     const { sessions, headerActions, ...conversationProps } = conversation ?? {};
+    const botLocale = conversationProps.locale ?? locale;
     const botLabels = {
-        ...labels.vikingBot,
+        ...consoleLabels(botLocale, overrides).vikingBot,
         ...conversationProps.labels
     };
     const id = useId();
@@ -1227,74 +1231,77 @@ function Console({ mode, defaultMode, locale = 'en-US', quickCommands = DEFAULT_
             preventScroll: true
         });
     };
-    return /*#__PURE__*/ jsxs("div", {
-        ...rest,
-        className: [
-            'ov-console',
-            className
-        ].filter(Boolean).join(' '),
-        children: [
-            /*#__PURE__*/ jsx(ConsoleToolbar, {
-                mode: state.mode,
-                panelId: id,
-                locale: locale,
-                labels: labels,
-                records: state.records,
-                isExecuting: state.isExecuting,
-                onModeChange: (next)=>state.setMode(next),
-                onClear: ()=>{
-                    state.clear();
-                    fillCommand('');
-                },
-                onRecall: fillCommand,
-                conversationActions: /*#__PURE__*/ jsx(VikingBotSessionActions, {
-                    sessions: sessions,
-                    extra: headerActions,
-                    labels: botLabels,
-                    locale: locale
+    return /*#__PURE__*/ jsx(LocaleProvider, {
+        locale: locale,
+        children: /*#__PURE__*/ jsxs("div", {
+            ...rest,
+            className: [
+                'ov-console',
+                className
+            ].filter(Boolean).join(' '),
+            children: [
+                /*#__PURE__*/ jsx(ConsoleToolbar, {
+                    mode: state.mode,
+                    panelId: id,
+                    locale: locale,
+                    labels: labels,
+                    records: state.records,
+                    isExecuting: state.isExecuting,
+                    onModeChange: (next)=>state.setMode(next),
+                    onClear: ()=>{
+                        state.clear();
+                        fillCommand('');
+                    },
+                    onRecall: fillCommand,
+                    conversationActions: /*#__PURE__*/ jsx(VikingBotSessionActions, {
+                        sessions: sessions,
+                        extra: headerActions,
+                        labels: botLabels,
+                        locale: botLocale
+                    }),
+                    children: slots?.toolbar
                 }),
-                children: slots?.toolbar
-            }),
-            /*#__PURE__*/ jsx("div", {
-                id: `${id}-conversation`,
-                className: "ov-console__panel",
-                hidden: 'conversation' !== state.mode,
-                children: 'conversation' === state.mode ? /*#__PURE__*/ jsx(VikingBot, {
-                    ...conversationProps,
-                    onOpenUri: conversationProps.onOpenUri ?? onOpenUri,
-                    messages: conversationProps.messages ?? [],
-                    draft: conversationProps.draft ?? state.conversationDraft,
-                    onDraftChange: void 0 === conversationProps.draft ? (value)=>{
-                        state.setConversationDraft(value);
-                        conversationProps.onDraftChange?.(value);
-                    } : conversationProps.onDraftChange,
-                    footer: slots?.conversationContext ?? conversationProps.footer,
-                    locale: conversationProps.locale ?? locale,
-                    labels: botLabels
-                }) : null
-            }),
-            /*#__PURE__*/ jsxs("div", {
-                id: `${id}-command`,
-                ref: commandPanel,
-                className: "ov-console__panel",
-                hidden: 'command' !== state.mode,
-                children: [
-                    slots?.commandHelp,
-                    /*#__PURE__*/ jsx(Tui, {
-                        records: state.records,
-                        value: state.command,
-                        commands: state.commands,
-                        locale: locale,
-                        disabled: state.isExecuting,
-                        quickCommands: quickCommands,
-                        onValueChange: state.setCommand,
-                        onSubmit: (command)=>void state.execute(command),
-                        onOpenUri: onOpenUri,
-                        labels: labels.tui
-                    })
-                ]
-            })
-        ]
+                /*#__PURE__*/ jsx("div", {
+                    id: `${id}-conversation`,
+                    className: "ov-console__panel",
+                    hidden: 'conversation' !== state.mode,
+                    children: 'conversation' === state.mode ? /*#__PURE__*/ jsx(VikingBot, {
+                        ...conversationProps,
+                        onOpenUri: conversationProps.onOpenUri ?? onOpenUri,
+                        messages: conversationProps.messages ?? [],
+                        draft: conversationProps.draft ?? state.conversationDraft,
+                        onDraftChange: void 0 === conversationProps.draft ? (value)=>{
+                            state.setConversationDraft(value);
+                            conversationProps.onDraftChange?.(value);
+                        } : conversationProps.onDraftChange,
+                        footer: slots?.conversationContext ?? conversationProps.footer,
+                        locale: botLocale,
+                        labels: botLabels
+                    }) : null
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    id: `${id}-command`,
+                    ref: commandPanel,
+                    className: "ov-console__panel",
+                    hidden: 'command' !== state.mode,
+                    children: [
+                        slots?.commandHelp,
+                        /*#__PURE__*/ jsx(Tui, {
+                            records: state.records,
+                            value: state.command,
+                            commands: state.commands,
+                            locale: locale,
+                            disabled: state.isExecuting,
+                            quickCommands: quickCommands,
+                            onValueChange: state.setCommand,
+                            onSubmit: (command)=>void state.execute(command),
+                            onOpenUri: onOpenUri,
+                            labels: labels.tui
+                        })
+                    ]
+                })
+            ]
+        })
     });
 }
 export { Console, useConsole };

package/dist/client/provider.d.ts

@@ -1,17 +1,21 @@
 import type { ReactNode } from 'react';
+import type { Locale } from '../shared/locale.js';
 import type { OvClient, OvClientOptions } from './types.js';
 /**
- * {@link OpenVikingProvider} 的属性。字段与 {@link OvClientOptions} 同形：
+ * {@link OpenVikingProvider} 的属性。请求字段与 {@link OvClientOptions} 同形，另可设置界面语言：
  * 服务地址、身份与作用域、Cookie 策略，都按字段传值。
- * Props of {@link OpenVikingProvider}, the same shape as {@link OvClientOptions}:
- * the service address, identity and scope, and the cookie policy are all passed
+ * Props of {@link OpenVikingProvider}: request fields follow {@link OvClientOptions},
+ * with an optional interface locale.
+ * The service address, identity and scope, and the cookie policy are all passed
  * as fields.
  */
 export interface OpenVikingProviderProps extends OvClientOptions {
+    /** 界面语言；省略时继承上层，无配置时默认英文。Subtree locale; inherits or defaults to en-US. */
+    locale?: Locale;
     children?: ReactNode;
 }
 /**
- * 向子树下发请求配置。模块通过内部的 `useOvClient` 取用，宿主只需在应用根部
+ * 向子树下发请求配置与默认语言。模块通过内部的 `useOvClient` 取用，宿主只需在应用根部
  * 配置一次服务地址与身份字段，不必自己组装请求头。
  *
  * 开源版传 `apiKey`、`accountId`、`userId`；商业版由浏览器 Cookie 鉴权，只传
@@ -23,7 +27,7 @@ export interface OpenVikingProviderProps extends OvClientOptions {
  * 不传 `baseURL` 时按浏览器同源请求。挂载本身不发请求，也不读取浏览器里保存
  * 的凭证。
  *
- * Provides request configuration to a subtree. Modules read it through the
+ * Provides request configuration and a default language to a subtree. Modules read it through the
  * internal `useOvClient`, so a host configures the service address and identity
  * fields once at the application root and never assembles headers itself.
  *
@@ -40,7 +44,7 @@ export interface OpenVikingProviderProps extends OvClientOptions {
  * Without `baseURL` it targets the browser's own origin. Mounting it sends no
  * request and reads no credential stored in the browser.
  */
-export declare function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, children, }: OpenVikingProviderProps): import("react").JSX.Element;
+export declare function OpenVikingProvider({ baseURL, apiKey, accountId, userId, resourceId, credentials, signal, fetch, locale, children, }: OpenVikingProviderProps): import("react").JSX.Element;
 /**
  * 读取最近的 Provider 提供的客户端。仅供模块内部使用，不从包入口导出：
  * 调用方不需要知道该发什么请求，也就不会直接用它。

package/dist/components/agent-connect/agent-connect-code-block.d.ts

@@ -0,0 +1,14 @@
+import type { AgentConnectLocale } from './types.js';
+export interface CodeBlockControls {
+    locale: AgentConnectLocale;
+    visibleBlockId: string | null;
+    onReveal: (id: string | null) => void;
+    onCopy?: (text: string) => void;
+}
+interface CodeBlockProps extends CodeBlockControls {
+    display: string;
+    copyText: string;
+    language?: string;
+}
+export declare function AgentConnectCodeBlock({ display, copyText, language, locale, visibleBlockId, onReveal, onCopy, }: CodeBlockProps): import("react").JSX.Element;
+export {};

package/dist/components/agent-connect/agent-connect-copy.d.ts

@@ -7,6 +7,9 @@ export declare function resolveAgentConnectLabels(locale: AgentConnectLocale): {
     instructions: string;
     copy: string;
     copyMarkdown: string;
+    copyCode: string;
+    showApiKey: string;
+    hideApiKey: string;
     copied: string;
     failed: string;
     notice: string;

package/dist/components/agent-connect/agent-connect-design.d.ts

@@ -1,5 +1,5 @@
 import type { AgentConnectLocale } from './types.js';
-export declare function getAgentConnectDesign(locale: AgentConnectLocale): {
+export declare function getAgentConnectDesign(locale: AgentConnectLocale, showOverseasTag?: boolean): {
     tabs: readonly [{
         readonly id: 'mainstream';
         readonly label: string;

package/dist/components/agent-connect/agent-connect-installer.d.ts

@@ -1,3 +1,4 @@
 import type { AgentConnectLocale } from './types.js';
 export declare const INSTALLER_HARNESSES: Partial<Record<string, string>>;
+export declare function getInstallerCommand(harness: string, locale: AgentConnectLocale, apiKey: string, baseUrl: string): string;
 export declare function getInstallerInstructions(name: string, harness: string, locale: AgentConnectLocale, apiKey: string, baseUrl: string): string;

package/dist/components/agent-connect/agent-connect-instructions-view.d.ts

@@ -1,14 +1,12 @@
 import type { AgentConnectLocale } from './types.js';
+import type { getAgentConnectInstructions } from './agent-connect-instructions.js';
 interface InstructionsViewProps {
-    instructions: {
-        fixed: boolean;
-        display: string;
-        copy: string;
-    };
+    instructions: ReturnType<typeof getAgentConnectInstructions>;
+    apiKey: string;
     locale: AgentConnectLocale;
     agreementUrl?: string;
     onCopy?: (text: string) => void;
 }
 /** 由父视图的 key 隔离指南及凭据的复制生命周期。 */
-export declare function AgentConnectInstructionsView({ instructions, locale, agreementUrl, onCopy, }: InstructionsViewProps): import("react").JSX.Element;
+export declare function AgentConnectInstructionsView({ instructions, apiKey, locale, agreementUrl, onCopy, }: InstructionsViewProps): import("react").JSX.Element;
 export {};

package/dist/components/agent-connect/agent-connect-instructions.d.ts

@@ -277,4 +277,17 @@ export declare function getAgentConnectInstructions(id: keyof typeof contentZh,
     fixed: boolean;
     display: string;
     copy: string;
+    command: {
+        display: string;
+        copy: string;
+    };
+    markdown?: undefined;
+    keyToken?: undefined;
+} | {
+    command?: undefined;
+    fixed: boolean;
+    display: string;
+    copy: string;
+    markdown: string;
+    keyToken: string;
 };

package/dist/components/agent-connect/agent-connect-markdown.d.ts

@@ -1,3 +1,9 @@
-export declare function AgentConnectMarkdown({ text }: {
+import { type CodeBlockControls } from './agent-connect-code-block.js';
+/** 先解析原始 HTML，再清理不允许的标签、属性与协议。 */
+interface MarkdownProps extends CodeBlockControls {
     text: string;
-}): import("react").JSX.Element;
+    keyToken: string;
+    apiKey: string;
+}
+export declare function AgentConnectMarkdown({ text, ...context }: MarkdownProps): import("react").JSX.Element;
+export {};

package/dist/components/agent-connect/agent-connect-mask.d.ts

@@ -0,0 +1,10 @@
+interface MarkdownNode {
+    type: string;
+    value?: string;
+    children?: MarkdownNode[];
+}
+/** 正文及行内代码只显示脱敏值；代码块由专用视图处理占位符。 */
+export declare function remarkMaskApiKey({ keyToken }: {
+    keyToken: string;
+}): (tree: MarkdownNode) => void;
+export {};

package/dist/components/agent-connect/agent-connect.d.ts

@@ -1,4 +1,4 @@
 import type { AgentConnectProps } from './types.js';
 export type { AgentConnectItem, AgentConnectProps, AgentConnectLocale, AgentConnectTabId, } from './types.js';
 /** 按设计稿固定文案与图标；选择与复制保持实例内交互。 */
-export declare function AgentConnect({ apiKey, locale, baseUrl, agreementUrl, activeTabId: controlledTabId, selectedId: controlledSelectedId, onTabChange, onSelect, onCopy, className, ...rest }: AgentConnectProps): import("react").JSX.Element;
+export declare function AgentConnect({ apiKey, locale: localeProp, baseUrl, agreementUrl, showOverseasTag, activeTabId: controlledTabId, selectedId: controlledSelectedId, onTabChange, onSelect, onCopy, className, ...rest }: AgentConnectProps): import("react").JSX.Element;

package/dist/components/agent-connect/locales/en-US.d.ts

@@ -6,6 +6,9 @@ declare const messages: {
     instructions: string;
     copy: string;
     copyMarkdown: string;
+    copyCode: string;
+    showApiKey: string;
+    hideApiKey: string;
     copied: string;
     failed: string;
     notice: string;

package/dist/components/agent-connect/style.css

@@ -91,6 +91,93 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-agent-connect__code-block {
+  border: 1px solid var(--ov-ui-agent-connect-border);
+  background: var(--ov-ui-agent-connect-bg);
+  white-space: normal;
+  border-radius: 8px;
+  margin-bottom: 12px;
+  overflow: hidden;
+}
+
+.ov-agent-connect__code-block:last-child {
+  margin-bottom: 0;
+}
+
+.ov-agent-connect__code-header {
+  border-bottom: 1px solid var(--ov-ui-agent-connect-border);
+  color: var(--ov-ui-agent-connect-muted);
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 12px;
+  font-size: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions {
+  align-items: center;
+  gap: 12px;
+  display: flex;
+}
+
+.ov-agent-connect__code-actions button {
+  width: 24px;
+  height: 24px;
+  color: var(--ov-ui-agent-connect-secondary);
+  background: none;
+  border: 0;
+  border-radius: 4px;
+  justify-content: center;
+  align-items: center;
+  padding: 4px;
+  font-size: 12px;
+  display: inline-flex;
+}
+
+.ov-agent-connect__code-actions button:hover {
+  color: var(--ov-ui-agent-connect-primary);
+}
+
+.ov-agent-connect__code-actions button:disabled {
+  opacity: .6;
+  cursor: wait;
+}
+
+.ov-agent-connect__code-actions svg {
+  width: 16px;
+  height: 16px;
+}
+
+.ov-agent-connect .ov-agent-connect__code-block pre {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  background: none;
+  border-radius: 0;
+  margin: 0;
+  padding: 12px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-agent-connect__code-block code {
+  font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
+}
+
+.ov-agent-connect__code-block > .ov-agent-connect__feedback:not(:empty) {
+  padding: 0 12px 8px;
+  display: block;
+}
+
+.ov-agent-connect__code-feedback {
+  clip-path: inset(50%);
+  white-space: nowrap;
+  width: 1px;
+  height: 1px;
+  position: absolute;
+  overflow: hidden;
+}
+
 .ov-agent-connect {
   --ov-ui-agent-connect-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default));
   --ov-ui-agent-connect-secondary: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default));
@@ -421,7 +508,7 @@
   white-space: normal;
 }
 
-.ov-agent-connect__markdown :where(p, pre, h5, table) {
+.ov-agent-connect__markdown :where(p, pre, h5, table, ul, ol, blockquote, details) {
   margin: 0 0 12px;
 }
 
@@ -433,6 +520,33 @@
   white-space: pre-wrap;
 }
 
+.ov-agent-connect__markdown :where(ul, ol) {
+  padding-left: 24px;
+}
+
+.ov-agent-connect__markdown ul {
+  list-style-type: disc;
+}
+
+.ov-agent-connect__markdown ol {
+  list-style-type: decimal;
+}
+
+.ov-agent-connect__markdown blockquote {
+  border-left: 2px solid var(--ov-ui-agent-connect-border);
+  margin-left: 0;
+  padding-left: 12px;
+}
+
+.ov-agent-connect__markdown summary {
+  cursor: pointer;
+}
+
+.ov-agent-connect__markdown summary:focus-visible {
+  outline: 2px solid var(--ov-ui-agent-connect-primary);
+  outline-offset: 2px;
+}
+
 .ov-agent-connect__markdown h5 {
   color: var(--ov-ui-agent-connect-text);
   font-size: 14px;

package/dist/components/agent-connect/types.d.ts

@@ -11,12 +11,14 @@ export interface AgentConnectItem {
 export interface AgentConnectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onSelect' | 'onCopy'> {
     /** 调用方提供的密钥；展示脱敏，复制保留原值。Host API key. */
     apiKey: string;
-    /** 内置文案语言；必须由调用方指定。Required content locale. */
-    locale: AgentConnectLocale;
+    /** 内置文案语言；省略时继承上层，最终默认英文。Optional locale; inherits or defaults to en-US. */
+    locale?: AgentConnectLocale;
     /** 服务地址，默认 OpenViking 云服务。Optional service endpoint. */
     baseUrl?: string;
     /** 宿主提供的用户协议链接；未传时不显示协议引用。Host agreement URL. */
     agreementUrl?: string;
+    /** 是否展示境外标签，默认 false。Show Overseas tags; defaults to false. */
+    showOverseasTag?: boolean;
     /** 受控页签；默认 mainstream。Controlled tab; defaults to mainstream. */
     activeTabId?: AgentConnectTabId;
     /** 受控 Agent；默认 codex。Controlled agent; defaults to codex. */
@@ -25,6 +27,6 @@ export interface AgentConnectProps extends Omit<HTMLAttributes<HTMLDivElement>,
     onTabChange?: (tabId: AgentConnectTabId) => void;
     /** 返回内置目录条目的 id 和 name。Reports the built-in item id and name. */
     onSelect?: (item: AgentConnectItem) => void;
-    /** 复制成功后通知；不负责写入剪贴板。Success notification, not clipboard writing. */
+    /** 复制成功后返回代码块或完整正文。Reports copied block or full-guide text. */
     onCopy?: (text: string) => void;
 }