Metadata-Version: 2.4
Name: deepseek-agent-2026
Version: 3.1.1
Summary: DeepSeek AI Agent - 智能终端助手，支持 JSON 模式工具调用、文件精确编辑、后台任务处理、对话历史
Author: 我是个人
License: MIT
Project-URL: Homepage, https://github.com/user/deepseek-agent
Project-URL: Repository, https://github.com/user/deepseek-agent.git
Project-URL: Issues, https://github.com/user/deepseek-agent/issues
Keywords: deepseek,ai,agent,termux,terminal,assistant,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Android
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Terminals
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: openai==0.28.0
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"

# DeepSeek AI Agent v3.1

智能终端助手 —— 专为 Termux 环境设计的 AI Agent，基于 DeepSeek API。

## 功能特性

- JSON 模式工具调用 —— 自动执行 shell 命令、读写文件、访问网页
- 文件精确编辑 —— replace_in_file 只替换需要改的部分
- 后台任务处理 —— 自动识别服务启动命令并加 `&` 后台运行
- 对话历史 —— 实时保存，下次启动可继续对话
- 用户自定义规则 —— 嵌入系统提示词，个性化 AI 行为
- 国内镜像源 —— 支持阿里云/清华源/中科大/自定义四种模式
- Termux 环境检测 —— 启动时自动验证运行环境

## 安装

### 从 PyPI 安装（推荐）

pip install deepseek-agent-2026

### 从源码安装

git clone https://github.com/user/deepseek-agent.git
cd deepseek-agent
pip install -e .

## 快速开始

安装后直接运行：

deepseek-agent-2026

或者作为 Python 模块运行：

python -m deepseek_agent

首次运行需要：
1. 同意用户协议与隐私政策
2. 输入 DeepSeek API Key（可从 https://platform.deepseek.com 获取）

## 可用工具

| 工具 | 功能 |
|------|------|
| run_shell | 执行系统命令 |
| read_file | 读取文件（带行号） |
| write_file | 安全写入文件 |
| replace_in_file | 精确替换文件内容 |
| mkdir | 创建目录 |
| fetch_webpage | 访问网页（Lynx） |
| ask_user | 向用户提问 |

## 特殊命令

| 命令 | 功能 |
|------|------|
| help / 帮助 | 显示帮助信息 |
| setting / 设置 | 打开设置菜单 |
| clear | 清屏 |
| reset | 重置对话并删除历史 |
| exit / 退出 | 保存并退出 |

## 系统要求

- Android 设备
- Termux 应用（[GitHub](https://github.com/termux/termux-app) 或 [F-Droid](https://f-droid.org/packages/com.termux/)）
- Python 3.8+
- DeepSeek API Key

## 许可证

MIT License
