mirror of https://github.com/farion1231/cc-switch.git synced 2026-07-30 10:25:05 +08:00

Files

T

Jason d9c0e4c452 docs: update user manual to v3.12.3 with new features coverage (en/zh/ja)

Add documentation for features introduced since v3.12.0:

New docs:
- 3.4 Session Manager: browse, search, resume, delete sessions
- 3.5 Workspace & Daily Memory: OpenClaw workspace file editing

Updated docs:
- Add Lightweight Mode to interface overview and FAQ
- Add tray submenu structure (providers grouped by app)
- Add API Format selection (Anthropic/OpenAI Chat/OpenAI Responses)
- Add Auto-Fetch Models button documentation
- Add Claude Common Config quick toggles
- Add Codex 1M Context Window toggle
- Add Skill backup/restore lifecycle
- Expand Backup Management panel documentation
- Update WebDAV sync to v2 protocol with dual-layer versioning
- Add OpenCode/OpenClaw to quickstart activation table
- Update README version to v3.12.3

All changes synced across en, zh, and ja locales.

2026-04-04 22:53:20 +08:00

3.8 KiB

Raw Permalink Blame History

3.4 会话管理器

会话管理器可让你在一处浏览、搜索和管理所有支持的 CLI 工具的对话会话。

支持的应用

应用	会话存储位置
Claude Code	`~/.cache/claude/projects/*.jsonl`
Codex	Codex 配置会话目录
OpenCode	`~/.local/share/opencode/`（JSON 或 SQLite）
OpenClaw	`~/.openclaw/agents/<agent>/sessions/*.jsonl`
Gemini CLI	`~/.cache/gemini/tmp/<project_hash>/chats/`

打开会话管理器

点击主导航栏中的会话按钮。

注意：会话按钮在所有五种应用模式下均可见。

界面布局

会话管理器采用 双栏布局：

左侧面板：会话列表，包含搜索和过滤工具栏
右侧面板：选中会话的详情和对话历史

会话列表（左侧面板）

每个会话条目显示：

供应商图标
会话标题
最后活跃时间（相对格式，如"5 分钟前"）

会话详情（右侧面板）

选中会话后，右侧面板显示：

标题：来自会话标题、项目目录名称或会话 ID
最后活跃日期/时间：完整时间戳
项目目录：可点击复制完整路径（显示目录名，完整路径以提示框显示）
恢复命令：以等宽字体显示（如可用）
对话历史：完整消息记录

搜索与过滤

全文搜索

使用左侧面板顶部的搜索框，可搜索以下内容：

会话 ID
标题
摘要
项目目录
源文件路径

搜索支持前缀匹配，实时过滤结果。按 Esc 清除搜索。

供应商过滤

点击左侧面板右上角的供应商过滤下拉菜单，按应用过滤：

全部 — 显示所有供应商的会话
Claude Code
Codex
OpenCode
OpenClaw
Gemini CLI

过滤可与搜索组合使用。

刷新

点击刷新按钮（圆形箭头图标），重新扫描所有供应商目录以发现新增或已删除的会话。

会话操作

恢复会话

点击选中会话上的恢复按钮（播放图标）继续对话。

macOS 上：

CC Switch 使用你偏好的终端启动恢复命令
终端会在会话的项目目录中打开
如果终端启动失败，命令会被复制到剪贴板

支持的终端（macOS）：Terminal.app、iTerm2、Ghostty、Kitty、WezTerm、Alacritty

其他平台：

恢复命令会被复制到剪贴板
在终端中粘贴即可恢复会话

如果会话没有可用的恢复命令，恢复按钮将被禁用。

删除会话

点击删除按钮（垃圾桶图标）永久删除会话文件。删除前会显示确认对话框。

没有本地源路径的会话（如不可变会话）无法删除。

批量操作

批量管理多个会话：

点击左侧面板工具栏中的 批量模式 按钮（复选框图标）
使用出现的复选框选择会话
使用全选选择所有过滤结果，或使用清除取消选择
点击 批量删除（红色垃圾桶图标）删除所有选中的会话

删除前会显示确认对话框并展示数量。结果会报告成功删除的数量和失败的数量。

对话历史

消息显示

消息按角色以颜色区分：

用户消息：绿色，左对齐
AI（助手）消息：蓝色，右对齐
系统消息：琥珀色
工具消息：紫色

目录导航

对于较长的对话，提供目录导航功能：

桌面端（XL+ 屏幕）：右侧边栏显示用户消息预览
较小屏幕：右下角浮动按钮（列表图标），点击打开对话框

点击任意条目可滚动到对应消息，消息会短暂高亮显示。

提示

会话按最后活跃时间排序（最新在前）
会话数量徽章会随搜索和过滤实时更新
OpenCode 会话可能来自 JSON 文件和 SQLite 数据库 — 重复项会自动去重

3.8 KiB Raw Permalink Blame History Unescape Escape