Metadata-Version: 2.4
Name: deepseek-agent-2026
Version: 3.1.3
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 环境检测 —— 启动时自动验证运行环境

## 安装

### 准备工作：安装 Termux

本工具基于 Termux 环境运行，如果你还没有安装 Termux，请先下载安装：

👉 [点击下载 Termux](https://m.32r.com/app/136073.html)

### 第一步：换国内镜像源（加速下载）

`echo "deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main stable main" > $PREFIX/etc/apt/sources.list && apt update`

### 第二步：安装 Python

`pkg install python -y`

### 第三步：安装 deepseek-agent-2026

`python -m pip install deepseek-agent-2026`

### 第四步：启动脚本

`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

## 更新日志

### v3.1.2 (2026-06-25)
- 优化：完善 README.md 文档，新增 Termux 下载链接
- 优化：新增作者主页链接

### v3.1.1 (2026-06-24)
- 修复：README.md 格式问题，优化 PyPI 页面显示
- 优化：完善项目文档，新增从零开始安装步骤

### v3.1.0 (2026-06-23)
- 新增：首次发布到 PyPI，包名 deepseek-agent-2026
- 新增：支持 pip install deepseek-agent-2026 安装
- 新增：命令行启动方式 deepseek-agent-2026
- 功能：JSON 模式工具调用（run_shell、read_file、write_file、replace_in_file、mkdir、fetch_webpage、ask_user）
- 功能：用户自定义规则系统
- 功能：对话历史实时保存
- 功能：国内镜像源切换（阿里云/清华源/中科大）
- 功能：Termux 环境自动检测

### v3.0.0 (2026-05-09)
- 新增：用户自定义规则系统
- 新增：reset 命令，重置对话并清除历史
- 新增：关于页面（版本信息、更新日志、用户协议、隐私政策）
- 优化：规则即时生效，系统规则始终优先

### v2.9.0 (2026-05)
- 新增：文件读取带行号（read_file 返回 行号| 内容 格式）
- 新增：安全文件写入（write_file 不受特殊字符影响）
- 优化：动态输出规则，AI 根据回复复杂度调整输出长度
- 优化：Token 显示修复

### v2.8.0 (2026-04)
- 新增：对话历史记录，下次启动可继续对话
- 新增：后台任务智能识别，服务启动命令自动加 & 后台运行
- 优化：搜索引擎优化，使用必应国内版
- 优化：最大轮次扩展至 64 轮，输出上限扩展至 60000 tokens

### v2.7.0 及更早
- 新增：JSON 模式工具调用
- 新增：自动安装依赖（pip/pkg 镜像源自动切换）
- 新增：彩色终端输出
- 新增：设置中心（命令超时/最大轮次/AI输出/AI模型/API Key 管理）

## 卸载

`python -m pip uninstall deepseek-agent-2026 -y`

## 作者主页

👉 [作者主页：https://www.rtsbox.cn/author/17993?t=0#67m5s](https://www.rtsbox.cn/author/17993?t=0#67m5s)

## 许可证

MIT License
