Skip to content

Commit d4afa8e

Browse files
committed
docs: 更新文档站近期变动描述
1 parent ab4fdfd commit d4afa8e

14 files changed

Lines changed: 573 additions & 220 deletions

docsite/docs/01.指南/01.开始/02.快速上手.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,12 @@ MPE 的前端以 Web 页面的形式可自由部署,因此您可以在任意
4141
对于各个使用方案的区别,您可以参考 [产品矩阵](/guide/start/product-matrix) 章节。
4242
:::
4343

44+
## 新手引导
45+
46+
为确保您了解 Pipeline 相关的基础知识,首次打开 MPE 时,会自动弹出新手引导弹窗。引导包含 MaaFramework 基础知识的简短问答,通过后即可正式开始使用。
47+
48+
完成引导后会自动弹出更新日志,帮助您了解当前版本的新功能。
49+
4450
## 初识界面
4551

4652
进入 Editor 后,您可以看到如下页面加载(点击图片可放大查看):

docsite/docs/01.指南/01.开始/10.产品矩阵.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,9 @@ MaaPipelineEditor 采用**渐进增强**的产品设计理念,提供三种部
5555
| 追踪、产物与识别详情查看 ||||
5656
| **AI 增强** | | | |
5757
| AI 节点搜索 ||||
58-
| AI 节点补全 ||||
58+
| AI 节点补全 | ⚠️ (需代理) |||
59+
| AI 流程探索 ||||
60+
| AI 调试摘要 ||||
5961
| **运维体验** | | | |
6062
| 配置持久化 | ⚠️ (浏览器) | ⚠️ (浏览器) | ✅ (本地文件) |
6163
| 自动更新 || ⚠️ (仅提醒) ||
@@ -83,6 +85,7 @@ MaaPipelineEditor 采用**渐进增强**的产品设计理念,提供三种部
8385
- 无法访问本地文件系统
8486
- 无法使用 MaaFramework 原生功能(截图、OCR、调试等)
8587
- 配置仅保存在浏览器本地存储中
88+
- AI 节点补全需要 API 支持 CORS,或通过 LocalBridge 代理(连接 LB 后自动启用)
8689
- 手动截图后需自行上传图片进行识别
8790

8891
**使用建议**
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: 更新日志
3+
permalink: /guide/start/changelog
4+
categories:
5+
- 指南
6+
tags:
7+
- 指南
8+
---
9+
10+
MPE 内置了更新日志弹窗,帮助您了解每个版本的新功能、优化和修复内容。
11+
12+
## 查看方式
13+
14+
更新日志弹窗会在以下时机自动弹出:
15+
16+
- 完成新手引导后
17+
- 检测到新版本时(可配置)
18+
19+
您也可以随时通过配置面板手动打开更新日志。
20+
21+
## 内容结构
22+
23+
### 版本时间线
24+
25+
左侧显示版本列表,按时间倒序排列。每个版本标注:
26+
27+
- **版本号**:如 v0.10.0
28+
- **版本类型**:major(重大更新)、feature(功能更新)、fix(修复更新)、perf(性能更新)
29+
- **发布日期**
30+
31+
点击版本号可查看对应版本的详细更新内容。
32+
33+
### 更新详情
34+
35+
右侧显示选中版本的更新内容,按类别分组:
36+
37+
- **功能新增**:新增的功能和特性
38+
- **性能优化**:性能改进和体验优化
39+
- **问题修复**:已修复的 Bug
40+
41+
每条更新记录支持 Markdown 链接,可跳转到相关文档或 Issue。
42+
43+
### 预告板块
44+
45+
更新日志还包含预告信息:
46+
47+
- **近期预告**:即将发布的功能和改进
48+
- **长期规划**:产品路线图和远期目标
49+
50+
### 置顶公告
51+
52+
顶部可能显示重要公告(如破坏性变更提醒、迁移指南等),以醒目的提示框形式展示。

docsite/docs/01.指南/01.开始/50.视频教程.md.tmp

Lines changed: 0 additions & 181 deletions
This file was deleted.

docsite/docs/01.指南/10.工作流面板/20.节点.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,26 @@ MPE 提供了三种节点视觉风格,以满足不同用户的审美和使用
102102

103103
![](/images/core/外部节点案例.png)
104104

