# lightAgentForWin7

**Repository Path**: hackha/light-agent-for-win7

## Basic Information

- **Project Name**: lightAgentForWin7
- **Description**: 1.轻量化的Ai Agent，实现Agent记忆、skills加载、工具调用能力。
2.python 3.8原生开发，使用http库封装大模型调用功能（包含工具调用），全面兼容win7以上系统，避免了lanchain等框架无法兼容python 3.8以及win7环境问题，适合特殊行业本地化调用AI。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

================================================
   Local Agent Win7
#  基于大语言模型的本地 AI 智能助手
   Windows 7/10/11 兼容
================================================

## 一、快速开始
============

【前置条件】
1. 安装 Python 3.8 ~ 3.12（推荐 3.12）
   下载: https://www.python.org/downloads/
   安装时务必勾选: "Add Python to PATH"

2. 安装依赖包
   方式一（推荐）: 双击 start.bat 自动安装
   方式二（手动）: 在目录下执行 pip install -r requirements.txt
   方式三（离线）: 将 .whl 文件放入 packages/，双击 start.bat

3. 配置 API Key
   编辑 config.yaml，填入你的 API 密钥：
     api_key: "sk-xxxxxxxxxxxxxxxx"
     base_url: "https://api.deepseek.com"   # 你的 API 地址
     model: "deepseek-chat"                  # 你的模型名

4. 启动！
   双击 start.bat
   打开浏览器访问 http://localhost:5001


## 二、支持的 API 服务商
=====================

1. DeepSeek (推荐)
   base_url: https://api.deepseek.com
   model: deepseek-chat 或 deepseek-reasoner

2. 讯飞星火 (本系统默认)
   base_url: https://maas-api.cn-huabei-1.xf-yun.com/v2
   model: generalv3.5 或 astron-code-latest

3. 智谱AI
   base_url: https://open.bigmodel.cn/api/paas/v4
   model: glm-4-flash (免费) 或 glm-4-plus

4. SiliconFlow (部分免费)
   base_url: https://api.siliconflow.cn/v1
   model: Qwen/Qwen2.5-7B-Instruct (免费)

5. Ollama (本地)
   base_url: http://localhost:11434/v1
   model: qwen2.5 或 llama3

6. 任何 OpenAI 兼容 API
   填入对应的 base_url 和 api_key 即可


