Chatminal 用户指南
把 Chatminal 当成你会回来继续使用的工作区，而不是一次性终端。
这页是写给用户的，不是写给贡献者的。它说明如何安装 Chatminal、session 与 profile 如何配合、layout 如何工作，以及你稍后回来继续工作时会发生什么。
安装
安装 Chatminal
Chatminal 是面向希望 shell session 保持有序且易于继续的用户的桌面终端。请选择与你的平台和更新方式相匹配的安装路径。
- 如果你想在 macOS 或 Linux 上获得最快的终端式安装体验，请使用安装脚本。
- 如果你想通过 brew 安装和升级，请在 macOS 上使用 Homebrew。
- 如果你更喜欢直接下载应用归档，或者你在 Windows 上，请使用 GitHub Release。
- 当前预构建产物覆盖 macOS、Linux x86_64 和 Windows x64。
bash
使用 Bash 安装
这会安装最新稳定版，也是从终端开始最快的方式。
curl -fsSL https://chatminal.com/install | bashbrew
使用 Homebrew 安装
如果你希望 Chatminal 在 macOS 上像普通 cask 一样被管理，请使用这个方式。
brew tap Khoa280703/chatminal https://github.com/Khoa280703/chatminal
brew install --cask chatminalwindows
下载 Windows 版本
Windows 当前通过最新 GitHub Release 的 zip 包分发。
start https://github.com/Khoa280703/chatminal/releases/latest首次启动
首次启动会发生什么
Chatminal 第一次打开时，会启动你的默认 shell，并给你一个干净的地方来创建真正用于工作的 session，而不是把所有内容都堆进同一个终端标签页里。
- 从一个新的 shell session 开始，并确认你的默认工作环境。
- 为不同任务或仓库创建独立 session。
- 使用 profile 来组织相关 session。
Session
Session 与 profile
Session 是 Chatminal 的核心单元。每个 session 都拥有自己的 shell、工作目录和活动状态。Profile 帮助你按项目、团队或工作流分组这些 session。
- 为每个任务、仓库或环境创建一个 session。
- 当你想切换上下文而不丢失当前 session 时，在 profile 之间切换。
- 重命名 session，让侧边栏清楚反映它们的用途。
- 为经常重开的 session 使用启动命令。
布局
分屏与布局
Chatminal 专为同时处理多个 session 而设计。布局让你可以拆分工作区、保持重要 session 可见，并在以后回到熟悉的排列方式。
- 当你需要同时看到日志、shell 输出和另一项任务时，拆分工作区。
- 使用布局让长时间运行的工作一直可见，而不是来回切换。
- 保存后的布局可以帮助你以后重新打开同样的工作区形状。
历史
历史记录与恢复行为
Chatminal 会持久化 session 状态，让你回来时不必每次都从空白终端开始。这包括 session 历史以及工作区结构。
- 你可以保留 session 历史，这样回来时仍能查看之前的输出。
- 重新打开应用应该更像继续工作，而不是从零重启。
- 如果你想要一个干净的起点，可以清除历史并重置 session 上下文。
启动
启动命令
如果某个 session 总是以同样的方式开始，就保存一个启动命令。它适合用来打开项目、连接工具，或者快速恢复一个固定 shell 流程。
- 为每天都会重复的 session 使用启动命令。
- 让它们专注于尽快把你带回可工作的状态。
- 把它当作快捷恢复工具，而不是完整部署脚本。
FAQ
常见问题
当前产品路线是 desktop-first 和 session-first。如果你在判断 Chatminal 是否适合你的工作流，这些是最关键的问题。
- 支持多个 session 吗？支持，这是产品的核心部分。
- 我可以用 profile 来组织工作吗？可以，profile 是持久化工作区模型的一部分。
- 它会记住布局和历史吗？会，持久化已经内建在 runtime 和 store 中。
- 这个页面是给贡献者看的吗？不是。这个页面写给终端用户。