Deep Code CLI
[![][npm-release-shield]][npm-release-link] [![][npm-downloads-shield]][npm-downloads-link] [![][github-contributors-shield]][github-contributors-link] [![][github-forks-shield]][github-forks-link] [![][github-stars-shield]][github-stars-link]
[![][github-issues-shield]][github-issues-link] [![][github-issues-pr-shield]][github-issues-pr-link] [![][github-license-shield]][github-license-link]
[English](README-en.md) · 中文
[Deep Code](https://github.com/lessweb/deepcode-cli) 是专为 `deepseek-v4` 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制、Agent Skills 以及 MCP 集成。
## 安装
```bash
npm install -g @vegamo/deepcode-cli
```
在任意项目目录下运行 `deepcode` 即可启动。
## 配置
创建 `~/.deepcode/settings.json` 文件，内容如下：
```json
{
"env": {
"MODEL": "deepseek-v4-pro",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "sk-..."
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}
```
配置文件与 [Deep Code VSCode 插件](https://github.com/lessweb/deepcode) 共享，无需重复配置。
完整配置说明（多层级优先级、环境变量等）请参阅 [docs/configuration.md](docs/configuration.md)。
## 主要功能
### **Skills**
Deep Code CLI 支持 agent skills，允许您扩展助手的能力：
Skills 会按以下优先级扫描：
| Scope | Path | Purpose |
| :------ | :-------------------- | :----------------- |
| Project | `./.deepcode/skills/` | Deep Code 原生位置 |
| Project | `./.agents/skills/` | 跨客户端互操作 |
| User | `~/.deepcode/skills/` | Deep Code 原生位置 |
| User | `~/.agents/skills/` | 跨客户端互操作 |
### **为 DeepSeek 优化**
- 专门为 DeepSeek 模型性能调优。
- 通过使用[上下文缓存](https://api-docs.deepseek.com/guides/kv_cache)来降低成本。
- 原生支持[思考模式](https://api-docs.deepseek.com/guides/thinking_mode)和思考强度控制。
## 使用飞书交互（飞书机器人）
Deep Code 提供独立的飞书机器人前端（`packages/feishu-bot`），配置好后**无需打开终端**，直接在飞书聊天里驱动 Deep Code 干活。它复用同一套引擎（`SessionManager`），多轮对话、权限卡片确认、模型反问、图片输入、Skills、MCP 全部可用，并支持多项目切换。
### 第一步：创建飞书应用
在[飞书开放平台](https://open.feishu.cn/)创建**企业自建应用**，启用「机器人」能力，申请权限：
- `im:message`、`im:message:send_as_bot`、`im:message.p2p_msg:readonly`、`im:message.group_at_msg:readonly`、`im:message:update`、`im:resource`
订阅事件 `im.message.receive_v1`，并将**事件传输方式设为「长连接」**（无需公网 URL），发布版本并等待审批通过。
### 第二步：配置
创建 `~/.deepcode/feishu-bot.json`（`appId` / `appSecret` 填你的应用凭据）：
```json
{
"appId": "cli_xxx",
"appSecret": "xxx",
"projects": { "repo": "C:/path/to/repo" },
"allowChatIds": [],
"allowUserOpenIds": [],
"showThinking": false,
"thinkingMaxChars": 1500
}
```
`projects` 可选：不配置时默认项目 = **运行 `deepcode-feishu` 的当前文件夹**（在哪启动就在哪干活）；配置多个仓库后可用 `/use