AI Shell Desktop

基于 DeepSeek Harness 的 Windows / macOS 桌面客户端：把终端、文件与 AI 对话放进同一个窗口，AI 只在你打开的真实终端里干活。

独立的开源项目，与深度求索不存在隶属、合作、授权或背书关系。

截图

新建会话与接入主机

新建会话	主机面板
新建主机（密码 / 私钥）	远端终端，连上即用

终端作业与 AI 协同

在终端里执行命令	选中现场输出
一键引用进对话	AI 对话

AI 回答与计划模式

AI 回答完成（思考可展开）	输入 /plan 进入计划模式
计划模式已开启	待执行命令卡片
点「执行」，命令进入终端回显

文件、会话与设置

文件面板（跟随当前主机）	会话按主机分组
通用设置	模型设置
深色主题 · 总览	浅色主题 · 总览

主题细节与安全删除

深色主题 · 设置	深色主题 · 终端
删除会话 · 弹窗确认	删除主机 · 弹窗确认

全部 24 张截图、逐张讲解与视频分镜见 docs/screenshots/README.md。

亮点

• 终端即上下文：在终端里选中现场输出，一键「引用选中内容」进对话；AI 读的是真实回显，不是复制粘贴的第二手材料。
• 一终端一会话，互不串台：每个终端标签绑定自己的 AI 会话，切换终端即切换对话；会话与其终端严格一一对应，AI 只能操作它绑定的那台终端。
• 高危动作由人把关：/plan 计划模式下 AI 只提交「待执行命令」卡片，你点「执行」才会进入终端。
• AI 碰不到本机：会话只能通过你打开的终端操作远端机器；本机 shell 与本机文件不在它的能力范围内。

功能

• AI Shell 布局：活动栏、导航列（会话 / 主机 / 文件）、中央终端工作台、右侧 AI 对话同屏协同
• 远端主机：SSH 主机保存 / 编辑 / 弹窗确认删除；SFTP 文件面板支持浏览、预览、新建目录与上传本地文件
• 终端工作台：多标签并行；本地 shell 与远端 Linux shell 体验一致；选中内容可引用进对话
• 会话管理：会话按主机归组，支持标题与内容全文检索与批量勾选删除，删除均经弹窗确认
• 计划模式：输入 /plan 进入，命令逐条以卡片提交、由人点击执行
• 外观：浅色 / 深色 / 跟随系统；深色下终端保持清晰可读
• 桌面能力：系统托盘（打开窗口 / 退出）、启动恢复
• 打包：Windows NSIS 安装包与免安装 zip、macOS universal DMG、Linux x64 / ARM64 的 AppImage、deb 与 tar.gz

下载

发布版通过 GitHub Releases 分发。下表列出各平台的构建产物；只有在 Release 资产中实际看到对应文件时，才表示该平台已经发布：

平台	产物	说明
Windows x64	AI-Shell-Desktop-<版本>-x64-Setup.exe	NSIS 安装包；当前未签名，首次运行可能提示「未知发布者」
Windows x64	AI-Shell-Desktop-<版本>-x64-Portable.zip	免安装包；解压后运行目录内的 AI Shell Desktop.exe
macOS Universal · Apple Silicon / Intel	AI-Shell-Desktop-<版本>-universal.dmg	universal DMG；正式发布需签名与公证
Linux x64	AI-Shell-Desktop-<版本>-x86_64.AppImage	AppImage；运行前需保证系统可挂载 FUSE（libfuse2）
Linux x64	AI-Shell-Desktop-<版本>-amd64.deb	Debian / Ubuntu 安装包
Linux x64	AI-Shell-Desktop-<版本>-linux-x64.tar.gz	免安装压缩包；解压后运行 ai-shell-desktop
Linux ARM64	AI-Shell-Desktop-<版本>-arm64.AppImage	AppImage；运行前需保证系统可挂载 FUSE（libfuse2）
Linux ARM64	AI-Shell-Desktop-<版本>-arm64.deb	Debian / Ubuntu 安装包
Linux ARM64	AI-Shell-Desktop-<版本>-linux-arm64.tar.gz	免安装压缩包；解压后运行 ai-shell-desktop

从源码构建

需要 Node.js 22.19+ 或 24+，以及 Corepack 提供的 Yarn 4：

git submodule update --init --recursive
corepack yarn install --immutable
corepack yarn dev              # 开发启动
corepack yarn check            # 构建 / 类型检查 / 测试
corepack yarn dist:win         # Windows 安装包（需在 Windows 上执行）
corepack yarn dist:mac         # macOS universal DMG（需签名与公证凭据）
corepack yarn dist:mac-smoke   # 未签名 macOS DMG 冒烟（需在 macOS 上执行）
corepack yarn dist:linux       # Linux x64 AppImage / deb / tar.gz（需在 Linux x64 上执行）
corepack yarn dist:linux-arm64 # Linux ARM64 AppImage / deb / tar.gz（需在 Linux ARM64 上执行）

文档

目标	入口
安装与日常使用	用户指南
平台、环境与使用边界	常见问题
桌面宿主架构与发布边界	架构说明
编写插件 / 桌面插件接口	插件开发 · 桌面服务合同
数据处理与隐私选择	隐私政策
参与贡献	CONTRIBUTING.md

与 DeepSeek Harness 的关系

上游提供智能体能力、插件系统与 Web UI；本项目负责桌面封装：应用外壳、本地服务的启动与恢复、窗口与托盘、安装包构建与发布。固定版本的 deepseek-harness/ 子模块原样运行，桌面壳通过 DSH 的插件机制组合进同一运行时。

License

MIT。「DeepSeek Harness」是深度求索公司的注册商标，本项目仅为说明技术来源与兼容性而使用该名称。