源码系统概览
文章正文
Cocode 是一套开源的 DeepSeek Harness 发行版 AI 编程工具源码，默认配置即装即用，支持桌面 GUI 和终端 TUI 双入口。
该工具将模型选择、工具装配、技能配置、会话管理和沙箱调度全部插件化，用户可在界面中直接查看和修改 agent.cordis.yml 配置文件。
Cocode 内置 Standard、PTC、Minimal 和 Creator 四种预设方案，用户可复制任一方案进行定制。
该项目基于 DeepSeek Harness 运行时构建，GUI 和 TUI 通过共享 Host 连接同一会话记录，桌面端和终端端可无缝切换工作状态。
该工具支持 Cocode Nut 自有模型服务、用户自有 DeepSeek API Key 以及任意 OpenAI 兼容端点三种模型接入方式。
源码简介
Cocode 是由 Cocode Agency 开发的开源 AI 编码代理工具源码，当前版本为开发者预览版 v0.1.0。
该项目采用 MIT 许可证开源，欢迎贡献 star 和 fork。仓库包含三个独立组件：cocode-gui（Electron 桌面客户端）、cocode-tui（终端客户端）和 cocode-host-supervisor（共享 Host 生命周期管理）。
三个组件通过统一的 Host 协议连接，共享 DSH_HOME、profile 和 Host 配置作用域。
GUI 和 TUI 从不直接启动 Harness 进程，而是获取租约连接到 Host 广播的端点。
最后更新 2026 年，项目持续维护中，更新日志见 GitHub Releases 页面。
适用场景
适用于需要本地部署 AI 编程助手的开发团队和个人开发者。
桌面 GUI 适合日常编码工作，终端 TUI 适合 SSH 远程开发和无图形界面环境。
两种入口共享同一会话，可随时切换工作方式。
该工具特别适合关注数据隐私的用户，所有代码和提示词均在本地处理，不上传至第三方服务器。
Cocode Nut 模型服务承诺不使用用户代码进行训练。
技术栈与运行环境
组件技术要求：cocode-gui 需要 Node.js 22.12.0 以上版本和 pnpm 10.34.5；cocode-tui 需要 Node.js 22.19.x 或 24 以上版本；
cocode-host-supervisor 需要 Node.js 22.12.0 以上版本。项目使用 Makefile 管理开发命令，支持 macOS、Windows 和 Linux 平台源码构建。
运行时依赖 DeepSeek Harness（@deepseek-ai/dsh npm 包），由 host-supervisor 统一管理。
环境变量包括 DSH_HOME、DSH_PROFILE、COCODE_HOME 和 DSH_SESSION_ROOT，用于配置共享 Host 作用域和会话文件路径。
功能亮点
- 双入口共享会话：桌面 GUI 和终端 TUI 连接同一 Host，读写同一会话记录
- 插件化 agent 架构：工具、提示词、能力均通过 preset 组装，可直接在界面中查看和修改
- 多模型支持：Cocode Nut 自有服务、DeepSeek API Key、OpenAI 兼容端点三种方式自由切换
- 工作区而非聊天框：文件、Git、终端、内置浏览器和 diff 预览并排展示
- 四种内置预设：Standard、PTC、Minimal、Creator，复制即可定制
技术架构与部署指南
安装与部署提示
GUI 安装：从 GitHub Releases 下载对应平台安装包，启动后选择 Cocode Nut 或自有 DeepSeek Key 即可。
TUI 安装：安装 Node.js 22.19.x 后执行 npm install –global @cocode-agency/tui，运行 cocode doctor 检查环境，再执行 cocode 启动。最后更新 2026 年，版本号 v0.1.0。
源码构建：执行 make install-gui && make dev gui 启动桌面版，或 make install-tui && make dev tui 启动终端版。构建分发包执行 make gui-build。
更新日志详见 GitHub Releases 页面。
截图与演示说明
以下截图展示了 Cocode 的桌面工作区界面，包含会话窗口、文件浏览器、终端面板和 diff 预览区域。用户可在工作区中直接查看 agent 修改的内容和执行的命令。
桌面工作区展示了 DeepSeek Harness 会话的完整界面，包含文件树、代码编辑器、终端和预览面板。
终端 TUI 截图展示了纯终端环境下的会话交互界面。
常见问题
问：Cocode 是什么？
Cocode 是基于 DeepSeek Harness 的开源 AI 编程工具发行版，提供桌面 GUI 和终端 TUI 双入口，支持插件化 agent 架构和多模型接入。
问：Cocode 和 Cursor 的区别是什么？
Cocode 对比 Cursor 的区别在于以下方面：
| 特性 | Cocode | Cursor |
|---|---|---|
| 开源许可 | MIT 开源 | 闭源商业 |
| 入口 | GUI 和 TUI 共享会话 | 仅 GUI |
| Agent 配置 | 可查看和修改 preset | 不可查看 |
Cocode 和 Cursor 的区别核心在于开放度和会话共享能力。
问：如何安装 Cocode TUI？
安装 Node.js 22.19.x 以上版本，执行 npm install –global @cocode-agency/tui，然后运行 cocode doctor 检查环境，最后执行 cocode 启动终端界面。
问：Cocode 是否免费？
Cocode 本身是开源免费的 MIT 项目。Cocode Nut 模型服务提供免费层（Flash 模型），付费层每月 10 美元可用价值约 60 美元的模型调用量。
安全风险提示
该项目未发现 eval、base64_decode、shell_exec 等高风险函数。CORS 配置由 Host 层统一管理，本地运行不涉及跨域请求。Docker 部署时需注意 DSH_HOME 目录权限设置，避免容器内敏感凭据泄露。nginx 反向代理配置需限制 Host 端口的外部访问权限。
API Key 存储在 DSH 凭据文件中，不进入会话日志。建议在生产环境中启用网络隔离，限制 Host 端点仅本地访问。
下载说明
本源码包含 Cocode 完整源代码，涵盖 cocode-gui、cocode-tui 和 cocode-host-supervisor 三个组件。下载后可通过 Makefile 进行源码构建和开发调试。源码包已打包为 zip 格式，提取码 8888。
GitHub项目开源地址：https://github.com/cocode-agency/cocode