deepseek-agent-2026 3.1.0__tar.gz

deepseek_agent_2026-3.1.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: deepseek-agent-2026
+Version: 3.1.0
+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 安装（推荐）
+
+```bash
+pip install deepseek-agent
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/user/deepseek-agent.git
+cd deepseek-agent
+pip install -e .
+```
+
+## 快速开始
+
+安装后直接运行：
+
+```bash
+deepseek-agent
+```
+
+或者作为 Python 模块运行：
+
+```bash
+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

deepseek_agent_2026-3.1.0/README.md

@@ -0,0 +1,80 @@
+# DeepSeek AI Agent v3.1
+
+智能终端助手 —— 专为 Termux 环境设计的 AI Agent，基于 DeepSeek API。
+
+## 功能特性
+
+- JSON 模式工具调用 —— 自动执行 shell 命令、读写文件、访问网页
+- 文件精确编辑 —— replace_in_file 只替换需要改的部分
+- 后台任务处理 —— 自动识别服务启动命令并加 `&` 后台运行
+- 对话历史 —— 实时保存，下次启动可继续对话
+- 用户自定义规则 —— 嵌入系统提示词，个性化 AI 行为
+- 国内镜像源 —— 支持阿里云/清华源/中科大/自定义四种模式
+- Termux 环境检测 —— 启动时自动验证运行环境
+
+## 安装
+
+### 从 PyPI 安装（推荐）
+
+```bash
+pip install deepseek-agent
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/user/deepseek-agent.git
+cd deepseek-agent
+pip install -e .
+```
+
+## 快速开始
+
+安装后直接运行：
+
+```bash
+deepseek-agent
+```
+
+或者作为 Python 模块运行：
+
+```bash
+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

