智能终端助手 - 一个跨平台的 AI 驱动命令行工具
--- ## 功能特性 ### 🤖 AI 对话 - 支持 OpenAI 兼容的 Chat Completions API - 可自由配置任意 LLM 服务（DeepSeek、OpenAI、Claude 等） - 流式输出，实时显示 AI 回复 - Markdown 渲染，代码高亮 - 多会话管理，历史记录持久化 - Shift+Enter 换行，Enter 发送 ### 🔧 工具调用 (Function Calling) - **SSH 连接**: 通过对话建立远程服务器连接 - **命令执行**: 在本地或远程执行 Shell 命令 - **文件操作**: 读写本地文件 - **SFTP 传输**: 上传/下载文件和文件夹，支持进度显示 - **链接打开**: 自动打开 URL ### 📁 SFTP 文件管理器 - 可视化浏览远程服务器文件 - 上传文件/文件夹到服务器 - 下载文件/文件夹到本地 - 实时传输进度显示 ### 💻 终端模拟器 - 基于 xterm + flutter_pty 的真实终端体验 - 支持本地 Shell (bash/zsh) - SSH 远程连接 - Tab 键命令补全 - 完整的终端功能（vim、htop、颜色等） - 会话级别的 SSH 连接管理 ### 🛡️ 安全防护 - 危险命令检测（rm -rf、格式化等） - 二次确认弹窗 - 风险等级提示 ### 🎨 界面特性 - 深色/浅色主题 - 现代化 UI 设计 - 浮动滚动按钮，快速回到顶部/底部 - 跨平台支持 (macOS, Windows, Linux, iOS, Android, Web) ## 安装 ### macOS 下载 DMG 安装包或从源码构建： ```bash # 克隆项目 git clone https://gitee.com/io123/aishell.git cd aishell/ai_shell # 构建 DMG ./build_dmg.sh ``` ### 从源码运行 ```bash # 安装依赖 flutter pub get # 运行 flutter run -d macos # macOS flutter run -d windows # Windows flutter run -d linux # Linux flutter run -d chrome # Web ``` ## 使用说明 ### 配置 LLM 1. 点击右上角设置图标 2. 添加或编辑模型配置 3. 填入 API 地址、密钥和模型名称 默认配置为 DeepSeek： - Base URL: `https://api.deepseek.com` - Model: `deepseek-chat` ### SSH 连接 通过 AI 对话建立连接： ``` 请帮我连接服务器 192.168.1.100，用户名 root，密码 xxx ``` AI 会自动调用 SSH 工具建立连接。 ### SFTP 文件传输 通过 AI 对话传输文件： ``` 将本地 ~/Documents/project 文件夹上传到服务器 /root/ ``` 或使用 SFTP 文件管理器： 1. 点击顶部文件夹图标 2. 选择已建立的 SSH 连接 3. 浏览目录、上传/下载文件 ### 终端使用 1. 点击顶部终端图标切换到终端 2. 支持本地终端和 SSH 远程连接 3. 当前会话的 SSH 连接会自动同步到终端 ## 开发 ### 项目结构 ``` ai_shell/ ├── lib/ │ ├── main.dart # 入口 │ ├── models/ # 数据模型 │ ├── providers/ # 状态管理 │ ├── services/ # 服务层 │ ├── screens/ # 页面 │ └── widgets/ # 组件 ├── assets/ # 资源文件 ├── generate_logo.py # Logo 生成脚本 └── build_dmg.sh # DMG 打包脚本 ``` ### 生成应用图标 ```bash pip install Pillow python generate_logo.py ``` ### 构建发布版本 ```bash # macOS DMG ./build_dmg.sh # 其他平台 flutter build macos --release flutter build windows --release flutter build linux --release flutter build web --release ``` ## 技术栈 - **Flutter** - 跨平台 UI 框架 - **Provider** - 状态管理 - **dartssh2** - SSH 客户端 - **xterm** - 终端模拟器 - **flutter_pty** - PTY 支持 - **flutter_markdown** - Markdown 渲染 - **file_picker** - 文件选择器 ## 更新日志 ### v1.0.1 - 新增 SFTP 文件管理器 - 新增文件/文件夹上传下载功能 - 新增传输进度显示 - 新增浮动滚动按钮 - 支持 Shift+Enter 换行输入 - 优化滚动体验 ### v1.0.0 - 初始版本发布 - AI 对话功能 - SSH 连接和命令执行 - 终端模拟器 - 安全防护 ## 许可证 MIT License ## 致谢 - [Flutter](https://flutter.dev/) - [DeepSeek](https://deepseek.com/) - [dartssh2](https://pub.dev/packages/dartssh2) - [xterm](https://pub.dev/packages/xterm) - [flutter_pty](https://pub.dev/packages/flutter_pty)