# chinese-agent

**Repository Path**: bdstu/chinese-agent

## Basic Information

- **Project Name**: chinese-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Chinese Agent (中文 AI Agent)

> 小核心 + 插件化 + 多 Agent 协作

中国版 AI Agent 工具，融合 Claude Code CLI 和 OpenClaw 的优势，专为国内使用习惯设计。

## 快速开始

### 安装依赖

```bash
cd chinese-agent
npm install
```

### 运行测试

```bash
# 运行核心测试
npm test

# 或直接用 CLI
npm start -- run "查看当前目录"
```

### CLI 命令

```bash
# 执行请求
node bin/cli.js run "你的请求"

# 查看状态
node bin/cli.js status

# 查看工具列表
node bin/cli.js tools

# 查看历史
node bin/cli.js history

# 交互模式
node bin/cli.js repl
```

## 核心架构

```
src/
├── core/
│   ├── CoreEngine.js      # 核心引擎（整合所有模块）
│   ├── TaskParser.js      # 任务解析器（意图识别→任务分解）
│   ├── AgentScheduler.js  # Agent 调度器（多 Agent 协作）
│   └── ToolManager.js     # 工具管理器（工具注册/执行）
├── tools/
│   └── index.js           # 内置工具（bash/file_read/file_edit 等）
├── agents/                # Agent 工厂（待开发）
└── adapters/              # 适配层（待开发）
```

## 核心能力

### 1. 任务解析
- 意图识别（查询/执行/创作/分析）
- 任务分解（多步骤任务→子任务列表）
- 依赖分析（DAG 生成）

### 2. 多 Agent 协作
- **主 Agent**: 任务分解、结果汇总、用户交互
- **工作 Agent**: 执行具体子任务（最多 5 个并行）
- **专家 Agent**: 专项能力（待开发）
- **监控 Agent**: 异常检测（待开发）

### 3. 工具系统
- `bash` - 执行 shell 命令
- `file_read` - 读取文件
- `file_edit` - 编辑文件
- `file_write` - 写入文件
- `grep` - 搜索内容
- `glob` - 文件匹配

## 开发计划

### Phase 1: 核心框架 (当前)
- [x] 任务解析器
- [x] Agent 调度器
- [x] 工具管理器
- [x] CLI 入口
- [ ] 实际工具执行（fs/exec）

### Phase 2: 国内化适配
- [ ] Qwen 3.5 Plus 适配
- [ ] 国内搜索集成
- [ ] 浏览器控制

### Phase 3: 记忆与进化
- [ ] 记忆引擎
- [ ] 自进化引擎
- [ ] 异常检测与恢复

### Phase 4: 插件系统
- [ ] 技能加载机制
- [ ] 技能管理界面
- [ ] MCP 集成

## 测试示例

```bash
# 简单查询
node bin/cli.js run "搜索代码中的 TODO"

# 多步骤任务
node bin/cli.js run "先查看当前目录，然后分析项目结构，最后生成报告"

# 交互模式
node bin/cli.js repl
```

## 许可证

MIT