Skip to main content

DeepSeek AI Agent - 智能终端助手,支持 JSON 模式工具调用、文件精确编辑、后台任务处理、对话历史

Project description

DeepSeek AI Agent v3.1

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

功能特性

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

安装

准备工作:安装 Termux

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

👉 点击下载 Termux

第一步:换国内镜像源(加速下载)

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 应用(GitHubF-Droid
  • 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

许可证

MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deepseek_agent_2026-3.1.3.tar.gz (22.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

deepseek_agent_2026-3.1.3-py3-none-any.whl (26.8 kB view details)

Uploaded Python 3

File details

Details for the file deepseek_agent_2026-3.1.3.tar.gz.

File metadata

  • Download URL: deepseek_agent_2026-3.1.3.tar.gz
  • Upload date:
  • Size: 22.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for deepseek_agent_2026-3.1.3.tar.gz
Algorithm Hash digest
SHA256 d11e2065ed6d63f96213bf3b9017a22df79cbb7fca40e795b95a33cec681ee37
MD5 b613bfa26ab7a4c4819f909a0156665d
BLAKE2b-256 3b95c27a344d2d3ce87dc99acaf2a862b01efa66eaea92b16d879c573290be3c

See more details on using hashes here.

File details

Details for the file deepseek_agent_2026-3.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for deepseek_agent_2026-3.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 21aeafbbfc8fdd2839f5df313aa280933374f1c0e300b682ec55c27dccf7e202
MD5 dd19c17c309741dc17891bb9d3da434a
BLAKE2b-256 4f61cdfac5c33a5462e07763b0366b19790dcf5c19b8d40420933730200ad725

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page