功夫熊猫的博客

aitm

一个把 AI 能力做进终端的桌面应用 —— 支持 macOS 与 Windows。

在熟悉的终端里直接和 AI 协作 —— AI 能读写文件、执行命令、操作内置浏览器，所有高危操作都要你点头才会发生。

Apache-2.0 开源，代码与全部安装包都在 GitHub 上。

立即下载 → 在 GitHub 查看源码

✨ 核心能力

🪟 多 tab 原生终端

每个 tab 一个独立 PTY 进程，xterm.js + WebGL 渲染，输入响应即时。

🤖 AI 侧栏

右侧抽屉式 AI 对话，流式响应、Markdown 渲染、随时呼出不打断手头终端工作。

🔧 AI 工具调用闭环

AI 不只给建议——能读文件、改文件、跑命令、开浏览器。改文件前先给你看一份真实 diff，跑命令拿的是真实退出码而不是等几秒瞎猜。每个高危动作都先弹窗等你确认。

🔔 系统通知

长任务跑完、AI 等待审批，自动发系统通知 + 任务栏小红点。⌘⇧U 直接跳到最近未读。

📋 Tab 元信息

每个 tab 上直接显示当前 git 分支 / dirty 状态 / 监听端口，多 tab 来回切不再迷失方向。

🧭 AI 知道你在哪

AI 调用工具读终端历史时自动带上当前 git 分支、工作目录、占用端口，不用反复"先告诉它你在哪"。

🎨 布局可调

AI 侧栏与文件树左右位置任你切换，适应不同主屏 / 副屏的工作姿势。

📝 内置文件编辑器

直接在 aitm 内打开并编辑项目文件，基于 CodeMirror，自带语法高亮，不用再切到别的编辑器窗口。

🌐 内置浏览器面板

不离开终端就能查文档。标签页连同缩放比例跨重启保留，还能一键请求站点的移动版。AI 也能自己打开并导航——它操作的永远是你看得见的那个标签页。

🧩 兼容 Claude Code skills

自动发现 ~/.claude/skills/、项目内 .claude/skills/ 以及插件市场里的 skills。AI 按需检索并加载，装几百个也几乎不占上下文。

💾 关掉再开，原样回来

终端标签、分屏布局、打开的文件连同各自的工作目录一起恢复，不再每次启动都弹窗问你一遍。不想要可以在设置里关掉。

⌨️ 命令面板

⌘⇧P 搜索并执行任意快捷键动作，每一项都显示当前绑定的键——顺带就把快捷键记住了。⌘1–⌘9 在当前分屏内切标签。

🖥️ tmux 会话管理器 (macOS)

侧栏列出本机所有 tmux 会话——名字、任务、窗口数、目录、谁连着。点一下就在新标签页接入；展开可预览最近 30 行输出，不用接入；哪个后台会话有新输出一眼可见。新建、改名、中断、结束也都在这里。

🚩 幻觉自检

如果 AI 声称"已经改好了 / 已经打开了"，但这一轮并没有真的调用对应工具，这条消息会被标出来。有些模型不做事也报成功，这让它无处可藏。

🎯 它能帮你做什么

让 AI 看一眼项目结构

直接问 "项目根目录有什么"，AI 会自动调用文件浏览与读取工具，几秒后给出结构总结，省去自己 ls -R + 翻文件的工夫。

把执行权交给 AI（但你说了算）

AI 给出建议命令并请求执行 → 弹出确认框告诉你"将要运行：xxx" → 你点 OK 才真正在终端里跑。AI 看到输出，自动判断下一步。

回顾刚才那条命令

"我刚才跑的那条 build 命令是什么？" AI 直接查当前 tab 的命令历史并搜索关键词，比翻屏 / Ctrl+R 快。

长任务后台跑，做完叫你

编译 / 测试 / 部署任务跑完，系统通知自动弹出；AI 完成一轮对话或需要你审批时，tab 栏的状态环会变色提醒。

多模型按需切换

国内外 6 家 LLM 任选，调试问题、写文案、代码改造可以分别配最合适的模型，不被一家锁死。

🧠 支持的 AI 提供方

国内

DeepSeek · 通义千问（DashScope）· 智谱 GLM · Moonshot Kimi

海外

OpenAI · Anthropic Claude

配置方式

设置面板 → AI Provider → 选模型 + 填 API Key → 保存即可，无需重启。

切换成本

OpenAI 兼容协议统一抽象，换 Provider 不影响对话历史和工具调用行为。

⬇️ 下载

当前版本：v1.6.1

macOS 安装包经 Apple Developer ID 签名和公证。Windows 安装包暂未代码签名——计划在后续版本接入 SignPath Foundation（一家支持开源项目代码签名的非营利组织）签名。详见 代码签名政策。

🍎 macOS Apple Silicon

dmg · 7.2 MB · aarch64（M1/M2/M3/M4）

下载 .dmg →

Release 页面

🪟 Windows x86_64

Intel / AMD 64 位

下载 .msi · x64 →

或 NSIS .exe · Release 页面

🪟 Windows ARM64

Surface Pro X / 骁龙笔记本

下载 .msi · ARM64 →

或 NSIS .exe · Release 页面

