kmd 终端指南
qqqide 内置终端 kmd——不用切窗口，随手敲命令。它和传统终端模拟器不一样：输出区是一个「日志式渲染器」（像编辑器一样任意选中、复制、检索），键入行是一个真正的输入框（点哪光标到哪）。
一、打开（三种方式）
- 按 x 键（最快）：任何非输入状态下按一下
x，立刻开一个新 kmd； - 顶部工具条的 kmd 按钮：菜单第二行的 kmd 按钮，点击即开；
- 从 Roam 打开：在文件面板里按
x或右键选「kmd」→ 新终端直接进入你当时所在的目录（选中单个文件时，文件名会预填到键入行）。
每次打开都是一个新的终端标签——想开多少开多少（同时最多 16 个会话）。标签右键支持「在右 / 左组再开」。在 kmd 里再按 x，新终端会继承当前目录。
二、界面速览
- shell 切换按钮：Windows——
cmd/PowerShell/Git Bash；macOS——zsh/bash。点击即切换（当前项高亮），切换会在同标签内重启会话。 - 命名框：给这个终端起个名，实时同步到标签标题（40 字以内），回车回到命令输入。
- 方块按钮（鼠标悬停展开菜单）：Clear 清屏 ／ Ctrl+C 给当前命令发中断 ／ Terminate 杀掉会话并原地重启。
- 输出区：可以像编辑器一样使用——点击定位光标、拖拽选中、Ctrl+A 全选、Ctrl+C 复制；最多保留 5000 行。
- 键入行：默认 3 行高、最多自动长到 8 行；点击任意位置移动光标；
Shift+Enter换行（也可以点右侧 ⏎ 按钮）；↑↓翻阅命令历史。 - here 指示牌：终端处于可键入状态时（标签可见 + 窗口聚焦），键入行会亮起并滚动绿色虚线、最后一行右侧出现红色 here 标记——一眼确认「命令打给谁」。
三、常用操作
| 操作 | 怎么做 |
|---|---|
| 执行命令 | 输入 → Enter |
| 多行命令 | Shift+Enter（或 ⏎ 按钮） |
| 命令历史 | ↑ / ↓ |
| 查找输出 | Ctrl+F：Enter 下一个 / Shift+Enter 上一个 / Aa 区分大小写 / Esc 关闭；命中项在滚动条上有刻度标记 |
| 复制输出 | 拖选 + Ctrl+C；Ctrl+A 全选 |
| 召回命令 | Git Bash 的回显行悬停 → 点行首 ❯ 箭头，把该条命令填回键入行（只填不执行，改完再跑） |
| 中断当前命令 | 方块按钮 → Ctrl+C（键盘 Ctrl+C 仍是复制语义，不会误杀命令） |
| 杀会话重开 | 方块按钮 → Terminate |
| 关闭终端 | 关掉标签（该会话的进程树一并结束） |
四、能力边界（诚实说明）
kmd 是「行模式」终端——一条命令进、一段输出出。跑构建、git、脚本、包管理、查看文件都很顺手；全屏交互程序不支持（vim、top 这类本地 TUI 无法在 kmd 里运行）。
- Windows 10 1809 及以上：需要全屏交互程序时用 qmd（完整交互终端：vim / REPL / ssh 全可用，打开方式与 kmd 相同）；
- macOS / 更低版本 Windows：只有 kmd；交互式需求请改用命令自身的非交互参数。
五、小知识
- Windows 下 cmd / PowerShell 的输出自动按系统码页解码（中文不乱码）；Git Bash 与 macOS 全链 UTF-8。
- Git Bash 用的是内置 git 组件自带的 bash——绿色包自带，零安装；万一组件损坏会给出明确报错而不是黑屏。
- 从 Roam / x 键打开终端会伴随一声轻提示音（音效可在设置里统一关闭）。