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, со встроенным ИИ-ассистентом.
Это просто SSH-клиент или он поддерживает больше протоколов?Он организует семь типов сессий в одном древовидном виде: SSH, Telnet, последовательный порт, SFTP, HTTP, RDP и локальные шеллы (PowerShell/CMD/Git Bash/WSL через кроссплатформенный PTY), с шифрованным хранилищем и TOFU-проверкой отпечатка хоста.
Как его собрать и запустить?Установите Go 1.25+, Node.js 20+ и CLI wails3, затем соберите с Wails3; выставление тега релиза запускает GitHub Actions, создающие бинарники для Windows, Linux и macOS (плюс неподписанный MSIX для Microsoft Store).
Какие инструменты нужны перед сборкой AceShell?Нужны установленные Go 1.25+, Node.js 20+ и CLI wails3; Docker или другой рантайм не требуются.
ИИ-ассистент всегда включён, и нужен ли для него API-ключ?ИИ-ассистент по умолчанию поставляется включённым как тестовая функция, но его можно выключить в меню вида или настройках; его веб-поиск перебирает по цепочке Bing, реальный рендер в браузере и DuckDuckGo, API-ключ не нужен вовсе.
Что реально умеет встроенный ИИ-ассистент?Он выступает ИИ-агентом для операций, который думает, прежде чем действовать, общается с инструментами через шину MCP (Streamable HTTP/SSE/stdio/встроенный), может подтягивать документацию через Context7, работает с уровнями прав plan/manual/auto и ведёт полностью отслеживаемую сохранённую историю команд, запросов и результатов.
Функция RDP даёт полноценный удалённый рабочий стол, а не просто терминал?Да — сессии RDP используют IronRDP для полноэкранного графического рабочего стола с взаимодействием мыши и клавиатуры, масштабированием 1:1 к физическому экрану по device pixel ratio и рендерингом с объединением изменённых областей.
Можно передавать и редактировать удалённые файлы по SFTP?SFTP даёт двухпанельный браузер локальных/удалённых файлов с выгрузкой, скачиванием, докачкой прерванных передач, редактированием текста в приложении (с белым списком типов файлов, проверкой UTF-8 и номерами строк) и поддержкой правого клика и drag-and-drop.
Приложение локализовано или только на китайском?В комплекте упрощённый китайский (по умолчанию) и английский, переключаются мгновенно в настройках, а интерфейс задуман с возможностью добавить больше языков.
What are similar projects?xpipe, navop, electerm, omnyssh, WindTerm, shell-rs, mRemoteNG, Netcatty
Size
14 MB
Stars
138
Age
2mo
Commits · 90 Days