# ibwhale v1.3 — 功能介绍 Claude Code 2.1.88版

# ibwhale v1.3 — 功能介绍 ## 概述 ibwhale 是一款基于 Electron + node-pty 构建的桌面端 Claude Code 终端包装器。它在原生终端之上提供了多会话管理、多模型切换、中文翻译、主题定制等增强功能，让 AI 编程助手的使用体验更加高效舒适。 --- ## 核心功能 ### 终端交互 - **真实 PTY 终端** — 基于 node-pty 启动真实的伪终端进程，完整支持 Claude Code TUI 界面 - **快捷命令输入** — 底部输入框专用于发送命令，Enter 发送，不与终端交互选择冲突 - **终端右键菜单** — 复制（Ctrl+C）/ 粘贴（Ctrl+V）/ 全选 / 清屏 - **Ctrl+C 复制** — 在输入框中可直接复制选中内容；在终端中正常发送 Ctrl+C 信号 - **Ctrl+V 粘贴** — 粘贴文本直接发送到终端 - **进程终止 / 重启** — 顶部工具栏提供终止和重启按钮，快速重置会话 ### 多对话管理 - **多会话侧边栏** — 左侧显示所有对话历史，点击切换 - **新建对话** — 点击「新对话」按钮创建独立的 PTY 终端会话 - **重命名对话** — 双击对话标题，输入新名称 - **关闭对话** — 悬停对话条目，点击 × 按钮关闭 - **会话缓冲** — 切换对话时自动保存/恢复终端缓冲内容 ### AI 模型管理 - **多服务商支持** — OpenAI / Anthropic / DeepSeek / 阿里云百炼 / 智谱 / 月之暗面 / OpenRouter / 本地模型 - **模型快速切换** — 顶部模型选择器，一键切换已配置的模型 - **模型详情展示** — 每个模型显示名称、发布时间、评分、价格、描述 - **自定义模型 ID** — 在 API 配置中输入任意模型 ID，支持非内置模型 - **模型热切换** — 点击模型名称即可切换，无需重启应用 ### API 配置 - **图形化配置面板** — 点击左下角钥匙图标打开设置 - **服务商一键选择** — 图标网格快速选择服务商，已配置显示徽章 - **API Key 安全输入** — 默认密码模式，点击眼睛按钮显示/隐藏 - **本地模型支持** — Ollama / LM Studio / vLLM / llama.cpp / LocalAI 一键选择 - **自定义服务地址** — 本地模型支持自定义 API 地址 - **配置持久化** — 所有配置保存到本地文件（config.json + .env），重装不丢失 - **配置清除** — 一键清除所有 API 配置 ### 中文翻译 - **划词翻译** — 在终端中选中文字，点击「翻译为中文」按钮即可翻译 - **自动翻译模式** — 点击顶部翻译开关，开启后选中文本自动翻译 - **侧边翻译面板** — 翻译结果在右侧面板展示，原文/译文对照 - **AI 翻译引擎** — 使用当前配置的 AI 模型进行翻译，支持所有服务商 - **主进程请求** — 翻译请求通过主进程发起，无 CORS 限制 ### 界面定制 - **5 种主题底色** — 深色 / 灰色 / 深蓝 / 深绿 / 深紫，一键切换 - **自定义用户名** — 首次启动设置昵称，支持后续修改 - **可点击头像** — 点击头像切换边框颜色，7 色循环 - **侧栏显示/隐藏** — 点击汉堡菜单按钮切换侧边栏 - **无框窗口** — 自定义标题栏，最小化/最大化/关闭按钮 - **透明终端** — 终端背景透明，自动适配主题底色 ### 其他功能 - **帮助与说明** — 点击底部 `?` 按钮查看快捷键和操作指南 - **错误提示** — 运行时错误自动弹出，支持复制错误信息 - **单实例锁** — 防止同时启动多个应用实例 - **MIT 开源协议** — 完整开源，可自由使用和修改 - **免责声明** — 仅供学习研究使用 --- ## 快捷键一览 | 快捷键 | 功能 | |--------|------| | Enter | 发送输入到终端 | | Ctrl+C | 输入框中复制 / 终端中发送中断信号 | | Ctrl+V | 粘贴到终端 | | 右键菜单 | 复制 / 粘贴 / 全选 / 清屏 | --- ## 技术架构 - **主进程** (main.cjs) — Electron 主进程，负责 PTY 管理、IPC 通信、配置持久化、翻译 API 请求