# docs-sync

**Repository Path**: fanlun007/docs-sync

## Basic Information

- **Project Name**: docs-sync
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-04
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dify API 文档索引

## 📚 文档列表

### 1. **工作流工具执行流程深度分析**
**文件**: `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md`

**内容概览**:
- ✅ 完整的工具执行链路图（Mermaid 图表）
- ✅ 工作流配置到工具节点的详细讲解
- ✅ ToolManager 工具管理器原理
- ✅ 动态模块加载机制
- ✅ BuiltinToolProviderController 初始化过程
- ✅ 工具获取和执行流程
- ✅ 关键文件结构说明
- ✅ 核心概念和数据流追踪
- ✅ 调试技巧和最佳实践

**关键问题解答**:
- 💡 `provider_id: "time"` 如何映射到 `/core/tools/builtin_tool/providers/time/` ?
- 💡 工具是如何被动态加载的？
- 💡 Dify 的工具缓存策略是什么？
- 💡 如何添加新的工具提供者？

**适合读者**:
- Dify 核心开发者
- 插件和工具扩展开发者
- 想深入理解 Dify 架构的开发者

---

## 🔍 快速导航

### 从问题找答案

| 问题 | 答案位置 |
|------|--------|
| 工作流中的 tool node 如何执行？ | `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md` - 完整执行流程详解 |
| provider_id 的映射规则是什么？ | `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md` - 第 3 步：动态加载提供者类 |
| 如何添加新的工具提供者？ | `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md` - 关键发现和最佳实践 |
| ToolManager 的缓存机制是什么？ | `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md` - 核心概念 → 缓存策略 |
| 调试工具加载失败的方法？ | `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md` - 调试技巧 |

### 按优先级阅读

**⭐ 必读（理解工具系统核心）**:
1. 完整执行流程详解
2. 执行链路图
3. 关键文件结构

**⭐⭐ 重要（开发工具时需要）**:
1. 第 4 步：BuiltinToolProviderController 初始化
2. 核心概念
3. 调试技巧

**⭐⭐⭐ 深度（架构优化）**:
1. 数据流追踪
2. 关键代码片段总结
3. 关键发现和最佳实践

---

## 📊 文档统计

| 指标 | 数值 |
|------|------|
| 总字数 | ~12,000 |
| 代码片段 | 15+ |
| 图表 | 2（执行流程图、完整数据流） |
| 表格 | 8+ |
| 关键概念 | 20+ |

---

## 🔗 相关文件

**核心文件** (在 Dify 源代码中):
- `/core/tools/tool_manager.py` - ToolManager 主文件
- `/core/tools/builtin_tool/provider.py` - 内置提供者基类
- `/core/tools/builtin_tool/providers/time/time.py` - 时间提供者示例
- `/controllers/console/app/workflow.py` - 工作流 REST API

---

## 📝 文档编写信息

- **分析日期**: 2026年4月1日
- **涵盖范围**: Dify API v1.11.3
- **分析方式**: 源代码深度追踪 (Trace-as-Code)
- **阅读时间**: 约 20-30 分钟

---

## 💡 使用建议

1. **第一次阅读**: 按顺序从上到下阅读 `WORKFLOW_TOOL_EXECUTION_ANALYSIS.md`
2. **快速查阅**: 使用章节目录（目录）快速跳转
3. **深度学习**: 结合源代码一起阅读，在 IDE 中对照查看
4. **实战应用**: 使用调试技巧解决实际问题

---

## 🚀 下一步计划

计划补充的文档:
- [ ] 工具参数验证和转换机制
- [ ] 工具凭证管理系统
- [ ] 插件工具加载流程
- [ ] 工作流变量 VariablePool 详解
- [ ] 工具的异步执行机制

---

如有问题或反馈，欢迎提交 Issue 或 PR！