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