project
Cocode - 开源DeepSeek Harness发行版，提供GUI与TUI双入口
Cocode 是 DeepSeek Harness 的开源发行版，提供桌面 GUI 与终端 TUI 双入口。工具将文件、Git、终端、浏览器和 Agent 共处一个工作空间，会话实时同步。Agen...
Cocode是什么
Cocode 是 DeepSeek Harness 的开源发行版，提供桌面 GUI 与终端 TUI 双入口。工具将文件、Git、终端、浏览器和 Agent 共处一个工作空间，会话实时同步。Agent 能力通过 preset 插件自由拆解组装，关键操作需确认后执行。Cocode支持 Cocode Nut 模型服务或自备 API Key，将 AI 编程从聊天工具升级为可信任、可定制的生产工作台。
Cocode的主要功能
-
开箱即用发行版：Cocode 是基于 DeepSeek Harness 的开源发行版，提供桌面 GUI 与终端 TUI 双入口，用户无需从零配置插件即可直接开始 AI 辅助编程。
-
一体化工作空间：将文件浏览、Git 版本控制、终端命令行、内置浏览器和 Agent 会话整合在同一个界面内，消除在多窗口间来回切换的碎片化体验。
-
双端会话同步：GUI 桌面端与 TUI 终端端共享同一套 Host 和会话状态，用户在桌面推进的任务可以通过 SSH 进入终端无缝继续，进度完全不会丢失。
-
可拆解的 Agent 预设：Agent 的能力组合通过 preset 插件化配置，内置 Standard、PTC、Minimal、Creator 四种预设，用户可自由复制并修改其中的工具集、提示词与权限开关。
-
安全确认机制：系统在写入文件、执行命令或联网请求等关键操作前会自动暂停并展示影响范围，经用户确认后才继续执行，确保每一步操作安全可控。
-
Diff 预览确认：所有代码改动均支持 diff 预览，用户可以在确认应用前逐行查看变更内容，有效防止误改或意外覆盖原有代码。
-
灵活的模型接入：支持 Cocode Nut 订阅服务、DeepSeek 官方 API Key 及任意 OpenAI-compatible 端点，三种方式可随时切换且密钥不会写入会话日志。
-
开源跨平台：支持 macOS、Windows 和 Linux 跨平台源码构建，当前发布版已提供 macOS 与 Windows 安装包。
如何使用Cocode
- 安装：从 GitHub Releases 下载对应平台的 GUI 安装包，或运行
npm install --global @cocode-agency/tui安装终端客户端。 - 启动：打开 GUI 应用，或在真实终端中运行
cocode doctor检查环境后执行cocode进入 TUI。 - 配置模型：首次启动时选择 Cocode Nut 登录订阅，或填入你自己的 DeepSeek 兼容 API Key。
- 打开工作空间：在界面中打开一个本地代码仓库作为工作目录，Agent 将在此目录内执行操作。
- 下达任务：在会话中描述你的开发目标，Agent 会自动分析文件、调用工具并规划执行步骤。
- 确认操作：当 Agent 需要修改文件、执行命令或联网时，系统会暂停并展示影响范围，你确认后才继续。
- 审阅改动：在预览面板中查看代码 diff，确认无误后批准应用，所有变更将写入工作空间。
- 跨端续作：需要切换环境时，在另一入口（GUI 或 TUI）用相同的
DSH_HOME和 profile 连接同一 Host，任务状态自动同步。
Cocode的核心优势
- 开箱即用：作为 DeepSeek Harness 的现成发行版，把模型、工具、技能和安全边界预先配置好，下载打开就能直接开始编码工作。
- 双端无缝切换：桌面 GUI 与终端 TUI 共享同一套 Host 和会话状态，在桌面推进的任务 SSH 到服务器后能从终端无缝续作。
- 一体化工作空间：文件浏览、Git、终端、内置浏览器和 Agent 对话共处一个界面，无需在多窗口之间拼接上下文。
- Agent 透明可拆：Agent 的能力组合通过 preset 插件化暴露，内置四种预设且支持自由复制修改，你可以像打开机箱一样看到并调整它的内部结构。
- 操作安全可控：写入文件、执行命令和联网等关键动作都会先暂停并展示影响范围，经你确认后才继续，避免误操作。
- 改动先审后发：所有代码变更以 diff 形式在预览面板中呈现，确认无误后再应用，确保对每一处修改都心中有数。
Cocode的项目地址
- 项目官网：https://cocode.agency/
- GitHub仓库：https://github.com/cocode-agency/cocode
Cocode的同类竞品对比
| 对比维度 | Cocode | Cursor |
|---|---|---|
| 产品定位 | DeepSeek Harness 的开源发行版，强调”可拆解的工作空间” | 基于 VS Code 的 AI 原生 IDE，强调”AI 优先的编码体验” |
| 界面形态 | 桌面 GUI + 终端 TUI 双入口，会话状态互通 | 完整的 IDE 界面（VS Code 分支），无原生 TUI |
| Agent 架构 | Preset 插件化配置，可自由拆解/替换工具、提示词和权限 | 内置 Agent 能力，通过 .cursorrules 和设置调整，架构相对封闭 |
| 开源性 | MIT 完全开源，可自由 fork、修改和分发 | 闭源商业产品，核心代码不开放 |
| 模型支持 | Nut 订阅 / DeepSeek Key / 任意 OpenAI-compatible 端点，随时切换 | 自有模型 + 支持自定义 API Key，但深度集成 Cursor 的模型路由 |
| 工作空间理念 | 文件、Git、终端、浏览器、Agent 共处一个界面，结果留在任务线里 | 以编辑器为中心，AI 侧边栏/Composer 辅助，文件系统通过 VS Code 原生管理 |
| 安全确认机制 | 写文件、执行命令、联网前强制暂停并展示影响范围，需用户确认 | 可配置自动运行或确认，Yolo 模式支持全自动执行，安全边界由用户自行设定 |
| 远程/服务器场景 | TUI 支持 SSH 直连，无图形环境也能全功能使用 | 需远程桌面或 VS Code Server，纯终端环境无法使用 |
Cocode的应用场景
- 远程服务器开发与运维：通过 TUI SSH 进入生产服务器或容器，在无图形界面的环境下让 Agent 分析日志、修改配置、执行部署脚本，GUI 与 TUI 会话互通，桌面写代码、服务器上验证。
- 安全敏感的企业内网开发：Cocode 支持完全本地运行 + 自备 API Key，代码不离开内网；关键操作均需人工确认，适合对数据安全和操作审计要求严格的金融、政企场景。
- 大型代码库的重构与迁移：用可拆解的 Agent Preset，为不同模块配置专门的工具集和提示词策略；Agent 在统一工作空间内跨文件分析依赖、批量修改、运行测试，所有改动以 diff 形式集中审阅后统一应用。
- 自定义 AI 工作流编排：开发者可基于开源代码复制并修改 Agent Preset，定义专属的工具组合、安全边界和调度逻辑，打造贴合团队规范的定制化编码 Agent。