安装步骤 — macOS

aitm 已经过 Apple Developer ID 签名和公证，Gatekeeper 会自动放行。

  1. 下载并打开 dmg
  2. 把 aitm.app 拖到 Applications 文件夹
  3. 通过 Launchpad 或 Spotlight 启动（搜索 “aitm”）

安装步骤 — Windows

⚠️ aitm 当前阶段尚未对 Windows 安装包签名，首次运行时 SmartScreen / Defender 可能弹 “Windows 已保护你的电脑” 提示。点 更多信息 → 仍要运行 即可，文件本身没问题。

MSI 安装包（推荐）：

  1. 双击下载好的 .msi
  2. 按向导一路下一步 —— 默认安装到当前用户目录，不需要管理员权限
  3. 从开始菜单输入 “aitm” 启动

NSIS .exe 安装包（更小的替代）：

  1. 双击下载的 -setup.exe
  2. 选安装位置 → 下一步 → 安装
  3. 从开始菜单输入 “aitm” 启动

企业 / IT 部署优先选 MSI（兼容 Group Policy 等工具）；个人用户哪个都行，NSIS 体积更小。

校验完整性（所有平台）

想确认下载在传输中没损坏？自行计算它的 SHA-256 哈希：

# macOS / Linux / Windows 上的 Git Bash
shasum -a 256 path/to/aitm_1.6.1_<arch>.<ext>

# Windows PowerShell
(Get-FileHash path\to\aitm_1.6.1_<arch>.<ext> -Algorithm SHA256).Hash.ToLower()

🚀 第一次使用

  1. 启动应用：Launchpad 或 Spotlight 搜 “aitm”
  2. 配置 AI Provider：右上角设置图标 → AI Provider → 任选一家 → 填入对应平台申请的 API Key → 保存
  3. （可选）初始化项目作用域：在任意终端 tab cd 到项目根目录后执行 
    aitm init
# 或显式指定路径和名称
aitm init /path/to/project --name my-app

    AI 工具调用的文件读写会被限制在这个目录边界内，避免越界。

  4. 唤出 AI 侧栏：点右侧栏图标，或使用快捷键
  5. 第一次对话：直接发问，例如 “看一下项目根目录有什么文件”。AI 会按需调用工具；遇到执行命令这类操作时会弹确认框。

🛡️ 安全设计

  • 本地优先存储：终端会话与命令历史保存在你本机；aitm 本身不会把这些数据上传到任何后台服务。AI 对话内容仅在你主动发送时按所选 Provider 的协议送达对应模型方。
  • AI 工具范围可控：通过 aitm init 划定的项目目录边界，AI 文件读取不会越界。
  • 高危命令拦截：内置一道黑名单规则，例如 rm -rf / / dd of=/dev/... / fork bomb 等典型危险模式无法被 AI 触发。
  • 执行需确认：AI 想运行任何命令前都会先弹确认框，你能看到完整命令再决定是否放行。
  • 工具循环上限：单轮对话内最多自动循环若干次工具调用，防止失控。
  • 配置文件只有你能读：~/.aitm/config.toml 里存着 API key，所以创建时就设为仅本用户可读写（0600，目录 0700），本机其他账户读不到。

📚 相关文章

aitm 的发布说明与设计思路：

❓ 常见问题

Q：macOS 双击 aitm.app 提示 “已损坏，无法打开”？ aitm v1.6.1 已通过 Apple Developer ID 签名和公证，正常下载安装不会出现此提示。如果你在使用旧版本，请升级到 v1.6.1。

Q：Windows 弹 “Windows 已保护你的电脑” SmartScreen 提示？ 和 macOS 那条同根：aitm v1.6.1 的 Windows 安装包暂时还未做代码签名。点 更多信息 → 仍要运行 即可。后续会跟进签名证书。

Q：现在支持哪些平台？ macOS Apple Silicon（M1/M2/M3/M4）+ Windows 双架构（x86_64 与 ARM64，覆盖 Surface Pro X 与骁龙笔记本）。Intel Mac 与 Linux 仍在路线图上。

Q：Windows 端 MSI 和 NSIS 选哪个？ 都可以。MSI 对企业 / IT 部署更友好（Group Policy、自动更新工具）；NSIS (.exe) 体积更小、安装向导界面更常见。个人用户哪个都行。

Q：API Key 怎么管理？ API Key 仅保存在你本机的 aitm 用户配置目录中，不会上传任何外部服务器。建议为 aitm 单独申请一个权限最小化、额度受限的 Key，并按你常规的安全实践定期轮换。

Q：aitm 开源吗？ 是，Apache-2.0。源码、Issue、全部平台的安装包都在 github.com/kanfu-panda/aitm。

Q：怎么升级到新版本？ macOS 上应用会自己更新：设置 → 关于 里可以手动查，平时后台每 6 小时查一次，发现新版就下载、验签、安装、重启，不用再手动拖 dmg。Windows 目前还是提示 + 给你对应平台的安装包链接。注意 v1.3.0 及更早的版本不带更新器，需要先手动装一次新版。

Q：发现了 bug 或想反馈？ 欢迎通过 关于页面 的邮箱联系作者。