# llm_prompt_test_tool

**Repository Path**: duzc2/llm_prompt_test_tool

## Basic Information

- **Project Name**: llm_prompt_test_tool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CLI Agent — Python 命令行智能体

一个用于测试提示词的 CLI 智能体，支持 Anthropic Claude / OpenAI / DeepSeek。

## 快速开始

```bash
# 1. 创建虚拟环境
python -m venv .venv
source .venv/bin/activate   # Linux/Mac
# .venv\Scripts\activate    # Windows

# 2. 安装依赖
pip install -r requirements.txt

# 3. 设置 API Key
export ANTHROPIC_API_KEY=sk-ant-...    # Anthropic
# 或
export OPENAI_API_KEY=sk-...           # OpenAI
# 或
export DEEPSEEK_API_KEY=sk-...         # DeepSeek

# 4. 运行
python main.py
```

## 配置文件

编辑 `config.yaml`：

```yaml
llm:
  provider: "deepseek"          # anthropic | openai | deepseek
  model: "deepseek-v4-pro"
  api_key_env: "DEEPSEEK_API_KEY"
  base_url: "https://api.deepseek.com"
  max_tokens: 4096
  temperature: 0.7
  thinking:                     # 仅 DeepSeek
    enabled: true
    effort: "high"              # high | max
```

## SKILLS

在 `SKILLS/` 目录下创建技能文件夹，每个文件夹包含 `SKILL.md`：

```
SKILLS/
  code-review/
    SKILL.md
```

SKILL.md 格式（YAML frontmatter + Markdown）：

```markdown
---
name: code-review
description: 代码审查助手
---

你是一个代码审查专家。当用户要求审查代码时，请检查...
```

## 对话记录

对话以 jsonl 格式保存在 `conversation.jsonl`：

```jsonl
{"role": "system", "content": "你是一个智能体助手..."}
{"role": "user", "content": "你好"}
{"role": "assistant", "content": "你好！有什么可以帮你的？"}
```

## 命令

| 命令 | 说明 |
|------|------|
| `/help` | 显示帮助 |
| `/exit` | 退出 |
| `/clear` | 清空对话 |
| `/skills` | 列出已加载的技能 |
| `/processes` | 列出运行中的 CLI 进程 |
| `/save` | 手动保存对话 |

## 项目结构

```
cli-agent/
├── main.py              # 入口
├── config.yaml           # 配置
├── requirements.txt
├── agent/
│   ├── config.py         # 配置加载
│   ├── core.py           # Agent 核心循环 + Tool Calling
│   ├── llm/              # LLM 提供者
│   │   ├── anthropic.py  #   Anthropic Claude
│   │   └── openai_compat.py  # OpenAI / DeepSeek
│   ├── tools/            # 工具模块
│   │   ├── file_ops.py   #   文件读写（大文件优化）
│   │   └── process_mgr.py    #   异步进程管理器
│   ├── skill/            # SKILL 加载器
│   └── conversation/     # 对话记录（jsonl）
├── SKILLS/               # 技能目录（只读）
└── data/                 # 数据目录（可读写）
```