适用场景 #
本指南说明如何把已在一台计算机上运行正常的启典，整体迁移到另一台计算机（目标机）。适用于单位内网多节点部署、或更换服务器的场景。
一、准备工作（源计算机） #
在当前已安装启典的计算机上，将以下文件打包：
| 类别 | 路径 | 说明 |
|---|---|---|
| Python 程序 | Claw\*.py |
全部 .py 文件及 requirements.txt |
| 知识库文档 | documents\ |
各分类目录及其中 .md 文件 |
| FAISS 索引 | index\ |
3 个索引文件（可选，目标机可重建） |
| 保管期限规则表 | retention_table.xlsx |
⚠️ 当前可能缺失，需补充 |
关于 retention_table.xlsx #
若源机缺失此文件，启典仍能启动，但保管期限判定功能不可用（返回”待定”）。部署前请在 Claw\ 目录下创建该文件，包含”分类 / 文种关键词 / 保管期限 / 依据”四列。
二、目标计算机环境要求 #
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 2 核 | 4 核及以上 |
| 内存 | 4 GB | 8 GB 及以上 |
| 硬盘 | 2 GB 可用空间 | 5 GB 及以上 |
| Python | 3.10 ~ 3.13 | 3.11 |
| 浏览器 | Chrome / Edge / Firefox | 访问 Web 界面用 |
三、安装步骤 #
步骤 1：安装 Python #
下载并安装 Python 3.11，安装时务必勾选”Add Python to PATH”。安装后在命令行执行 python --version 验证。
步骤 2：解压部署包 #
将部署包复制到目标机的合适位置（如 D:\启典\），保持 Claw\（程序）与 documents\（知识库文档）的目录结构。
步骤 3：修改 config.py 中的路径 #
用记事本打开 config.py，把 KNOWLEDGE_DIR 改为目标机的实际路径：
KNOWLEDGE_DIR = r"D:\启典\documents"步骤 4：安装 Python 依赖 #
cd D:\启典\Claw
python -m pip install --upgrade pip
python -m pip install -r requirements.txt步骤 5（可选）：配置混元 API Key #
能联网用混元云端模式（默认）：确认 config.py 中 IS_LOCAL = False 且 Key 已填写。无法联网用本地模式：安装 Ollama 并拉取 qwen2.5:7b、bge-m3，再把 IS_LOCAL 设为 True。
四、首次启动 #
重建 FAISS 索引（如未复制索引文件） #
cd D:\启典\Claw
python build_index.py启动 Web 界面（Streamlit） #
python -B -m streamlit run app.py --server.port 8502启动后浏览器自动打开 http://localhost:8502。
启动 API 服务（FastAPI，可选） #
python api_server.py启动后访问 http://localhost:8000/docs 查看接口文档，详见《API 调用指南》。
五、常见问题 #
启动后提示”知识库未就绪”？ #
多为 FAISS 索引未构建或路径不对。检查 KNOWLEDGE_DIR，然后执行 python build_index.py 重建索引。
混元 API 调用失败？ #
检查目标机能否访问 hunyuan.tencentcloudapi.com；无法联网则切换本地模式（IS_LOCAL = True）。
端口 8502 被占用？ #
更换端口，如 --server.port 8503。
能否在没有网络的内网计算机运行？ #
可以，使用本地模式：在能联网的机器下载 Ollama + 模型后整体复制，修改 config.py 的 IS_LOCAL = True 并启动 ollama serve。
