zhaolei
3e356b117a
feat(agent): 添加技能自动路由功能 - 引入 SkillRouter 实现根据用户消息自动推荐技能 - 在构建引擎时集成技能路由器 - 从对话历史中提取最后一条用户消息作为路由输入 - 为技能添加触发关键词和中文标题字段支持 refactor(browser): 重构浏览器自动化为子进程架构 - 将 Playwright 浏览器控制移至独立的子进程 worker - 解决 PyInstaller 打包环境下 C 扩展兼容性问题 - 通过 JSON RPC 协议与浏览器 worker 通信 - 添加工具目录和脚本路径查找机制 feat(skills): 增强技能元数据和UI展示 - 为技能添加 triggers 和 title 字段 - 在技能商店中包含中文标题信息 - 添加 office-viz 技能优先级排序 - 在服务器管理器中返回技能标题 feat(gui): 实现技能选择器UI组件 - 添加带下拉菜单的技能选择器按钮 - 支持中文标题和拼音首字母显示 - 集成会话技能加载和状态管理 - 提供通用技能选项和已启用技能列表 ```
465 lines
9.0 KiB
Markdown
465 lines
9.0 KiB
Markdown
\# OpenMesh 打包流程说明
|
||
|
||
|
||
|
||
\## 概述
|
||
|
||
|
||
|
||
OpenMesh 是一个基于 Python (FastAPI) + React (Vite) 的 AI 智能助手平台，最终交付形态为 Windows 绿色免安装版。打包产物位于 \`dist/openmesh/\` 目录，用户双击 \`启动 OpenMesh.bat\` 即可运行。
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 打包产物目录结构
|
||
|
||
|
||
|
||
\`\`\`
|
||
|
||
dist/openmesh/
|
||
|
||
├── openmesh-server.exe # 后端服务主程序（PyInstaller one-dir 模式）
|
||
|
||
├── openmesh-static.exe # 前端静态文件服务器
|
||
|
||
├── _internal/ # PyInstaller 运行时依赖（Python 解释器 + 所有库）
|
||
|
||
├── frontend/ # 前端构建产物（React + Vite）
|
||
|
||
│ ├── index.html
|
||
|
||
│ └── assets/
|
||
|
||
├── data/ # 用户数据目录（首次启动后生成配置）
|
||
|
||
│ ├── config.toml
|
||
|
||
│ ├── coworker.db
|
||
|
||
│ ├── chat.db
|
||
|
||
│ └── skills/ # 已安装的 skills（从 skills/ 初始化复制）
|
||
|
||
├── skills/ # 预置内置 skills（首次启动复制到 data/skills）
|
||
|
||
├── workspace/ # 默认工作目录
|
||
|
||
├── tools/ # 第三方命令行工具（pandoc, tesseract, libreoffice）
|
||
|
||
├── .venv/ # Python 虚拟环境（用于 skill 脚本执行）
|
||
|
||
├── 启动 OpenMesh.bat # 一键启动脚本
|
||
|
||
├── 卸载 OpenMesh.bat # 卸载脚本
|
||
|
||
└── 使用说明.txt # 使用说明
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 打包步骤总览
|
||
|
||
|
||
|
||
完整打包分为 \*\*4 个阶段\*\*，顺序执行：
|
||
|
||
|
||
|
||
\`\`\`
|
||
|
||
阶段1: 前端构建 → 阶段2: 后端 PyInstaller 打包 → 阶段3: 静态服务器打包 → 阶段4: 组装发布包
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 阶段 1：前端构建
|
||
|
||
|
||
|
||
\### 目的
|
||
|
||
|
||
|
||
将 React + Vite 前端项目编译为静态 HTML/CSS/JS 资源。
|
||
|
||
|
||
|
||
\### 前置条件
|
||
|
||
|
||
|
||
\* Node.js >\\\= 16
|
||
|
||
\* 已执行 \`npm install\`
|
||
|
||
|
||
|
||
\### 操作命令
|
||
|
||
|
||
|
||
\`\`\`bash
|
||
|
||
cd surfaces/gui
|
||
|
||
npm run build
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\### 输入
|
||
|
||
|
||
|
||
\* \`surfaces/gui/src/\` — 前端源码
|
||
|
||
\* \`surfaces/gui/index.html\` — HTML 模板
|
||
|
||
|
||
|
||
\### 输出
|
||
|
||
|
||
|
||
\* \`surfaces/gui/dist/\` — 构建产物
|
||
|
||
  \* \`index.html\`
|
||
|
||
  \* \`assets/index-\*.js\`
|
||
|
||
  \* \`assets/index-\*.css\`
|
||
|
||
  \* 其他静态资源（字体、图片等）
|
||
|
||
|
||
|
||
\### 配置文件
|
||
|
||
|
||
|
||
\* \`surfaces/gui/vite.config.ts\` — Vite 配置
|
||
|
||
  \* \`base: "./"\` — 相对路径，支持从文件系统直接加载
|
||
|
||
  \* 构建输出到 \`dist/\`
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 阶段 2：后端服务 PyInstaller 打包
|
||
|
||
|
||
|
||
\### 目的
|
||
|
||
|
||
|
||
将 Python 后端服务（FastAPI + uvicorn）打包为独立的 Windows 可执行程序及运行时目录。
|
||
|
||
|
||
|
||
\### 前置条件
|
||
|
||
|
||
|
||
\* Python 3.10+
|
||
|
||
\* 虚拟环境已安装所有依赖：\`pip install -e .\`
|
||
|
||
\* \`pyinstaller\` 已安装
|
||
|
||
|
||
|
||
\### 操作命令
|
||
|
||
|
||
|
||
\`\`\`bash
|
||
|
||
pyinstaller dist/openworker-server.spec
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\### Spec 文件说明
|
||
|
||
|
||
|
||
路径：\`dist/openworker-server.spec\`
|
||
|
||
|
||
|
||
关键配置：
|
||
|
||
|
||
|
||
\* \*\*入口\*\*：\`packaging/server_entry.py\` → 调用 \`coworker.server.run\:main\`
|
||
|
||
\* \*\*模式\*\*：one-dir（exe + \`_internal/\` 目录），比 onefile 启动快 6-7 秒
|
||
|
||
\* \*\*控制台\*\*：\`console\=True\`（uvicorn 需要 stdout，窗口通过 CREATE\\_NO\\_WINDOW 隐藏）
|
||
|
||
\* \*\*收集的包\*\*：coworker, aisuite, mcp, ddgs, uvicorn, certifi, websockets, pypdf, pypdfium2, boto3, botocore 等
|
||
|
||
\* \*\*排除\*\*：tkinter, matplotlib, PIL, PyQt5 等不需要的库
|
||
|
||
|
||
|
||
\### 输出
|
||
|
||
|
||
|
||
\* \`dist/openmesh-server/\`
|
||
|
||
  \* \`openmesh-server.exe\` — 主程序
|
||
|
||
  \* \`_internal/\` — Python 运行时 + 所有依赖库
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 阶段 3：静态文件服务器打包
|
||
|
||
|
||
|
||
\### 目的
|
||
|
||
|
||
|
||
打包一个极简的 HTTP 服务器，用于托管前端静态文件。
|
||
|
||
|
||
|
||
\### Spec 文件
|
||
|
||
|
||
|
||
路径：\`openmesh-static.spec\` 或 \`static-server.spec\`
|
||
|
||
|
||
|
||
入口：\`packaging/static_server.py\`
|
||
|
||
|
||
|
||
输出：\`dist/openmesh-static.exe\` 或 \`dist/static-server/static-server.exe\`
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 阶段 4：组装发布包
|
||
|
||
|
||
|
||
\### 目的
|
||
|
||
|
||
|
||
将前端、后端、工具、配置等所有组件组装到 \`dist/openmesh/\` 目录，形成最终可交付的绿色版。
|
||
|
||
|
||
|
||
\### 组装清单
|
||
|
||
|
||
|
||
| 源位置 | 目标位置 | 说明 |
|
||
|
||
| ------------------------------------------ | ----------------------------------- | ---------- |
|
||
|
||
| \`dist/openmesh-server/openmesh-server.exe\` | \`dist/openmesh/openmesh-server.exe\` | 后端服务 |
|
||
|
||
| \`dist/openmesh-server/_internal/\` | \`dist/openmesh/_internal/\` | Python 运行时 |
|
||
|
||
| \`surfaces/gui/dist/\` | \`dist/openmesh/frontend/\` | 前端构建产物 |
|
||
|
||
| \`dist/openmesh-static.exe\` | \`dist/openmesh/openmesh-static.exe\` | 静态文件服务器 |
|
||
|
||
| \`skills/\` (项目内置) | \`dist/openmesh/skills/\` | 预置 skills |
|
||
|
||
| \`tools/\` (pandoc 等) | \`dist/openmesh/tools/\` | 第三方工具 |
|
||
|
||
| \`dist/config.template.toml\` | \`dist/openmesh/data/config.toml\` | 默认配置 |
|
||
|
||
| — | \`dist/openmesh/workspace/\` | 工作目录（空） |
|
||
|
||
| — | \`dist/openmesh/data/\` | 数据目录（空） |
|
||
|
||
| \`启动 OpenMesh.bat\` | \`dist/openmesh/启动 OpenMesh.bat\` | 启动脚本 |
|
||
|
||
| \`卸载 OpenMesh.bat\` | \`dist/openmesh/卸载 OpenMesh.bat\` | 卸载脚本 |
|
||
|
||
| \`使用说明.txt\` | \`dist/openmesh/使用说明.txt\` | 使用说明 |
|
||
|
||
|
||
|
||
\### 启动脚本逻辑
|
||
|
||
|
||
|
||
文件：\`dist/openmesh/启动 OpenMesh.bat\`
|
||
|
||
|
||
|
||
关键环境变量：
|
||
|
||
|
||
|
||
\`\`\`bat
|
||
|
||
set DATA_DIR\=%SCRIPT_DIR%data :: COWORKER_STATE_DIR 指向 data 目录
|
||
|
||
set SKILLS_DIR\=%DATA_DIR%\skills :: 实际 skills 目录
|
||
|
||
set BUILTIN_SKILLS\=%SCRIPT_DIR%skills :: 内置 skills 源
|
||
|
||
set COWORKER_DISABLE_AUTH\=1 :: 禁用认证（本地使用）
|
||
|
||
set COWORKER_STATE_DIR\=%DATA_DIR% :: 状态目录
|
||
|
||
set COWORKER_SCRATCH_BASE\=workspace :: 临时文件基准目录
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
启动顺序：
|
||
|
||
|
||
|
||
1\. 创建 data、skills、workspace 目录
|
||
|
||
2\. 首次启动时，将内置 skills 复制到 data/skills
|
||
|
||
3\. 启动 \`openmesh-server.exe --port 8765 --cwd workspace\`（后端，端口 8765）
|
||
|
||
4\. 启动 \`openmesh-static.exe frontend\`（前端静态服务器，端口 3000）
|
||
|
||
5\. 打开浏览器访问 http://localhost:3000
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 重新打包操作清单
|
||
|
||
|
||
|
||
当代码修改后需要重新打包时，按以下顺序执行：
|
||
|
||
|
||
|
||
\### 仅前端修改
|
||
|
||
|
||
|
||
\`\`\`
|
||
|
||
npm run build → 复制到 dist/openmesh/frontend/
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\### 仅后端修改
|
||
|
||
|
||
|
||
\`\`\`
|
||
|
||
pyinstaller dist/openworker-server.spec → 复制 exe 和 _internal/ 到 dist/openmesh/
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\### 前后端都修改
|
||
|
||
|
||
|
||
\`\`\`
|
||
|
||
1\. cd surfaces/gui && npm run build
|
||
|
||
2\. pyinstaller dist/openworker-server.spec
|
||
|
||
3\. 组装到 dist/openmesh/
|
||
|
||
\`\`\`
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 注意事项
|
||
|
||
|
||
|
||
1\. \*\*data/skills 与 skills/\*\*：内置 skills 仅首次启动时复制。修改内置 skills 后，需删除用户 \`data/skills/\` 目录才能生效，或手动更新。
|
||
|
||
2\. \*\*PyInstaller 增量构建\*\*：build 目录会缓存，重复构建时速度较快。完全干净构建可删除 \`build/\` 目录。
|
||
|
||
3\. \*\*.venv 目录\*\*：发布包中的 \`.venv\` 用于 skill 脚本执行（如 Python 脚本），与 PyInstaller 打包的运行时是两套独立环境。
|
||
|
||
4\. \*\*端口冲突\*\*：默认后端 8765，前端 3000。可在 \`data/config.toml\` 中修改。
|
||
|
||
5\. \*\*UPX 压缩\*\*：server 端默认关闭 UPX（\`upx\=False\`），避免某些库加载失败。static 端开启了 UPX。
|
||
|
||
|
||
|
||
\*\*\*
|
||
|
||
|
||
|
||
\## 相关文件索引
|
||
|
||
|
||
|
||
| 文件 | 作用 |
|
||
|
||
| ------------------------------- | -------------------- |
|
||
|
||
| \`pyproject.toml\` | Python 项目配置、依赖、入口点 |
|
||
|
||
| \`dist/openworker-server.spec\` | 后端 PyInstaller 配置 |
|
||
|
||
| \`openmesh-static.spec\` | 静态服务器 PyInstaller 配置 |
|
||
|
||
| \`dist/server_entry.py\` | 后端打包入口 |
|
||
|
||
| \`surfaces/gui/vite.config.ts\` | 前端构建配置 |
|
||
|
||
| \`surfaces/gui/package.json\` | 前端依赖和脚本 |
|
||
|
||
| \`dist/openmesh/启动 OpenMesh.bat\` | 启动脚本 |
|
||
|
||
| \`coworker/server/run.py\` | 后端服务主入口 | |