# s_full

**Repository Path**: debugc/s_full

## Basic Information

- **Project Name**: s_full
- **Description**: https://github.com/shareAI-lab/learn-claude-code/blob/main/agents/s_full.py教学项目复刻。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Agent 助手

基于 Rust 后端 + React 前端的 AI Agent 系统，支持多种 LLM 提供商。

[https://github.com/shareAI-lab/learn-claude-code/blob/main/agents/s\_full.py教学项目复刻。](https://github.com/shareAI-lab/learn-claude-code/blob/main/agents/s_full.py)

## 功能特性

- 🤖 **多 LLM 支持**：SiliconFlow、OpenAI、Ollama
- 🛠️ **内置工具**：文件读写、目录创建、后台任务、日期查询
- 🌐 **网络工具**：网页内容提取、网络搜索
- 📋 **看板系统**：任务管理
- ⚠️ **安全控制**：危险命令拦截与审批
- 📝 **Markdown 支持**：富文本渲染

## 技术栈

- **后端**：Rust + Axum + async-openai
- **前端**：React + TypeScript + Tailwind CSS + Vite
- **数据库**：SQLite

## 快速开始

### 前置要求

- Rust 1.70+
- Node.js 18+
- LLM API Key（配置在 config.toml）

### 后端

```bash
cd backend
cargo run
```

后端默认运行在 <http://localhost:3000>

### 前端

```bash
cd frontend
npm install
npm run dev
```

前端默认运行在 <http://localhost:5173>

## 配置

编辑 `backend/config.toml`：

```toml
[provider]
default_provider = "siliconflow"
default_model = "Pro/MiniMaxAI/MiniMax-M2.5"

[web_api]
base_url = "http://localhost:8000"

[providers.siliconflow]
api_key = "your-api-key"
base_url = "https://api.siliconflow.cn/v1"
```

## 可用工具

| 工具                   | 说明         |
| -------------------- | ---------- |
| bash\_command        | 执行 Bash 命令 |
| read\_file           | 读取文件       |
| write\_file          | 写入文件       |
| edit\_file           | 编辑文件       |
| make\_dir            | 创建目录       |
| run\_in\_background  | 后台执行命令     |
| get\_current\_date   | 获取当前日期     |
| web\_page\_view      | 查看网页内容     |
| web\_search          | 网络搜索       |
| create\_task         | 创建任务       |
| update\_task\_status | 更新任务状态     |

## 安全机制

- 危险命令（rm、sudo 等）需要人工审批
- 安全命令（ls、cat、git status 等）自动放行
- 工作目录隔离，防止目录穿越攻击

## 许可证

MIT