# lisa_code

**Repository Path**: ichiva_admin/lisa_code

## Basic Information

- **Project Name**: lisa_code
- **Description**: 基于claude code实现的一个Agent
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-22
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CN Agent - 迷你 Claude Code 中文版

一个基于技能机制的 AI 编码代理，支持 OpenAI 兵容 API。

## 快速开始

### 1. 安装依赖
```bash
pip install -r requirements.txt
```

### 2. 配置 API 密钥
```bash
# 复制示例配置文件
cp .env.example .env

# 编辑 .env 文件，填入你的 API 密钥
# OPENAI_API_KEY=your-api-key-here
# OPENAI_BASE_URL=https://api.openai.com/v1
# MODEL=gpt-4o-mini
```

### 3. 运行代理
```bash
python agent.py
```

## 功能特性

- **工具调用**: bash, read_file, write_file, edit_file
- **任务管理**: TodoWrite 工具
- **子代理**: Task 工具
- **技能系统**: Skill 工具
- **中文界面**: 完全中文化的交互提示

## 项目结构
```
cn_agent/
├── agent.py          # 主代理文件
├── api_config.py     # API 配置
├── requirements.txt  # Python 依赖
├── .env.example      # 环境变量示例
├── .env              # 环境变量 (需创建)
└── skills/            # 技能目录
    ├── agent-builder/
    │   └── SKILL.md
    ├── code-builder/
    │   └── SKILL.md
    ├── code-review/
    │   └── SKILL.md
    └── pdf/
        └── SKILL.md
```

## 核心理念

### 知识外化
传统 AI 将知识锁定在模型参数中，需要昂贵训练才能更新。
本代理通过技能文件（SKILL.md）存储专业知识，实现：
- **成本**: 免费（vs $10K-$1M+ 训练成本)
- **时间**: 分钟级（vs 周级训练时间)

### 渐进式披露
```
第 1 层: 元数据（始终加载） ~100 tokens/技能
         name + description

第 2 层: SKILL.md 正文（触发加载） ~2000 tokens
         详细指令

第 3 层: 资源（按需） 无限制
         scripts/, references/, assets/
```

### 缓存保护
技能内容作为 `tool_result` 注入，保护提示缓存。
- **错误**: 编辑系统提示 → 缓存失效，成本 +20-50x
- **正确**: tool_result 追加 → 前缀不变，缓存命中

## 使用示例

```text
你: 请帮我创建一个 Python 脚本来处理 CSV 文件

> 加载技能: code-builder
  技能已加载 (1234 字符)

[代理使用 code-builder 技能的知识来生成代码...]

> write_file
  已写入 2345 字节到 csv_handler.py

我已创建了一个 CSV 处理脚本。主要功能：
- 读取 CSV 文件
- 数据验证
- 错误处理
- 结果输出
```

## 配置说明

### 环境变量
| 变量 | 说明 | 必需 |
|------|------|------|
| `OPENAI_API_KEY` | API 密钥 | 是 |
| `OPENAI_BASE_URL` | API 基础 URL | 否 (默认: OpenAI) |
| `MODEL` | 模型名称 | 否 (默认: gpt-4o-mini) |

### 支持的 API 服务
- OpenAI (官方)
- Azure OpenAI
- 火山引擎
- 智谱 AI
- 其他 OpenAI 兼容服务

## 扩展开发
### 添加新技能
1. 在 `skills/` 目录下创建新文件夹
2. 添加 `SKILL.md` 文件，格式：
```yaml
---
name: your-skill
description: 技能描述
---

# 技能详细说明
...
```

### 添加新工具
在 `agent.py` 的 `BASE_TOOLS` 列表中添加新工具定义。

## 技术栈
- Python 3.8+
- requests (HTTP 客户端)
- python-dotenv (环境变量)

## 许可证
MIT License

## 致谢
本项目基于 Claude Code 的代理架构设计。