## 三、界面功能详解
================
![初始化界面](https://foruda.gitee.com/images/1778162493056011982/79d0865d_5490151.png "屏幕截图")


【侧边栏（左侧）】
  + 新建     — 创建新的空白会话
  ✕ 删除     — 删除选中的会话
  ☰ 切换     — 点击切换不同会话

【聊天区】
  输入框：输入消息，按回车发送
  流式输出：AI 逐字显示回复内容
  支持 Markdown：标题、列表、表格、代码块

【功能区（右上角）】
  工具箱 — 查看所有可用工具
  技能 — 查看已加载的 AI 技能
  状态 — 系统运行状态和统计信息


## 四、核心功能
============

1. ✅ 流式输出
   AI 回复逐字显示，无需等待完整回复生成。
   基于 WebSocket 实时通信，零延迟。

2. 🧠 长期记忆
   自动记住用户信息（姓名、职业、偏好等）。
   跨会话记忆：新会话自动加载已有信息。

3. 📝 对话摘要
   每次对话结束后，AI 自动总结关键内容。
   下次对话时注入系统提示，让 AI 了解你的近期关注。

4. 🛠️ 工具调用
   支持以下内置工具：
   - 计算器 (calculator)
   - 代码执行 (execute_python)
   - 文件操作 (read/write/list/delete/copy/move)
   - 时间日期 (get_current_time)
   - 网络搜索 (web_search)
   - 网页抓取 (fetch_url)
   - Word 文档生成 (generate_word_document)

   例如：
   "搜索今天的热点新闻"
   "帮我计算 2+3*4 的结果"
   "生成一份工作总结的 Word 文档"

5. 📄 Word 文档生成
   说"帮我生成一份报告"，AI 会自动调用工具。
   生成的 .docx 存放在 outputs/ 目录。
   支持标题、段落、列表、表格、代码块等格式。

6. 📋 任务规划（时间线可视化）
   AI 自动将复杂任务分解为多个步骤。
   时间线显示每一步的完成状态：
     📋 执行计划
     ✅ 1. 步骤一  (已完成)
     ⏳ 2. 步骤二  (进行中)
     ⬜ 3. 步骤三  (待处理)

7. 💬 多会话管理
   支持多个独立对话，每个会话独立记录。
   适合不同主题的对话分开管理。

8. 🔌 技能扩展
   按需加载专业技能（如 TRIZ 创新方法等）。
   技能文件放在 skills/ 目录下。


## 五、配置文件说明
================
```text
config.yaml 详解：

   ---------- LLM 配置 ----------
  llm:
    api_key: "你的API密钥"
    base_url: "https://api.deepseek.com/v1"    # API 地址
    model: "deepseek-chat"                      # 模型名称

  ---------- 记忆系统 ----------
  memory:
    db_path: "data/agent_memory.db"            # 数据库存储位置
    short_term_limit: 20                        # 短期记忆窗口（消息数）

  ---------- 代理行为配置 ----------
  agent:
    max_tool_calls: 20          # 单次请求最大工具调用次数
    max_tool_retries: 3         # 工具失败自动重试次数
    system_prompt: |
      你是一个有用的本地 AI 助手...
      （系统提示词，可自定义）

  ---------- 技能目录 ----------
  skills_dir: "skills"          # 技能文件目录
  skill_cache: true             # 是否启用技能缓存加速
```

## 六、数据存储
============
```text
data/agent_memory.db  — SQLite 数据库
  ├── sessions  表 — 会话记录
  ├── messages  表 — 所有对话消息
  ├── knowledge 表 — 长期记忆（用户信息 + 对话摘要）
  └── messages_fts  — 全文搜索索引

所有数据本地存储，不会上传到任何第三方。
```

## 七、常见问题
============

Q: 启动后浏览器显示空白页面？
A: 检查 config.yaml 中的 API Key 是否正确配置。
   检查 WebSocket 端口 5002 是否被占用。

Q: "WebSocket 未连接"？
A: 确保端口 5002 未被其他程序占用。
   刷新页面（Ctrl + Shift + R）重试。

Q: AI 回复内容全是方框（乱码）？
A: 这通常是字符编码问题。确保系统编码为 UTF-8：
   在 start.bat 中已包含 chcp 65001 设置。

Q: 切换端口？
A: 设置环境变量 PORT=8080，python web_app.py 将在 8080 端口启动。
   WebSocket 端口跟随 HTTP 端口 +1，即 8081。

Q: 如何重置所有数据？
A: 删除 data/ 目录下的所有文件，重启即可。

Q: 工具调用失败？
A: 系统会自动重试（默认 3 次）。如持续失败，检查工具参数格式。


## 八、目录结构
============
```text
LocalAgentWin7/
├── start.bat              # 【双击启动】自动检测 Python 和依赖
├── start_web.bat          # 备用启动脚本
├── requirements.txt       # Python 依赖清单
├── packages/              # 离线安装包存放处
├── config.yaml            # 配置文件
│
├── web_app.py             # Web 服务器（HTTP + WebSocket）
├── agent_core.py          # AI 核心引擎
├── llm_client.py          # LLM API 客户端
│
├── memory/                # 记忆系统
│   └── storage.py         # SQLite 数据库存储
│
├── tools/                 # 工具系统
│   ├── registry.py        # 工具注册中心
│   └── builtin/           # 内置工具
│       ├── calculator.py
│       ├── code_executor.py
│       ├── file_ops.py
│       ├── time_utils.py
│       ├── web_search.py
│       ├── web_tools.py
│       └── generate_word.py    # Word 文档生成
│
├── skills/                # AI 技能目录
├── ui/web/                # 前端界面
│   ├── templates/index.html
│   ├── static/css/style.css
│   └── static/js/app.js
│
├── outputs/               # 文档输出（自动生成）
└── data/                  # 数据库（自动生成）
```

## 九、技术架构
============
```text
  浏览器 ←─ WebSocket ─→ websockets 服务器(5002)
    │                          │
    │ HTTP                     │ WebSocket
    ↓                          ↓
  Flask HTTP 服务器(5001) ──→ Agent Core
    │                          │
    │ API 调用                 │ LLM 调用
    ↓                          ↓
  REST API 端点 ──────────→ LLM API（OpenAI 兼容）

```
## 十、版本信息
============
```text
Python    : 3.8 ~ 3.12（推荐 3.12）
OS        : Windows 7 / 10 / 11
协议      : MIT License
端口      : HTTP 5001 / WebSocket 5002
```