9.8 KiB
9.8 KiB
大沃项目 — 目录结构
项目包含 4 个独立模块 + 若干根目录资源文件
bigwo/
│
├── 📄 根目录资源文件
│ ├── agents_prompts.txt # Agent 提示词汇总（15 个角色）
│ ├── 大沃.doc # 原始 Word 文档
│ ├── 大沃_clean.txt # 清洗后的纯文本
│ └── 大沃_content.txt # 提取的完整内容
│
│
├── 📦 ai-knowledge-splitter/ # 模块一：AI 知识库文档智能分块工具
│ │ # Python CLI，DeepSeek API 语义分块
│ │
│ ├── main.py # CLI 入口（单文件/批量模式）
│ ├── splitter.py # 主协调器（解析→分块→输出流程）
│ ├── chunker.py # AI 分块器（预切分 + API 语义分块）
│ ├── api_client.py # DeepSeek API 客户端（含重试）
│ ├── prompts.py # 分块提示词（文档/表格/问答/图片 4 种策略）
│ ├── writer.py # 输出写入器（Markdown / JSON）
│ ├── models.py # 数据结构（Chunk / ProcessResult）
│ ├── exceptions.py # 自定义异常
│ ├── batch.py # 批量处理（递归扫描 + 容错 + 汇总）
│ ├── categorizer.py # 分类合并器（按业务标签归类）
│ ├── batch_convert.py # 批量 doc/docx → Markdown 转换脚本
│ ├── ai_restructure.py # AI 整理已有 MD 文件（格式优化）
│ ├── doc_extractor.py # .doc 二进制格式文本提取器（olefile）
│ ├── requirements.txt # Python 依赖
│ ├── .env # 环境变量（DEEPSEEK_API_KEY）
│ │
│ ├── parsers/ # 文件解析器（策略模式）
│ │ ├── base.py # BaseParser 抽象基类 + ParserRegistry
│ │ ├── pdf_parser.py # PDF（PyMuPDF）
│ │ ├── doc_parser.py # Word .docx（python-docx）
│ │ ├── legacy_doc_parser.py # Word .doc（Word 97-2003）
│ │ ├── xlsx_parser.py # Excel .xlsx（openpyxl）
│ │ ├── xls_parser.py # Excel .xls（xlrd）
│ │ ├── csv_parser.py # CSV
│ │ ├── html_parser.py # HTML（BeautifulSoup）
│ │ ├── text_parser.py # TXT / Markdown
│ │ └── image_parser.py # 图片（base64 → Vision API）
│ │
│ ├── tests/ # 单元测试（pytest）
│ │ ├── test_main.py
│ │ ├── test_splitter.py
│ │ ├── test_chunker.py
│ │ ├── test_api_client.py
│ │ ├── test_prompts.py
│ │ ├── test_writer.py
│ │ ├── test_models.py
│ │ ├── test_exceptions.py
│ │ ├── test_parsers_base.py
│ │ ├── test_pdf_parser.py
│ │ ├── test_doc_parser.py
│ │ ├── test_xlsx_parser.py
│ │ ├── test_xls_parser.py
│ │ ├── test_csv_parser.py
│ │ ├── test_html_parser.py
│ │ ├── test_text_parser.py
│ │ └── test_image_parser.py
│ │
│ ├── test_results/ # 测试输出样本
│ │
│ └── 2026火山知识库用/ # 知识库源文档（待处理）
│ └── 2026火山知识库用/
│ ├── *.doc / *.docx / *.md # 各类源文档
│ ├── 整理后/ # AI 整理后的 MD 文件
│ └── 标注的图片知识库/ # 产品图片
│
│
├── 📦 coze_config/ # 模块二：Coze Bot 配置与 Agent 提示词
│ │ # 15 个专业角色 Agent 的提示词定义
│ │
│ ├── README.md # 模块说明
│ ├── Coze平台操作指南.md # Coze 平台操作指南
│ ├── coze_bot_config.json # Bot 完整配置（JSON）
│ ├── orchestrator_prompt.md # 编排器（主控 Agent）提示词
│ │
│ └── agents/ # 15 个子 Agent 提示词
│ ├── 01_事业招商_zhaoshang.md
│ ├── 02_产品宣传_xuanchuan.md
│ ├── 03_趋势前瞻_qianzhan.md
│ ├── 04_产品互动_hudong.md
│ ├── 05_自我介绍_ziwojieshao.md
│ ├── 06_活动促销_cuxiao.md
│ ├── 07_产品文化_wenhua.md
│ ├── 08_生活感悟_ganwu.md
│ ├── 09_公司介绍_gongsijieshao.md
│ ├── 10_营养科普_kepu.md
│ ├── 11_问候_wenhou.md
│ ├── 12_误区厘清_wuquliqing.md
│ ├── 13_工作复盘_fupan.md
│ ├── 14_事业顾问_guwen.md
│ └── 15_客户成交_chengjiao.md
│
│
├── 📦 coze_api/ # 模块三：Coze API 客户端
│ │ # Python，Coze v3 Chat API 调用封装
│ │
│ ├── README.md
│ ├── coze_client.py # Coze API 客户端（创建对话/轮询/获取回复）
│ ├── test_coze_api.py # 测试脚本
│ ├── requirements.txt # Python 依赖
│ ├── .env # 环境变量（COZE_API_TOKEN / BOT_ID）
│ └── .env.example # 环境变量模板
│
│
└── 📦 test2/ # 模块四：混合编排语音通话 + 文字对话系统
│ # 全栈 Web App，火山 S2S + Coze Bot
│
├── E2E_HYBRID_MODE_PLAN.md # 混合编排方案详细设计文档
├── E2E_VOICE_MODULE.md # 端到端语音模块技术方案
├── KNOWLEDGE_BASE_GUIDE.md # 知识库配置与使用指南
│
├── client/ # 前端（React + Vite + TailwindCSS）
│ ├── package.json
│ ├── vite.config.js # Vite 配置（含 /api 代理到 :3001）
│ ├── index.html
│ └── src/
│ ├── main.jsx # 入口
│ ├── index.css # 全局样式
│ ├── App.jsx # 主组件（语音/文字模式切换）
│ ├── components/
│ │ ├── VoicePanel.jsx # 语音通话面板
│ │ ├── ChatPanel.jsx # 文字对话面板
│ │ ├── SubtitleDisplay.jsx # 字幕展示
│ │ └── SettingsPanel.jsx # 设置面板
│ ├── hooks/
│ │ └── useVoiceChat.js # 语音通话 Hook
│ └── services/
│ ├── rtcService.js # WebRTC 连接管理
│ ├── voiceApi.js # 语音 API 调用
│ └── chatApi.js # 文字对话 API 调用
│
└── server/ # 后端（Express.js）
├── package.json
├── app.js # Express 入口（端口 3001）
├── .env # 环境变量（火山/Coze 凭证）
├── .env.example # 环境变量模板
├── config/
│ ├── voiceChatConfig.js # StartVoiceChat 配置构建器
│ └── tools.js # 5 个工具定义（天气/订单/知识库/时间/计算）
├── routes/
│ ├── voice.js # 语音通话路由（start/stop/subtitle/tool-callback）
│ └── chat.js # 文字对话路由（start/send/send-stream）
└── services/
├── volcengine.js # 火山引擎 OpenAPI（V4 签名 + RTC Token）
├── arkChatService.js # 方舟 LLM 服务（流式/工具调用循环）
├── cozeChatService.js # Coze Bot 对话服务（流式/非流式）
└── toolExecutor.js # 工具执行器（知识库三级 fallback）
模块关系
┌─────────────────────────┐
│ ai-knowledge-splitter │ 文档 → 分块 → 上传知识库
└───────────┬─────────────┘
│ 产出知识库数据
▼
┌─────────────────────────┐ ┌──────────────┐
│ coze_config │────►│ coze_api │
│ Bot 配置 / Agent 提示词 │ │ API 客户端 │
└───────────┬─────────────┘ └──────┬───────┘
│ 配置 Coze Bot │ 调用 Coze API
▼ ▼
┌─────────────────────────────────────────────────┐
│ test2 │
│ 语音通话（火山 S2S）+ 文字对话（Coze Bot） │
│ 最终用户交互入口 │
└─────────────────────────────────────────────────┘