﻿AI 桌面端 · 便携版 使用说明
==============================

这是把你本机跑通的 AI 桌面端**整包复制**出来的便携版本，可在另一台电脑使用，
并且**保留了全部源码**，可以继续改造 / 加功能 / 加资料。

【快速开始（在新电脑上）】
1. 先安装 Python 3.12（安装时**勾选 Add Python to PATH**）。
2. 双击「首次安装并启动.bat」
   —— 它会自动：建虚拟环境 .venv → 装依赖 requirements.txt → 把配置里的旧路径改成本机路径。
3. 以后每次使用，双击「启动AI-Desktop.bat」。
4. 模型另放（见《模型放置说明.txt》，模型太大没打进包）。

【包里包含】
- 全部源码：start_ai_desktop.py、web_chat.py、plugins\、tools\、mcp_servers\、webui\ 等
- 配置：配置.json（含 MCP 服务器：pro-tools / arch-tools / ai-desktop 等）
- 知识库：AIKnowledge\（kb.sqlite + 知识包 + 专业包）
- 任务库与对话记录：任务库.db、conversations.db
- 启动脚本、一键还原源码.bat

【继续改造 / 加资料 / 加功能】
- 改源码：直接改 .py；改坏了用「一键还原源码.bat」或 _清理归档 里的备份回滚。
- 加资料进知识库：把文档放进 AIKnowledge\，再运行：
      python tools\kb.py add "路径或目录"      （入库，供检索）
- 加工具：参考 mcp_servers\arch_tools.py / pro_tools.py 的写法，写完在 配置.json 的
      mcp_servers 里登记一条，重启程序即可用。
- 首启后可跑一次 setup_portable.py 再次校准路径。

【再次打包】
- 在新机改好后，用本包里的「打包便携版.py」（或 一键打包便携版.bat）可再打一个新便携包。

【注意】
- 首次安装需要联网 pip 下载依赖。
- 本机原程序仍在 D:\AI-Desktop\AIDesktop，本包是独立副本，互不影响。