deepseek_agent_2026-3.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "deepseek-agent-2026"
+version = "3.1.0"
+description = "DeepSeek AI Agent - 智能终端助手，支持 JSON 模式工具调用、文件精确编辑、后台任务处理、对话历史"
+authors = [
+    {name = "我是个人"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Android",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Terminals",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = ["deepseek", "ai", "agent", "termux", "terminal", "assistant", "cli"]
+dependencies = [
+    "openai==0.28.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+    "pytest-cov",
+]
+
+[project.urls]
+Homepage = "https://github.com/user/deepseek-agent"
+Repository = "https://github.com/user/deepseek-agent.git"
+Issues = "https://github.com/user/deepseek-agent/issues"
+
+[project.scripts]
+deepseek-agent-2026 = "deepseek_agent.__main__:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

deepseek_agent_2026-3.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

deepseek_agent_2026-3.1.0/src/deepseek_agent/__init__.py

@@ -0,0 +1,9 @@
+"""
+DeepSeek AI Agent - 智能终端助手 v3.1
+
+Termux AI Agent with JSON-mode tool calling, file editing,
+background task handling, conversation history, and user rules.
+"""
+
+__version__ = "3.1.0"
+__author__ = "我是个人"

deepseek_agent_2026-3.1.0/src/deepseek_agent/__main__.py

@@ -0,0 +1,68 @@
+"""入口点 —— 可通过 python -m deepseek_agent 启动"""
+
+import sys
+
+from .environment import ensure_termux
+from .colors import print_banner, print_status, Colors
+from .config import load_config, load_api_key, save_api_key
+from .mirrors import apply_mirror_source, install_pkg_with_retry, install_pip_package, check_command
+from .workspace import create_work_dir
+from .cli import check_agreement, first_run_agreement
+
+
+def main():
+    """主入口函数"""
+    # 先加载配置（必须在 apply_mirror_source 之前）
+    load_config()
+
+    # 首次运行：显示协议并要求用户同意
+    if not check_agreement():
+        if not first_run_agreement():
+            sys.exit(0)
+
+    print_banner()
+
+    # 应用镜像源（在 load_config 之后，使用用户保存的选择）
+    print_status("正在初始化环境，切换至国内镜像源...", "info")
+    apply_mirror_source()
+
+    # 安装必要的依赖
+    if not check_command("lynx"):
+        install_pkg_with_retry("lynx")
+
+    try:
+        import openai
+    except ImportError:
+        if not install_pip_package("openai==0.28.0"):
+            print_status("openai 安装失败，请检查网络后重试", "error")
+            sys.exit(1)
+        try:
+            import openai
+        except ImportError:
+            print_status("openai 导入失败，请重启脚本", "error")
+            sys.exit(1)
+
+    # 创建工作目录
+    work_dir = create_work_dir()
+    print_status(f"工作目录: {work_dir}", "success")
+
+    saved_key = load_api_key()
+
+    if saved_key:
+        print(f"  {Colors.DIM}🔑 已加载 API Key{Colors.RESET}")
+        api_key = saved_key
+    else:
+        print(f"\n{Colors.BRIGHT_YELLOW}  🔑 请输入 DeepSeek API Key{Colors.RESET}")
+        api_key = input(f"\n{Colors.BOLD}{Colors.BRIGHT_WHITE}  Key{Colors.RESET} {Colors.BRIGHT_BLUE}»{Colors.RESET} ").strip()
+        if not api_key:
+            sys.exit(1)
+        save = input(f"\n{Colors.DIM}保存 Key？(Y/n): {Colors.RESET}").strip().lower()
+        if save in ["", "y", "yes"]:
+            save_api_key(api_key)
+
+    from .agent import start
+    start(api_key, work_dir, openai)
+
+
+if __name__ == "__main__":
+    main()

deepseek_agent_2026-3.1.0/src/deepseek_agent/agent.py

@@ -0,0 +1,182 @@
+"""AI Agent 主循环 —— 与 DeepSeek API 交互的核心逻辑"""
+
+import os
+import json
+import sys
+
+from . import config
+from .colors import print_status, Colors
+from .prompts import build_system_prompt
+from .tools import FUNC_MAP, ICON_MAP, TOOLS, ask_user
+from .history import save_history, save_conversation_history, load_history, clear_history, get_history_summary
+
+
+def start(api_key, work_dir, openai_module):
+    """启动 AI Agent 主循环"""
+    openai_module.api_key = api_key
+    openai_module.api_base = config.BASE_URL
+
+    messages = None
+
+    # 尝试加载历史记录
+    saved_messages = load_history()
+    if saved_messages:
+        summary = get_history_summary(saved_messages)
+        if summary:
+            print(f"\n  {Colors.BRIGHT_YELLOW}📜 发现上次对话记录（{summary['total']}条消息，{summary['user_count']}轮对话）{Colors.RESET}")
+            print(f"  {Colors.DIM}首条: {summary['first']}{Colors.RESET}")
+            print(f"  {Colors.DIM}末条: {summary['last']}{Colors.RESET}")
+        choice = input(f"\n  {Colors.BRIGHT_WHITE}是否继续上次对话？{Colors.RESET}\n  {Colors.DIM}(输入 y 继续 / 直接回车开启新对话并删除记录): {Colors.RESET}").strip().lower()
+        if choice in ["y", "yes"]:
+            messages = saved_messages
+            print_status(f"已加载上次对话记录，继续对话", "success")
+        else:
+            clear_history()
+            print_status("已开启新对话，旧记录已删除", "info")
+
+    if messages is None:
+        messages = [{"role": "system", "content": build_system_prompt(work_dir)}]
+
+    from .rules import get_user_rules_status
+    from .workspace import HISTORY_DIR
+
+    user_rules_status = get_user_rules_status()
+    print(f"""
+ {Colors.BRIGHT_GREEN}  ✨ 就绪 - 输入需求开始对话{Colors.RESET}
+   {Colors.DIM}配置: 超时{config.CMD_TIMEOUT}s | 轮次{config.MAX_TASK_ROUNDS} | 输出{config.MAX_TOKENS} tokens | {config.MODEL}{Colors.RESET}
+   {Colors.DIM}工作目录: {work_dir}{Colors.RESET}
+   {Colors.DIM}历史记录: {HISTORY_DIR}{Colors.RESET}
+   {Colors.DIM}特殊命令：help | setting | 退出 | clear | reset{Colors.RESET}
+   {Colors.DIM}提示：Ctrl+C 可安全中断当前执行的命令{Colors.RESET}
+   {Colors.DIM}用户规则：{user_rules_status}{Colors.RESET}
+""")
+
+    while True:
+        try:
+            user_input = input(f"\n{Colors.BOLD}{Colors.BRIGHT_WHITE}你{Colors.RESET} {Colors.BRIGHT_BLUE}»{Colors.RESET} ").strip()
+        except (EOFError, KeyboardInterrupt):
+            save_history(messages)
+            save_conversation_history(messages, work_dir)
+            print(f"\n\n{Colors.BRIGHT_YELLOW}  👋 再见！对话已保存，下次启动可继续{Colors.RESET}\n")
+            break
+
+        if user_input.lower() in ["exit", "退出"]:
+            save_history(messages)
+            save_conversation_history(messages, work_dir)
+            print(f"\n{Colors.BRIGHT_YELLOW}  👋 再见！对话已保存，下次启动可继续{Colors.RESET}\n")
+            break
+        elif user_input.lower() in ["setting", "设置"]:
+            # 延迟导入避免循环依赖
+            from .cli import settings_menu
+            settings_menu()
+            messages = [{"role": "system", "content": build_system_prompt(work_dir)}]
+            continue
+        elif user_input.lower() == "clear":
+            os.system("clear")
+            from .colors import print_banner
+            print_banner()
+            continue
+        elif user_input.lower() == "reset":
+            clear_history()
+            messages = [{"role": "system", "content": build_system_prompt(work_dir)}]
+            print_status("对话已完全重置，历史记录已删除", "success")
+            continue
+        elif user_input.lower() in ["help", "帮助"]:
+            from .colors import print_help
+            print_help()
+            continue
+        elif not user_input:
+            continue
+
+        messages.append({"role": "user", "content": user_input})
+
+        for round_num in range(config.MAX_TASK_ROUNDS):
+            try:
+                resp = openai_module.ChatCompletion.create(
+                    model=config.MODEL,
+                    messages=messages,
+                    max_tokens=config.MAX_TOKENS,
+                    temperature=0.1,
+                    tools=TOOLS,
+                    tool_choice="auto"
+                )
+                assistant_msg = resp["choices"][0]["message"]
+            except Exception as e:
+                print_status(f"API 错误: {str(e)[:100]}", "error")
+                break
+
+            tool_calls_data = assistant_msg.get("tool_calls")
+
+            if tool_calls_data:
+                messages.append(assistant_msg)
+
+                for tc in tool_calls_data:
+                    if tc["type"] != "function":
+                        continue
+
+                    fname = tc["function"]["name"]
+                    try:
+                        args = json.loads(tc["function"]["arguments"])
+                    except json.JSONDecodeError:
+                        print_status(f"参数解析失败", "error")
+                        continue
+
+                    if fname not in FUNC_MAP:
+                        print_status(f"未知工具: {fname}", "error")
+                        continue
+
+                    icon = ICON_MAP.get(fname, "exec")
+                    if fname in ("run_shell", "mkdir"):
+                        display = str(args.get('cmd', args.get('path', '')))[:80].replace('\n', '\\n')
+                    elif fname == "ask_user":
+                        display = str(args.get('question', ''))[:80]
+                    elif fname == "replace_in_file":
+                        display = f"path={args.get('path', '')}"
+                    else:
+                        display = str(args)[:80]
+                    print_status(f"{fname}: {display}...", icon)
+
+                    if fname == "ask_user":
+                        result = ask_user(args.get("question", ""))
+                    else:
+                        try:
+                            result = FUNC_MAP[fname](**args)
+                        except Exception as e:
+                            result = f"执行失败: {e}"
+
+                    if fname == "read_file":
+                        try:
+                            data = json.loads(result)
+                            print_status(f"读取: {data.get('path', '')} ({data.get('size', 0)}字节, {data.get('line_count', 0)}行)", "success")
+                        except Exception:
+                            print_status(f"{result[:50]}", "warning" if "不存在" in result else "success")
+                    elif fname == "write_file":
+                        msg = "写入成功" if "✅" in result else "写入失败"
+                        print_status(f"{msg}: {args.get('path', '')}", "success" if "✅" in result else "error")
+                    elif fname == "replace_in_file":
+                        msg = "替换成功" if "✅" in result else "替换失败"
+                        print_status(f"{msg}: {args.get('path', '')}", "success" if "✅" in result else "error")
+                    elif fname == "ask_user":
+                        print_status(result, "info")
+
+                    messages.append({
+                        "role": "tool",
+                        "tool_call_id": tc["id"],
+                        "name": fname,
+                        "content": result
+                    })
+
+                save_history(messages)
+                save_conversation_history(messages, work_dir)
+                continue
+
+            content = assistant_msg.get("content", "").strip()
+            if content:
+                print(f"\n{Colors.BRIGHT_GREEN}助手{Colors.RESET} {Colors.BRIGHT_BLUE}»{Colors.RESET} {content}\n")
+                messages.append({"role": "assistant", "content": content})
+                save_history(messages)
+                save_conversation_history(messages, work_dir)
+            break
+
+        if round_num >= config.MAX_TASK_ROUNDS - 1:
+            print_status("达到最大轮次", "warning")