开源 DeepSeek 桌面 Coding Agent — Wails 独立窗口
Diff 审批 · 经验库 · MCP/Skills · 沙盒预览 · 三档模式 · 内置工作台 · 远程定时 · 长会话优化

⬇ 下载桌面版  ·  特色  ·  预览  ·  描述  ·  技术栈  ·  须知  ·  安装  ·  快速开始  ·  贡献  ·  English

_{导入工作区 → Agent 工具链执行 → 侧栏 Diff 审阅 · 逐步审批}

⬇ Windows  ·  全部发布

ArcDesk 是面向 DeepSeek 的开源桌面 Coding Agent：在 Wails 独立窗口里完成「对话 → 工具 → 侧栏 Diff → 审批」，长会话侧有前缀缓存、分级压缩与费用可见。

除 Agent 内核外，ArcDesk 自带完整桌面工作台 — 经验库、MCP/Skills 市场、项目沙盒与 Web 预览、Auto / Plan / YOLO 三档模式、终端与 Git 面板、手机远程与定时任务；CLI arcdesk chat / run / serve 与桌面共用同一套 Go 内核。

上手前建议先读，避免首次安装与配置上的常见问题。

故障排查：

当前 Releases 仅提供 Windows (amd64) NSIS 安装包（非 Source code zip）。macOS / Linux 预编译包暂未发布，需从源码构建（见「源码构建桌面」）。

依赖： Go 1.25+、Git

git clone https://github.com/P1ouson/deepseek-ArcDesk.git
cd deepseek-ArcDesk
make build          # 输出 bin/ARCDESK（Windows: ARCDESK.exe）

依赖： Go · Node.js · pnpm · Wails CLI · 平台 WebView 库

cd desktop
wails dev            # 开发热重载
wails build          # → build/bin/arcdesk-desktop

Windows 本地快速构建（跳过 NSIS 安装包，在仓库根目录执行）：

powershell -File desktop/build-dev.ps1

build-dev.ps1 内前端步骤当前使用 npm run build；日常前端开发亦可 cd desktop/frontend && pnpm install && pnpm dev。

Windows NSIS 安装包：desktop/scripts/build-windows-installer.ps1（详见 desktop/README.md）。

1. 安装 Windows 安装包并启动 ArcDesk（macOS / Linux 见上方「源码构建桌面」）
2. 在设置中粘贴 DeepSeek API Key（保存在本地凭证存储）
3. 导入工作区 — 选择项目文件夹
4. 在输入框描述任务，例如：阅读 README 并列出主要模块
5. 对工具调用（写文件、bash 等）在审批 UI 中确认

默认 Auto 模式逐步审批；Plan / YOLO 可在输入区 Shift+Tab 切换。

export DEEPSEEK_API_KEY=sk-...        # Linux / macOS；或 ./bin/ARCDESK setup 交互写入
./bin/ARCDESK setup                   # 生成 ~/.config/arcdesk/config.toml

cd your-project
./bin/ARCDESK chat                    # 交互 TUI
./bin/ARCDESK run "解释这个仓库的目录结构"

Windows PowerShell：

$env:DEEPSEEK_API_KEY = "sk-..."
.\bin\ARCDESK.exe setup
.\bin\ARCDESK.exe chat

# arcdesk.toml
default_model = "deepseek"

[[providers]]
name        = "deepseek"
kind        = "openai"
base_url    = "https://api.deepseek.com"
models      = ["deepseek-v4-flash", "deepseek-v4-pro"]
default     = "deepseek-v4-flash"
api_key_env = "DEEPSEEK_API_KEY"
context_window = 1000000

[agent]
max_steps = 25
compact_ratio = 0.8

[permissions]
mode  = "ask"
deny  = ["bash(rm -rf*)"]

完整 schema → docs/SPEC.md · 完整示例 → docs/examples/arcdesk.example.toml

deepseek-ArcDesk/
├── cmd/arcdesk/              # CLI 入口（chat / run / setup / serve / acp …）
├── internal/
│   ├── boot/                 # 组装 control.Controller
│   ├── agent/                # Agent 循环与会话
│   ├── cli/                  # TUI 与子命令
│   ├── control/              # 传输无关控制器（桌面 / CLI / HTTP 共用）
│   ├── config/               # TOML 配置加载
│   ├── provider/             # 模型后端
│   ├── tool/builtin/         # 内置工具
│   ├── plugin/               # MCP 客户端
│   ├── skill/                # Skills 与子 Agent
│   ├── serve/                # HTTP/SSE 服务
│   ├── hook/                 # Hooks
│   └── knowledge/            # Knowledge Studio / Failure Memory
├── desktop/                  # Wails 桌面应用（独立 Go 模块）
│   ├── app.go                # Go ↔ React 绑定
│   └── frontend/             # React UI
├── docs/                     # SPEC、示例配置、截图、变更记录
├── Makefile
└── README.md

完整目录说明见 CONTRIBUTING.md。

桌面、CLI、HTTP 与 ACP 共用同一 Agent 内核；桌面通过 Wails 直接绑定 control.Controller 并订阅事件流，不经 HTTP。

flowchart TB
  subgraph clients [客户端]
    D[ArcDesk 桌面]
    C[arcdesk CLI]
    H[arcdesk serve]
    A[arcdesk acp]
  end
  subgraph bind [绑定层]
    W[Wails 方法 + 事件流]
  end
  subgraph kernel [Go Agent 内核]
    BOOT[boot.Build]
    CTRL[control.Controller]
    AGENT[agent.Session]
    PROV[provider]
    TOOL[tool 注册表]
  end
  D --> W --> BOOT
  C --> BOOT
  H --> BOOT
  A --> BOOT
  BOOT --> CTRL
  CTRL --> AGENT
  AGENT --> PROV
  AGENT --> TOOL

欢迎贡献！细则见 CONTRIBUTING.md。

git clone https://github.com/P1ouson/deepseek-ArcDesk.git
cd deepseek-ArcDesk
make check-toolchain
make build && make test && make vet

Commit 规范： Conventional Commits（如 feat(desktop): … · fix: … · docs: …）

PR 流程：

1. Fork P1ouson/deepseek-ArcDesk，从 main 切分支
2. 行为变更需附测试；make test 与 make vet 通过
3. 桌面 UI 变更：desktop/frontend 通过 pnpm exec tsc --noEmit；建议 cd desktop && go test ./...
4. 提交前可运行 make fmt；可选 make hooks 安装 pre-push vet

安全漏洞： 请勿公开 Issue，见 SECURITY.md。

MIT © ArcDesk contributors

_{如果 ArcDesk 对你有帮助，欢迎 Star ⭐ 支持项目}