@jwangkun/deep-code

Deep Code

基于 DeepSeek API 的 AI 编程智能体，集成 pi-coding-agent 和生成式 UI 功能

English | 中文

---

中文

特性

• DeepSeek API 集成 - 支持 DeepSeek Chat、Coder、Reasoner 模型
• 交互式终端界面 - 基于 pi-coding-agent 的强大终端 UI
• 生成式 UI - 支持实时可视化组件渲染（集成 pi-generative-ui）
• 会话管理 - 持久化会话历史，支持分支和回溯
• 工具系统 - 文件操作、命令执行、代码编辑
• 思考级别 - 支持 5 个推理深度级别

安装

# 全局安装
npm install -g deep-code

# 或使用
npx deep-code

配置

设置 DeepSeek API 密钥：

export DEEPSEEK_API_KEY=your_api_key_here

可选配置：

# 自定义 API 端点（默认：https://api.deepseek.com）
export DEEPSEEK_BASE_URL=https://api.deepseek.com

# 自定义数据存储目录（默认：~/.deep-code）
export DEEP_CODE_CODING_AGENT_DIR=~/.deep-code

使用

# 启动交互式会话
deep
# 或
deep-code

# 指定模型
deep --model=deepseek-reasoner

# 创建新会话
deep --new

# 查看帮助
deep --help

支持的模型

模型	类型	上下文	最大输出	特点
deepseek-chat	通用	64K	8K	代码生成、对话
deepseek-coder	编程专用	64K	8K	代码理解、重构
deepseek-reasoner	推理	64K	8K	复杂问题求解

工具系统

• read - 读取文件内容
• write - 写入文件
• edit - 编辑文件（搜索替换）
• bash - 执行 shell 命令
• grep - 文本搜索
• ls - 列出目录
• visualize_read_me - 加载 UI 设计指南
• show_widget - 渲染可视化组件

生成式 UI

基于 pi-generative-ui 的可视化能力：

• diagram - 流程图、架构图、SVG 图形
• mockup - UI 原型、表单、卡片
• interactive - 交互式控件、滑块、实时计算
• chart - 图表、数据分析（Chart.js）
• art - 插画、生成艺术

项目结构

deep-code/
├── src/
│   ├── ai/              # AI 提供商和模型配置
│   ├── core/            # 核心功能（会话、工具、认证）
│   ├── extensions/      # 扩展系统（generative-ui）
│   ├── cli.ts           # CLI 入口
│   ├── main.ts          # 主逻辑
│   └── config.ts        # 配置管理
├── dist/                # 编译输出
├── package.json
└── tsconfig.json

致谢

本项目整合了以下开源项目：

• pi-mono - pi-coding-agent 核心框架
• pi-generative-ui - 生成式 UI 功能

许可证

MIT

---

English

Features

• DeepSeek API Integration - Supports DeepSeek Chat, Coder, Reasoner models
• Interactive Terminal UI - Powerful terminal UI based on pi-coding-agent
• Generative UI - Real-time visual component rendering (pi-generative-ui integration)
• Session Management - Persistent conversation history with branching and backtracking
• Tool System - File operations, command execution, code editing
• Thinking Levels - 5 reasoning depth levels supported

Installation

# Global installation
npm install -g deep-code

# Or use npx
npx deep-code

Configuration

Set your DeepSeek API key:

export DEEPSEEK_API_KEY=your_api_key_here

Optional configuration:

# Custom API endpoint (default: https://api.deepseek.com)
export DEEPSEEK_BASE_URL=https://api.deepseek.com

# Custom data storage directory (default: ~/.deep-code)
export DEEP_CODE_CODING_AGENT_DIR=~/.deep-code

Usage

# Start interactive session
deep
# or
deep-code

# Specify model
deep --model=deepseek-reasoner

# Create new session
deep --new

# Show help
deep --help

Supported Models

Model	Type	Context	Max Output	Features
deepseek-chat	General	64K	8K	Code generation, conversation
deepseek-coder	Programming	64K	8K	Code understanding, refactoring
deepseek-reasoner	Reasoning	64K	8K	Complex problem solving

Acknowledgments

This project integrates:

• pi-mono - pi-coding-agent core framework
• pi-generative-ui - Generative UI features

License

MIT