# DeepSeek-chat

**Repository Path**: sansecy/deep-seek-chat

## Basic Information

- **Project Name**: DeepSeek-chat
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek Assistant for VS Code

AI-powered coding assistant using the DeepSeek API with chat, code explanation, review features, and extensible agents — right inside VS Code.

## Features

### Chat
- **Streaming Chat** — Interactive chat panel with real-time streaming responses
- **Tool Integration** — AI can read/write files, search code, execute commands, and manage todos
- **Web Search** — Built-in MCP-based web search (Baidu, Bing) with full article fetching
- **Slash Commands** — Type `/review`, `/explain`, `/refactor`, `/test`, `/doc` for quick actions

### Agents (智能体)
- **Extensible Agent System** — Switch between specialized AI agents for different tasks
- **Built-in Agents** — General Assistant, 智能问答
- **Sub-Agents** — Parent agents can delegate to reviewer, explainer, implementer, and planner sub-agents
- **Custom Agents** — Create your own agents with custom system prompts and tool access

### Skills (技能)
- **Reusable Workflows** — Skills provide structured, parameterized instruction templates
- **Slash Command Access** — Invoke skills directly from chat with `/skill-name`
- **Custom Skills** — Create `.skill.md` files in `~/.deepseek/skills/`

### Multi-Provider Support
- **DeepSeek** — DeepSeek V4 Flash and V4 Pro models
- **Xiaomi MiMo** — MiMo Auto (pay-per-use) and MiMo V2.5 (token plan)
- **Custom Providers** — Configure your own API endpoints

### Code Actions
Select code in the editor, right-click and choose:
- **Explain This Code** — Get a line-by-line explanation
- **Review This Code** — Get a review focusing on bugs, performance, and security
- **Ask DeepSeek About Selection** — Ask a custom question about the selected code

### Memory System
- **Two-Level Memory** — Global memory (persists across projects) and project memory (workspace-specific)
- **Automatic Context** — AI remembers your preferences, tech stack, and project architecture

### Security
- **API Key Storage** — API keys stored in VS Code's SecretStorage
- **Tool Presets** — Control what tools each agent can access (readonly, development, full, full+MCP)

## Requirements

- VS Code 1.85.0 or higher
- A [DeepSeek API](https://platform.deepseek.com/) account and API key

## Installation

1. Install the extension from VS Code Marketplace
2. Open the DeepSeek sidebar (robot icon in the activity bar)
3. Go to the **Settings** tab and enter your API key
4. Click **Test Connection** to verify
5. Start chatting in the **Chat** tab

## Configuration

| Setting | Default | Description |
|---------|---------|-------------|
| API Key | (required) | Your DeepSeek API key (starts with `sk-`) |
| Base URL | `https://api.deepseek.com` | API endpoint URL |
| Model | `deepseek-v4-flash` | Model to use (`deepseek-v4-flash` or `deepseek-v4-pro`) |

## Usage

### Chat Panel
Open the DeepSeek sidebar and use the Chat tab to ask questions.

### Slash Commands
Type these in the chat input:

| Command | Description |
|---------|-------------|
| `/review <file> --focus=<area>` | Deep code review |
| `/explain <file>` | Line-by-line code explanation |
| `/refactor <file>` | Refactoring suggestions and implementation |
| `/test <file>` | Generate unit tests |
| `/doc <file>` | Generate code documentation |

### Code Actions
Select code in the editor, right-click and choose:
- **Explain This Code** — Get a line-by-line explanation
- **Review This Code** — Get a review focusing on bugs, performance, and security
- **Ask DeepSeek About Selection** — Ask a custom question about the selected code

### Agents
Configure agents via the `DeepSeek: Open Agents Config File` command, or manage them programmatically. See [agents.md](agents.md) for detailed architecture documentation.

### Creating Custom Skills
1. Create a `.skill.md` file in `~/.deepseek/skills/`
2. Define front matter (id, name, description, parameters)
3. Write the skill prompt using `{{parameter}}` placeholders
4. The skill will be automatically loaded on restart

Example:
```markdown
---
id: review
name: 代码审查
description: 对指定代码进行深度审查
tools: [read_file, search_code]
parameters:
  - name: target
    type: string
    required: true
    description: 要审查的文件路径
  - name: focus
    type: string
    required: false
    description: 审查重点
    default: all
---

你是一位代码审查专家。请审查 {{target}}，重点关注 {{focus}}。
```

## Tool Presets

| Preset | Tools | Use Case |
|--------|-------|----------|
| Read Only | read_file, search_code, list_workspace | Reading code only |
| Development | + edit_file, write_file, execute_command | Development tasks |
| Full Access | + todo management, memory management | Full access |
| Full + MCP | + web search, article fetching | Full access + internet |

## Project Structure

```
src/
├── extension.ts          # Extension entry point
├── chatWebview.ts         # Chat webview panel
├── deepseekClient.ts      # DeepSeek API client
├── commandHandlers.ts     # Command handlers
├── agents.ts              # Agent system (AgentManager)
├── skills.ts              # Skills system (SkillManager)
├── toolHandler.ts         # Tool execution handler
├── memoryManager.ts       # Memory system (global + project)
├── mcpClient.ts           # MCP client
├── mcpManager.ts          # MCP server manager
├── providers.ts           # Multi-provider support
├── settingsPanel.ts       # Settings webview
├── types.ts               # Shared type definitions
├── i18n.ts                # Internationalization
└── logger.ts              # Logging
```

## License

MIT