@yushaw/sanqian-chat 0.2.1 → 0.2.3

package/dist/main/index.d.mts

@@ -66,8 +66,19 @@ interface AppAgentConfig {
     description?: string;
     /** System prompt */
     systemPrompt?: string;
-    /** Enabled tool names (without app prefix) */
+    /**
+     * Tools to enable. Supports:
+     * - Builtin: "file_ops", "run_bash", "web_search"
+     * - SDK: "myapp:tool_name" or just "tool_name" (auto-prefixed)
+     * - MCP: "mcp_server_tool"
+     * - Wildcard: ["*"]
+     */
     tools?: string[];
+    /**
+     * Skills to enable.
+     * @example ["pdf", "web-research", "xlsx"]
+     */
+    skills?: string[];
 }
 /**
  * Embedding configuration from Sanqian
@@ -207,6 +218,40 @@ declare class SanqianAppClient {
      * Delete a conversation
      */
     deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * List available capabilities (tools, skills, agents)
+     *
+     * @example
+     * ```typescript
+     * // List all tools
+     * const tools = await client.listCapabilities({ type: 'tool' });
+     *
+     * // List builtin tools only
+     * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+     * ```
+     */
+    listCapabilities(options?: _yushaw_sanqian_sdk.ListCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.Capability[]>;
+    /**
+     * Search capabilities by query
+     *
+     * @example
+     * ```typescript
+     * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+     * ```
+     */
+    searchCapabilities(query: string, options?: _yushaw_sanqian_sdk.SearchCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.CapabilitySearchResult[]>;
+    /**
+     * List available tools
+     */
+    listTools(source?: 'builtin' | 'sdk' | 'mcp'): Promise<_yushaw_sanqian_sdk.ToolCapability[]>;
+    /**
+     * List available skills
+     */
+    listSkills(): Promise<_yushaw_sanqian_sdk.SkillCapability[]>;
+    /**
+     * List all available agents (not just own agents)
+     */
+    listAvailableAgents(): Promise<_yushaw_sanqian_sdk.AgentCapability[]>;
     /**
      * Get the underlying SDK instance
      * @internal This is for internal use by other sanqian-chat components

package/dist/main/index.d.ts

@@ -66,8 +66,19 @@ interface AppAgentConfig {
     description?: string;
     /** System prompt */
     systemPrompt?: string;
-    /** Enabled tool names (without app prefix) */
+    /**
+     * Tools to enable. Supports:
+     * - Builtin: "file_ops", "run_bash", "web_search"
+     * - SDK: "myapp:tool_name" or just "tool_name" (auto-prefixed)
+     * - MCP: "mcp_server_tool"
+     * - Wildcard: ["*"]
+     */
     tools?: string[];
+    /**
+     * Skills to enable.
+     * @example ["pdf", "web-research", "xlsx"]
+     */
+    skills?: string[];
 }
 /**
  * Embedding configuration from Sanqian
@@ -207,6 +218,40 @@ declare class SanqianAppClient {
      * Delete a conversation
      */
     deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * List available capabilities (tools, skills, agents)
+     *
+     * @example
+     * ```typescript
+     * // List all tools
+     * const tools = await client.listCapabilities({ type: 'tool' });
+     *
+     * // List builtin tools only
+     * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+     * ```
+     */
+    listCapabilities(options?: _yushaw_sanqian_sdk.ListCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.Capability[]>;
+    /**
+     * Search capabilities by query
+     *
+     * @example
+     * ```typescript
+     * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+     * ```
+     */
+    searchCapabilities(query: string, options?: _yushaw_sanqian_sdk.SearchCapabilitiesOptions): Promise<_yushaw_sanqian_sdk.CapabilitySearchResult[]>;
+    /**
+     * List available tools
+     */
+    listTools(source?: 'builtin' | 'sdk' | 'mcp'): Promise<_yushaw_sanqian_sdk.ToolCapability[]>;
+    /**
+     * List available skills
+     */
+    listSkills(): Promise<_yushaw_sanqian_sdk.SkillCapability[]>;
+    /**
+     * List all available agents (not just own agents)
+     */
+    listAvailableAgents(): Promise<_yushaw_sanqian_sdk.AgentCapability[]>;
     /**
      * Get the underlying SDK instance
      * @internal This is for internal use by other sanqian-chat components

package/dist/main/index.js

@@ -112,7 +112,8 @@ var SanqianAppClient = class {
       name: config.name,
       description: config.description,
       system_prompt: config.systemPrompt,
-      tools: config.tools
+      tools: config.tools,
+      skills: config.skills
     };
     const result = await this.sdk.createAgent(sdkConfig);
     return { agentId: result.agent_id };
@@ -191,6 +192,53 @@ var SanqianAppClient = class {
     return this.sdk.deleteConversation(conversationId);
   }
   // ============================================================
+  // Capability Discovery
+  // ============================================================
+  /**
+   * List available capabilities (tools, skills, agents)
+   *
+   * @example
+   * ```typescript
+   * // List all tools
+   * const tools = await client.listCapabilities({ type: 'tool' });
+   *
+   * // List builtin tools only
+   * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+   * ```
+   */
+  async listCapabilities(options) {
+    return this.sdk.listCapabilities(options);
+  }
+  /**
+   * Search capabilities by query
+   *
+   * @example
+   * ```typescript
+   * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+   * ```
+   */
+  async searchCapabilities(query, options) {
+    return this.sdk.searchCapabilities(query, options);
+  }
+  /**
+   * List available tools
+   */
+  async listTools(source) {
+    return this.sdk.listTools(source);
+  }
+  /**
+   * List available skills
+   */
+  async listSkills() {
+    return this.sdk.listSkills();
+  }
+  /**
+   * List all available agents (not just own agents)
+   */
+  async listAvailableAgents() {
+    return this.sdk.listAvailableAgents();
+  }
+  // ============================================================
   // Internal Access (for FloatingWindow and other internal components)
   // ============================================================
   /**
@@ -257,6 +305,7 @@ var FloatingWindow = class _FloatingWindow {
     const { alwaysOnTop, showInTaskbar, preloadPath } = this.options;
     const initialBounds = this.getInitialBounds();
     const { minWidth, minHeight } = this.getMinSize();
+    const isWindows = process.platform === "win32";
     const win = new import_electron.BrowserWindow({
       width: initialBounds.width,
       height: initialBounds.height,
@@ -264,11 +313,13 @@ var FloatingWindow = class _FloatingWindow {
       y: initialBounds.y,
       show: false,
       frame: false,
-      transparent: true,
+      // Windows: transparent 会移除 resize 边框，需要禁用
+      transparent: !isWindows,
       hasShadow: false,
       // Disable system shadow to avoid white border on macOS
       resizable: true,
-      backgroundColor: "#00000000",
+      // Windows: 非透明时需要设置背景色（默认深色，renderer 会根据主题同步）
+      backgroundColor: isWindows ? "#1F1F1F" : "#00000000",
       minWidth,
       minHeight,
       alwaysOnTop,
@@ -623,6 +674,17 @@ var FloatingWindow = class _FloatingWindow {
       if (!activeInstance) return { success: false, error: "Window not available" };
       return { success: true, data: activeInstance.getResolvedUiConfig() };
     });
+    import_electron.ipcMain.handle("sanqian-chat:setBackgroundColor", (_event, params) => {
+      if (!activeInstance) return { success: false, error: "Window not available" };
+      const win = activeInstance.getWindow();
+      if (!win) return { success: false, error: "Window not available" };
+      try {
+        win.setBackgroundColor(params.color);
+        return { success: true };
+      } catch (e) {
+        return { success: false, error: e instanceof Error ? e.message : "Failed to set background color" };
+      }
+    });
   }
   // Public API
   show() {
@@ -711,6 +773,7 @@ var FloatingWindow = class _FloatingWindow {
         import_electron.ipcMain.removeHandler("sanqian-chat:setAlwaysOnTop");
         import_electron.ipcMain.removeHandler("sanqian-chat:getAlwaysOnTop");
         import_electron.ipcMain.removeHandler("sanqian-chat:getUiConfig");
+        import_electron.ipcMain.removeHandler("sanqian-chat:setBackgroundColor");
         ipcHandlersRegistered = false;
       }
     }

package/dist/main/index.mjs

@@ -75,7 +75,8 @@ var SanqianAppClient = class {
       name: config.name,
       description: config.description,
       system_prompt: config.systemPrompt,
-      tools: config.tools
+      tools: config.tools,
+      skills: config.skills
     };
     const result = await this.sdk.createAgent(sdkConfig);
     return { agentId: result.agent_id };
@@ -154,6 +155,53 @@ var SanqianAppClient = class {
     return this.sdk.deleteConversation(conversationId);
   }
   // ============================================================
+  // Capability Discovery
+  // ============================================================
+  /**
+   * List available capabilities (tools, skills, agents)
+   *
+   * @example
+   * ```typescript
+   * // List all tools
+   * const tools = await client.listCapabilities({ type: 'tool' });
+   *
+   * // List builtin tools only
+   * const builtinTools = await client.listCapabilities({ type: 'tool', source: 'builtin' });
+   * ```
+   */
+  async listCapabilities(options) {
+    return this.sdk.listCapabilities(options);
+  }
+  /**
+   * Search capabilities by query
+   *
+   * @example
+   * ```typescript
+   * const results = await client.searchCapabilities('file operations', { type: 'tool', limit: 5 });
+   * ```
+   */
+  async searchCapabilities(query, options) {
+    return this.sdk.searchCapabilities(query, options);
+  }
+  /**
+   * List available tools
+   */
+  async listTools(source) {
+    return this.sdk.listTools(source);
+  }
+  /**
+   * List available skills
+   */
+  async listSkills() {
+    return this.sdk.listSkills();
+  }
+  /**
+   * List all available agents (not just own agents)
+   */
+  async listAvailableAgents() {
+    return this.sdk.listAvailableAgents();
+  }
+  // ============================================================
   // Internal Access (for FloatingWindow and other internal components)
   // ============================================================
   /**
@@ -220,6 +268,7 @@ var FloatingWindow = class _FloatingWindow {
     const { alwaysOnTop, showInTaskbar, preloadPath } = this.options;
     const initialBounds = this.getInitialBounds();
     const { minWidth, minHeight } = this.getMinSize();
+    const isWindows = process.platform === "win32";
     const win = new BrowserWindow({
       width: initialBounds.width,
       height: initialBounds.height,
@@ -227,11 +276,13 @@ var FloatingWindow = class _FloatingWindow {
       y: initialBounds.y,
       show: false,
       frame: false,
-      transparent: true,
+      // Windows: transparent 会移除 resize 边框，需要禁用
+      transparent: !isWindows,
       hasShadow: false,
       // Disable system shadow to avoid white border on macOS
       resizable: true,
-      backgroundColor: "#00000000",
+      // Windows: 非透明时需要设置背景色（默认深色，renderer 会根据主题同步）
+      backgroundColor: isWindows ? "#1F1F1F" : "#00000000",
       minWidth,
       minHeight,
       alwaysOnTop,
@@ -586,6 +637,17 @@ var FloatingWindow = class _FloatingWindow {
       if (!activeInstance) return { success: false, error: "Window not available" };
       return { success: true, data: activeInstance.getResolvedUiConfig() };
     });
+    ipcMain.handle("sanqian-chat:setBackgroundColor", (_event, params) => {
+      if (!activeInstance) return { success: false, error: "Window not available" };
+      const win = activeInstance.getWindow();
+      if (!win) return { success: false, error: "Window not available" };
+      try {
+        win.setBackgroundColor(params.color);
+        return { success: true };
+      } catch (e) {
+        return { success: false, error: e instanceof Error ? e.message : "Failed to set background color" };
+      }
+    });
   }
   // Public API
   show() {
@@ -674,6 +736,7 @@ var FloatingWindow = class _FloatingWindow {
         ipcMain.removeHandler("sanqian-chat:setAlwaysOnTop");
         ipcMain.removeHandler("sanqian-chat:getAlwaysOnTop");
         ipcMain.removeHandler("sanqian-chat:getUiConfig");
+        ipcMain.removeHandler("sanqian-chat:setBackgroundColor");
         ipcHandlersRegistered = false;
       }
     }

package/dist/preload/index.d.ts

@@ -144,6 +144,13 @@ interface SanqianChatAPI {
         data?: ChatUiConfigSerializable | null;
         error?: string;
     }>;
+    setBackgroundColor(params: {
+        color: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    getPlatform(): string;
 }
 declare global {
     interface Window {

package/dist/preload/index.js

@@ -36,7 +36,9 @@ var api = {
   hide: () => import_electron.ipcRenderer.invoke("sanqian-chat:hide"),
   setAlwaysOnTop: (params) => import_electron.ipcRenderer.invoke("sanqian-chat:setAlwaysOnTop", params),
   getAlwaysOnTop: () => import_electron.ipcRenderer.invoke("sanqian-chat:getAlwaysOnTop"),
-  getUiConfig: () => import_electron.ipcRenderer.invoke("sanqian-chat:getUiConfig")
+  getUiConfig: () => import_electron.ipcRenderer.invoke("sanqian-chat:getUiConfig"),
+  setBackgroundColor: (params) => import_electron.ipcRenderer.invoke("sanqian-chat:setBackgroundColor", params),
+  getPlatform: () => process.platform
 };
 import_electron.contextBridge.exposeInMainWorld("sanqianChat", api);
 import_electron.contextBridge.exposeInMainWorld("__SANQIAN_CHAT_STYLE_MODE__", "full");

package/dist/renderer/index.js

@@ -7624,9 +7624,37 @@ var SanqianChat = (0, import_react22.memo)(function SanqianChat2({
 });
 
 // src/renderer/components/FloatingChat.tsx
+var import_react24 = require("react");
+
+// src/renderer/hooks/useWindowBackgroundSync.ts
 var import_react23 = require("react");
+var cachedPlatform = null;
+var getPlatform = () => {
+  if (cachedPlatform !== null) return cachedPlatform;
+  const api = typeof window !== "undefined" ? window.sanqianChat : null;
+  if (api?.getPlatform) {
+    cachedPlatform = api.getPlatform();
+    return cachedPlatform;
+  }
+  return null;
+};
+var setBackgroundColor = (color) => {
+  const api = typeof window !== "undefined" ? window.sanqianChat : null;
+  if (api?.setBackgroundColor) {
+    void api.setBackgroundColor({ color });
+  }
+};
+function useWindowBackgroundSync(isDarkMode) {
+  (0, import_react23.useEffect)(() => {
+    if (getPlatform() !== "win32") return;
+    const colors = getBaseColors(isDarkMode);
+    setBackgroundColor(colors.bg);
+  }, [isDarkMode]);
+}
+
+// src/renderer/components/FloatingChat.tsx
 var import_jsx_runtime15 = require("react/jsx-runtime");
-var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
+var FloatingChat = (0, import_react24.memo)(function FloatingChat2({
   messages,
   isLoading,
   isStreaming,
@@ -7647,8 +7675,8 @@ var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
   header,
   footer
 }) {
-  const chatContainerRef = (0, import_react23.useRef)(null);
-  const chatInputRef = (0, import_react23.useRef)(null);
+  const chatContainerRef = (0, import_react24.useRef)(null);
+  const chatInputRef = (0, import_react24.useRef)(null);
   useChatStyles();
   useFocusPersistence({
     containerRef: chatContainerRef,
@@ -7659,18 +7687,19 @@ var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
   const themeMode = resolvedConfig?.theme ?? "auto";
   const { themeClass, isDarkMode } = useResolvedTheme(themeMode);
   const accentStyle = useAccentStyle(resolvedConfig?.accentColor);
-  const rootStyle = (0, import_react23.useMemo)(() => ({
+  useWindowBackgroundSync(isDarkMode);
+  const rootStyle = (0, import_react24.useMemo)(() => ({
     ...accentStyle || {},
     minHeight: "100vh",
     minWidth: "100vw"
   }), [accentStyle]);
   const resolvedLogo = logo ?? resolvedConfig?.logo;
   const resolvedLocale = resolvedConfig?.locale ?? locale;
-  const resolvedStrings = (0, import_react23.useMemo)(
+  const resolvedStrings = (0, import_react24.useMemo)(
     () => resolveChatStrings(resolvedLocale, resolvedConfig?.strings),
     [resolvedLocale, resolvedConfig?.strings]
   );
-  const headerConfig = (0, import_react23.useMemo)(
+  const headerConfig = (0, import_react24.useMemo)(
     () => {
       if (!resolvedConfig) {
         return resolvedLogo ? { logo: resolvedLogo } : void 0;
@@ -7683,7 +7712,7 @@ var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
     [resolvedConfig, resolvedLogo]
   );
   const { logoNode, showPin, showClose, isPinned, togglePin, resolvedOnClose } = useChatHeader(headerConfig);
-  const emptyLogoNode = (0, import_react23.useMemo)(() => resolveLogoNode(resolvedLogo, "empty"), [resolvedLogo]);
+  const emptyLogoNode = (0, import_react24.useMemo)(() => resolveLogoNode(resolvedLogo, "empty"), [resolvedLogo]);
   const inputPlaceholder = placeholder ?? resolvedStrings.inputPlaceholder;
   const showHeader = !!(header || logoNode || showPin || showClose);
   const defaultHeader = /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("header", { className: "flex h-9 flex-shrink-0 items-center px-2 border-b chat-divider-border", children: [
@@ -7722,7 +7751,7 @@ var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
     ] })
   ] });
   const resolvedHeader = header ?? (showHeader ? defaultHeader : null);
-  const defaultRenderMessage = (0, import_react23.useCallback)(
+  const defaultRenderMessage = (0, import_react24.useCallback)(
     (message) => {
       if (message.role === "tool") return null;
       const isUser = message.role === "user";
@@ -7736,7 +7765,7 @@ var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
     },
     [renderContent]
   );
-  const defaultRenderHitl = (0, import_react23.useCallback)(
+  const defaultRenderHitl = (0, import_react24.useCallback)(
     (interrupt, onApprove, onReject) => /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("div", { className: "p-4 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg m-2", children: [
       /* @__PURE__ */ (0, import_jsx_runtime15.jsx)("p", { className: "font-medium mb-2", children: interrupt.type === "approval_request" ? resolvedStrings.hitlApprovalRequired : resolvedStrings.hitlInputRequired }),
       interrupt.tool && /* @__PURE__ */ (0, import_jsx_runtime15.jsxs)("p", { className: "text-sm mb-2", children: [
@@ -7810,10 +7839,10 @@ var FloatingChat = (0, import_react23.memo)(function FloatingChat2({
 });
 
 // src/renderer/components/HistoryList.tsx
-var import_react24 = require("react");
+var import_react25 = require("react");
 var import_jsx_runtime16 = require("react/jsx-runtime");
 function DeleteButton({ onClick, title, colors }) {
-  const [isHovered, setIsHovered] = (0, import_react24.useState)(false);
+  const [isHovered, setIsHovered] = (0, import_react25.useState)(false);
   return /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
     "button",
     {
@@ -7857,7 +7886,7 @@ function DeleteButton({ onClick, title, colors }) {
   );
 }
 function LoadMoreButton({ onClick, colors, children }) {
-  const [isHovered, setIsHovered] = (0, import_react24.useState)(false);
+  const [isHovered, setIsHovered] = (0, import_react25.useState)(false);
   return /* @__PURE__ */ (0, import_jsx_runtime16.jsx)(
     "button",
     {
@@ -7907,7 +7936,7 @@ function formatRelativeTime(dateStr, strings) {
     return date.toLocaleDateString(void 0, { month: "short", day: "numeric" });
   }
 }
-var HistoryList = (0, import_react24.memo)(function HistoryList2({
+var HistoryList = (0, import_react25.memo)(function HistoryList2({
   conversations,
   selectedId,
   isLoading,
@@ -7919,11 +7948,11 @@ var HistoryList = (0, import_react24.memo)(function HistoryList2({
   isDarkMode = false,
   strings = {}
 }) {
-  const [hoveredId, setHoveredId] = (0, import_react24.useState)(null);
-  const loadMoreRef = (0, import_react24.useRef)(null);
-  const isLoadingRef = (0, import_react24.useRef)(isLoading);
+  const [hoveredId, setHoveredId] = (0, import_react25.useState)(null);
+  const loadMoreRef = (0, import_react25.useRef)(null);
+  const isLoadingRef = (0, import_react25.useRef)(isLoading);
   isLoadingRef.current = isLoading;
-  (0, import_react24.useEffect)(() => {
+  (0, import_react25.useEffect)(() => {
     if (!hasMore || loadError || !onLoadMore) return;
     const sentinel = loadMoreRef.current;
     if (!sentinel) return;
@@ -8020,10 +8049,10 @@ var HistoryList = (0, import_react24.memo)(function HistoryList2({
 });
 
 // src/renderer/components/CompactChat.tsx
-var import_react25 = require("react");
+var import_react26 = require("react");
 var import_react_dom = require("react-dom");
 var import_jsx_runtime17 = require("react/jsx-runtime");
-var CompactChat = (0, import_react25.memo)(function CompactChat2({
+var CompactChat = (0, import_react26.memo)(function CompactChat2({
   adapter,
   config,
   logo,
@@ -8058,12 +8087,12 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
   const { themeClass, isDarkMode: resolvedIsDarkMode } = useResolvedTheme(themeMode);
   const accentStyle = useAccentStyle(resolvedConfig?.accentColor);
   const resolvedLogo = logo ?? resolvedConfig?.logo;
-  const baseStrings = (0, import_react25.useMemo)(
+  const baseStrings = (0, import_react26.useMemo)(
     () => resolveChatStrings(resolvedConfig?.locale, resolvedConfig?.strings),
     [resolvedConfig?.locale, resolvedConfig?.strings]
   );
-  const mergedStrings = (0, import_react25.useMemo)(() => ({ ...baseStrings, ...strings }), [baseStrings, strings]);
-  const headerConfig = (0, import_react25.useMemo)(
+  const mergedStrings = (0, import_react26.useMemo)(() => ({ ...baseStrings, ...strings }), [baseStrings, strings]);
+  const headerConfig = (0, import_react26.useMemo)(
     () => {
       if (!resolvedConfig) {
         return resolvedLogo ? { logo: resolvedLogo } : void 0;
@@ -8076,12 +8105,12 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
     [resolvedConfig, resolvedLogo]
   );
   const { logoNode, showPin, showClose, isPinned, togglePin, resolvedOnClose } = useChatHeader(headerConfig);
-  const emptyLogoNode = (0, import_react25.useMemo)(() => resolveLogoNode(resolvedLogo, "empty"), [resolvedLogo]);
-  const chatContainerRef = (0, import_react25.useRef)(null);
-  const chatInputRef = (0, import_react25.useRef)(null);
-  const [showHistory, setShowHistory] = (0, import_react25.useState)(false);
-  const [connectionAlert, setConnectionAlert] = (0, import_react25.useState)(null);
-  const portalContainerRef = (0, import_react25.useRef)(inputPortalContainer ?? null);
+  const emptyLogoNode = (0, import_react26.useMemo)(() => resolveLogoNode(resolvedLogo, "empty"), [resolvedLogo]);
+  const chatContainerRef = (0, import_react26.useRef)(null);
+  const chatInputRef = (0, import_react26.useRef)(null);
+  const [showHistory, setShowHistory] = (0, import_react26.useState)(false);
+  const [connectionAlert, setConnectionAlert] = (0, import_react26.useState)(null);
+  const portalContainerRef = (0, import_react26.useRef)(inputPortalContainer ?? null);
   portalContainerRef.current = inputPortalContainer ?? null;
   const shouldRenderInputExternally = !!inputPortalContainer;
   const inputPlaceholder = placeholder ?? mergedStrings.inputPlaceholder;
@@ -8119,27 +8148,27 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
     adapter,
     onError
   });
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (sendMessageRef) {
       sendMessageRef.current = chat.sendMessage;
     }
   }, [sendMessageRef, chat.sendMessage]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (newConversationRef) {
       newConversationRef.current = chat.newConversation;
     }
   }, [newConversationRef, chat.newConversation]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (parentFocusInputRef) {
       parentFocusInputRef.current = () => chatInputRef.current?.focus();
     }
   }, [parentFocusInputRef]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (parentSetTextRef) {
       parentSetTextRef.current = (text) => chatInputRef.current?.setValue(text);
     }
   }, [parentSetTextRef]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (onMessageReceived && chat.messages.length > 0) {
       const lastMessage = chat.messages[chat.messages.length - 1];
       if (lastMessage.role === "assistant" && !lastMessage.isStreaming) {
@@ -8147,12 +8176,12 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
       }
     }
   }, [chat.messages, onMessageReceived]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (onLoadingChange) {
       onLoadingChange(chat.isLoading);
     }
   }, [chat.isLoading, onLoadingChange]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (onStateChange) {
       onStateChange({
         messages: chat.messages,
@@ -8160,19 +8189,19 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
       });
     }
   }, [chat.messages, chat.conversationId, onStateChange]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     if (showHistory && connection.isConnected) {
       conversations.loadConversations();
     }
   }, [showHistory, connection.isConnected]);
-  const handleSelectConversation = (0, import_react25.useCallback)(
+  const handleSelectConversation = (0, import_react26.useCallback)(
     async (id) => {
       await chat.loadConversation(id);
       setShowHistory(false);
     },
     [chat]
   );
-  const handleDeleteConversation = (0, import_react25.useCallback)(
+  const handleDeleteConversation = (0, import_react26.useCallback)(
     async (id) => {
       await conversations.deleteConversation(id);
       if (id === chat.conversationId) {
@@ -8181,14 +8210,14 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
     },
     [conversations, chat]
   );
-  const handleNewChat = (0, import_react25.useCallback)(() => {
+  const handleNewChat = (0, import_react26.useCallback)(() => {
     chat.newConversation();
     setShowHistory(false);
     setTimeout(() => {
       chatInputRef.current?.focus();
     }, 0);
   }, [chat]);
-  (0, import_react25.useEffect)(() => {
+  (0, import_react26.useEffect)(() => {
     const handleKeyDown = (e) => {
       const isMac2 = navigator.platform.includes("Mac");
       const modifierKey = isMac2 ? e.metaKey : e.ctrlKey;
@@ -8202,7 +8231,7 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
   }, [handleNewChat]);
   const isMac = typeof navigator !== "undefined" && navigator.platform.includes("Mac");
   const shortcutKey = isMac ? "\u2318N" : "Ctrl+N";
-  const defaultRenderMessage = (0, import_react25.useCallback)((message) => {
+  const defaultRenderMessage = (0, import_react26.useCallback)((message) => {
     if (message.role === "tool") return null;
     const isUser = message.role === "user";
     const hasToolCalls = message.toolCalls && message.toolCalls.length > 0;
@@ -8248,11 +8277,11 @@ var CompactChat = (0, import_react25.memo)(function CompactChat2({
     ] }) });
   }, [mergedStrings]);
   const containerClass = floating ? `chat-window-container ${themeClass} ${className}` : `flex h-full flex-col bg-[var(--chat-bg)] text-[var(--chat-text)] ${themeClass} ${className}`;
-  const baseColors = (0, import_react25.useMemo)(() => {
+  const baseColors = (0, import_react26.useMemo)(() => {
     if (!floating) return null;
     return getBaseColors(resolvedIsDarkMode);
   }, [floating, resolvedIsDarkMode]);
-  const containerStyle = (0, import_react25.useMemo)(() => {
+  const containerStyle = (0, import_react26.useMemo)(() => {
     if (!floating || !baseColors) return accentStyle;
     return {
       ...accentStyle,

package/dist/renderer/index.mjs

@@ -7569,6 +7569,34 @@ var SanqianChat = memo10(function SanqianChat2({
 
 // src/renderer/components/FloatingChat.tsx
 import { memo as memo11, useCallback as useCallback12, useMemo as useMemo9, useRef as useRef11 } from "react";
+
+// src/renderer/hooks/useWindowBackgroundSync.ts
+import { useEffect as useEffect16 } from "react";
+var cachedPlatform = null;
+var getPlatform = () => {
+  if (cachedPlatform !== null) return cachedPlatform;
+  const api = typeof window !== "undefined" ? window.sanqianChat : null;
+  if (api?.getPlatform) {
+    cachedPlatform = api.getPlatform();
+    return cachedPlatform;
+  }
+  return null;
+};
+var setBackgroundColor = (color) => {
+  const api = typeof window !== "undefined" ? window.sanqianChat : null;
+  if (api?.setBackgroundColor) {
+    void api.setBackgroundColor({ color });
+  }
+};
+function useWindowBackgroundSync(isDarkMode) {
+  useEffect16(() => {
+    if (getPlatform() !== "win32") return;
+    const colors = getBaseColors(isDarkMode);
+    setBackgroundColor(colors.bg);
+  }, [isDarkMode]);
+}
+
+// src/renderer/components/FloatingChat.tsx
 import { Fragment as Fragment3, jsx as jsx15, jsxs as jsxs10 } from "react/jsx-runtime";
 var FloatingChat = memo11(function FloatingChat2({
   messages,
@@ -7603,6 +7631,7 @@ var FloatingChat = memo11(function FloatingChat2({
   const themeMode = resolvedConfig?.theme ?? "auto";
   const { themeClass, isDarkMode } = useResolvedTheme(themeMode);
   const accentStyle = useAccentStyle(resolvedConfig?.accentColor);
+  useWindowBackgroundSync(isDarkMode);
   const rootStyle = useMemo9(() => ({
     ...accentStyle || {},
     minHeight: "100vh",
@@ -7754,7 +7783,7 @@ var FloatingChat = memo11(function FloatingChat2({
 });
 
 // src/renderer/components/HistoryList.tsx
-import { memo as memo12, useState as useState14, useEffect as useEffect16, useRef as useRef12 } from "react";
+import { memo as memo12, useState as useState14, useEffect as useEffect17, useRef as useRef12 } from "react";
 import { jsx as jsx16, jsxs as jsxs11 } from "react/jsx-runtime";
 function DeleteButton({ onClick, title, colors }) {
   const [isHovered, setIsHovered] = useState14(false);
@@ -7867,7 +7896,7 @@ var HistoryList = memo12(function HistoryList2({
   const loadMoreRef = useRef12(null);
   const isLoadingRef = useRef12(isLoading);
   isLoadingRef.current = isLoading;
-  useEffect16(() => {
+  useEffect17(() => {
     if (!hasMore || loadError || !onLoadMore) return;
     const sentinel = loadMoreRef.current;
     if (!sentinel) return;
@@ -7964,7 +7993,7 @@ var HistoryList = memo12(function HistoryList2({
 });
 
 // src/renderer/components/CompactChat.tsx
-import { memo as memo13, useRef as useRef13, useState as useState15, useEffect as useEffect17, useCallback as useCallback14, useMemo as useMemo10 } from "react";
+import { memo as memo13, useRef as useRef13, useState as useState15, useEffect as useEffect18, useCallback as useCallback14, useMemo as useMemo10 } from "react";
 import { createPortal } from "react-dom";
 import { Fragment as Fragment4, jsx as jsx17, jsxs as jsxs12 } from "react/jsx-runtime";
 var CompactChat = memo13(function CompactChat2({
@@ -8063,27 +8092,27 @@ var CompactChat = memo13(function CompactChat2({
     adapter,
     onError
   });
-  useEffect17(() => {
+  useEffect18(() => {
     if (sendMessageRef) {
       sendMessageRef.current = chat.sendMessage;
     }
   }, [sendMessageRef, chat.sendMessage]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (newConversationRef) {
       newConversationRef.current = chat.newConversation;
     }
   }, [newConversationRef, chat.newConversation]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (parentFocusInputRef) {
       parentFocusInputRef.current = () => chatInputRef.current?.focus();
     }
   }, [parentFocusInputRef]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (parentSetTextRef) {
       parentSetTextRef.current = (text) => chatInputRef.current?.setValue(text);
     }
   }, [parentSetTextRef]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (onMessageReceived && chat.messages.length > 0) {
       const lastMessage = chat.messages[chat.messages.length - 1];
       if (lastMessage.role === "assistant" && !lastMessage.isStreaming) {
@@ -8091,12 +8120,12 @@ var CompactChat = memo13(function CompactChat2({
       }
     }
   }, [chat.messages, onMessageReceived]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (onLoadingChange) {
       onLoadingChange(chat.isLoading);
     }
   }, [chat.isLoading, onLoadingChange]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (onStateChange) {
       onStateChange({
         messages: chat.messages,
@@ -8104,7 +8133,7 @@ var CompactChat = memo13(function CompactChat2({
       });
     }
   }, [chat.messages, chat.conversationId, onStateChange]);
-  useEffect17(() => {
+  useEffect18(() => {
     if (showHistory && connection.isConnected) {
       conversations.loadConversations();
     }
@@ -8132,7 +8161,7 @@ var CompactChat = memo13(function CompactChat2({
       chatInputRef.current?.focus();
     }, 0);
   }, [chat]);
-  useEffect17(() => {
+  useEffect18(() => {
     const handleKeyDown = (e) => {
       const isMac2 = navigator.platform.includes("Mac");
       const modifierKey = isMac2 ? e.metaKey : e.ctrlKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yushaw/sanqian-chat",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Floating chat window SDK for Sanqian AI Assistant",
   "main": "./dist/main/index.js",
   "types": "./dist/main/index.d.ts",
@@ -43,7 +43,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@yushaw/sanqian-sdk": "^0.3.0",
+    "@yushaw/sanqian-sdk": "^0.3.1",
     "react-virtuoso": "^4.15.0",
     "rehype-harden": "^1.1.6",
     "remark-gfm": "^4.0.1",