# 目录

本文档概述了 model-compose 用户指南的结构。

---

## 1. [入门指南](./01-getting-started.md)
- 1.1 [简介和概述](./01-getting-started.md#11-简介和概述)
- 1.2 [安装](./01-getting-started.md#12-安装)
- 1.3 [运行您的第一个工作流](./01-getting-started.md#13-运行您的第一个工作流)
  - 1.3.1 [简单示例（OpenAI API 调用）](./01-getting-started.md#131-简单示例openai-api-调用)
  - 1.3.2 [运行工作流（run 命令）](./01-getting-started.md#132-运行工作流run-命令)
  - 1.3.3 [启动控制器并使用 Web UI](./01-getting-started.md#133-启动控制器并使用-web-ui)
- 1.4 [基础概念](./01-getting-started.md#14-基础概念)

## 2. [核心概念](./02-core-concepts.md)
- 2.1 [model-compose.yml 结构](./02-core-concepts.md#21-model-composeyml-结构)
- 2.2 [控制器](./02-core-concepts.md#22-控制器)
- 2.3 [组件](./02-core-concepts.md#23-组件)
- 2.4 [工作流](./02-core-concepts.md#24-工作流)
- 2.5 [作业](./02-core-concepts.md#25-作业)
- 2.6 [数据流和变量绑定](./02-core-concepts.md#26-数据流和变量绑定)

## 3. [CLI 使用](./03-cli-usage.md)
- 3.1 [基础命令](./03-cli-usage.md#31-基础命令)
- 3.2 [up 命令](./03-cli-usage.md#32-up-命令)
- 3.3 [down 命令](./03-cli-usage.md#33-down-命令)
- 3.4 [start 命令](./03-cli-usage.md#34-start-命令)
- 3.5 [stop 命令](./03-cli-usage.md#35-stop-命令)
- 3.6 [run 命令](./03-cli-usage.md#36-run-命令)
- 3.7 [环境变量管理](./03-cli-usage.md#37-环境变量管理)
- 3.8 [配置文件指定](./03-cli-usage.md#38-配置文件指定)
- 3.9 [调试选项](./03-cli-usage.md#39-调试选项)
- 3.10 [实践示例](./03-cli-usage.md#310-实践示例)
- 3.11 [命令快速参考](./03-cli-usage.md#311-命令快速参考)

## 4. [组件配置](./04-component-configuration.md)
- 4.1 [组件类型](./04-component-configuration.md#41-组件类型)
- 4.2 [定义组件](./04-component-configuration.md#42-定义组件)
- 4.3 [输入/输出映射](./04-component-configuration.md#43-输入输出映射)
- 4.4 [可重用性模式](./04-component-configuration.md#44-可重用性模式)
- 4.5 [组件最佳实践](./04-component-configuration.md#45-组件最佳实践)

## 5. [编写工作流](./05-writing-workflows.md)
- 5.1 [什么是工作流？](./05-writing-workflows.md#51-什么是工作流)
- 5.2 [单作业工作流](./05-writing-workflows.md#52-单作业工作流)
- 5.3 [多步骤工作流](./05-writing-workflows.md#53-多步骤工作流)
- 5.4 [作业间数据传递](./05-writing-workflows.md#54-作业间数据传递)
- 5.5 [作业类型](./05-writing-workflows.md#55-作业类型)
- 5.6 [条件执行](./05-writing-workflows.md#56-条件执行)
- 5.7 [流式模式](./05-writing-workflows.md#57-流式模式)
- 5.8 [错误处理](./05-writing-workflows.md#58-错误处理)
- 5.9 [工作流最佳实践](./05-writing-workflows.md#59-工作流最佳实践)

## 6. [工作流 Schema](./06-workflow-schema.md)
- 6.1 [什么是工作流 Schema？](./06-workflow-schema.md#61-什么是工作流-schema)
- 6.2 [获取 Schema](./06-workflow-schema.md#62-获取-schema)
- 6.3 [输入 Schema](./06-workflow-schema.md#63-输入-schema)
- 6.4 [输出 Schema](./06-workflow-schema.md#64-输出-schema)
- 6.5 [Schema 的实际应用](./06-workflow-schema.md#65-schema-的实际应用)
- 6.6 [实战示例](./06-workflow-schema.md#66-实战示例)
- 6.7 [工作流元数据字段](./06-workflow-schema.md#67-工作流元数据字段)
- 6.8 [最佳实践](./06-workflow-schema.md#68-最佳实践)

## 7. [控制器配置](./07-controller-configuration.md)
- 7.1 [HTTP 服务器](./07-controller-configuration.md#71-http-服务器)
- 7.2 [MCP 服务器](./07-controller-configuration.md#72-mcp-服务器)
- 7.3 [队列订阅者 (Queue Subscriber)](./07-controller-configuration.md#73-队列订阅者-queue-subscriber)
- 7.4 [队列分发（分布式部署）](./07-controller-configuration.md#74-队列分发分布式部署)
- 7.5 [队列流式传输 (Queue Streaming)](./07-controller-configuration.md#75-队列流式传输-queue-streaming)
- 7.6 [并发控制](./07-controller-configuration.md#76-并发控制)
- 7.7 [端口和主机配置](./07-controller-configuration.md#77-端口和主机配置)
- 7.8 [控制器最佳实践](./07-controller-configuration.md#78-控制器最佳实践)

## 8. [WebSocket 接口](./08-websocket-interface.md)
- 7.1 [WebSocket 概述](./08-websocket-interface.md#71-websocket-overview)
- 7.2 [配置](./08-websocket-interface.md#72-configuration)
- 7.3 [连接 WebSocket](./08-websocket-interface.md#73-connecting-to-websocket)
- 7.4 [WebSocket 消息](./08-websocket-interface.md#74-websocket-messages)
- 7.5 [REST API 集成](./08-websocket-interface.md#75-rest-api-integration)
- 7.6 [使用模式](./08-websocket-interface.md#76-usage-patterns)
- 7.7 [连接管理](./08-websocket-interface.md#77-connection-management)
- 7.8 [安全注意事项](./08-websocket-interface.md#78-security-considerations)
- 7.9 [最佳实践](./08-websocket-interface.md#79-best-practices)

## 9. [Web UI 配置](./09-webui-configuration.md)
- 8.1 [Web UI 概述](./09-webui-configuration.md#81-web-ui-概述)
- 8.2 [Gradio 驱动](./09-webui-configuration.md#82-gradio-驱动)
- 8.3 [静态文件驱动](./09-webui-configuration.md#83-静态文件驱动)
- 8.4 [通过反向代理部署 Web UI](./09-webui-configuration.md#84-通过反向代理部署-web-ui)

## 10. [使用本地 AI 模型](./10-local-ai-models.md)
- 9.1 [本地模型概述](./10-local-ai-models.md#91-本地模型概述)
- 9.2 [模型安装和设置](./10-local-ai-models.md#92-模型安装和设置)
- 9.3 [支持的任务类型](./10-local-ai-models.md#93-支持的任务类型)
- 9.4 [模型配置（设备、精度、批量大小）](./10-local-ai-models.md#94-模型配置设备精度批量大小)
- 9.5 [使用 LoRA/PEFT 适配器](./10-local-ai-models.md#95-使用-lorapeft-适配器)
- 9.6 [模型服务框架](./10-local-ai-models.md#96-模型服务框架)
- 9.7 [性能优化技巧](./10-local-ai-models.md#97-性能优化技巧)

## 11. [模型训练](./11-model-training.md)
- 10.1 [训练概述](./11-model-training.md#101-训练概述)
- 10.2 [数据集准备](./11-model-training.md#102-数据集准备)
  - 10.2.1 [数据集组件概述](./11-model-training.md#1021-数据集组件概述)
  - 10.2.2 [加载 HuggingFace 数据集](./11-model-training.md#1022-加载-huggingface-数据集)
  - 10.2.3 [加载本地数据集](./11-model-training.md#1023-加载本地数据集)
  - 10.2.4 [数据集操作](./11-model-training.md#1024-数据集操作)
  - 10.2.5 [数据集格式](./11-model-training.md#1025-数据集格式)
- 10.3 [训练配置](./11-model-training.md#103-训练配置)
  - 10.3.1 [基础训练配置](./11-model-training.md#1031-基础训练配置)
  - 10.3.2 [优化器配置](./11-model-training.md#1032-优化器配置)
  - 10.3.3 [学习率调度器](./11-model-training.md#1033-学习率调度器)
  - 10.3.4 [优化设置](./11-model-training.md#1034-优化设置)
  - 10.3.5 [评估和保存](./11-model-training.md#1035-评估和保存)
  - 10.3.6 [内存优化](./11-model-training.md#1036-内存优化)
  - 10.3.7 [可重复性设置](./11-model-training.md#1037-可重复性设置)
- 10.4 [微调](./11-model-training.md#104-微调)
  - 10.4.1 [SFT（监督微调）](./11-model-training.md#1041-sft监督微调)
  - 10.4.2 [序列打包](./11-model-training.md#1042-序列打包)
- 10.5 [LoRA 训练](./11-model-training.md#105-lora-训练)
  - 10.5.1 [LoRA 概述](./11-model-training.md#1051-lora-概述)
  - 10.5.2 [基础 LoRA 配置](./11-model-training.md#1052-基础-lora-配置)
  - 10.5.3 [目标模块配置](./11-model-training.md#1053-目标模块配置)
  - 10.5.4 [LoRA 偏置配置](./11-model-training.md#1054-lora-偏置配置)
  - 10.5.5 [QLoRA（量化 LoRA）](./11-model-training.md#1055-qlora量化-lora)
  - 10.5.6 [LoRA 超参数指南](./11-model-training.md#1056-lora-超参数指南)
- 10.6 [训练监控](./11-model-training.md#106-训练监控)
- 10.7 [检查点管理](./11-model-training.md#107-检查点管理)
- 10.8 [实践示例](./11-model-training.md#108-实践示例)

## 12. [外部服务集成](./12-external-service-integration.md)
- 11.1 [OpenAI API](./12-external-service-integration.md#111-openai-api)
  - 11.1.1 [聊天补全](./12-external-service-integration.md#1111-聊天补全)
  - 11.1.2 [图像生成（DALL-E）](./12-external-service-integration.md#1112-图像生成dall-e)
  - 11.1.3 [音频（TTS、转录）](./12-external-service-integration.md#1113-音频tts转录)
- 11.2 [Anthropic Claude API](./12-external-service-integration.md#112-anthropic-claude-api)
- 11.3 [Google Gemini API](./12-external-service-integration.md#113-google-gemini-api)
- 11.4 [ElevenLabs（TTS）](./12-external-service-integration.md#114-elevenlabstts)
- 11.5 [Stability AI（图像生成）](./12-external-service-integration.md#115-stability-ai图像生成)
- 11.6 [Replicate](./12-external-service-integration.md#116-replicate)
- 11.7 [自定义 HTTP API](./12-external-service-integration.md#117-自定义-http-api)
- 11.8 [外部服务集成最佳实践](./12-external-service-integration.md#118-外部服务集成最佳实践)

## 13. [流式模式](./13-streaming-mode.md)
- 12.1 [流式概述](./13-streaming-mode.md#121-流式概述)
  - 12.1.1 [什么是流式？](./13-streaming-mode.md#1211-什么是流式)
  - 12.1.2 [支持的组件](./13-streaming-mode.md#1212-支持的组件)
  - 12.1.3 [流式协议](./13-streaming-mode.md#1213-流式协议)
- 12.2 [组件特定的流式配置](./13-streaming-mode.md#122-组件特定的流式配置)
  - 12.2.1 [模型组件](./13-streaming-mode.md#1221-模型组件)
  - 12.2.2 [HTTP 组件](./13-streaming-mode.md#1222-http-组件)
- 12.3 [在工作流中使用流式](./13-streaming-mode.md#123-在工作流中使用流式)
  - 12.3.1 [基础流式工作流](./13-streaming-mode.md#1231-基础流式工作流)
  - 12.3.2 [多步骤工作流流式](./13-streaming-mode.md#1232-多步骤工作流流式)
  - 12.3.3 [条件流式](./13-streaming-mode.md#1233-条件流式)
- 12.4 [处理流式响应](./13-streaming-mode.md#124-处理流式响应)
  - 12.4.1 [API 端点](./13-streaming-mode.md#1241-api-端点)
  - 12.4.2 [客户端实现（JavaScript）](./13-streaming-mode.md#1242-客户端实现javascript)
  - 12.4.3 [客户端实现（Python）](./13-streaming-mode.md#1243-客户端实现python)
  - 12.4.4 [Web UI 集成](./13-streaming-mode.md#1244-web-ui-集成)
- 12.5 [性能和优化](./13-streaming-mode.md#125-性能和优化)
  - 12.5.1 [模型流式优化](./13-streaming-mode.md#1251-模型流式优化)
  - 12.5.2 [HTTP 流式优化](./13-streaming-mode.md#1252-http-流式优化)
  - 12.5.3 [内存管理](./13-streaming-mode.md#1253-内存管理)
  - 12.5.4 [网络优化](./13-streaming-mode.md#1254-网络优化)
  - 12.5.5 [错误处理](./13-streaming-mode.md#1255-错误处理)
- 12.6 [真实世界示例](./13-streaming-mode.md#126-真实世界示例)
  - 12.6.1 [实时翻译流式](./13-streaming-mode.md#1261-实时翻译流式)
  - 12.6.2 [OpenAI + Claude 组合](./13-streaming-mode.md#1262-openai--claude-组合)
  - 12.6.3 [本地模型流式服务器](./13-streaming-mode.md#1263-本地模型流式服务器)
- 12.7 [分布式流式传输（队列流式传输）](./13-streaming-mode.md#127-分布式流式传输���列流式传输)
- 12.8 [流式最佳实践](./13-streaming-mode.md#128-流式最佳实践)

## 14. [变量绑定](./14-variable-binding.md)
- 13.1 [语法概述](./14-variable-binding.md#131-语法概述)
- 13.2 [变量来源](./14-variable-binding.md#132-变量来源)
  - 13.2.1 [工作流输入](./14-variable-binding.md#1321-工作流输入)
  - 13.2.2 [组件响应变量](./14-variable-binding.md#1322-组件响应变量)
  - 13.2.3 [前置作业输出](./14-variable-binding.md#1323-前置作业输出)
  - 13.2.4 [环境变量](./14-variable-binding.md#1324-环境变量)
  - 13.2.5 [流式块引用](./14-variable-binding.md#1325-流式块引用)
- 13.3 [路径访问](./14-variable-binding.md#133-路径访问)
- 13.4 [类型转换](./14-variable-binding.md#134-类型转换)
  - 13.4.1 [基础类型](./14-variable-binding.md#1341-基础类型)
  - 13.4.2 [对象数组投影](./14-variable-binding.md#1342-对象数组投影)
  - 13.4.3 [媒体类型](./14-variable-binding.md#1343-媒体类型)
  - 13.4.4 [属性](./14-variable-binding.md#1344-属性)
  - 13.4.5 [Base64 类型 vs Base64 格式](./14-variable-binding.md#1345-base64-类型-vs-base64-格式)
- 13.5 [格式与上下文语义](./14-variable-binding.md#135-格式与上下文语义)
  - 13.5.1 [格式值](./14-variable-binding.md#1351-格式值)
  - 13.5.2 [输入上下文](./14-variable-binding.md#1352-输入上下文)
  - 13.5.3 [组件/作业输出上下文](./14-variable-binding.md#1353-组件作业输出上下文)
  - 13.5.4 [工作流输出上下文](./14-variable-binding.md#1354-工作流输出上下文)
- 13.6 [默认值](./14-variable-binding.md#136-默认值)
  - 13.6.1 [字面量默认值](./14-variable-binding.md#1361-字面量默认值)
  - 13.6.2 [环境变量默认值](./14-variable-binding.md#1362-环境变量默认值)
  - 13.6.3 [嵌套默认值（环境变量 + 字面量）](./14-variable-binding.md#1363-嵌套默认值环境变量--字面量)
- 13.7 [元数据与 UI 提示](./14-variable-binding.md#137-元数据与-ui-提示)
  - 13.7.1 [注解](./14-variable-binding.md#1371-注解)
  - 13.7.2 [Select（下拉菜单）](./14-variable-binding.md#1372-select下拉菜单)
  - 13.7.3 [Slider](./14-variable-binding.md#1373-slider)
  - 13.7.4 [Textarea](./14-variable-binding.md#1374-textarea)
- 13.8 [实践示例](./14-variable-binding.md#138-实践示例)

## 15. [系统集成](./15-system-integration.md)
- 14.1 [监听器概述](./15-system-integration.md#141-监听器概述)
- 14.2 [HTTP 回调监听器](./15-system-integration.md#142-http-回调监听器)
  - 14.2.1 [HTTP 回调概述](./15-system-integration.md#1421-http-回调概述)
  - 14.2.2 [基础 HTTP 回调配置](./15-system-integration.md#1422-基础-http-回调配置)
  - 14.2.3 [回调端点配置](./15-system-integration.md#1423-回调端点配置)
  - 14.2.4 [回调字段描述](./15-system-integration.md#1424-回调字段描述)
  - 14.2.5 [批量回调处理](./15-system-integration.md#1425-批量回调处理)
  - 14.2.6 [高级 HTTP 回调配置](./15-system-integration.md#1426-高级-http-回调配置)
  - 14.2.7 [HTTP 回调工作原理](./15-system-integration.md#1427-http-回调工作原理)
  - 14.2.8 [回调数据映射](./15-system-integration.md#1428-回调数据映射)
- 14.3 [HTTP 触发监听器](./15-system-integration.md#143-http-触发监听器)
  - 14.3.1 [HTTP 触发概述](./15-system-integration.md#1431-http-触发概述)
  - 14.3.2 [基础 HTTP 触发配置](./15-system-integration.md#1432-基础-http-触发配置)
  - 14.3.3 [触发端点配置](./15-system-integration.md#1433-触发端点配置)
  - 14.3.4 [触发字段描述](./15-system-integration.md#1434-触发字段描述)
  - 14.3.5 [批量触发处理](./15-system-integration.md#1435-批量触发处理)
  - 14.3.6 [HTTP 触发工作原理](./15-system-integration.md#1436-http-触发工作原理)
  - 14.3.7 [输入数据映射](./15-system-integration.md#1437-输入数据映射)
  - 14.3.8 [实践示例](./15-system-integration.md#1438-实践示例)
- 14.4 [网关 - HTTP 隧道](./15-system-integration.md#144-网关---http-隧道)
  - 14.4.1 [网关概述](./15-system-integration.md#1441-网关概述)
  - 14.4.2 [HTTP 隧道 - ngrok](./15-system-integration.md#1442-http-隧道---ngrok)
  - 14.4.3 [HTTP 隧道 - Cloudflare](./15-system-integration.md#1443-http-隧道---cloudflare)
  - 14.4.4 [SSH 隧道](./15-system-integration.md#1444-ssh-隧道)
  - 14.4.5 [高级网关配置](./15-system-integration.md#1445-高级网关配置)
  - 14.4.6 [真实世界示例：Slack Bot Webhook](./15-system-integration.md#1446-真实世界示例slack-bot-webhook)
- 14.5 [同时使用监听器和网关](./15-system-integration.md#145-同时使用监听器和网关)
  - 14.5.1 [集成示例：异步图像处理](./15-system-integration.md#1451-集成示例异步图像处理)
  - 14.5.2 [架构图](./15-system-integration.md#1452-架构图)
  - 14.5.3 [生产环境考虑](./15-system-integration.md#1453-生产环境考虑)
- 14.6 [系统集成最佳实践](./15-system-integration.md#146-系统集成最佳实践)
- 14.7 [系统 - 基础设施管理](./15-system-integration.md#147-系统---基础设施管理)
  - 14.7.1 [系统概述](./15-system-integration.md#1471-系统概述)
  - 14.7.2 [Docker Compose 系统](./15-system-integration.md#1472-docker-compose-系统)
  - 14.7.3 [多个系统](./15-system-integration.md#1473-多个系统)
  - 14.7.4 [完整示例：浏览器自动化](./15-system-integration.md#1474-完整示例浏览器自动化)
  - 14.7.5 [生命周期顺序](./15-system-integration.md#1475-生命周期顺序)
  - 14.7.6 [前提条件](./15-system-integration.md#1476-前提条件)

## 16. [部署](./16-deployment.md)
- 15.1 [本地执行](./16-deployment.md#151-本地执行)
  - 15.1.1 [基础执行](./16-deployment.md#1511-基础执行)
  - 15.1.2 [环境变量管理](./16-deployment.md#1512-环境变量管理)
  - 15.1.3 [指定配置文件](./16-deployment.md#1513-指定配置文件)
  - 15.1.4 [独立运行工作流](./16-deployment.md#1514-独立运行工作流)
  - 15.1.5 [调试选项](./16-deployment.md#1515-调试选项)
- 15.2 [Docker 运行时](./16-deployment.md#152-docker-运行时)
  - 15.2.1 [基础 Docker 配置](./16-deployment.md#1521-基础-docker-配置)
  - 15.2.2 [高级 Docker 选项](./16-deployment.md#1522-高级-docker-选项)
  - 15.2.3 [卷和环境变量](./16-deployment.md#1523-卷和环境变量)
- 15.3 [Docker 容器构建和部署](./16-deployment.md#153-docker-容器构建和部署)
  - 15.3.1 [自动构建过程](./16-deployment.md#1531-自动构建过程)
  - 15.3.2 [使用自定义 Dockerfile](./16-deployment.md#1532-使用自定义-dockerfile)
  - 15.3.3 [多阶段构建](./16-deployment.md#1533-多阶段构建)
  - 15.3.4 [使用镜像仓库](./16-deployment.md#1534-使用镜像仓库)
  - 15.3.5 [私有仓库认证](./16-deployment.md#1535-私有仓库认证)
- 15.4 [生产环境考虑](./16-deployment.md#154-生产环境考虑)
  - 15.4.1 [并发控制](./16-deployment.md#1541-并发控制)
  - 15.4.2 [资源限制](./16-deployment.md#1542-资源限制)
  - 15.4.3 [重启策略](./16-deployment.md#1543-重启策略)
  - 15.4.4 [健康检查](./16-deployment.md#1544-健康检查)
  - 15.4.5 [安全考虑](./16-deployment.md#1545-安全考虑)
  - 15.4.6 [数据持久化](./16-deployment.md#1546-数据持久化)
- 15.5 [监控和日志](./16-deployment.md#155-监控和日志)
  - 15.5.1 [日志配置](./16-deployment.md#1551-日志配置)
  - 15.5.2 [Docker 容器日志](./16-deployment.md#1552-docker-容器日志)
  - 15.5.3 [工作流执行日志](./16-deployment.md#1553-工作流执行日志)
  - 15.5.4 [指标收集](./16-deployment.md#1554-指标收集)
  - 15.5.5 [外部监控系统](./16-deployment.md#1555-外部监控系统)
  - 15.5.6 [追踪器配置](./16-deployment.md#1556-追踪器配置)
- 15.6 [部署最佳实践](./16-deployment.md#156-部署最佳实践)

## 17. [实践示例](./17-practical-examples.md)
- 16.1 [构建聊天机器人](./17-practical-examples.md#161-构建聊天机器人)
  - 16.1.1 [OpenAI GPT-4o 聊天机器人](./17-practical-examples.md#1611-openai-gpt-4o-聊天机器人)
  - 16.1.2 [流式聊天机器人](./17-practical-examples.md#1612-流式聊天机器人)
- 16.2 [语音生成流水线](./17-practical-examples.md#162-语音生成流水线)
  - 16.2.1 [文本转语音（OpenAI TTS）](./17-practical-examples.md#1621-文本转语音openai-tts)
  - 16.2.2 [励志名言语音生成](./17-practical-examples.md#1622-励志名言语音生成)
- 16.3 [图像分析和编辑](./17-practical-examples.md#163-图像分析和编辑)
  - 16.3.1 [图像说明（图像转文本）](./17-practical-examples.md#1631-图像说明图像转文本)
  - 16.3.2 [图像编辑（OpenAI DALL-E）](./17-practical-examples.md#1632-图像编辑openai-dall-e)
- 16.4 [RAG 系统（使用向量数据库）](./17-practical-examples.md#164-rag-系统使用向量数据库)
  - 16.4.1 [使用 ChromaDB 的文本嵌入搜索](./17-practical-examples.md#1641-使用-chromadb-的文本嵌入搜索)
  - 16.4.2 [使用 Milvus 的 RAG 系统](./17-practical-examples.md#1642-使用-milvus-的-rag-系统)
- 16.5 [Slack 机器人（MCP）](./17-practical-examples.md#165-slack-机器人mcp)
  - 16.5.1 [使用 MCP 服务器构建 Slack 机器人](./17-practical-examples.md#1651-使用-mcp-服务器构建-slack-机器人)
  - 16.5.2 [AI 驱动的 Slack 自动回复机器人](./17-practical-examples.md#1652-ai-驱动的-slack-自动回复机器人)
- 16.6 [多模态工作流](./17-practical-examples.md#166-多模态工作流)
  - 16.6.1 [图像 → 文本 → 语音流水线](./17-practical-examples.md#1661-图像--文本--语音流水线)
  - 16.6.2 [语音 → 文本 → 翻译 → 语音流水线](./17-practical-examples.md#1662-语音--文本--翻译--语音流水线)
- 16.8 [键值存储（缓存与会话）](./17-practical-examples.md#168-键值存储缓存与会话)
  - 16.8.1 [API 响应缓存](./17-practical-examples.md#1681-api-响应缓存)
  - 16.8.2 [会话管理](./17-practical-examples.md#1682-会话管理)
- 17.10 [带对话记忆的聊天机器人](./17-practical-examples.md#1710-带对话记忆的聊天机器人)
  - 17.10.1 [有状态聊天机器人 (model-memory)](./17-practical-examples.md#17101-有状态聊天机器人-model-memory)
  - 17.10.2 [使用 Redis 记忆的多用户聊天](./17-practical-examples.md#17102-使用-redis-记忆的多用户聊天)

## 18. [故障排除](./18-troubleshooting.md)
- 17.1 [常见问题解答（FAQ）](./18-troubleshooting.md#171-常见问题解答faq)
  - 17.1.1 [安装和环境设置](./18-troubleshooting.md#1711-安装和环境设置)
  - 17.1.2 [组件配置](./18-troubleshooting.md#1712-组件配置)
  - 17.1.3 [工作流执行](./18-troubleshooting.md#1713-工作流执行)
  - 17.1.4 [Web UI](./18-troubleshooting.md#1714-web-ui)
  - 17.1.5 [监听器和网关](./18-troubleshooting.md#1715-监听器和网关)
- 17.2 [常见错误和解决方案](./18-troubleshooting.md#172-常见错误和解决方案)
  - 17.2.1 [模型加载错误](./18-troubleshooting.md#1721-模型加载错误)
  - 17.2.2 [网络错误](./18-troubleshooting.md#1722-网络错误)
  - 17.2.3 [配置文件错误](./18-troubleshooting.md#1723-配置文件错误)
  - 17.2.4 [变量绑定错误](./18-troubleshooting.md#1724-变量绑定错误)
  - 17.2.5 [Docker 运行时错误](./18-troubleshooting.md#1725-docker-运行时错误)
- 17.3 [调试技巧](./18-troubleshooting.md#173-调试技巧)
  - 17.3.1 [启用日志](./18-troubleshooting.md#1731-启用日志)
  - 17.3.2 [检查变量值](./18-troubleshooting.md#1732-检查变量值)
  - 17.3.3 [逐步执行](./18-troubleshooting.md#1733-逐步执行)
  - 17.3.4 [检查 API 响应](./18-troubleshooting.md#1734-检查-api-响应)
  - 17.3.5 [Docker 容器日志](./18-troubleshooting.md#1735-docker-容器日志)
  - 17.3.6 [验证环境变量](./18-troubleshooting.md#1736-验证环境变量)
  - 17.3.7 [检查端口冲突](./18-troubleshooting.md#1737-检查端口冲突)
  - 17.3.8 [验证依赖项](./18-troubleshooting.md#1738-验证依赖项)

## 19. [附录](./19-appendix.md)
- 18.1 [完整配置文件架构](./19-appendix.md#181-完整配置文件架构)
  - 18.1.1 [顶层结构](./19-appendix.md#1811-顶层结构)
  - 18.1.2 [控制器架构](./19-appendix.md#1812-控制器架构)
  - 18.1.3 [组件架构](./19-appendix.md#1813-组件架构)
  - 18.1.4 [工作流架构](./19-appendix.md#1814-工作流架构)
  - 18.1.5 [监听器架构](./19-appendix.md#1815-监听器架构)
  - 18.1.6 [网关架构](./19-appendix.md#1816-网关架构)
  - 18.1.7 [日志架构](./19-appendix.md#1817-日志架构)
  - 18.1.8 [追踪器架构](./19-appendix.md#1818-追踪器架构)
  - 18.1.9 [运行时架构](./19-appendix.md#1819-运行时架构)

---

**注意**：标记为"待定"的部分是当前正在开发的功能的占位符。
