docs: 同步最近需求到项目文档-新增REQUIREMENTS.md系统需求文档(最近需求包RQ-AI/RQ-CAP/RQ-MK/RQ-KB/RQ-REDIS/RQ-FLOW/RQ-SKILL+验收要点),README中英双语v1.8更新日志追加12条(AI节点增强/模型参数/工具调用/知识库/数据提取/Redis/Skill/市场/发现/分享/能力绑定)+文档区链接,Architecture.md更新模块划分/数据表/21种节点类型/版本规划+新增十二AI能力与开放生态架构章节(回调注入/知识库检索/市场生态/Redis多实例),DesignDoc.md版本迭代计划v1.7/v1.8标记完成+新增十二v1.8模块详细设计(15张新表/API清单/工具调用与GitHub分享流程),DEPLOY.md新增十市场发现与分享配置(market目录持久化/GitHub PAT授权/常见问题),表结构文档更新为40张表+新增报表告警/AI知识库/集成市场生态模块

Author: pythonHuang

Architecture.md

@@ -215,6 +215,15 @@ console-ui/
 | 模板市场 | /market/template | 流程模板市场 |
 | Token 管理 | /system/token | 访问令牌管理 |
 | 数据源管理 | /system/datasource | MySQL 数据源配置 |
+| 市场 | /market | 五类条目市场（接口/流程/模型助手/Skill/报表）+ 发现/收藏/下载/分享 |
+| 模型助手 | /ai/assistant | 自定义模型助手管理 + 流程/接口/报表智能编排 |
+| 大模型设置 | /system/ai-provider | 模型供应商（多供应商/能力绑定/模型拉取测试） |
+| 知识库 | /knowledge | 知识库管理（文档解析切片/检索/清洗/匹配记录） |
+| Skill 管理 | /system/skill | 技能 CRUD / 导入导出 |
+| Redis 配置 | /system/redis | Redis 多实例配置与测试 |
+| 报表管理 | /report | 数据视图 + 报表设计器 + 报表查询 |
+
+> 注：报表/知识库/市场/模型助手模块为 v1.8 新增，详见图 4.2 对应的菜单路由配置（`router/index.ts`）。
 
 ### 4.3 核心组件
 
@@ -252,6 +261,16 @@ console-ui/
 | t_flow_version | 流程版本表 |
 | t_token | 访问令牌表 |
 | t_data_source | 数据源表 |
+| t_ai_provider | AI 模型供应商表（baseUrl/apiKey/models/capabilities 能力绑定） |
+| t_ai_assistant | AI 自定义助手表（系统提示词/入出参/快速提示词/图标） |
+| t_ai_conversation | AI 对话会话表（多轮消息/输出/历史） |
+| t_skill | 技能表（分组/内容/启停，AI 节点拼入提示词） |
+| t_kb / t_kb_document / t_kb_chunk / t_kb_match_log | 知识库 4 表（切片/向量/匹配记录） |
+| t_redis_config | Redis 多实例配置表 |
+| t_market_item | 市场条目表（平台级共享，含官方 ID/图标/作者/版本） |
+| t_market_favorite | 市场收藏表（租户级） |
+| t_data_view / t_report | 数据视图 / 报表表 |
+| t_alert_rule / t_alert_record | 告警规则 / 告警记录表 |
 
 ### 5.2 ER 关系
 
@@ -338,6 +357,14 @@ t_flow_definition ──(部署)──> t_flow_info ──< t_flow_version
 | PARALLEL | 并行节点，多分支并发执行 |
 | NOTIFY | 通知节点，Webhook/邮件通知 |
 | TRANSFORM | 模板转换节点，${var|pipe} 语法替换占位符 |
+| AI | 大模型节点：供应商/模型/图片输入/模型参数（深度思考/温度/最大输出/随机种子）+ 函数调用工具（接口/流程，最多 4 轮） |
+| FILE_PARSE | 文件解析节点：json/csv/xml/text/图片（视觉模型识别） |
+| EXCEL_READ | Excel 读取节点 |
+| FILE_WRITE | 文件写入节点 |
+| REDIS_GET | Redis 查询节点（多实例/变量模板/JSON 解析） |
+| REDIS_SET | Redis 设置节点（过期秒数） |
+| KB_SEARCH | 知识库检索节点（RAG 上下文） |
+| DATA_EXTRACT | 数据提取节点（json/code/keyword/between/length 五种提取类型） |
 
 ### 6.3 变量机制
 
@@ -543,4 +570,71 @@ JuggleNet6/
 | v1.2 | 流程调试 + 部署 + 触发 + 开放接口 | P0 |
 | v1.3 | Token 管理 + 数据源管理 | P1 |
 | v1.4 | 套件/模板市场（只读展示） | P2 |
-| v2.0 | 多租户支持、权限系统 | P3 |
+| v1.5-v1.7 | 子流程/监控/静态变量/WSDL/TRANSFORM/报表/AI 助手 | ✅ 已完成 |
+| v1.8 | AI 节点增强与工具调用、知识库、Redis 多实例、Skill 管理、市场生态（发现/收藏/分享 GitHub PR）、模型能力绑定 | ✅ 已完成（2026-09） |
+| v1.9 | 官方市场运营（GitHub 仓库 index.json 维护）、更多节点类型、AI 多模态扩展 | ⏳ 待规划 |
+
+---
+
+## 十二、AI 能力与开放生态架构（v1.8 新增）
+
+### 12.1 AI 大模型能力架构
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│                    前端 AI 模块（Vue3）                            │
+│  大模型设置(供应商/模型/能力绑定)  模型助手管理  流程/接口/报表助手   │
+└──────────────┬───────────────────────────────────────────────────┘
+               │ /api/ai/*（JWT）
+┌──────────────▼───────────────────────────────────────────────────┐
+│                    AiService（Application 层）                    │
+│  ChatRequestAsync(统一入口: 图片/模型参数/tools/多轮历史)           │
+│  ResolveConfigAsync(供应商解析)  GenerateFlow/Apis/Report(编排生成) │
+│  Conversation(多轮会话)   ExtractJson(代码块剥离)                  │
+└──────────────┬───────────────────────────────────────────────────┘
+               │ Func 回调注入（引擎与配置解耦）
+┌──────────────▼───────────────────────────────────────────────────┐
+│                   FlowEngine 回调注入体系                          │
+│  aiChatFunc       → AiChatRequest → AiChatResult(Text+ToolCalls)  │
+│  toolsResolver    → 接口/流程 → OpenAI tools 定义(含参数说明)       │
+│  toolRunner       → api:xxx HTTP 调用 / flow:xxx 递归子引擎执行     │
+│  skillResolver    → 技能 ID → 提示词拼接                            │
+│  kbSearchFunc     → 知识库检索上下文                                │
+│  redisConnStrs    → Redis 多实例连接串（0=默认实例）                │
+└───────────────────────────────────────────────────────────────────┘
+```
+
+**关键设计**：
+1. **能力绑定（Capabilities）**：供应商存 `capabilities` JSON（skills/apis/flows/tools），前端按所选供应商过滤 AI 节点技能下拉。
+2. **函数调用（Tool Calling）**：AI 节点勾选接口/流程 → 执行时经 `toolsResolver` 生成 OpenAI 函数定义 → 模型返回 `tool_calls` → `toolRunner` 执行（接口走 HTTP，流程走递归 FlowEngine）→ 结果以 `role=tool` 消息回传，最多 4 轮；`AiChatRequest` 携带 `History`（多轮 tool_calls 消息）与 `ToolsJson`。
+3. **模型参数**：深度思考（enable_thinking）、温度、max_tokens、seed 经统一请求入口透传 OpenAI 兼容接口。
+
+### 12.2 知识库检索架构
+
+- **存储**：`t_kb`（库配置：切片大小/重叠/检索类型/向量模型）→ `t_kb_document`（文档）→ `t_kb_chunk`（切片，`vector_json` 存向量）。
+- **检索**：文本模式（SQLite LIKE 关键词打分）与向量模式（调用供应商 embeddings 接口 → 余弦相似度 TopK）；`t_kb_match_log` 记录每次检索。
+- **流程接入**：`KB_SEARCH` 节点经 `kbSearchFunc` 回调获取 TopK 上下文文本，供 AI 节点 RAG 问答。
+
+### 12.3 市场生态架构（发现 / 收藏 / 分享）
+
+```
+GitHub 官方仓库 pythonHuang/APIWorkflowCanvasDesignNet
+  └── market/
+        ├── index.json            # 条目索引（id/type/name/author/version/file）
+        ├── flow/1.json ...       # 各类型 {id}.json 条目文件
+
+① 发现：GET /api/market/discover → 拉取 index.json + 各条目文件 → 本地 market/ 目录
+② 导入：POST /api/market/import-file → 按 (market_item_id, item_type) upsert t_market_item
+③ 应用：POST /api/market/import/{id} → 按类型创建业务实体（按名称/code 去重）
+④ 收藏：t_market_favorite（租户级）→ 列表过滤 favorite=1
+⑤ 分享：POST /api/market/generate-share-file → 本地生成 {id}.json + 更新 index.json
+        （同名条目复用原 id）→ 前端 GitHub API：fork → 分支 → 写条目文件
+        → 合并官方最新 index.json → Pull Request（管理员审核合并）
+```
+
+**多租户**：市场条目 `TenantId=null`（平台级共享，宽松隔离）；收藏 `TenantId=当前租户`（严格隔离）；导入产生的业务实体归属导入方租户。
+
+### 12.4 Redis 多实例架构
+
+- `t_redis_config` 存多实例（0=默认实例），`RedisConnectionPool` 按连接串缓存 `ConnectionMultiplexer`。
+- 引擎经 `redisConnStrs` 字典（实例 ID → 连接串）注入；节点 `redisId` 解析实例，未配置时抛明确错误。

DEPLOY.md

@@ -318,3 +318,40 @@ journalctl -u juggle -f
 # Docker
 docker logs -f juggle
 ```
+
+---
+
+## 十、市场发现与分享配置（v1.8）
+
+### 10.1 本地 market 目录
+
+- 市场「发现」拉取官方市场时，条目文件落在后端运行目录下的 `market/` 目录（`market/{type}/{id}.json` + `market/index.json`）。
+- 分享时也会在该目录生成 `{id}.json` 并更新 `index.json`（同名条目复用原 id）。
+- Docker 部署建议将该目录挂载到卷以持久化：
+
+```bash
+docker run -d --name juggle -p 9127:9127 \
+  -v juggle_data:/data \
+  -v juggle_market:/app/market \
+  pythonhuang/juggle-net8:v1.0
+```
+
+> 官方市场仓库：`https://github.com/pythonHuang/APIWorkflowCanvasDesignNet`（market 目录由管理员审核 PR 后维护）。
+
+### 10.2 分享到官方市场（GitHub 授权）
+
+1. 在 GitHub 创建 Personal Access Token（classic）：
+   `Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token`，
+   勾选 **repo** 权限（fork/写文件/创建 PR 所需）。
+2. 分享弹窗中粘贴 Token（仅保存在本机浏览器 localStorage，不落库、不上传服务器），填写作者与版本号。
+3. 系统自动完成：校验令牌 → 确保 fork → 创建分支 → 写入 `market/{type}/{id}.json` → 合并官方最新 `index.json` → 创建 Pull Request。
+4. 管理员审核合并 PR 后，条目进入官方市场；其他用户通过「市场 → 发现」拉取。
+
+### 10.3 常见问题
+
+| 问题 | 处理 |
+|------|------|
+| 发现提示 index.json 获取失败 404 | 官方仓库尚未建立 market 目录/网络受限，稍后重试 |
+| 分享提示 Fork 创建超时 | 登录 GitHub 手动 fork 一次后重试 |
+| PR 创建失败（token 无权限） | 确认 Token 勾选了 repo 权限且未过期 |
+| 大模型节点报"未配置 AI 大模型" | 系统设置 → 大模型设置 添加并启用供应商（支持 DeepSeek/通义千问/Kimi/OpenAI/GLM/Ollama） |

DesignDoc.md

@@ -1357,9 +1357,154 @@ VALUES ('sync_example', '示例流程', 'sync', '...JSON...', '', 0);
 - [x] 监控仪表盘独立菜单，置于首位
 - [x] 复制 URL 剪贴板兼容非 HTTPS 环境
 
-### v1.7（待规划）
-- [ ] 流程模板市场
-- [ ] 执行日志统计图表增强
-- [ ] 接口批量测试
-- [ ] 属性选择器集成到方法节点入/出参
+### v1.7（AI 助手与报表）✅ 已完成
+- [x] 大模型设置（供应商/模型拉取测试/启停）
+- [x] 模型助手管理（自定义助手 + 多轮对话 + 对话历史）
+- [x] 流程/接口/报表智能编排助手
+- [x] 报表模块（数据视图 + 报表设计器 + 公式引擎 + PDF/Excel 导出）
+- [x] 数据库节点 SQL 辅助（表/视图/存储过程浏览 + 测试 SQL）
+- [x] 条件/赋值节点表达式增强（算术/字符串/toString/&&||/子属性/数组）
+
+### v1.8（AI 深化与开放生态）✅ 已完成（2026-09）
+- [x] AI 节点增强：供应商/模型、图片输入（多模态）、输出目标三选
+- [x] AI 节点模型参数：深度思考/温度/最大输出字数/随机种子
+- [x] AI 节点工具调用：接口/流程函数调用（tools，最多 4 轮）
+- [x] 知识库子系统（4 表 + 文档解析切片 + 文本/向量检索 + 清洗 + 匹配记录）+ KB_SEARCH 节点
+- [x] 数据提取节点（json/code/keyword/between/length）
+- [x] Redis 缓存查询/设置节点 + Redis 多实例配置
+- [x] Skill 管理（CRUD/导入导出）+ AI 节点多技能拼接
+- [x] 市场系统（5 类条目/发布/导入去重/收藏/下载/元信息）
+- [x] 市场发现（GitHub index.json → 本地 market 目录 → 按 id 导入更新）
+- [x] 市场分享（本地生成 id.json+index.json → GitHub fork/分支/PR）
+- [x] 模型能力绑定（供应商 capabilities：skills/apis/flows/tools）
+
+---
+
+## 十二、v1.8 新增模块详细设计
+
+### 12.1 新增数据表
+
+#### t_ai_provider（AI 模型供应商表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INTEGER | 主键 |
+| provider_name | TEXT | 供应商名称 |
+| base_url | TEXT | 接口地址（OpenAI 兼容 /v1 一级） |
+| api_key | TEXT | API Key |
+| model | TEXT | 默认模型 |
+| models | TEXT | 可用模型（逗号分隔，对话中可切换） |
+| capabilities | TEXT | 能力绑定 JSON：`{"skills":[..],"apis":["code",..],"flows":["key",..],"tools":["web_search"]}` |
+| enabled | INTEGER | 1=启用 0=禁用 |
+
+#### t_ai_assistant（AI 自定义助手表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| id | INTEGER | 主键 |
+| assistant_name / description | TEXT | 名称 / 描述 |
+| system_prompt | TEXT | 系统提示词（人设与任务） |
+| input_params / output_params | TEXT | 入参/出参定义 JSON（含数据类型/是否必填） |
+| quick_prompts | TEXT | 辅助提问词 JSON（按钮列表） |
+| icon | TEXT | 图标（emoji/上传/模型生成） |
+| enabled | INTEGER | 启用后自动加入模型助手菜单 |
+
+#### t_ai_conversation（对话会话表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| assistant_id / assistant_name | INTEGER/TEXT | 关联助手 |
+| messages | TEXT | 多轮消息 JSON（气泡历史） |
+| outputs | TEXT | 最终输出 JSON（按输出参数生成） |
+| provider_id / model | INTEGER/TEXT | 对话所用供应商/模型（支持切换） |
+| status | INTEGER | 0=进行中 1=已结束 |
+
+#### t_skill（技能表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| skill_name / group_name | TEXT | 名称 / 分组 |
+| description / content | TEXT | 描述 / 技能内容（拼入系统提示词） |
+| enabled | INTEGER | 启停 |
+| market_skill_id | INTEGER | 市场导入来源标记 |
+
+#### t_kb / t_kb_document / t_kb_chunk / t_kb_match_log（知识库 4 表）
+
+| 表 | 关键字段 | 说明 |
+|------|------|------|
+| t_kb | chunk_size / chunk_overlap / retrieve_type(text\|vector) / vector_model / chunk_count | 库配置 |
+| t_kb_document | kb_id / doc_name / doc_type / content / status | 文档（上传解析后原文） |
+| t_kb_chunk | kb_id / doc_id / content / seq_no / vector_json | 切片（向量 JSON 数组） |
+| t_kb_match_log | kb_id / query / results_json / score | 检索匹配记录 |
+
+#### t_redis_config（Redis 多实例配置表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| config_name | TEXT | 实例名称 |
+| host / port / password / db | TEXT | 连接参数 |
+| is_default | INTEGER | 默认实例（全局唯一，0 号=默认） |
+
+#### t_market_item（市场条目表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| item_type | TEXT | api / flow / assistant / skill / report |
+| item_name / description / group_name | TEXT | 名称 / 描述 / 分组 |
+| content_json | TEXT | 内容快照（按类型结构不同） |
+| download_count | INTEGER | 导入次数 |
+| market_item_id | INTEGER | 官方市场条目 ID（发现导入；本地发布为 null） |
+| icon / author / version | TEXT | 图标 / 作者 / 版本号（7.5 元信息） |
+| enabled | INTEGER | 上架/下架 |
+
+#### t_market_favorite（市场收藏表）
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| market_item_id | INTEGER | 收藏的市场条目 ID |
+| tenant_id | INTEGER | 收藏租户（严格隔离） |
+
+### 12.2 新增后端 API
+
+| 方法 | 路径 | 说明 |
+|------|------|------|
+| GET | /api/market/discover | 发现官方市场：拉取 GitHub index.json + 条目文件到本地 market 目录 |
+| GET | /api/market/local-files | 本地 market 目录条目列表（含是否已导入） |
+| POST | /api/market/import-file | 按 (type, marketId) 导入本地文件（id 相同更新否则新增） |
+| POST | /api/market/favorite/{id} / unfavorite/{id} | 收藏 / 取消收藏（幂等） |
+| GET | /api/market/list?favorite=1 | 列表（含元信息 + favorited 标记 + 收藏过滤） |
+| POST | /api/market/generate-share-file | 生成分享文件：本地写 market/{type}/{id}.json + 更新 index.json（同名复用 id） |
+| GET | /api/ai/providers · /api/ai/provider/save · /api/ai/fetch-models | 供应商 CRUD + 模型拉取/配置测试（capabilities 能力绑定） |
+| GET/POST | /api/skill/list · save · delete · toggle · import · batch-import · export · batch-export | Skill 管理 |
+| GET | /api/redis-config/configs · config · save · delete · config/test | Redis 多实例 |
+| GET/POST | /api/knowledge/* | 知识库（kb/document/chunk/search/clean/revectorize/match-logs） |
+
+### 12.3 AI 节点函数调用流程（工具调用）
+
+```
+1. 执行器解析 aiConfig：toolApis（接口 methodCode 列表）+ toolFlows（流程 flowKey 列表）
+2. toolsResolver 回调 → 加载接口/流程定义（含参数说明）→ OpenAI tools JSON
+3. _chat(new AiChatRequest(..., ToolsJson, History)) → AiChatResult{Text, ToolCalls}
+4. ToolCalls 非空（且 <4 轮）：
+   a. history 追加 assistant 消息（tool_calls）
+   b. toolRunner(name, args) 逐个执行：
+      - api:xxx → 按 RequestType 拼 query/body 直接 HTTP 调用（MockJson 优先），响应截断 8000 字符
+      - flow:xxx → flowContentLoader 加载 → 递归 BuildEngineAsync → ExecuteAsync(args) → 出参 JSON
+   c. history 追加 tool 消息（tool_call_id + 结果）
+   d. 回到步骤 3 携带 History 继续
+5. 取最终文本（无文本时回退最近非空文本）写入输出目标
+```
+
+### 12.4 市场分享（GitHub PR）流程
+
+```
+1. 前端校验作者 → POST /api/market/generate-share-file：
+   后端本地落盘 market/{type}/{id}.json（同名复用 id）+ upsert market/index.json
+2. 前端 GitHub API（api.github.com，Token 存 localStorage）：
+   GET /user 校验 → GET/POST forks 确保 fork → POST git/refs 建分支
+   → PUT contents/market/{type}/{id}.json（条目文件）
+   → GET raw index.json（官方最新）合并本条索引 → PUT contents/market/index.json
+   → POST pulls 创建 PR（head=用户名:分支, base=默认分支）→ 打开 PR 页面
+3. 管理员审核合并 → 进入官方 market 目录 → 其他用户「发现」拉取
+```