cue-console 0.1.14 → 0.1.16

package/bin/cue-console.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
-const { spawn } = require("node:child_process");
-const fs = require("node:fs");
-const path = require("node:path");
+let spawn;
+let fs;
+let path;
 
 function printHelp() {
   process.stdout.write(
@@ -44,6 +44,13 @@ function parseArgs(argv) {
 }
 
 async function main() {
+  if (!spawn || !fs || !path) {
+    const childProcess = await import("node:child_process");
+    spawn = childProcess.spawn;
+    fs = await import("node:fs");
+    path = await import("node:path");
+  }
+
   const { command, port, host, passthrough } = parseArgs(process.argv.slice(2));
 
   if (!command) {
@@ -57,12 +64,11 @@ async function main() {
     process.exit(1);
   }
 
-  let nextBin;
-  try {
-    nextBin = require.resolve("next/dist/bin/next");
-  } catch (e) {
+  const pkgRoot = path.resolve(__dirname, "..");
+  const nextBin = path.join(pkgRoot, "node_modules", "next", "dist", "bin", "next");
+  if (!fs.existsSync(nextBin)) {
     process.stderr.write(
-      "Unable to resolve Next.js CLI. Please install dependencies first (e.g. pnpm install).\n"
+      "Unable to resolve Next.js CLI. Please install dependencies first (e.g. npm install).\n"
     );
     process.exit(1);
   }
@@ -71,8 +77,6 @@ async function main() {
   if (port) env.PORT = String(port);
   if (host) env.HOSTNAME = String(host);
 
-  const pkgRoot = path.resolve(__dirname, "..");
-
   const spawnNext = (subcmd) =>
     new Promise((resolve, reject) => {
       const child = spawn(process.execPath, [nextBin, subcmd, ...passthrough], {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cue-console",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Cue Hub console launcher (Next.js UI)",
   "license": "Apache-2.0",
   "keywords": ["mcp", "cue", "console", "nextjs"],

package/src/app/page.tsx

@@ -12,7 +12,16 @@ export default function Home() {
   const [selectedType, setSelectedType] = useState<"agent" | "group" | null>(null);
   const [selectedName, setSelectedName] = useState<string>("");
   const [showCreateGroup, setShowCreateGroup] = useState(false);
-  const [sidebarCollapsed, setSidebarCollapsed] = useState(false);
+  const [sidebarCollapsed, setSidebarCollapsed] = useState(() => {
+    try {
+      const raw = window.localStorage.getItem("cuehub.sidebarCollapsed");
+      if (raw === "1") return true;
+      if (raw === "0") return false;
+      return false;
+    } catch {
+      return false;
+    }
+  });
 
   useEffect(() => {
     let stopped = false;
@@ -105,16 +114,6 @@ export default function Home() {
     };
   }, []);
 
-  useEffect(() => {
-    try {
-      const raw = window.localStorage.getItem("cuehub.sidebarCollapsed");
-      if (raw === "1") setSidebarCollapsed(true);
-      if (raw === "0") setSidebarCollapsed(false);
-    } catch {
-      // ignore
-    }
-  }, []);
-
   useEffect(() => {
     try {
       window.localStorage.setItem("cuehub.sidebarCollapsed", sidebarCollapsed ? "1" : "0");

package/src/components/chat/message-bubble.tsx

@@ -1,10 +1,11 @@
-import { useMemo } from "react";
+import { useMemo, useState } from "react";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import { cn, getAgentEmoji, formatFullTime, getWaitingDuration } from "@/lib/utils";
 import { MarkdownRenderer } from "@/components/markdown-renderer";
 import { PayloadCard } from "@/components/payload-card";
 import type { CueRequest } from "@/lib/actions";
+import { Copy, Check } from "lucide-react";
 
 interface MessageBubbleProps {
   request: CueRequest;
@@ -44,6 +45,17 @@ export function MessageBubble({
   onCancel,
 }: MessageBubbleProps) {
   const isPending = request.status === "PENDING";
+  const [copied, setCopied] = useState(false);
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(request.prompt || "");
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch (err) {
+      console.error("Failed to copy:", err);
+    }
+  };
 
   const isPause = useMemo(() => {
     if (!request.payload) return false;
@@ -133,6 +145,17 @@ export function MessageBubble({
         </div>
         <div className="mt-1 flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
           <span className="shrink-0">{formatFullTime(request.created_at || "")}</span>
+          <Button
+            variant="ghost"
+            size="sm"
+            className="h-auto p-1 text-xs"
+            onClick={handleCopy}
+            disabled={disabled}
+            title={copied ? "已复制" : "复制"}
+          >
+            {copied ? <Check className="h-3 w-3" /> : <Copy className="h-3 w-3" />}
+            <span className="ml-1">{copied ? "已复制" : "复制"}</span>
+          </Button>
           {isPending && (
             <>
               <Badge variant="outline" className="text-xs shrink-0">

package/src/components/chat/timeline-list.tsx

@@ -1,12 +1,13 @@
 "use client";
 
-import { memo, useMemo, type ReactNode } from "react";
+import { memo, useMemo, useState, type ReactNode } from "react";
 import { Button } from "@/components/ui/button";
 import { Badge } from "@/components/ui/badge";
 import { cn, formatFullTime, getAgentEmoji, getWaitingDuration } from "@/lib/utils";
 import { MarkdownRenderer } from "@/components/markdown-renderer";
 import { PayloadCard } from "@/components/payload-card";
 import type { AgentTimelineItem, CueRequest, CueResponse } from "@/lib/actions";
+import { Copy, Check } from "lucide-react";
 
 function parseDbTime(dateStr: string) {
   return new Date((dateStr || "").replace(" ", "T"));
@@ -193,6 +194,17 @@ const MessageBubble = memo(function MessageBubble({
   onCancel?: () => void;
 }) {
   const isPending = request.status === "PENDING";
+  const [copied, setCopied] = useState(false);
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(request.prompt || "");
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2000);
+    } catch (err) {
+      console.error("Failed to copy:", err);
+    }
+  };
 
   const isPause = useMemo(() => {
     if (!request.payload) return false;
@@ -282,6 +294,17 @@ const MessageBubble = memo(function MessageBubble({
         </div>
         <div className="mt-1 flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
           <span className="shrink-0">{formatFullTime(request.created_at || "")}</span>
+          <Button
+            variant="ghost"
+            size="sm"
+            className="h-auto p-1 text-xs"
+            onClick={handleCopy}
+            disabled={disabled}
+            title={copied ? "已复制" : "复制"}
+          >
+            {copied ? <Check className="h-3 w-3" /> : <Copy className="h-3 w-3" />}
+            <span className="ml-1">{copied ? "已复制" : "复制"}</span>
+          </Button>
           {isPending && (
             <>
               <Badge variant="outline" className="text-xs shrink-0">
@@ -350,13 +373,17 @@ const UserResponseBubble = memo(function UserResponseBubble({
     mentions?: { userId: string; start: number; length: number; display: string }[];
   };
 
-  const files = Array.isArray((response as any).files) ? ((response as any).files as any[]) : [];
+  const filesRaw = (response as unknown as { files?: unknown }).files;
+  const files = Array.isArray(filesRaw) ? filesRaw : [];
   const imageFiles = files.filter((f) => {
-    const mime = String(f?.mime_type || "");
-    return mime.startsWith("image/") && typeof f?.inline_base64 === "string" && f.inline_base64.length > 0;
+    const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+    const mime = String(obj?.mime_type || "");
+    const b64 = obj?.inline_base64;
+    return mime.startsWith("image/") && typeof b64 === "string" && b64.length > 0;
   });
   const otherFiles = files.filter((f) => {
-    const mime = String(f?.mime_type || "");
+    const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+    const mime = String(obj?.mime_type || "");
     return !mime.startsWith("image/");
   });
 
@@ -423,8 +450,9 @@ const UserResponseBubble = memo(function UserResponseBubble({
         {imageFiles.length > 0 && (
           <div className="flex flex-wrap gap-2 mt-2 max-w-full">
             {imageFiles.map((f, i) => {
-              const mime = String(f?.mime_type || "image/png");
-              const b64 = String(f?.inline_base64 || "");
+              const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+              const mime = String(obj?.mime_type || "image/png");
+              const b64 = String(obj?.inline_base64 || "");
               const img = { mime_type: mime, base64_data: b64 };
               return (
                 <img
@@ -442,7 +470,8 @@ const UserResponseBubble = memo(function UserResponseBubble({
         {otherFiles.length > 0 && (
           <div className="mt-2 flex flex-col gap-1 max-w-full">
             {otherFiles.map((f, i) => {
-              const fileRef = String(f?.file || "");
+              const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+              const fileRef = String(obj?.file || "");
               const name = fileRef.split("/").filter(Boolean).pop() || fileRef || "file";
               return (
                 <div

package/src/components/chat/user-response-bubble.tsx

@@ -21,13 +21,17 @@ export function UserResponseBubble({
     mentions?: { userId: string; start: number; length: number; display: string }[];
   };
 
-  const files = Array.isArray((response as any).files) ? ((response as any).files as any[]) : [];
+  const filesRaw = (response as unknown as { files?: unknown }).files;
+  const files = Array.isArray(filesRaw) ? filesRaw : [];
   const imageFiles = files.filter((f) => {
-    const mime = String(f?.mime_type || "");
-    return mime.startsWith("image/") && typeof f?.inline_base64 === "string" && f.inline_base64.length > 0;
+    const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+    const mime = String(obj?.mime_type || "");
+    const b64 = obj?.inline_base64;
+    return mime.startsWith("image/") && typeof b64 === "string" && b64.length > 0;
   });
   const otherFiles = files.filter((f) => {
-    const mime = String(f?.mime_type || "");
+    const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+    const mime = String(obj?.mime_type || "");
     return !mime.startsWith("image/");
   });
 
@@ -99,8 +103,9 @@ export function UserResponseBubble({
         {imageFiles.length > 0 && (
           <div className="flex flex-wrap gap-2 mt-2 max-w-full">
             {imageFiles.map((f, i) => {
-              const mime = String(f?.mime_type || "image/png");
-              const b64 = String(f?.inline_base64 || "");
+              const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+              const mime = String(obj?.mime_type || "image/png");
+              const b64 = String(obj?.inline_base64 || "");
               const img = { mime_type: mime, base64_data: b64 };
               return (
                 <img
@@ -118,7 +123,8 @@ export function UserResponseBubble({
         {otherFiles.length > 0 && (
           <div className="mt-2 flex flex-col gap-1 max-w-full">
             {otherFiles.map((f, i) => {
-              const fileRef = String(f?.file || "");
+              const obj = f && typeof f === "object" ? (f as Record<string, unknown>) : null;
+              const fileRef = String(obj?.file || "");
               const name = fileRef.split("/").filter(Boolean).pop() || fileRef || "file";
               return (
                 <div

package/src/components/chat-composer.tsx

@@ -2,6 +2,7 @@
 
 import {
   useMemo,
+  useRef,
   useState,
   type ChangeEvent,
   type ClipboardEvent,
@@ -63,6 +64,8 @@ export function ChatComposer({
   canSend,
   hasPendingRequests,
   input,
+  conversationMode,
+  setConversationMode,
   setInput,
   images,
   setImages,
@@ -103,6 +106,8 @@ export function ChatComposer({
   canSend: boolean;
   hasPendingRequests: boolean;
   input: string;
+  conversationMode: "chat" | "agent";
+  setConversationMode: (mode: "chat" | "agent") => void;
   setInput: Dispatch<SetStateAction<string>>;
   images: { mime_type: string; base64_data: string; file_name?: string }[];
   setImages: Dispatch<SetStateAction<{ mime_type: string; base64_data: string; file_name?: string }[]>>;
@@ -147,6 +152,7 @@ export function ChatComposer({
   }, [onBack]);
 
   const [dragIndex, setDragIndex] = useState<number | null>(null);
+  const isComposingRef = useRef(false);
 
   const submitOrQueue = () => {
     if (busy) return;
@@ -412,6 +418,12 @@ export function ChatComposer({
               }
               value={input}
               onPaste={handlePaste}
+              onCompositionStart={() => {
+                isComposingRef.current = true;
+              }}
+              onCompositionEnd={() => {
+                isComposingRef.current = false;
+              }}
               onChange={(e) => {
                 const next = e.target.value;
                 setInput(next);
@@ -508,7 +520,7 @@ export function ChatComposer({
                   }
                 }
 
-                if (e.key === "Enter" && !e.shiftKey) {
+                if (e.key === "Enter" && !e.shiftKey && !isComposingRef.current) {
                   e.preventDefault();
                   submitOrQueue();
                 }
@@ -563,6 +575,27 @@ export function ChatComposer({
                 <Plus className="h-4.5 w-4.5" />
               </Button>
 
+              <Button
+                type="button"
+                variant="ghost"
+                size="sm"
+                className={cn(
+                  "h-8 rounded-xl px-2",
+                  conversationMode === "chat"
+                    ? "bg-white/35 text-foreground ring-1 ring-white/25"
+                    : "text-muted-foreground hover:text-foreground",
+                  "hover:bg-white/40"
+                )}
+                onClick={() => {
+                  if (busy) return;
+                  setConversationMode(conversationMode === "chat" ? "agent" : "chat");
+                }}
+                disabled={busy}
+                title={conversationMode === "chat" ? "Chat mode" : "Agent mode"}
+              >
+                {conversationMode === "chat" ? "Chat" : "Agent"}
+              </Button>
+
               <Button
                 type="button"
                 variant="ghost"

package/src/components/chat-view.tsx

@@ -77,7 +77,7 @@ function ChatViewContent({ type, id, name, onBack }: ChatViewProps) {
     { mime_type: string; base64_data: string } | null
   >(null);
 
-  const { input, images, setInput, setImages } = useInputContext();
+  const { input, images, conversationMode, setConversationMode, setInput, setImages } = useInputContext();
   const { busy, error, notice, setBusy, setError, setNotice } = useUIStateContext();
   const deferredInput = useDeferredValue(input);
   const imagesRef = useRef(images);
@@ -179,7 +179,7 @@ function ChatViewContent({ type, id, name, onBack }: ChatViewProps) {
 
   useEffect(() => {
     if (type !== "group") return;
-    setGroupTitle(name);
+    queueMicrotask(() => setGroupTitle(name));
   }, [name, type]);
 
   const {
@@ -372,6 +372,25 @@ function ChatViewContent({ type, id, name, onBack }: ChatViewProps) {
     setMentions([]);
   }, [type, id]);
 
+  const loadMore = useCallback(async () => {
+    if (!nextCursor) return;
+    if (loadingMore) return;
+
+    const el = scrollRef.current;
+    const prevScrollHeight = el?.scrollHeight ?? 0;
+    const prevScrollTop = el?.scrollTop ?? 0;
+
+    const res = await loadMorePage(nextCursor);
+    requestAnimationFrame(() => {
+      const cur = scrollRef.current;
+      if (!cur) return;
+      const newScrollHeight = cur.scrollHeight;
+      cur.scrollTop = prevScrollTop + (newScrollHeight - prevScrollHeight);
+    });
+
+    nextCursorRef.current = res.cursor;
+  }, [loadMorePage, loadingMore, nextCursor]);
+
   useEffect(() => {
     const el = scrollRef.current;
     if (!el) return;
@@ -403,25 +422,6 @@ function ChatViewContent({ type, id, name, onBack }: ChatViewProps) {
     el.scrollTop = el.scrollHeight;
   }, [timeline, isAtBottom]);
 
-  const loadMore = useCallback(async () => {
-    if (!nextCursor) return;
-    if (loadingMore) return;
-
-    const el = scrollRef.current;
-    const prevScrollHeight = el?.scrollHeight ?? 0;
-    const prevScrollTop = el?.scrollTop ?? 0;
-
-    const res = await loadMorePage(nextCursor);
-    requestAnimationFrame(() => {
-      const cur = scrollRef.current;
-      if (!cur) return;
-      const newScrollHeight = cur.scrollHeight;
-      cur.scrollTop = prevScrollTop + (newScrollHeight - prevScrollHeight);
-    });
-
-    nextCursorRef.current = res.cursor;
-  }, [loadMorePage, loadingMore, nextCursor]);
-
   const handleSubmitConfirm = useCallback(async (requestId: string, text: string, cancelled: boolean) => {
     if (busy) return;
     setBusy(true);
@@ -611,6 +611,8 @@ function ChatViewContent({ type, id, name, onBack }: ChatViewProps) {
         canSend={canSend}
         hasPendingRequests={hasPendingRequests}
         input={input}
+        conversationMode={conversationMode}
+        setConversationMode={setConversationMode}
         setInput={setInput}
         images={images}
         setImages={setImages}

package/src/components/conversation-list.tsx

@@ -26,8 +26,11 @@ import {
   deleteConversations,
   fetchArchivedConversationCount,
   fetchConversationList,
+  fetchPinnedConversationKeys,
   getUserConfig,
+  pinConversationByKey,
   setUserConfig,
+  unpinConversationByKey,
   unarchiveConversations,
   type ConversationItem,
 } from "@/lib/actions";
@@ -42,6 +45,7 @@ import {
   ChevronLeft,
   ChevronRight,
   MoreHorizontal,
+  Pin,
   Settings,
   X,
 } from "lucide-react";
@@ -60,6 +64,14 @@ function conversationKey(item: Pick<ConversationItem, "type" | "id">) {
   return `${item.type}:${item.id}`;
 }
 
+type IdleCallbackHandle = number;
+type IdleRequestCallback = () => void;
+type IdleRequestOptions = { timeout?: number };
+type GlobalWithIdleCallbacks = typeof globalThis & {
+  requestIdleCallback?: (cb: IdleRequestCallback, opts?: IdleRequestOptions) => IdleCallbackHandle;
+  cancelIdleCallback?: (handle: IdleCallbackHandle) => void;
+};
+
 interface ConversationListProps {
   selectedId: string | null;
   selectedType: "agent" | "group" | null;
@@ -103,18 +115,36 @@ export function ConversationList({
 
   const [settingsOpen, setSettingsOpen] = useState(false);
   const [soundEnabled, setSoundEnabled] = useState(true);
+  const [conversationModeDefault, setConversationModeDefault] = useState<"chat" | "agent">("agent");
+  const [pinnedKeys, setPinnedKeys] = useState<string[]>([]);
 
   useEffect(() => {
     void (async () => {
       try {
         const cfg = await getUserConfig();
         setSoundEnabled(Boolean(cfg.sound_enabled));
+        const nextMode = cfg.conversation_mode_default === "chat" ? "chat" : "agent";
+        setConversationModeDefault(nextMode);
+        try {
+          window.localStorage.setItem("cue-console:conversationModeDefault", nextMode);
+        } catch {
+        }
       } catch {
-        // ignore
       }
     })();
   }, []);
 
+  useEffect(() => {
+    void (async () => {
+      try {
+        const keys = await fetchPinnedConversationKeys(view);
+        setPinnedKeys(Array.isArray(keys) ? keys : []);
+      } catch {
+        setPinnedKeys([]);
+      }
+    })();
+  }, [view]);
+
   const ensureAvatarUrl = useCallback(async (kind: "agent" | "group", rawId: string) => {
     if (!rawId) return;
     const t0 = perfEnabled() ? performance.now() : 0;
@@ -254,14 +284,16 @@ export function ConversationList({
     }
 
     const scheduleIdle = (fn: () => void) => {
-      if (typeof (globalThis as any).requestIdleCallback === "function") {
-        return (globalThis as any).requestIdleCallback(fn, { timeout: 1000 });
+      const g = globalThis as GlobalWithIdleCallbacks;
+      if (typeof g.requestIdleCallback === "function") {
+        return g.requestIdleCallback(fn, { timeout: 1000 });
       }
       return window.setTimeout(fn, 60);
     };
     const cancelIdle = (handle: number) => {
-      if (typeof (globalThis as any).cancelIdleCallback === "function") {
-        (globalThis as any).cancelIdleCallback(handle);
+      const g = globalThis as GlobalWithIdleCallbacks;
+      if (typeof g.cancelIdleCallback === "function") {
+        g.cancelIdleCallback(handle);
         return;
       }
       window.clearTimeout(handle);
@@ -356,8 +388,30 @@ export function ConversationList({
     item.displayName.toLowerCase().includes(search.toLowerCase())
   );
 
-  const groups = filtered.filter((i) => i.type === "group");
-  const agents = filtered.filter((i) => i.type === "agent");
+  const pinnedSet = useMemo(() => new Set(pinnedKeys), [pinnedKeys]);
+
+  const groupsAll = filtered.filter((i) => i.type === "group");
+  const agentsAll = filtered.filter((i) => i.type === "agent");
+
+  const groups = useMemo(() => {
+    const byKey = new Map(groupsAll.map((g) => [conversationKey(g), g] as const));
+    const pinned = pinnedKeys
+      .filter((k) => k.startsWith("group:"))
+      .map((k) => byKey.get(k))
+      .filter(Boolean) as ConversationItem[];
+    const rest = groupsAll.filter((g) => !pinnedSet.has(conversationKey(g)));
+    return [...pinned, ...rest];
+  }, [groupsAll, pinnedKeys, pinnedSet]);
+
+  const agents = useMemo(() => {
+    const byKey = new Map(agentsAll.map((a) => [conversationKey(a), a] as const));
+    const pinned = pinnedKeys
+      .filter((k) => k.startsWith("agent:"))
+      .map((k) => byKey.get(k))
+      .filter(Boolean) as ConversationItem[];
+    const rest = agentsAll.filter((a) => !pinnedSet.has(conversationKey(a)));
+    return [...pinned, ...rest];
+  }, [agentsAll, pinnedKeys, pinnedSet]);
 
   const groupsPendingTotal = groups.reduce((sum, g) => sum + g.pendingCount, 0);
   const agentsPendingTotal = agents.reduce((sum, a) => sum + a.pendingCount, 0);
@@ -445,7 +499,7 @@ export function ConversationList({
 
   useEffect(() => {
     if (pendingDelete.length > 0) {
-      setUndoToastKey((v) => v + 1);
+      queueMicrotask(() => setUndoToastKey((v) => v + 1));
     }
   }, [pendingDelete.length]);
 
@@ -768,6 +822,7 @@ export function ConversationList({
                       item={item}
                       avatarUrl={avatarUrlMap[`group:${item.id}`]}
                       isSelected={selectedId === item.id && selectedType === "group"}
+                      isPinned={pinnedSet.has(conversationKey(item))}
                       bulkMode={bulkMode}
                       checked={selectedKeys.has(conversationKey(item))}
                       onToggleChecked={() => toggleSelected(conversationKey(item))}
@@ -810,6 +865,7 @@ export function ConversationList({
                       item={item}
                       avatarUrl={avatarUrlMap[`agent:${item.id}`]}
                       isSelected={selectedId === item.id && selectedType === "agent"}
+                      isPinned={pinnedSet.has(conversationKey(item))}
                       bulkMode={bulkMode}
                       checked={selectedKeys.has(conversationKey(item))}
                       onToggleChecked={() => toggleSelected(conversationKey(item))}
@@ -934,6 +990,32 @@ export function ConversationList({
           style={{ left: menu.x, top: menu.y }}
           onPointerDown={(e) => e.stopPropagation()}
         >
+          {(() => {
+            const isPinned = pinnedSet.has(menu.key);
+            return (
+              <button
+                className="w-full rounded-lg px-3 py-2 text-left text-sm hover:bg-accent"
+                onClick={async () => {
+                  const key = menu.key;
+                  setMenu({ open: false });
+                  if (!key) return;
+                  if (isPinned) {
+                    await unpinConversationByKey(key, view);
+                    setPinnedKeys((prev) => prev.filter((k) => k !== key));
+                    return;
+                  }
+                  await pinConversationByKey(key, view);
+                  setPinnedKeys((prev) => (prev.includes(key) ? prev : [...prev, key]));
+                }}
+              >
+                <span className="inline-flex items-center gap-2">
+                  <Pin className="h-4 w-4" />
+                  {isPinned ? "Unpin" : "Pin"}
+                </span>
+              </button>
+            );
+          })()}
+
           {view === "archived" ? (
             <button
               className="w-full rounded-lg px-3 py-2 text-left text-sm hover:bg-accent disabled:opacity-50"
@@ -1031,7 +1113,6 @@ export function ConversationList({
                 try {
                   await setUserConfig({ sound_enabled: next });
                 } catch {
-                  // ignore
                 }
                 window.dispatchEvent(
                   new CustomEvent("cue-console:configUpdated", {
@@ -1043,6 +1124,63 @@ export function ConversationList({
               {soundEnabled ? "On" : "Off"}
             </Button>
           </div>
+
+          <div className="mt-4 flex items-center justify-between gap-3">
+            <div className="min-w-0">
+              <div className="text-sm font-medium">Default conversation mode</div>
+              <div className="text-xs text-muted-foreground truncate">
+                Used when opening cue-console (unless a last-used mode exists)
+              </div>
+            </div>
+            <div className="flex items-center gap-2">
+              <Button
+                type="button"
+                variant={conversationModeDefault === "chat" ? "default" : "outline"}
+                onClick={async () => {
+                  const next = "chat" as const;
+                  setConversationModeDefault(next);
+                  try {
+                    await setUserConfig({ conversation_mode_default: next });
+                  } catch {
+                  }
+                  try {
+                    window.localStorage.setItem("cue-console:conversationModeDefault", next);
+                  } catch {
+                  }
+                  window.dispatchEvent(
+                    new CustomEvent("cue-console:configUpdated", {
+                      detail: { conversation_mode_default: next },
+                    })
+                  );
+                }}
+              >
+                Chat
+              </Button>
+              <Button
+                type="button"
+                variant={conversationModeDefault === "agent" ? "default" : "outline"}
+                onClick={async () => {
+                  const next = "agent" as const;
+                  setConversationModeDefault(next);
+                  try {
+                    await setUserConfig({ conversation_mode_default: next });
+                  } catch {
+                  }
+                  try {
+                    window.localStorage.setItem("cue-console:conversationModeDefault", next);
+                  } catch {
+                  }
+                  window.dispatchEvent(
+                    new CustomEvent("cue-console:configUpdated", {
+                      detail: { conversation_mode_default: next },
+                    })
+                  );
+                }}
+              >
+                Agent
+              </Button>
+            </div>
+          </div>
         </DialogContent>
       </Dialog>
 
@@ -1131,6 +1269,7 @@ function ConversationItemCard({
   item,
   avatarUrl,
   isSelected,
+  isPinned,
   onClick,
   bulkMode,
   checked,
@@ -1140,6 +1279,7 @@ function ConversationItemCard({
   item: ConversationItem;
   avatarUrl?: string;
   isSelected: boolean;
+  isPinned?: boolean;
   onClick: () => void;
   bulkMode?: boolean;
   checked?: boolean;
@@ -1155,7 +1295,9 @@ function ConversationItemCard({
         "backdrop-blur-sm",
         isSelected
           ? "bg-primary/10 text-accent-foreground shadow-sm"
-          : "hover:bg-white/40"
+          : isPinned
+            ? "bg-amber-200/15 hover:bg-amber-200/20"
+            : "hover:bg-white/40"
       )}
       onClick={onClick}
     >
@@ -1183,7 +1325,10 @@ function ConversationItemCard({
       </span>
       <div className="flex-1 min-w-0">
         <div className="flex items-center justify-between gap-2">
-          <span className="text-sm font-medium leading-5">{truncateText(item.displayName, 18)}</span>
+          <span className="inline-flex items-center gap-1.5 text-sm font-medium leading-5">
+            {isPinned && <Pin className="h-3.5 w-3.5 shrink-0 text-amber-600/80" />}
+            {truncateText(item.displayName, 18)}
+          </span>
           {item.lastTime && (
             <span className="text-[11px] text-muted-foreground shrink-0">
               {formatTime(item.lastTime)}

package/src/components/payload-card/form-view.tsx

@@ -4,8 +4,6 @@ import { useState } from "react";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import { cn } from "@/lib/utils";
-
-import type { OnPasteChoice, ParsedViewModel } from "./types";
 import {
   fieldDisplayName,
   findFieldLine,
@@ -13,6 +11,7 @@ import {
   parseMultiValues,
   toggleValue,
 } from "./utils";
+import type { OnPasteChoice, ParsedViewModel, ParsedChoice } from "./types";
 
 export function PayloadFormView({
   vm,
@@ -100,7 +99,7 @@ export function PayloadFormView({
             {options.length > 0 ? (
               <div className="grid grid-cols-1 gap-2">
                 {options.map((opt, oidx) => {
-                  const value = formatChoiceLabel(opt as any);
+                  const value = formatChoiceLabel(opt as ParsedChoice);
                   const title = value ? `Click to select: ${fieldKey}: ${value}` : undefined;
                   const isSelected = allowMultiple && !!value && currentSet.has(value);
                   return (

package/src/contexts/input-context.tsx

@@ -1,11 +1,17 @@
+"use client";
+
 import { createContext, useContext, useState, type ReactNode } from "react";
 import type { ImageAttachment } from "@/types/chat";
 
+type ConversationMode = "chat" | "agent";
+
 interface InputContextValue {
   input: string;
   images: ImageAttachment[];
+  conversationMode: ConversationMode;
   setInput: React.Dispatch<React.SetStateAction<string>>;
   setImages: React.Dispatch<React.SetStateAction<ImageAttachment[]>>;
+  setConversationMode: (mode: ConversationMode) => void;
 }
 
 const InputContext = createContext<InputContextValue | null>(null);
@@ -25,12 +31,32 @@ interface InputProviderProps {
 export function InputProvider({ children }: InputProviderProps) {
   const [input, setInput] = useState("");
   const [images, setImages] = useState<ImageAttachment[]>([]);
+  const [conversationMode, setConversationModeState] = useState<ConversationMode>(() => {
+    try {
+      const last = window.localStorage.getItem("cue-console:conversationMode");
+      if (last === "agent" || last === "chat") return last;
+      const def = window.localStorage.getItem("cue-console:conversationModeDefault");
+      return def === "agent" || def === "chat" ? def : "agent";
+    } catch {
+      return "agent";
+    }
+  });
+
+  const setConversationMode = (mode: ConversationMode) => {
+    setConversationModeState(mode);
+    try {
+      window.localStorage.setItem("cue-console:conversationMode", mode);
+    } catch {
+    }
+  };
 
   const value: InputContextValue = {
     input,
     images,
+    conversationMode,
     setInput,
     setImages,
+    setConversationMode,
   };
 
   return <InputContext.Provider value={value}>{children}</InputContext.Provider>;

package/src/hooks/use-conversation-timeline.ts

@@ -7,6 +7,7 @@ import {
   fetchGroupTimeline,
   type AgentTimelineItem,
   type CueRequest,
+  type QueuedMessage,
 } from "@/lib/actions";
 
 export function useConversationTimeline({
@@ -29,7 +30,7 @@ export function useConversationTimeline({
   onBootstrap: (res: {
     members: string[];
     agentNameMap: Record<string, string>;
-    queue: any[];
+    queue: QueuedMessage[];
     timeline: { items: AgentTimelineItem[]; nextCursor: string | null };
   }) => void;
   isPauseRequest: (req: CueRequest) => boolean;

package/src/hooks/use-file-handler.ts

@@ -4,6 +4,8 @@ import { handleError, logError } from "@/lib/error-handler";
 import { useInputContext } from "@/contexts/input-context";
 import { useUIStateContext } from "@/contexts/ui-state-context";
 
+type InlineAttachment = Awaited<ReturnType<typeof fileToInlineAttachment>>;
+
 interface UseFileHandlerParams {
   inputWrapRef: React.RefObject<HTMLDivElement | null>;
 }
@@ -23,7 +25,7 @@ export function useFileHandler({ inputWrapRef }: UseFileHandlerParams) {
 
       const successful = results
         .filter((r) => r.status === "fulfilled")
-        .map((r) => (r as PromiseFulfilledResult<any>).value);
+        .map((r) => (r as PromiseFulfilledResult<InlineAttachment>).value);
 
       results.forEach((r, i) => {
         if (r.status === "rejected") {

package/src/hooks/use-mentions.ts

@@ -321,7 +321,7 @@ export function useMentions({
     const queryChanged = prevMentionQueryRef.current !== mentionQuery;
     if (queryChanged) {
       shouldAutoScrollMentionRef.current = true;
-      setMentionActive(0);
+      queueMicrotask(() => setMentionActive(0));
       el.scrollTop = 0;
       mentionScrollTopRef.current = 0;
     }

package/src/hooks/use-message-sender.ts

@@ -14,7 +14,7 @@ interface UseMessageSenderParams {
 }
 
 export function useMessageSender({ type, pendingRequests, mentions, onSuccess }: UseMessageSenderParams) {
-  const { input, images, setInput, setImages } = useInputContext();
+  const { input, images, conversationMode, setInput, setImages } = useInputContext();
   const { busy, setBusy, setError } = useUIStateContext();
   const imagesRef = useRef(images);
   
@@ -46,18 +46,27 @@ export function useMessageSender({ type, pendingRequests, mentions, onSuccess }:
 
     try {
       let result;
+
+      const analysisOnlyInstruction =
+        "只做分析，不要对代码/文件做任何改动。";
+      const textToSend =
+        conversationMode === "chat"
+          ? input.trim().length > 0
+            ? `${input}\n\n${analysisOnlyInstruction}`
+            : analysisOnlyInstruction
+          : input;
       
       if (type === "agent" && targets.targetRequests.length === 1) {
         result = await submitResponse(
           targets.targetRequests[0].request_id,
-          input,
+          textToSend,
           currentImages,
           mentions
         );
       } else {
         result = await batchRespond(
           targets.targetRequests.map((r) => r.request_id),
-          input,
+          textToSend,
           currentImages,
           mentions
         );
@@ -78,7 +87,7 @@ export function useMessageSender({ type, pendingRequests, mentions, onSuccess }:
     } finally {
       setBusy(false);
     }
-  }, [type, input, mentions, pendingRequests, busy, setBusy, setError, setInput, setImages, onSuccess]);
+  }, [type, input, conversationMode, mentions, pendingRequests, busy, setBusy, setError, setInput, setImages, onSuccess]);
 
   return { send };
 }

package/src/lib/actions.ts

@@ -43,6 +43,9 @@ import {
   getLastRequestsByAgents,
   getLastResponsesByAgents,
   getPendingCountsByAgents,
+  pinConversation,
+  unpinConversation,
+  listPinnedConversations,
   type ConversationType,
   type CueResponse,
 } from "./db";
@@ -55,6 +58,7 @@ import { v4 as uuidv4 } from "uuid";
 
 export type UserConfig = {
   sound_enabled: boolean;
+  conversation_mode_default: "chat" | "agent";
 };
 
 export type QueuedMessage = {
@@ -66,6 +70,7 @@ export type QueuedMessage = {
 
 const defaultUserConfig: UserConfig = {
   sound_enabled: true,
+  conversation_mode_default: "agent",
 };
 
 function getUserConfigPath(): string {
@@ -82,6 +87,10 @@ export async function getUserConfig(): Promise<UserConfig> {
         typeof parsed.sound_enabled === "boolean"
           ? parsed.sound_enabled
           : defaultUserConfig.sound_enabled,
+      conversation_mode_default:
+        parsed.conversation_mode_default === "chat" || parsed.conversation_mode_default === "agent"
+          ? parsed.conversation_mode_default
+          : defaultUserConfig.conversation_mode_default,
     };
   } catch {
     return defaultUserConfig;
@@ -93,6 +102,10 @@ export async function setUserConfig(next: Partial<UserConfig>): Promise<UserConf
   const merged: UserConfig = {
     sound_enabled:
       typeof next.sound_enabled === "boolean" ? next.sound_enabled : prev.sound_enabled,
+    conversation_mode_default:
+      next.conversation_mode_default === "chat" || next.conversation_mode_default === "agent"
+        ? next.conversation_mode_default
+        : prev.conversation_mode_default,
   };
   const p = getUserConfigPath();
   await fs.mkdir(path.dirname(p), { recursive: true });
@@ -155,6 +168,25 @@ function parseConversationKey(key: string): { type: "agent" | "group"; id: strin
   return { type, id };
 }
 
+export async function pinConversationByKey(key: string, view: "active" | "archived") {
+  const parsed = parseConversationKey(key);
+  if (!parsed) return { success: false, error: "Invalid conversation key" } as const;
+  pinConversation(parsed.type, parsed.id, view);
+  return { success: true } as const;
+}
+
+export async function unpinConversationByKey(key: string, view: "active" | "archived") {
+  const parsed = parseConversationKey(key);
+  if (!parsed) return { success: false, error: "Invalid conversation key" } as const;
+  unpinConversation(parsed.type, parsed.id, view);
+  return { success: true } as const;
+}
+
+export async function fetchPinnedConversationKeys(view: "active" | "archived"): Promise<string[]> {
+  const rows = listPinnedConversations(view);
+  return rows.map((r) => `${r.conv_type}:${r.conv_id}`);
+}
+
 export async function archiveConversations(keys: string[]) {
   const unique = Array.from(new Set(keys));
   for (const k of unique) {

package/src/lib/avatar.ts

@@ -114,7 +114,7 @@ export async function thumbsAvatarDataUrl(seed: string): Promise<string> {
 
   const t1 = perfEnabled() ? performance.now() : 0;
 
-  const svg = createAvatar(thumbsStyle as any, {
+  const svg = createAvatar(thumbsStyle, {
     seed,
   }).toString();
 

package/src/lib/db.ts

@@ -217,7 +217,7 @@ function initTables() {
     .prepare(`SELECT value FROM schema_meta WHERE key = ?`)
     .get("schema_version") as { value?: string } | undefined;
   const version = String(versionRow?.value ?? "");
-  if (version !== "2") {
+  if (version !== "3") {
     const reqCountRow = database.prepare(`SELECT COUNT(*) as n FROM cue_requests`).get() as { n: number };
     const respCountRow = database.prepare(`SELECT COUNT(*) as n FROM cue_responses`).get() as { n: number };
     const reqCount = Number(reqCountRow?.n ?? 0);
@@ -225,7 +225,7 @@ function initTables() {
     if (reqCount === 0 && respCount === 0) {
       database
         .prepare(`INSERT INTO schema_meta (key, value) VALUES (?, ?)`)
-        .run("schema_version", "2");
+        .run("schema_version", "3");
     } else {
       throw new Error(
         "Database schema is outdated (pre-file storage). Please migrate: cueme migrate\n" +
@@ -266,6 +266,17 @@ function initTables() {
     )
   `);
 
+  database.exec(`
+    CREATE TABLE IF NOT EXISTS conversation_pins (
+      conv_type TEXT NOT NULL,
+      conv_id TEXT NOT NULL,
+      view TEXT NOT NULL,
+      pin_order INTEGER PRIMARY KEY AUTOINCREMENT,
+      pinned_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE(conv_type, conv_id, view)
+    )
+  `);
+
   database.exec(`
     CREATE TABLE IF NOT EXISTS worker_leases (
       lease_key TEXT PRIMARY KEY,
@@ -303,6 +314,45 @@ function initTables() {
   `);
 }
 
+export function pinConversation(convType: ConversationType, convId: string, view: "active" | "archived"): void {
+  const t = String(convType || "").trim();
+  const id = String(convId || "").trim();
+  const v = view === "archived" ? "archived" : "active";
+  if (!id) return;
+  getDb()
+    .prepare(
+      `INSERT OR IGNORE INTO conversation_pins (conv_type, conv_id, view)
+       VALUES (?, ?, ?)`
+    )
+    .run(t, id, v);
+}
+
+export function unpinConversation(convType: ConversationType, convId: string, view: "active" | "archived"): void {
+  const t = String(convType || "").trim();
+  const id = String(convId || "").trim();
+  const v = view === "archived" ? "archived" : "active";
+  if (!id) return;
+  getDb()
+    .prepare(
+      `DELETE FROM conversation_pins
+       WHERE conv_type = ? AND conv_id = ? AND view = ?`
+    )
+    .run(t, id, v);
+}
+
+export function listPinnedConversations(view: "active" | "archived"): Array<{ conv_type: ConversationType; conv_id: string }> {
+  const v = view === "archived" ? "archived" : "active";
+  const rows = getDb()
+    .prepare(
+      `SELECT conv_type, conv_id
+       FROM conversation_pins
+       WHERE view = ?
+       ORDER BY pin_order ASC`
+    )
+    .all(v) as Array<{ conv_type: ConversationType; conv_id: string }>;
+  return rows || [];
+}
+
 function nowIso(): string {
   return formatLocalIsoWithOffset(new Date());
 }

package/src/lib/error-handler.ts

@@ -33,7 +33,7 @@ export function logError(error: unknown, context?: string): void {
   console.error(`${prefix} ${message}`, error);
 }
 
-export function withErrorHandling<T extends (...args: any[]) => Promise<any>>(
+export function withErrorHandling<T extends (...args: unknown[]) => Promise<unknown>>(
   fn: T,
   context: string
 ): T {