chatccc 0.2.272 → 0.2.276

package/dist/src/cards.js

@@ -139,6 +139,8 @@ export function buildHelpCard(userText, opts = {}) {
         "发送 **/new ccc** 创建新 CCC Agent 会话",
         "发送 **/new dsh** 创建新 DeepSeek Harness 会话",
         "发送 **/forget** 重置当前会话（忘掉上下文，沿用当前工作目录，不切换）",
+        "发送 **/rename 名称** 修改会话展示标题（不会修改群名）",
+        "发送 **/sessions 关键词** 搜索会话，**/pin** 置顶，**/archive** 归档",
         "发送 **/plan** 以规划模式提问（只读，不执行写操作）",
         "发送 **/ask** 以问答模式提问（只读，不执行写操作）",
         "发送 **/usage** 查看当前 Agent 的用量或余额",
@@ -308,7 +310,8 @@ export function buildSessionsCard(sessions, opts = {}) {
             extra = ` | 本轮: ${mins}分${secs}秒`;
         }
         const toolLabel = sessionToolLabel(s.tool);
-        const namePart = s.chatName ? `**${s.chatName}** ` : "";
+        const title = s.displayTitle || s.chatName;
+        const namePart = title ? `${s.pinned ? "📌 " : ""}**${title}** ` : "";
         const chatTag = !s.chatId
             ? " (chat id缺失)"
             : s.chatType === "p2p"
@@ -316,7 +319,7 @@ export function buildSessionsCard(sessions, opts = {}) {
                 : s.chatType === "group" || (s.chatType == null && s.chatId.startsWith("oc_"))
                     ? " (群聊)"
                     : "";
-        return `**${i + 1}.** ${namePart}${chatTag} \`${shortId}\` ${status} | 工具: ${toolLabel} | 轮数: ${s.turnCount} | ${s.model}${extra}`;
+        return `**${i + 1}.** ${namePart}${chatTag}${s.archivedAt ? " (已归档)" : ""} \`${shortId}\` ${status} | 工具: ${toolLabel} | 轮数: ${s.turnCount} | ${s.model}${extra}`;
     };
     const lines = [`共 **${sessions.length}** 个会话:`, ""];
     const idx = { value: 0 };
@@ -337,8 +340,8 @@ export function buildSessionsCard(sessions, opts = {}) {
             { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
             { tag: "hr" },
             { tag: "div", text: { tag: "lark_md", content: fixedPrivateSession
-                        ? "当前飞书私聊使用专属会话；默认 Agent 变化后，下一条普通消息会自动创建对应 Agent 的新空会话。发送 **/forget** 可在私聊中原地重置（忘掉当前上下文）。群聊会话请回到对应群聊继续，私聊不支持 **/session** 切换。"
-                        : "在会话群内发送 **/forget** 可重置当前会话（忘掉上下文，创建新 Session，保留工作目录和群聊）。\n发送 **/session 数字**（如 `/session 1`）可将当前群聊切换到列表中对应编号的会话。" } },
+                        ? "当前飞书私聊使用专属会话；默认 Agent 变化后，下一条普通消息会自动创建对应 Agent 的新空会话。发送 **/rename 名称** 修改展示标题，**/pin** 置顶，**/archive** 归档，**/sessions 关键词** 搜索。发送 **/forget** 可在私聊中原地重置；群聊会话请回到对应群聊继续，私聊不支持 **/session** 切换。"
+                        : "发送 **/rename 名称** 修改展示标题，**/pin** 置顶，**/archive** 归档，**/sessions 关键词** 搜索，**/sessions --archived** 查看归档。\n发送 **/session 数字** 可切换到最近一次列表中对应编号的会话；**/forget** 会保留群聊和工作目录并创建新 Session。" } },
             { tag: "hr" },
             {
                 tag: "action",

package/dist/src/im-skills.js

@@ -1,7 +1,14 @@
 import { readdir, readFile, mkdir, writeFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
 import { join, dirname } from "node:path";
 import { PROJECT_ROOT } from "./config.js";
 export const DEFAULT_IM_SKILLS_DIR = join(PROJECT_ROOT, "im-skills");
+export function sessionImSkillsCacheDir(cacheRoot, sessionId) {
+    if (!sessionId)
+        throw new Error("sessionId is required for the IM skills cache");
+    const sessionKey = createHash("sha256").update(sessionId, "utf8").digest("hex").slice(0, 24);
+    return join(cacheRoot, sessionKey);
+}
 function renderTemplate(template, variables) {
     return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_match, key) => {
         return variables[key] ?? "";
@@ -56,8 +63,8 @@ function promptCacheKey(input) {
     const names = input.enabledSkillNames
         ? [...input.enabledSkillNames].sort().join(",")
         : "*";
-    const { session_id, cwd, open_id } = input.variables;
-    return `${input.skillsDir ?? DEFAULT_IM_SKILLS_DIR}|${names}|${session_id}|${cwd}|${open_id}`;
+    const { session_id, cwd, open_id, agent_capability_grant } = input.variables;
+    return `${input.skillsDir ?? DEFAULT_IM_SKILLS_DIR}|${names}|${session_id}|${cwd}|${open_id}|${agent_capability_grant}`;
 }
 /** 带会话级缓存的 buildImSkillsPrompt。同 session + 同 cwd 时直接返回缓存的渲染结果。 */
 export async function buildImSkillsPromptCached(input) {

package/dist/src/orchestrator.js

@@ -16,13 +16,13 @@ import { appendStartupTrace } from "./shared.js";
 import { CLAUDE_MODEL, GIT_TIMEOUT_MS, PROJECT_ROOT, anthropicConfigDisplay, config, fileLog, getAllEffortsForTool, getAllModelsForTool, getDefaultEffortForTool, getDefaultCwd, LOG_DIR, setDefaultCwd, getRecentDirs, addRecentDir, resolveDefaultAgentTool, sessionPrefixForTool, toolDisplayName, ts, } from "./config.js";
 import { buildHelpCard, buildEffortCard, buildFastModeCard, buildModelCard, buildStatusCard, buildCdContent, buildCdCard, buildSessionsCard, buildQueuedCard, buildQueueFullCard, buildCodexUsageCard, } from "./cards.js";
 import { formatGitResult, gitResultHeaderTemplate, runGitCommand, } from "./git-command.js";
-import { clearSessionModelOverride, clearSessionEffortOverride, getSessionStatus, getAllSessionsStatus, initClaudeSession, lastMsgTimestamps, resumeAndPrompt, sessionInfoMap, setSessionModelOverride, setSessionEffortOverride, switchChatBinding, recordSessionRegistry, getAdapterForTool, getEffectiveModelForTool, getEffectiveEffortForTool, getEffectiveFastModeForTool, setSessionFastModeOverride, stopSession, loadSessionRegistryForBinding, removeSessionRegistryRecord, saveSessionTool, recordChatPlatform, } from "./session.js";
+import { clearSessionModelOverride, clearSessionEffortOverride, getSessionStatus, getAllSessionsStatus, initClaudeSession, lastMsgTimestamps, resumeAndPrompt, sessionInfoMap, setSessionModelOverride, setSessionEffortOverride, switchChatBinding, recordSessionRegistry, getAdapterForTool, getEffectiveModelForTool, getEffectiveEffortForTool, getEffectiveFastModeForTool, setSessionFastModeOverride, stopSession, loadSessionRegistryForBinding, removeSessionRegistryRecord, saveSessionTool, saveSessionPresentation, recordChatPlatform, } from "./session.js";
 import { bindChatToSession, unbindChatFromSession, isSessionRunning, displayCards, enqueueMessage, cancelQueuedMessage, getSessionDrainSnapshot, } from "./session-chat-binding.js";
 import { getCodexUsageSummary, getTenantAccessToken, sendPostMessage } from "./feishu-platform.js";
 import { getCursorUsageSummary } from "./cursor-usage.js";
 import { getChatGptSubscriptionStatus } from "./chatgpt-subscription.js";
 import { applySharedPrefix } from "./shared-prefix.js";
-import { sessionChatName } from "./session-name.js";
+import { normalizeSessionDisplayTitle, sessionChatName, sessionDisplayTitleFromPrompt, } from "./session-name.js";
 import { reloadRuntimeConfig } from "./runtime-reload.js";
 import { acquireUpdateCommandGuard } from "./update-command-guard.js";
 import { createInternalRestartEnv, INTERNAL_RESTART_ENV_VAR } from "./startup-lifecycle.js";
@@ -417,6 +417,21 @@ async function sendUsageError(platform, chatId, tool, err) {
 function isUntitledSessionChatName(name) {
     return name === "新会话" || name.startsWith("新会话-");
 }
+const sessionListViews = new Map();
+function orderSessionsForCard(sessions) {
+    const tools = ["claude", "cursor", "codex", "ccc", "dsh"];
+    return tools.flatMap((tool) => sessions.filter((session) => session.tool === tool));
+}
+function parseSessionsCommand(text) {
+    const raw = text.trim().slice("/sessions".length).trim();
+    if (!raw)
+        return {};
+    if (raw === "--archived")
+        return { includeArchived: true, archivedOnly: true };
+    if (raw.startsWith("--all"))
+        return { includeArchived: true, query: raw.slice("--all".length).trim() || undefined };
+    return { query: raw };
+}
 async function fixedSessionChatName(chatId) {
     const registry = await loadSessionRegistryForBinding();
     const record = registry[chatId];
@@ -904,8 +919,8 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
         logTrace(tid, "DONE", { outcome: canceled ? "safe_maintenance_canceled" : "safe_maintenance_cancel_unavailable" });
         return;
     }
-    if (isCommandText && normalizedCommandText === "/restart safe") {
-        logTrace(tid, "BRANCH", { cmd: "/restart safe" });
+    if (isCommandText && ["/restart safe", "/restartsf"].includes(normalizedCommandText)) {
+        logTrace(tid, "BRANCH", { cmd: "/restart safe", alias: normalizedCommandText });
         try {
             const job = await safeMaintenanceCoordinator.schedule("restart", safeMaintenanceRequester(platform, chatId, openId));
             await platform.sendText(chatId, job.phase === "executing"
@@ -921,8 +936,8 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
         }
         return;
     }
-    if (isCommandText && normalizedCommandText === "/update safe") {
-        logTrace(tid, "BRANCH", { cmd: "/update safe" });
+    if (isCommandText && ["/update safe", "/updatesf"].includes(normalizedCommandText)) {
+        logTrace(tid, "BRANCH", { cmd: "/update safe", alias: normalizedCommandText });
         const isGlobal = isRunningFromGlobalNpm();
         if (!isGlobal) {
             await platform.sendText(chatId, "当前进程非 npm 全局安装，无法使用 /update safe。请通过 npm install -g chatccc 安装后使用。").catch(() => { });
@@ -951,11 +966,14 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
         return;
     }
     const maintenanceAllowedCommands = new Set([
-        "/stop", "/cancel", "/state", "/sessions", "/usage", "/safestatus", "/cancelsf", "/restart", "/update", "/reload", "/help",
+        "/stop", "/cancel", "/state", "/sessions", "/usage", "/safestatus", "/cancelsf", "/restart", "/restartsf", "/update", "/updatesf", "/reload", "/help",
+        "/pin", "/unpin", "/archive", "/unarchive",
     ]);
+    const maintenancePresentationCommand = normalizedCommandText.startsWith("/rename ")
+        || normalizedCommandText.startsWith("/sessions ");
     if (isSafeMaintenanceAdmissionClosed()
         && !acceptedBeforeSafeMaintenance
-        && (!isCommandText || !maintenanceAllowedCommands.has(normalizedCommandText))) {
+        && (!isCommandText || (!maintenanceAllowedCommands.has(normalizedCommandText) && !maintenancePresentationCommand))) {
         await platform.sendText(chatId, "ChatCCC 正在等待安全重启或更新，当前不接受新的任务。请在维护完成后重新发送；可用 /safestatus 查看状态。").catch(() => { });
         logTrace(tid, "DONE", { outcome: "safe_maintenance_admission_closed" });
         return;
@@ -1513,6 +1531,27 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
                 console.error(`[${ts()}] [RENAME] ${platform.kind} P2P failed: ${err.message}`);
             }
         }
+        // Display titles are independent from chatName. Preserve the existing IM
+        // group-name behavior while giving session lists a durable user-facing title.
+        if (!isCommandText) {
+            try {
+                const registry = await loadSessionRegistryForBinding();
+                const current = registry[chatId];
+                if (current && !current.displayTitle && current.namePolicy !== "fixed") {
+                    const displayTitle = sessionDisplayTitleFromPrompt(text);
+                    await recordSessionRegistry({
+                        chatId,
+                        sessionId,
+                        tool: descriptionTool,
+                        displayTitle,
+                    });
+                    await saveSessionPresentation(sessionId, { displayTitle });
+                }
+            }
+            catch (err) {
+                console.error(`[${ts()}] [SESSION-TITLE] auto title failed: ${err.message}`);
+            }
+        }
         if (isCommandText && textLower === "/stop") {
             logTrace(tid, "BRANCH", { cmd: "/stop" });
             if (stopSession(sessionId)) {
@@ -1582,13 +1621,55 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
             await sendStateCard(platform, chatId, sessionId, toolLabel, tid);
             return;
         }
-        if (isCommandText && textLower === "/sessions") {
-            logTrace(tid, "BRANCH", { cmd: "/sessions" });
-            const allSessions = await getAllSessionsStatus();
+        const renameMatch = isCommandText ? text.trim().match(/^\/rename(?:\s+(.+))?$/i) : null;
+        if (renameMatch) {
+            logTrace(tid, "BRANCH", { cmd: "/rename" });
+            if (!renameMatch[1]) {
+                const registry = await loadSessionRegistryForBinding();
+                const currentTitle = registry[chatId]?.displayTitle || registry[chatId]?.chatName || "（未命名）";
+                await platform.sendText(chatId, `当前会话标题：${currentTitle}\n用法：/rename 新名称`).catch(() => { });
+                return;
+            }
+            try {
+                const displayTitle = normalizeSessionDisplayTitle(renameMatch[1]);
+                await recordSessionRegistry({ chatId, sessionId, tool: descriptionTool, displayTitle });
+                await saveSessionPresentation(sessionId, { displayTitle });
+                await platform.sendText(chatId, `会话标题已更新为：${displayTitle}\n群名保持不变。`).catch(() => { });
+                logTrace(tid, "DONE", { outcome: "rename_session", displayTitle });
+            }
+            catch (err) {
+                await platform.sendText(chatId, `会话重命名失败：${err.message}`).catch(() => { });
+            }
+            return;
+        }
+        if (isCommandText && ["/pin", "/unpin", "/archive", "/unarchive"].includes(textLower)) {
+            const registry = await loadSessionRegistryForBinding();
+            const current = registry[chatId];
+            const pinned = textLower === "/pin" ? true : textLower === "/unpin" ? false : current?.pinned;
+            const archivedAt = textLower === "/archive" ? Date.now() : textLower === "/unarchive" ? null : current?.archivedAt;
+            await recordSessionRegistry({ chatId, sessionId, tool: descriptionTool, pinned, archivedAt });
+            await saveSessionPresentation(sessionId, { pinned, archivedAt });
+            const message = textLower === "/pin" ? "会话已置顶。"
+                : textLower === "/unpin" ? "会话已取消置顶。"
+                    : textLower === "/archive" ? "会话已归档；可用 /sessions --archived 查看。"
+                        : "会话已取消归档。";
+            await platform.sendText(chatId, message).catch(() => { });
+            logTrace(tid, "DONE", { outcome: textLower.slice(1) });
+            return;
+        }
+        if (isCommandText && (textLower === "/sessions" || textLower.startsWith("/sessions "))) {
+            const listOptions = parseSessionsCommand(text);
+            logTrace(tid, "BRANCH", { cmd: "/sessions", ...listOptions });
+            const allSessions = await getAllSessionsStatus(listOptions);
+            const orderedSessions = orderSessionsForCard(allSessions);
+            sessionListViews.set(chatId, orderedSessions.map((session) => session.sessionId));
             const now = Date.now();
-            const cardData = allSessions.map((s) => ({
+            const cardData = orderedSessions.map((s) => ({
                 sessionId: s.sessionId,
                 chatName: s.chatName,
+                displayTitle: s.displayTitle,
+                pinned: s.pinned,
+                archivedAt: s.archivedAt,
                 chatId: s.chatId,
                 chatType: s.chatType,
                 active: s.active,
@@ -1719,19 +1800,12 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
             }
             const index = parseInt(sessionMatch[1], 10) - 1;
             logTrace(tid, "BRANCH", { cmd: "/session", index: index + 1 });
-            const allSessions = await getAllSessionsStatus();
-            const claudeOrdered = allSessions.filter((s) => s.tool === "claude");
-            const cursorOrdered = allSessions.filter((s) => s.tool === "cursor");
-            const codexOrdered = allSessions.filter((s) => s.tool === "codex");
-            const cccOrdered = allSessions.filter((s) => s.tool === "ccc");
-            const dshOrdered = allSessions.filter((s) => s.tool === "dsh");
-            const ordered = [
-                ...claudeOrdered,
-                ...cursorOrdered,
-                ...codexOrdered,
-                ...cccOrdered,
-                ...dshOrdered,
-            ];
+            const viewIds = sessionListViews.get(chatId);
+            const allSessions = await getAllSessionsStatus({ includeArchived: true, limit: 100 });
+            const byId = new Map(allSessions.map((session) => [session.sessionId, session]));
+            const ordered = viewIds !== undefined
+                ? viewIds.map((sessionId) => byId.get(sessionId)).filter((session) => !!session)
+                : orderSessionsForCard(allSessions.filter((session) => !session.archivedAt).slice(0, 20));
             if (ordered.length === 0) {
                 await platform.sendCard(chatId, "/session", "暂无历史会话。", "yellow");
                 logTrace(tid, "DONE", { outcome: "session_no_sessions" });
@@ -1773,6 +1847,9 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
                 tool: target.tool,
                 chatName: newName2,
                 namePolicy: fixedName2 ? "fixed" : "auto",
+                displayTitle: target.displayTitle,
+                pinned: target.pinned,
+                archivedAt: target.archivedAt ?? null,
                 newDescription: `${descPrefix2} ${target.sessionId}`,
                 initialTurnCount: target.turnCount,
                 initialContextTokens: 0,
@@ -2217,13 +2294,24 @@ async function handleCommandInternal(platform, text, chatId, openId, msgTimestam
         logTrace(tid, "DONE", { outcome: "effort_no_session", defaultTool });
         return;
     }
-    if (isCommandText && textLower === "/sessions") {
-        logTrace(tid, "BRANCH", { cmd: "/sessions", scope: "global" });
-        const allSessions = await getAllSessionsStatus();
+    if (isCommandText && (/^\/rename(?:\s|$)/.test(textLower) || ["/pin", "/unpin", "/archive", "/unarchive"].includes(textLower))) {
+        await platform.sendText(chatId, "当前没有绑定会话。请进入具体会话后再修改标题、置顶或归档状态。").catch(() => { });
+        logTrace(tid, "DONE", { outcome: "session_presentation_no_session" });
+        return;
+    }
+    if (isCommandText && (textLower === "/sessions" || textLower.startsWith("/sessions "))) {
+        const listOptions = parseSessionsCommand(text);
+        logTrace(tid, "BRANCH", { cmd: "/sessions", scope: "global", ...listOptions });
+        const allSessions = await getAllSessionsStatus(listOptions);
+        const orderedSessions = orderSessionsForCard(allSessions);
+        sessionListViews.set(chatId, orderedSessions.map((session) => session.sessionId));
         const now = Date.now();
-        const cardData = allSessions.map((s) => ({
+        const cardData = orderedSessions.map((s) => ({
             sessionId: s.sessionId,
             chatName: s.chatName,
+            displayTitle: s.displayTitle,
+            pinned: s.pinned,
+            archivedAt: s.archivedAt,
             chatId: s.chatId,
             chatType: s.chatType,
             active: s.active,

package/dist/src/session-name.js

@@ -5,3 +5,18 @@ export function cwdDisplayName(cwd) {
 export function sessionChatName(left, cwd) {
     return `${left}-${cwdDisplayName(cwd)}`;
 }
+/** Derive a deterministic user-facing title without changing the IM chat name. */
+export function sessionDisplayTitleFromPrompt(prompt, maxLength = 32) {
+    const normalized = prompt.replace(/\s+/g, " ").trim();
+    if (!normalized)
+        return "新会话";
+    return normalized.length <= maxLength ? normalized : `${normalized.slice(0, maxLength - 1)}…`;
+}
+export function normalizeSessionDisplayTitle(value, maxLength = 80) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (!normalized)
+        throw new Error("会话名称不能为空");
+    if (normalized.length > maxLength)
+        throw new Error(`会话名称不能超过 ${maxLength} 个字符`);
+    return normalized;
+}

package/dist/src/session.js

@@ -14,7 +14,8 @@ import { createCccAdapter } from "./adapters/ccc-adapter.js";
 import { createDshAdapter } from "./adapters/dsh-adapter.js";
 import { killProcessTree } from "./adapters/proc-tree-kill.js";
 import { resourceMonitor, registerProcess, unregisterProcess } from "./adapters/resource-monitor.js";
-import { buildImSkillsPromptCached, exportSkillSubDocs } from "./im-skills.js";
+import { buildImSkillsPromptCached, exportSkillSubDocs, sessionImSkillsCacheDir, } from "./im-skills.js";
+import { clearAgentCapabilityGrants, issueAgentCapabilityGrant, } from "./agent-capability-grants.js";
 import { hasResponseStalled, observeResponseProgress } from "./response-stall.js";
 import { classifyTerminalError, formatTerminalErrorNotice, formatTerminalErrorReason, } from "./terminal-error.js";
 import { MAX_PROCESSED, clearFeishuMessageLedgerMemory, processedMessages, } from "./feishu-message-ingress.js";
@@ -384,6 +385,7 @@ export function resetState() {
     sessionModelOverrides.clear();
     sessionEffortOverrides.clear();
     sessionFastModeOverrides.clear();
+    clearAgentCapabilityGrants();
     adapterCache.clear();
     stopUnifiedDisplayLoop();
     console.log(`[${ts()}] [RESET] State cleared (dedup + active sessions + bindings)`);
@@ -602,6 +604,22 @@ export async function saveSessionTool(sessionId, tool, chatName) {
         tool,
         createdAt: existing?.createdAt ?? Date.now(),
         ...(mergedChatName ? { chatName: mergedChatName } : {}),
+        ...(existing?.displayTitle ? { displayTitle: existing.displayTitle } : {}),
+        ...(existing?.pinned ? { pinned: true } : {}),
+        ...(existing?.archivedAt ? { archivedAt: existing.archivedAt } : {}),
+    };
+    await saveSessionTools(data);
+}
+export async function saveSessionPresentation(sessionId, patch) {
+    const data = await loadSessionTools();
+    const existing = data[sessionId];
+    if (!existing)
+        return;
+    data[sessionId] = {
+        ...existing,
+        ...(patch.displayTitle !== undefined ? { displayTitle: patch.displayTitle } : {}),
+        ...(patch.pinned !== undefined ? { pinned: patch.pinned } : {}),
+        ...(patch.archivedAt === null ? { archivedAt: undefined } : patch.archivedAt !== undefined ? { archivedAt: patch.archivedAt } : {}),
     };
     await saveSessionTools(data);
 }
@@ -674,6 +692,9 @@ export async function recordSessionRegistry(update) {
         tool: update.tool,
         chatType: update.chatType ?? existing?.chatType,
         chatName: update.chatName ?? existing?.chatName ?? "",
+        displayTitle: update.displayTitle ?? existing?.displayTitle,
+        pinned: update.pinned ?? existing?.pinned,
+        archivedAt: update.archivedAt === null ? undefined : update.archivedAt ?? existing?.archivedAt,
         namePolicy: update.namePolicy ?? existing?.namePolicy,
         turnCount: update.turnCount ?? existing?.turnCount ?? 0,
         lastContextTokens: update.lastContextTokens ?? existing?.lastContextTokens ?? 0,
@@ -809,7 +830,7 @@ export function accumulateBlockContent(block, state, toolCallMap) {
     }
 }
 export async function switchChatBinding(args) {
-    const { chatId, chatType, oldSessionId, newSessionId, tool, chatName, namePolicy, newDescription, initialTurnCount = 0, initialContextTokens = 0, updateChatInfoFn, } = args;
+    const { chatId, chatType, oldSessionId, newSessionId, tool, chatName, namePolicy, displayTitle, pinned, archivedAt, newDescription, initialTurnCount = 0, initialContextTokens = 0, updateChatInfoFn, } = args;
     // Step 1: 群聊场景先调用飞书 API（不可逆操作放最前）。
     // 私聊跳过——p2p chatId 调 updateChatInfo 必然失败。
     if (chatType !== "p2p") {
@@ -847,6 +868,9 @@ export async function switchChatBinding(args) {
         chatType,
         chatName,
         namePolicy,
+        displayTitle,
+        pinned,
+        archivedAt,
         turnCount: initialTurnCount,
         lastContextTokens: initialContextTokens,
         startTime: now,
@@ -992,16 +1016,18 @@ export async function runAgentSession(sessionId, userText, platform, _chatId, ms
         if (tid)
             logTrace(tid, "SESSION_START", { sessionId, tool, cwd, turn: (sessionInfoMap.get(_chatId)?.turnCount ?? 0) + 1 });
         console.log(`[${ts()}] Running ${adapter.displayName} session: ${sessionId} (${formatToolConfigForLog(tool, info?.model, sessionId)}, cwd=${cwd})`);
-        // 构建 IM skills prompt（sessionId 方式，无 token）
+        // 会话专属目录防止并发覆盖；capability grant 防止跨会话投递。
         const feishuSkillDir = join(PROJECT_ROOT, "im-skills", "feishu-skill");
         const wechatImageSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-image-skill");
         const wechatFileSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-file-skill");
         const wechatVideoSkillDir = join(PROJECT_ROOT, "im-skills", "wechat-video-skill");
-        const imSkillsCacheDir = join(USER_DATA_DIR, "im-skills");
+        const imSkillsCacheDir = sessionImSkillsCacheDir(join(USER_DATA_DIR, "im-skills"), sessionId);
+        const agentCapabilityGrant = issueAgentCapabilityGrant(sessionId);
         const skillVariables = {
             cwd,
             session_id: sessionId,
             open_id: options.initiatorOpenId,
+            agent_capability_grant: agentCapabilityGrant,
             im_skills_cache_dir: imSkillsCacheDir,
             delegate_task_url: `http://127.0.0.1:${CHATCCC_PORT}/api/agent/delegate-task`,
             set_cwd_url: `http://127.0.0.1:${CHATCCC_PORT}/api/agent/set-cwd`,
@@ -2141,7 +2167,7 @@ export async function getSessionStatus(chatId) {
         accumulatedLength,
     };
 }
-export async function getAllSessionsStatus() {
+export async function getAllSessionsStatus(options = {}) {
     const registry = await loadSessionRegistry();
     const registryEntries = Object.values(registry)
         .filter((record) => record.chatId && record.sessionId && record.tool)
@@ -2159,6 +2185,9 @@ export async function getAllSessionsStatus() {
             sessionId,
             tool: record.tool,
             chatName: record.chatName ?? "",
+            displayTitle: record.displayTitle ?? "",
+            pinned: record.pinned ?? false,
+            archivedAt: record.archivedAt,
             turnCount: 0,
             lastContextTokens: 0,
             startTime: active?.startTime ?? createdAt,
@@ -2167,9 +2196,13 @@ export async function getAllSessionsStatus() {
             sortTime: active?.startTime ?? createdAt,
         };
     });
+    const query = options.query?.trim().toLowerCase() ?? "";
     const entries = [...registryEntries, ...orphanEntries]
-        .sort((a, b) => b.sortTime - a.sortTime)
-        .slice(0, 20);
+        .filter((entry) => options.archivedOnly ? !!entry.archivedAt : options.includeArchived ? true : !entry.archivedAt)
+        .filter((entry) => !query || [entry.displayTitle, entry.chatName, entry.sessionId, entry.tool]
+        .some((value) => String(value ?? "").toLowerCase().includes(query)))
+        .sort((a, b) => Number(!!b.pinned) - Number(!!a.pinned) || b.sortTime - a.sortTime)
+        .slice(0, options.limit ?? 20);
     // 并行解析每个 session 的 model/effort（cursor 涉及异步 store IO）
     return Promise.all(entries.map(async (info) => {
         const { model, effort } = await resolveModelEffort(info.tool, info.sessionId);
@@ -2178,6 +2211,9 @@ export async function getAllSessionsStatus() {
             chatType: info.chatType,
             sessionId: info.sessionId,
             chatName: info.chatName || "",
+            displayTitle: info.displayTitle || "",
+            pinned: info.pinned ?? false,
+            ...(info.archivedAt ? { archivedAt: info.archivedAt } : {}),
             active: !!activePrompts.get(info.sessionId) &&
                 !activePrompts.get(info.sessionId)?.stopped &&
                 !activePrompts.get(info.sessionId)?.abnormalExit,