npm package: @jwangkun/deep-code
Description: 基于 DeepSeek API 的 AI 编程智能体，集成 pi-coding-agent 和生成式 UI
Latest version: 1.0.5

# Deep Code

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

[English](#english) | [中文](#中文)

---

## 中文

### 🚀 特性

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

### 📦 安装

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

# 或使用
npx deep-code
```

### 🔧 配置

设置 DeepSeek API 密钥：

```bash
export DEEPSEEK_API_KEY=your_api_key_here
```

可选配置：

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

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

### 🎯 使用

```bash
# 启动交互式会话
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](https://github.com/badlogic/pi-mono) - pi-coding-agent 核心框架
- [pi-generative-ui](https://github.com/Michaelliv/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

```bash
# Global installation
npm install -g deep-code

# Or use npx
npx deep-code
```

### 🔧 Configuration

Set your DeepSeek API key:

```bash
export DEEPSEEK_API_KEY=your_api_key_here
```

Optional configuration:

```bash
# 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

```bash
# 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](https://github.com/badlogic/pi-mono) - pi-coding-agent core framework
- [pi-generative-ui](https://github.com/Michaelliv/pi-generative-ui) - Generative UI features

### 📄 License

MIT