105+
#### 视觉副本(可重复外部节点)
106+
107+
外部节点支持创建多个**视觉副本**。同一个外部引用可以在画布上出现多次,方便在复杂流程中就近连接,避免长距离连线。
108+
109+
**特点**
110+
111+
- **副本徽章**:当同名外部节点存在多个时,每个节点右上角会显示 `+N` 徽章,表示共有 N+1 个同名副本
112+
- **智能连线**:导入文件时,边会自动连接到距离最近的副本,而非固定连接第一个
113+
- **独立位置**:每个副本可以放置在画布的不同位置,位置信息会随导出保存
114+
- **逻辑等价**:所有同名副本在编译时等价,指向同一个外部节点
115+
116+
**使用场景**
117+
118+
- 大型流程中多个节点需要引用同一个外部节点时,避免连线交叉
119+
- 将外部节点副本放置在引用它的节点附近,提升可读性
120+
121+
::: tip
122+
创建副本的方式:复制已有的外部节点并粘贴,或直接创建同名的外部节点。系统会自动识别为副本关系。
123+
:::
124+
105125
### Anchor 重定向节点
106126

107127
Anchor 重定向节点是一个特殊的节点类型,用于标记一个 **锚点** 的位置,连接到锚点节点的连接会在编译时添加 `[Anchor]` 前缀。

docsite/docs/01.指南/10.工作流面板/50.文件与视口.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,3 +52,44 @@ MPE 的一个文件视口相当于一个 `.json` Pipeline 文件,您可以在
5252
```
5353

5454
若您不希望导出配置,可以在设置中关闭。
55+
56+
## 跨文件搜索
57+
58+
当连接 LocalBridge 后,MPE 支持跨文件搜索功能,可以在所有已扫描的本地文件中搜索节点。
59+
60+
### 启用/禁用
61+
62+
在配置面板的「本地服务」区域,可以通过 **启用跨文件搜索** 开关控制此功能。默认开启。
63+
64+
关闭后,搜索工具仅在当前打开的文件中搜索节点。
65+
66+
### 文件夹过滤
67+
68+
当项目文件较多时,可以通过 **文件夹过滤** 配置项限制搜索和文件列表的范围。
69+
70+
**配置方式**
71+
72+
在配置面板的「本地服务」区域,找到「文件夹过滤」输入框,填写需要包含的文件夹相对路径。
73+
74+
**格式**
75+
76+
- 多个路径之间用逗号、分号或换行分隔
77+
- 路径相对于 LocalBridge 的扫描根目录
78+
- 留空表示不过滤(显示所有文件)
79+
80+
**示例**
81+
82+
```
83+
pipeline
84+
pipeline/sub
85+
resource/tasks
86+
```
87+
88+
**作用范围**
89+
90+
- 本地文件列表面板中显示的文件
91+
- 跨文件搜索的候选范围
92+
93+
::: tip
94+
文件夹过滤不影响 LocalBridge 的文件监听范围,仅影响前端的显示和搜索结果。
95+
:::

docsite/docs/01.指南/10.工作流面板/60.工具.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -270,3 +270,35 @@ AI 对话历史面板提供详细的信息展示:
270270
:::
271271

272272
**详细使用说明**,请参考 [AI 流程探索模式](/guide/server/ai#ai-流程探索模式) 文档。
273+
274+
## 操作日志
275+
276+
操作日志面板记录您在编辑过程中的所有操作,方便回溯和定位问题。
277+
278+
### 入口位置
279+
280+
点击编辑区左上角工具栏中的日志图标即可打开操作日志面板。当有新日志产生且面板处于收起状态时,图标会显示脉冲动画提示。
281+
282+
### 记录的操作类型
283+
284+
操作日志按类别记录以下操作:
285+
286+
| 类别 | 记录内容 |
287+
|------|----------|
288+
| **节点(node)** | 节点创建、删除、修改 |
289+
| **连接(edge)** | 连接的建立、删除、修改 |
290+
| **图(graph)** | 图级别操作(如导入、清空) |
291+
| **分组(group)** | 分组创建、解散、节点移入移出 |
292+
293+
### 功能特点
294+
295+
- **时间戳**:每条日志显示精确到秒的操作时间
296+
- **分类图标**:不同类别使用不同颜色和图标区分
297+
- **快速跳转**:点击操作日志中的节点/边记录,可直接选中并聚焦到对应元素
298+
- **自动滚动**:新日志产生时自动滚动到最新条目
299+
- **清空日志**:支持一键清空所有日志记录
300+
- **容量限制**:最多保存 200 条日志,超出后自动移除最早的记录
301+
302+
### 后端日志
303+
304+
操作日志面板还包含「后端日志」Tab,显示 LocalBridge 推送的服务端日志信息,方便在编辑器内直接查看后端运行状态。

0 commit comments

Comments
 (0)