零成本打造本地 AI 智能助手能写代码、操控浏览器、管理文件完全离线运行项目开源地址https://github.com/xjh-gg/local-ai-agent技术栈Python Ollama Playwright Qwen2.5/DeepSeek适用场景毕业设计、敏感代码辅助、自动化办公、零 API 费用一、为什么要造这个轮子作为计算机专业学生我在做毕业设计时遇到了几个痛点敏感代码不敢上传云端—— 毕业设计代码涉及未来工作不敢往 Claude/Kimi 里贴AI 只能建议不能动手—— 想让 AI 直接改文件、截图看效果、查系统状态结果只能给我一段代码让我自己复制粘贴API 费用积少成多—— 学生党能省则省于是干脆自己写了一个完全离线的本地 Agent跑在自己的笔记本上零成本、数据不出本机。二、效果展示1. 智能模型切换根据问题复杂度自动选择模型简单闲聊→qwen2.5:3b响应快省内存写代码/改配置→qwen2.5-coder:7b代码理解力强架构设计/推理→deepseek-r1:7b思维链逻辑严密2. 浏览器自动化不是建议是真控制浏览器 用户帮我打开 baidu.com 然后截图 Agent✅ 已打开网页 → ✅ 截图已保存3. 系统级文件管理直接操作电脑任意位置的文件带安全保护 用户读取 D:\workspace\my-project\package.json Agent { name: my-project, ... } 用户把 index.html 的标题改成我的毕业设计 Agent⚠️ 确认写入? (y/n) → ✅ 写入成功原文件已备份为.bak三、核心架构用户输入 ↓ Agent (agent.py) ├─ 模型选择器关键词匹配 优先级队列 ├─ Ollama 本地 APIlocalhost:11434 └─ 工具调度器 ├─ 文件工具list/read/write/search ├─ 系统工具shell/exec/app/open_url ├─ 监控工具cpu/ram/disk └─ 浏览器工具playwright navigate/click/input/screenshot模型自动切换代码片段def select_model(self, user_input): text user_input.lower() # 简单问题 → 3B if any(k in text for k in [你好, 谢谢, 在吗]) and len(text) 30: return qwen2.5:3b # 代码问题 → Coder 7B if any(k in text for k in [代码, vue, bug, 函数, 组件]): return qwen2.5-coder:7b # 推理问题 → DeepSeek R1 if any(k in text for k in [设计, 架构, 为什么, 方案]): return deepseek-r1:7b return self.current_modelPlaywright 浏览器控制def playwright_navigate(self, url): page self._ensure_browser() # 启动 Edge page.goto(url, wait_untilnetworkidle) return f已打开: {url} def playwright_screenshot(self, filenamescreenshot.png): page self._ensure_browser() page.wait_for_load_state(networkidle) page.screenshot(pathfD:/local-agent/{filename}) return 截图完成四、快速部署环境准备项目要求系统Windows 10/11内存8GB7B 模型/ 4GB3B 模型Python3.101. 安装 Ollama官网下载https://ollama.com# 拉取模型按需选择 ollama pull qwen2.5-coder:7b # 代码专用 ollama pull deepseek-r1:7b # 推理专用 ollama pull qwen2.5:3b # 轻量快速2. 克隆项目git clone https://github.com/xjh-gg/local-ai-agent.git cd local-ai-agent3. 安装依赖pip install requests psutil playwright playwright install chromium4. 启动终端 1保持运行ollama serve终端 2python agent.py五、安全设计本地 Agent 能执行系统命令必须做好防护危险命令黑名单rm、del、format、shutdown会被拦截系统目录保护禁止写入C:\Windows、Program Files写入双重确认修改文件前必须输入y且自动备份.bak路径沙箱检查所有文件操作校验路径防止越界访问def shell_exec(self, command, timeout30):dangerous [“rm -rf”, “del /f”, “format”, “shutdown”]for d in dangerous:if d in command.lower():return “ 禁止执行危险命令”# … 执行命令六、适用场景✅毕业设计辅助敏感代码本地处理不上传云端✅自动化办公截图、填表、抓取网页数据✅系统运维查日志、看资源、批量改配置✅学习实验理解 Agent 架构二次开发七、后续计划添加长期记忆SQLite 记录用户习惯接入联网搜索查最新文档支持语音输入打包成 exe 一键安装八、开源地址GitHubhttps://github.com/xjh-gg/local-ai-agent欢迎 Star ⭐、提 Issue、Fork 二次开发如果有问题可以在评论区交流我会尽量回复。#AI #Agent #Ollama #本地部署 #Python #毕业设计 #开源项目