Skip to content

city25/CloudLLMToPCAgent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CloudLLMToPCAgent

基于本地LLM的Windows智能助手,通过流水线架构安全地操控计算机。

特性

  • 🔒 本地优先:所有数据本地处理,使用Ollama运行开源模型
  • 🛡️ 安全可控:危险操作需用户确认,支持命令白名单/黑名单
  • 🔄 流水线执行:复杂任务自动分解为分析→计划→执行→验证→总结
  • 💻 系统操控:PowerShell命令执行、文件管理、进程监控
  • 🧠 记忆功能:持久化存储用户偏好和历史信息
  • 🎨 现代UI:PyQt6构建的直观图形界面

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 安装Ollama

ollama.com 下载并安装Ollama。

3. 拉取模型

ollama pull kimi-k2.5:cloud
#
ollama pull qwen2.5:14b

4. 运行

python main.py

使用说明

查询类指令(自动执行)

  • "查看当前运行的进程"
  • "显示系统信息"
  • "列出C盘文件"

操作类指令(需确认)

  • "创建一个文本文件"
  • "删除某个文件"
  • "终止某个进程"

斜杠命令

  • /clear - 清空对话
  • /memory - 管理记忆
  • /model <name> - 切换模型
  • /help - 显示帮助

项目结构

CloudLLMToPCAgent/
├── core/           # 核心引擎
│   ├── agents/     # Agent实现
│   ├── tools/      # 系统工具
│   ├── memory/     # 记忆管理
│   └── logger/     # 日志管理
├── ui/             # 用户界面
│   ├── components/ # UI组件
│   ├── workers/    # 后台线程
│   └── styles/     # 样式主题
├── services/       # 服务层
├── config/         # 配置文件
└── main.py         # 入口

安全说明

  1. deny-by-default:所有命令默认需要验证
  2. 白名单机制:只读命令可自动执行
  3. 黑名单机制:危险命令直接阻止
  4. 路径沙箱:文件操作限制在C:\ChatAgent目录
  5. 显式确认:修改性操作需用户点击确认

开源协议

MIT License

About

基于 Ollama 的本地化 LLM Agent,支持安全命令执行与文件操作,数据不出本机,命令可控可审计

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages