AITerminal
Health Gecti
- License — License: Apache-2.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 54 GitHub stars
Code Basarisiz
- fs.rmSync — Destructive file system operation in lib/pluginDiagnostics.js
- fs module — File system access in lib/pluginDiagnostics.js
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
AI 运维终端:本地 PTY / SSH、多标签 AI 接管、交互式 CLI 与插件中心。Apache-2.0。
![]()
AITerminal
English · 下载 · 插件开发 · 参与共建 · 讨论
用 AI 管理本地电脑和远程服务器,也让开发者把自己的运维经验变成插件。
AITerminal 是基于 Electron、xterm.js 和 SSH2 的开源桌面终端,将本地 PTY、SSH、AI 对话、交互式命令接管和插件中心放在同一工作界面。源码使用 Apache License 2.0,支持 Windows、Linux 和 macOS。
能做什么
- 本地与远程终端:直接打开本地 Shell,或连接 SSH;支持 Codex、Vim、tmux 等交互式程序。
- 按标签隔离:每个标签独立持有连接、AI 配置与历史、接管状态、输出、插件实例和终端尺寸。
- AI 运维:对本地、远程或混合目标执行任务;高危命令执行前确认,可信任已核验指纹的指定 SSH 服务器以减少重复弹窗。
- 终端交互:
Ctrl+Shift+C/V复制粘贴;选中文本后 Enter 复制并取消选择;右键复制选中内容或粘贴。tmux/Vim 启用鼠标时接收鼠标和滚轮事件,Shift+右键使用本地剪贴板。tmux 请启用set -g mouse on。 - 任务通知:HTTPS Webhook 支持任务结果、程序正常/异常停止及屏幕输出关键词匹配;手动交互程序可从“🔔 运行并通知”启动。支持冷却、大小写及可选脱敏片段,详见 通知说明。
- 插件中心:参数化工具、模型适配器、标准 MCP、任务事件、面板、配置、插件源和版本恢复;提供独立进程、Cordis 生命周期和开发 SDK。
- 凭据与连接保护:SSH 首次连接确认 SHA-256 主机指纹,密钥变化默认阻断;SSH 凭据、模型 Key 和 Webhook URL 由系统加密存储管理。
Windows 的可见本地终端默认是 WSL Ubuntu(wsl.exe -d Ubuntu --cd ~);Windows 的 AI 本地接管使用宿主 PowerShell 操作 Windows 工作目录。两者是不同环境。
安装与开始使用
从 GitHub Releases 下载对应平台的 AITerminal 安装包,核对该版本附带的 SHA256SUMS。1.5.1 对应本次开源及 Plugin API 1.1;旧版安装包不包含最新插件和程序通知。
| 平台 | 安装包 | 运行条件 |
|---|---|---|
| Windows x64 | .exe 安装器 |
本地终端需要 WSL 和名为 Ubuntu 的发行版;可在管理员终端执行 wsl --install -d Ubuntu,完成初始化后启动应用 |
| Linux x64 | .AppImage |
下载后添加执行权限;系统需支持 FUSE,或使用 AppImage 的提取运行方式 |
| macOS Apple Silicon | .dmg |
当前 CI 产物为 arm64、未签名/未公证;仅在核验来源后按系统提示允许打开 |
当前只提供桌面版本,没有 iOS .ipa。安装包不要求用户安装 Node.js。
启动后选择本地终端或配置 SSH;使用 AI 时填写自己的兼容模型 API 地址、模型名与 Key。插件中心可从底部“🧩 插件”或 Ctrl/Cmd+Shift+P 打开。终端宠物和运维闯关无需模型 Key,也无需连接服务器。
一起建设插件生态
欢迎开发者贡献运维工具、交互式 CLI 助手、模型适配器、MCP 集成、教学插件、文档和测试。AITerminal 提供自己的插件中心与 SDK,内部借鉴 DeepSeek Harness 的组合方式并使用 Cordis 管理生命周期;已有 DSH/Cordis 插件需按服务接口适配,详见 SDK。
| 内置插件 | 可以参考的能力 |
|---|---|
| 系统巡检、Docker、Git 审查、交互式 CLI | 声明式指引与静态命令 |
| Docker 工作台 | 参数化工具、只读巡检、交互日志 |
| 任务通知与记录、模型策略 | 任务事件、Webhook、模型适配器 |
| 终端宠物、运维闯关 | 无需 AI 的面板交互、会话状态与事件 |
| Git 时光机 | 真实 Git 时间线、只读操作、可选 AI 故事 |
从 贡献指南 开始,或提交 插件提案。路线图 列出了插件开发体验、MCP、终端可靠性和跨平台验证等共建方向;不需要先完成一个大型插件才参与。
从源码运行
需要 Node.js 22+、npm,以及目标系统的原生模块构建环境(若预编译模块不可用)。不要跨 Windows、Linux、macOS 共用 node_modules。
git clone https://github.com/Amo-Zeng/AITerminal.git
cd AITerminal
npm ci
npm start
插件开发最小流程(在项目根目录执行,生成目录位于仓库外):
npm run plugin:dev -- new ../hello-aiterminal example.hello
npm run plugin:dev -- validate ../hello-aiterminal
npm run plugin:dev -- pack ../hello-aiterminal ../example.hello.aitplugin.json
在插件中心“加载开发目录”后预览安装、在本标签启用,即可运行模板的问候工具。修改文件后需重新导入。完整说明见 Plugin SDK;英文入门见 Plugin Quickstart。
测试与构建
npm test
npm run security:scan
npm run doctor
# 在目标操作系统选择对应命令:
npm run build:win
npm run build:linux
npm run build:mac:unsigned
公开 GitHub Actions 在 PR、普通 push 到 main / release/**、v* 标签和手动触发时运行三平台构建。Fork 开发者可以在自己的仓库启用 Actions;构建无需维护者私有仓库或模型 Key。每个平台执行锁定安装、测试、依赖审计、真实 Electron/插件/通知检查、打包源码一致性及打包后启动,再上传安装包、校验和与 SBOM。Actions 临时产物保留 14 天,正式下载使用 Releases。
按改动范围运行真实交互测试,命令与环境要求见 贡献指南。维护者原有私有打包脚本仍保留,使用说明移至 构建与发布。
文档与安全边界
AITerminal 以当前本地用户或 SSH 用户的权限运行。工作目录、命令审计和插件独立进程均不等于操作系统权限沙箱;仅启用可信插件。凭据无法安全加密时只在当前会话保留。漏洞请通过 私密安全报告 提交,避免在公开 Issue 附上密钥或敏感终端输出。
许可证
Copyright © Amo Zeng and AITerminal contributors. 本项目采用 Apache License 2.0,允许按协议使用、修改和再分发。第三方依赖保留各自许可证。
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi