AceShell README

The project's README from github.com/dingtongbin/AceShell. As one markdown file: README.md.

AceShell

AceShell 是一个跨平台(Windows / macOS / Linux)网络终端管理工具,基于 Go + Wails v3 + Vue 3 + TypeScript + Naive UI 构建,支持 SSH / Telnet / 串口 / SFTP / HTTP / RDP / 本地终端的统一管理,并内置 AI 智能助手。

功能特性

存储目录

应用数据存储在平台应用数据目录(不依赖可执行文件位置):

平台 数据目录
Windows %AppData%\AceShell\
macOS ~/Library/Application Support/AceShell/
Linux ~/.config/aceshell/

目录结构:

<数据目录>/
├── config.toml       # 全局配置(主题/透明度/开关等)
├── agent-mcp.json    # 智能体外接 MCP 服务器配置(兼容 Claude/Cursor 字段惯例)
├── sessions/         # 会话目录(.toml 会话文件 + 指纹 + 密钥库 key/)
├── autolog/          # 自动连接日志(logs/ 日志正文 + meta/ 会话元数据)
└── script/           # 脚本目录

构建

前置要求:Go 1.25+、Node.js 20+、wails3 CLI(go install github.com/wailsapp/wails/v3/cmd/[email protected])。

# 生产构建(输出 bin/AceShell)
wails3 build

# 开发模式(前后端热重载)
wails3 dev

Windows 发布

打标签自动触发 GitHub Actions 构建三平台产物并创建 Release:

git tag v0.2.3
git push --tags

CI 产物:Windows / Linux / macOS 二进制 + 未签名 MSIX(AceShell-<版本>.msix,供微软商店提交,商店侧自动重签)。

测试

# 后端单元测试(数据目录隔离,不触碰真实数据)
go test ./...

# 前端类型检查
cd frontend && npx vue-tsc --noEmit

部分测试(SSH / Telnet 真实连接)依赖外部服务器,凭据不提交仓库:

  1. 复制模板:cp internal/services/testservers.json.example internal/services/testservers.json
  2. 填入真实服务器信息(该文件已被 .gitignore 排除)
  3. 未配置时相关测试自动跳过,不影响 CI

许可证

GPL-3.0。第三方依赖许可见 THIRD_PARTY_NOTICES.md。

更新日志见 CHANGELOG.md。

AceShell (dingtongbin/AceShell)

Searching Database…

这是什么?AceShell 是一款管理网络终端会话的跨平台桌面应用——它把 SSH、Telnet、串口、SFTP、HTTP、RDP 和本地终端统一在一个工具里,用 Go、Wails3、Vue3 和 TypeScript 构建,并内置 AI 助手。
它只是个 SSH 客户端,还是支持更多协议?它在一个树形视图里管理七种会话类型:SSH、Telnet、串口、SFTP、HTTP、RDP 和本地 shell(通过跨平台 PTY 支持 PowerShell/CMD/Git Bash/WSL),并提供加密存储和主机指纹 TOFU 校验。
怎么构建和运行它?安装 Go 1.25+、Node.js 20+ 和 wails3 命令行工具,然后用 Wails3 构建;打上发行版标签会触发 GitHub Actions 产出 Windows、Linux 和 macOS 二进制(外加一个供 Microsoft Store 使用的未签名 MSIX)。
构建 AceShell 之前需要哪些工具?需要安装 Go 1.25+、Node.js 20+ 和 wails3 命令行工具;不需要 Docker 或其他运行时。
AI 助手是一直开着的吗,需要为它准备 API 密钥吗?AI 助手默认作为测试功能启用,但可以在视图菜单或设置里关闭;它的网页搜索会依次回退到 Bing、真实浏览器渲染和 DuckDuckGo,完全不需要 API 密钥。
内置的 AI 助手究竟能做什么?它扮演一个先思考再行动的 AI 运维智能体,通过 MCP 总线(Streamable HTTP/SSE/stdio/内置)与工具通信,可以用 Context7 拉取文档,在计划/手动/自动三档权限下运行,并保留完整可追溯、持久化的命令、查询和结果历史。
RDP 功能给的是完整远程桌面,而不只是终端吧?是的——RDP 会话用 IronRDP 提供全屏图形桌面,支持鼠标/键盘交互、按设备像素比做 1:1 物理显示缩放,以及合并脏区域的渲染。
可以通过 SFTP 传输和编辑远程文件吗?SFTP 提供本地/远程双栏浏览器,支持上传、下载、断点续传、应用内文本编辑(带文件类型白名单、UTF-8 校验和行号),并支持右键和拖放操作。
这个应用有本地化吗,还是只有中文?它内置简体中文(默认)和英文,可在设置里即时切换,界面在设计上也便于扩展更多语言。
What are similar projects?xpipe, navop, electerm, omnyssh, WindTerm, shell-rs, mRemoteNG, Netcatty
Size
14 MB
Stars
138
Age
2mo
Commits · 90 Days