Cocode：基于DeepSeek Harness的开源AI编码智能体发行版

AI新闻 dotaai 1个月前

102

一、Cocode是什么

Cocode 是 cocode‑agency 推出的开源AI编码智能体发行版，不属于DeepSeek官方项目，基于 DeepSeek Harness（DSH）智能体运行时构建，MIT开源协议，处于开发者预览阶段。

它同时提供图形GUI客户端与终端TUI客户端，两套客户端共享同一套会话状态。不同于普通AI聊天窗口，Cocode是完整的本地开发工作空间，集成文件浏览、Git版本管理、内置终端、代码变更预览，AI生成的修改需要人工确认后才会写入磁盘，降低误改代码风险。项目本身不内置大模型，支持接入多种模型服务，适配 Windows、macOS、Linux 全平台。

Cocode（图1）

二、功能特色

双客户端互通：Electron桌面GUI、终端TUI，本地桌面与SSH远程终端可以接续同一个任务，会话状态双向同步。
多套Agent预设，支持自定义：内置Standard、PTC、Minimal、Creator四套智能体配置，可编辑agent.cordis.yml配置文件，自定义提示词、工具集、开关智能体能力。
完整本地开发工作区：内置文件管理器、Git操作、终端模拟器，AI对代码的修改会生成diff预览，确认之后才应用，避免无感知改写源码。
多模型接入方案：支持Cocode Nut自有模型服务，也可填入自定义API Key，兼容OpenAI协议接口。密钥存储在本地凭证文件，不会写入会话日志。
环境隔离与诊断工具：通过环境变量DSH_HOME、DSH_PROFILE实现多套配置隔离；内置cocode doctor命令，一键诊断运行环境故障。
插件化架构：遵循DSH“一切皆插件”理念，模型适配器、工具、会话调度全部支持替换与二次开发。

三、技术细节

底层依赖：核心运行时为@deepseek‑ai/dsh（DeepSeek Harness），基于Cordis元框架，采用插件树运行机制，Agent循环、工具注册、会话管理均为可插拔插件组件。
项目工程结构：仓库采用pnpm多子项目管理，由三大核心模块组成

cocode‑gui：Electron图形桌面客户端；
cocode‑tui：终端交互客户端，发布为npm包@cocode‑agency/tui；
cocode‑host‑supervisor：宿主后台服务，管理DSH生命周期，负责GUI/TUI之间IPC通信。

会话机制：会话以追加式事件流存储，所有模型输入输出、工具调用记录全部可回溯，支持会话重建、任务接续。
版本约束：GUI模块要求固定pnpm版本10.34.5；Node.js版本要求22.19+/24+；TUI与host‑supervisor版本必须保持一致，跨版本混用会出现兼容性异常。
协议与状态：MIT开源，开发者预览版，上游DSH接口持续迭代，存在破坏性变更风险。

四、应用场景

本地项目AI开发：对本地仓库做代码重构、Bug排查、单元测试编写、文档生成，AI改动先预览确认，保障源码安全。
SSH远程服务器开发：使用TUI终端客户端，在无图形界面服务器上直接运行AI编码智能体，远程完成项目处理。
自定义AI智能体调试：开发者修改agent配置文件，调试专属编码Agent，做二次开发与插件开发。
隐私敏感项目开发：密钥本地存储，代码与提示词不会默认外传，可接入自有API端点，适合内部私有项目。
多终端接力开发：本地桌面写一半任务，切换SSH终端继续处理，会话上下文完整保留。

五、使用方法

方式1：GUI桌面客户端

访问GitHub Releases页面，下载对应操作系统安装包，直接安装启动。

方式2：TUI终端客户端

环境准备：安装 Node.js 22.19 或更高版本
全局安装：

npm install --global @cocode‑agency/tui

启动命令：

cocode

方式3：源码编译运行

拉取仓库源码，安装pnpm 10.34.5；
使用根目录Makefile脚本：

make dev gui  # 开发模式启动GUI
make dev tui  # 开发模式启动TUI

常用命令

cocode doctor：环境检测、故障诊断
cocode --version：查看版本
重要提示：TUI和宿主supervisor版本必须完全一致，不要混用不同版本包。

模型配置

两种模型接入二选一：

Cocode Nut服务：无需API Key，提供免费额度，付费订阅可调用DeepSeek系列模型；
自定义OpenAI兼容接口：填入API地址与密钥，密钥保存在本地，不上传会话日志。

六、竞品对比

选取Aider、OpenHands作为对标产品，从部署形态、客户端形态、底层架构、自定义Agent、代码变更机制做对比。

对比项	Cocode	Aider‑chat	OpenHands
底层架构	DeepSeek Harness，一切皆插件，Cordis驱动	自有终端Agent实现	基于SWE‑Agent自有运行时
客户端形态	GUI桌面 + TUI终端，会话互通	仅终端CLI	Web网页UI
Agent自定义	yml配置完整修改提示词、工具集	有限的提示词配置	配置文件修改，能力受限
代码修改流程	diff预览，人工确认后写入文件	直接写入文件，可开启预览	预览变更，确认后写入
运行环境	本地宿主服务，支持SSH远程终端	纯终端进程	本地Web服务
开源协议	MIT	Apache‑2.0	MIT

七、常见问题解答

Cocode是DeepSeek官方产品吗？

不是，Cocode由cocode‑agency团队开发维护，只是基于DeepSeek Harness开源库构建，不属于DeepSeek官方出品。

TUI启动报错，连接宿主失败如何处理？

TUI包和host‑supervisor版本必须完全相同，版本不一致会通信失败；执行cocode doctor命令，会自动检测版本、环境依赖，给出修复提示。

我的API密钥会上传到第三方服务器吗？

密钥保存在本地DSH凭证文件，不会写入会话日志，不会随会话数据对外传输，仅本地程序调用模型接口使用。

可以使用本地部署大模型吗？

只要模型提供兼容OpenAI的API接口，就可以填入自定义端点地址使用，对模型本身无强制绑定。

开发者预览版本可以用于生产项目吗？

不建议直接用于生产环境，上游DSH接口还会发生破坏性变更，部分功能会迭代调整，适合开发者测试、二次开发。

GUI和TUI会话可以互相读取吗？

可以，两者共用同一套host‑supervisor宿主服务，同一个会话可以桌面打开，也可以SSH终端接续执行任务。

八、相关链接

GitHub仓库：https://github.com/cocode‑agency/cocode
官方文档站点：https://doc.cocode.agency

九、总结

Cocode是一套基于DeepSeek Harness打造的开源AI编码智能体发行版，凭借GUI与TUI双端互通、完整的本地开发工作区、高度可插件化的底层架构，为开发者提供可自主掌控的本地AI编码环境，它不绑定特定大模型，兼顾桌面可视化操作与SSH远程终端场景，适合希望自定义AI编码Agent、重视代码隐私的开发者进行测试与二次开发。