sb1733831438-maker/DSH-closerAI

CloserAI

本地优先、模型无关、权限透明的开源桌面 AI 工作台，用于交付真实的 Chat + Work +
Code/Cowork 成果。基于 DeepSeek Harness 构建。

English · 简体中文

Release
CI
License
Platform

CloserAI 是一款开源桌面应用，在加固的 Electron 外壳中托管一个
DeepSeek Harness 进程。它不是简单套壳：在保留
DSH 作为 Agent 运行时的同时，新增了桌面监督器（Supervisor）、三种权限隔离工作模式
（Chat / Work / Code）、本地优先的会话存储、基于系统钥匙串的密钥管理，以及插件安全模型。

✨ 核心特性

- 加固外壳 —— 上下文隔离、沙箱、严格 CSP、导航锁定、单实例、深链。
- 三种权限隔离模式 —— Chat / Work / Code，让模型只能拿到它该拿的工具与文件。
- 本地优先的会话 —— 所有对话持久化在 DSH_HOME 下，支持历史、项目、导出/导入与重启恢复。
- 原生桌面 —— 系统托盘、崩溃/恢复通知、开机启动。
- 透明设计 —— 管理页展示能力开关、各模式权限清单与脱敏诊断日志。
- 模型无关 —— 支持 DeepSeek、任意 OpenAI 兼容接口，以及完全离线的 Mock 模式（无需密钥）。
- 系统 DSH 同步 —— 存在系统 DSH 目录（~/.dsh）时，桌面端直接启动你自己的 DSH：会话、插件、设置与 web 端完全一致（且绝不覆盖其配置）。
- 官方 DeepSeek 虎鲸图标 —— 应用、安装包与任务栏使用官方 DeepSeek 鲸鱼 logo。
- 同步体验 —— 工作区页显示「已与系统 DSH 同步」横幅；共享目录被另一个 DSH 锁定时给出友好提示而非静默崩溃。
- 自动更新 —— 内置更新器（electron-updater + GitHub Releases），可在工作区页检查更新。
- 跨平台安装包 —— Windows（NSIS）、macOS（dmg，arm64）、Linux（AppImage）由 CI 构建，带各自平台的自动更新元数据。
- 供应链透明 —— 每个 Release 附带 CycloneDX SBOM（973 组件，pnpm check 中有许可门禁）。
- MCP 服务器管理 —— 在工作区页管理可复用的 MCP 服务器（stdio / HTTP），导出标准 mcp.json 给 Claude Code、Kimi Code、编辑器或任何 MCP 兼容客户端。

🚀 快速开始

方式 A —— 安装 Windows 版（推荐）

1. 下载最新安装包：Windows CloserAI-0.7.0-Setup-x64.exe、macOS CloserAI-0.7.0-arm64.dmg、或 Linux CloserAI-0.7.0.AppImage——都在 Releases 页。
2. 用 SHA256SUMS.txt 校验 SHA-256（Windows：Get-FileHash -Algorithm SHA256 .\CloserAI-0.7.0-Setup-x64.exe）。
3. 运行安装包，启动后选择 Mock 模式 即可零配置体验。

安装包尚未代码签名——若 SmartScreen 提示，请选择「更多信息 → 仍要运行」，并以校验和为准。
详见 docs/TROUBLESHOOTING.md。

方式 B —— 从源码运行

pnpm install
pnpm check          # 格式化 + 检查 + 构建 + 类型检查 + 测试
pnpm smoke          # 端到端：引导 → DSH UI → 管理页
cd apps/desktop && pnpm run dev

需要 Node.js >= 20.19 与 pnpm 11。DSH 在 lockfile 中固定了精确运行时版本。

🧩 模式

| 模式     | 能做                               | 不能做              |
| -------- | ---------------------------------- | ------------------- |
| Chat | 联网搜索、附件（只读）             | Shell、本地文件访问 |
| Work | 应用私有沙箱内处理文档             | Shell、访问沙箱外   |
| Code | 指定目录、shell/git/终端（需批准） | 未经批准访问目录外  |

可通过托盘或管理页切换模式；每个项目固定一种模式 + 工作目录，并在重启后恢复。

🛠 开发

git clone https://github.com/sb1733831438-maker/DSH-closerAI.git
cd DSH-closerAI
pnpm install
pnpm check
cd apps/desktop
pnpm run pack     # 构建 Windows 安装包（release/CloserAI-*-Setup-x64.exe）

新增功能必须保持 pnpm check 全绿（145 项测试）与 pnpm smoke 通过。扩展模式/预设请参考
docs/PLUGIN_DEV.md。

📚 文档

- 用户手册 (中文) · User manual (EN)
- 排障指南
- 架构 · 决策记录 · 状态 · 执行计划
- 第三方声明 · 安全策略 · 贡献指南

🗺 里程碑

| 版本       | 范围                                                       | 状态       |
| ---------- | ---------------------------------------------------------- | ---------- |
| v0.0.1     | monorepo、工具链、Mock Provider、CI                        | 已发布     |
| v0.0.2     | 桌面外壳：DSH 监督器 + 加固 Electron 窗口                  | 已发布     |
| v0.0.3     | 首次引导、钥匙串密钥、DeepSeek/OpenAI 兼容 + Mock Provider | 已发布     |
| v0.0.4     | Chat / Work / Code 权限隔离模式                            | 已发布     |
| v0.0.5     | 日常对话：会话、历史、项目、文件处理                       | 已发布     |
| v0.0.6     | 扩展与 Web：能力开关、诊断、权限清单                       | 已发布     |
| v0.0.7     | 原生桌面：托盘、通知、开机启动                             | 已发布     |
| v0.0.8     | 首个 Windows 安装包 + 打包运行时修复                       | 已发布     |
| v0.0.9     | RC 硬化：声明、安全与健壮性测试、手册                      | 已发布     |
| v0.1.0 | 可日常使用：Windows 安装包 + 校验和                    | 已发布 |
| v0.2.0     | 系统 DSH home 同步：桌面端 == 你的 web 端 DSH              | 已发布     |
| v0.2.1     | 官方 DeepSeek 虎鲸应用图标                                 | 已发布     |
| v0.3.0     | 同步体验：工作区横幅 + 并发 DSH 友好处理                   | 已发布     |
| v0.4.1 | 自动更新（electron-updater）+ 陈旧锁自愈               | 已发布 |
| v0.5.0     | SBOM（CycloneDX）+ CI 许可门禁                             | 已发布     |
| v0.6.2     | macOS/Linux 安装包 + 黑鲸鱼托盘图标                        | 已发布     |
| v0.7.0 | MCP 服务器管理 UI + 标准 mcp.json 导出                 | 已发布 |

📄 许可证

MIT © CloserAI 贡献者。CloserAI 不 Fork、不修改 DeepSeek Harness 核心，仅将其作为
Agent 运行时托管。