diff --git a/docs/get-started/1-quick-start.md b/docs/get-started/1-quick-start.md
index 5aece22e5..8437e2702 100644
--- a/docs/get-started/1-quick-start.md
+++ b/docs/get-started/1-quick-start.md
@@ -3,133 +3,236 @@ sidebar_position: 1
---
# 快速开始
+
+## 平台能力介绍
+
+刻行时空是一款基于 **SceneOps 理念**的多模态数据管理平台,提供了**数据采集、存储、管理、标注、审核、分析、可视化**等功能,在帮助用户更高效地管理和分析数据同时,还可以通过平台提供算力实现**云端 EB 级别数据回灌测试、云端仿真验证、算法测试**。
+
+- 数据采集:支持设备、传感器、关节等多种数据源,支持手动采集、自动采集、远程采集等多种方式。
+- 数据存储:支持多种数据存储方式,如本地存储、云存储、对象存储等。
+- 数据管理:支持数据的增删改查、权限管理、数据版本控制等,同时**支持对 hdf5、db3、mcap、bag 等主流格式的数据格式之间的相关转换。**
+- 数据标注:支持数据的标注、审核、审核结果统计等。
+- 数据分析:支持数据的统计分析、数据挖掘、机器学习等。
+- 云端仿真:支持云端仿真验证、云端 EB 级别数据回灌测试、算法测试等。
+- 可视化:支持数据(mcap,bag,db3 等主流格式)的可视化分析、数据挖掘、机器学习等。
+- 协作:支持多用户协作、多组织协作、多项目协作等。
+- 权限管理:支持用户、组织、项目、记录、文件、一刻等资源的权限管理。
+
## 登录刻行时空
-刻行时空的使用角色分为管理员和普通用户,你可以按照角色,创建或进入组织。
+
+刻行时空平台中,我们提供了几个核心维度的角色与权限的划分,可参考下图的组织架构图:
+
+
+- 「组织」:组织是刻行时空平台的最高管理单位,相当于一个公司或公司内部的某个团队。
+
+- 「项目」:项目是刻行时空平台的第二级管理单位,在不同的应用场景下可以有不同的意义:
+
+ - 在具身智能数采场景中,一个项目可以对应是一个数采工厂,然后通过第三级的记录来区分技能。也可以对应成一个技能,在项目下通过记录来管理归属于此技能的所有数据。
+ - 在商清机器人运维领域中,一个项目可以对应是一个型号的机器人的全部运维问题,也可以定义成某个重点客户的运维问题。
+ - 在机器人仿真验证场景中,一个项目可以对应是一个型号的机器人的全部仿真验证环境。
+
+- 「设备」:设备是刻行时空平台的第二级管理单位,对应的是安装了刻行时空端侧软件的设备,如机器人、无人机等。
+
+- 「镜像仓库」:镜像仓库是刻行时空平台的第二级管理单位,用于存放镜像文件,如 Docker 镜像、ROS 镜像等。
+
+- 「记录」:记录是刻行时空平台的第三级管理单位,它一定会归属与第二级管理单位'项目',在不同的应用场景下可以有不同的意义:
+
+ - 在具身智能数采场景中,一个记录可以对应是一个数采工厂中的一次数采。
+ - 在商清机器人运维场景中,一个记录可以对应是某台机器人的一次现场运维数据的记录。
+ - 在仿真验证场景中,一个记录可以对应是一个仿真验证环境。
+
+- 「自动化动作/测试程序/测试套件/触发器」:以上单位与记录同级,都需要归属与第二级管理单位'项目',在不同的应用场景下可以自由排列组合获得不同的能力,可查看对应文档获取详细信息。
+
+而对于我们每一位用户,**每个组织的创建者(或者首位登录者),会默认成为组织的管理员。** 其余成员可以通过与组织创建者的相同的 OA 办公软件认证登录(例如飞书/钉钉等),用户将自动加入管理员创建的组织。或者由组织管理员邀请用户加入组织(邮箱登录)。
+
+每一位用户,在进入组织后,会获得组织成员的权限,可以看到组织内的内部项目/公开项目/以及用户自己创建的私有项目。可以对组织内的设备进行查看和注册,但无管理权限。
+
+用户可以创建属于自己的项目,则默认获得项目管理员权限,在该项目中用户可以创建记录、上传文件、创建自动化动作、创建测试程序、创建测试套件、创建触发器等。
### 管理员
-1. 通过浏览器访问[刻行时空平台 https://www.coscene.cn/](https://www.coscene.cn),点击右上角的【快速登录】,进入登录界面。
-
- 
+
+1. 通过浏览器访问[刻行时空平台](https://www.coscene.cn),点击右上角的【快速登录】,进入登录界面。
+
+ 
2. 选择登录方式进入平台:邮箱、飞书、钉钉或谷歌企业邮箱。
- 
+ 
3. 填写「组织名称」与「组织 ID」,勾选「同意」,点击【创建组织】按钮。
-
- 
-4. 创建成功后,将自动进入组织首页。可以开始[管理你的组织](../collaboration/organization/1-organizations.md)啦。
+ 
+
+4. 创建成功后,将自动进入组织首页。可以开始[管理你的组织](../collaboration/organization/1-organizations.md)。
### 普通用户
-> 首先请联系组织管理员,邀请你加入组织。
+
+> 首先请联系组织管理员,邀请你加入组织。或者通过同一飞书/钉钉/谷歌企业邮箱等办公软件,使用相同的途径登录。
1. 通过浏览器访问[刻行时空平台 https://www.coscene.cn/](https://www.coscene.cn),点击右上角的【快速登录】,进入登录界面。
-
- 
+
+ 
2. 选择与你组织一致的登录方式(邮箱、飞书、钉钉或谷歌企业邮箱)进行登录。
- 
+ 
-3. 选择组织后,即可进入组织,开始你的数据之旅啦。
+3. 选择组织后,即可进入组织,开始你的数据之旅。
- 
+ 
+
+## 可视化您的数据与日志
+
+**可视化**是刻行时空平台中最核心的能力之一,基于刻行时空强大的能力,用户可以抛弃依赖繁琐的 Rviz/Rviz2 等工具,直观地查看、分析、诊断设备数据、日志、配置文件等数据,帮助用户更高效地管理和分析数据。
-## 管理多模态数据
### 创建项目
+
项目是数据管理的单元,对于数据的存储、管理、隔离和应用都发生在项目级别。一个项目可以是一个部门、一个项目组或一个业务线。更多关于项目的介绍,请参考[项目](../collaboration/project-collaboration/1-project.md)。
在主页上点击"创建项目"按钮,然后按照指引步骤完成项目创建。

-### 创建记录并上传文件
-记录是一个描述相似场景的文件集合,用于存储、管理、可视化数据。一条记录中可以存放设备发生一次故障时产生的数据、设备执行一次任务时产生的数据、待标注的一小段数据集,如 ROS Bag、日志、地图、配置文件、图片与视频等。更多关于记录的介绍,请参考[记录](../collaboration/record/1-quick-start-record.md)。
+### 创建记录
+
+记录(Record)是描述相关场景的文件集合,用于数据的存储、管理和可视化。记录可以包含:
-1. 在项目左侧边栏,选择「记录」,点击【创建记录】按钮。
+- 设备故障数据
+- 任务执行数据
+- 待标注数据集
+- ROS Bag、日志、地图、配置文件等
- 
+详细信息请参考[记录](../collaboration/record/1-quick-start-record.md)。
+
+1. 在项目左侧导航栏,选择「记录」,点击【创建记录】。
+
+
2. 在弹窗中输入记录的名称等相关信息,点击【创建】按钮。
- 
+
3. 创建完成后,自动进入记录详情页,点击【上传】按钮上传 bag/mcap 文件,或点击[下载示例文件](https://coscene-artifacts-prod.oss-cn-hangzhou.aliyuncs.com/docs/example/viz/scene-0001.mcap)后上传。
- 
+
### 可视化播放记录
+
数据可视化界面通过可配置的「面板」和「布局」,将设备数据以直观的可视化方式呈现,助力用户高效分析与诊断各类问题。更多关于可视化的介绍,请参考[可视化数据](../viz/1-about-viz.md)。
-1. 在记录中上传 bag/mcap 后,点击【播放记录】,进入可视化页面。
+1. 在记录中上传 bag/mcap/db3/hdf5 后,点击【播放记录】,进入可视化页面。
- 
+
2. 在可视化页面的布局栏中,选择【从文件导入】,导入示例布局。
- 
+
3. 点击底部【播放】按钮开始播放数据。可以通过切换不同的面板(如三维图、曲线图、状态转换图、表格等)来查看数据。更多面板使用说明,请参考[面板介绍](../viz/4-panel/1-panel-overview.md)。
- 
-
+
+
### 创建并分享一刻
+
在可视化界面播放数据时,你可以通过创建「一刻」来标记重要的时间点或时间段。「一刻」可以帮助你追踪关键数据变化(如设备异常、性能波动)等值得关注的信息,方便后续查看和分析。更多关于一刻的介绍,请参考[一刻](../viz/5-create-moment-viz.md)。
1. 在可视化播放记录时,点击左下角【创建一刻】,可标记一刻的起点。
- 
+
2. 再次点击【创建一刻】以标记一刻的终点。此时会自动弹出创建一刻的窗口,蓝色区域表示一刻的时间范围。
- 
+
3. 填写相关信息后,点击【创建一刻】即可完成。在左侧的一刻面板中查看当前记录的所有一刻。
- 
+
4. 点击分享按钮可将当前一刻的链接分享给其他成员,方便协作分析。
- 
+
## 远程连接设备
-设备可以与真实设备建立联系,详见[设备](../device/1-device.md)
+
+用户可以与现场正在运行的设备建立联系,详见[设备](../device/1-device.md)
+
+通过远程连接设备,可以实时查看设备的运行状态与各传感器的信息,还可以通过网页 SSH 远程连接设备,进行调试和操作。在机器人的远程运维与操作方面有极大的助力。
### 添加设备
+
> 前提条件:支持 Linux 设备,arm64 和 x86_64 架构
1. 通过右上角「我的」,进入「组织管理-设备」页面,点击【添加设备】按钮。
- 
+
2. 在弹框中,选择【系统生成 ID】,勾选【远程控制】,点击【复制】按钮,复制安装命令。
- - 若要使用自定义的 ID,参见[设备 ID 配置](../device/2-create-device.md#设备-id-配置)
-
-
+ - 若要使用自定义的 ID,参见[设备 ID 配置](../device/2-create-device.md#设备-id-配置)
+
+
+**刻行时空强烈建议用户使用自定义的 ID,避免出现后续设备重复注册的问题。**
3. 在真实设备上打开 shell 终端,执行安装命令,设备端出现 `Installation completed successfully 🎉` 即表示安装成功。
4. 等待 1-2 分钟,设备会自动展示在设备列表中。联系组织管理员,准入设备的使用权限。
- 
+
### 网页 SSH
+
当设备准入后,在「组织管理-设备」页面找到该设备,点击【网页 SSH】按钮即可在浏览器中打开新标签页,远程连接到设备。更多详情请参考[网页 SSH](../device/5-device-remote-control.md#网页-ssh)。


### 实时可视化
+
+通过实时可视化的功能,用户可以实时查看设备的运行状态和数据,实时查看机器人传感器的状态与数据,还可以调用机器人端提供的service,发布 rostopic,订阅 rostopic,调用服务等。实现实时的**远程运维**。
+
> 前提条件:
>
> 1. 安装 coBridge 组件
> - coBridge 是一个独立的 ROS 节点,负责通过 WebSocket 协议将设备数据实时传输到前端
> - 支持的 ROS 版本:
> - ROS1:Noetic Ninjemys、Melodic Morenia
-> - ROS2:Foxy Fitzroy、Galactic Geochelone、Humble Hawksbill
-> - [查看 coBridge 源码(C++)](https://github.com/coscene-io/coBridge)
->
+> - ROS2:Foxy Fitzroy、Galactic Geochelone、HumbleHawksbill
+
+安装方法:
+
+- 导入公钥:
+
+```bash
+curl -fsSL https://download.coscene.cn/coscene-apt-source/coscene.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/coscene.gpg
+```
+
+- 添加源:
+
+```bash
+echo "deb [signed-by=/etc/apt/trusted.gpg.d/coscene.gpg] https://download.coscene.cn/coscene-apt-source $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/coscene.list
+```
+
+- 更新与安装:
+
+```bash
+sudo apt update
+# CAUTION: ${ROS_DISTRO} need to be replaced by 'noetic', 'foxy' or 'humble', if ROS_DISTRO not in your env
+sudo apt install ros-${ROS_DISTRO}-cobridge -y
+```
+
+- 运行与启动:
+
+```bash
+source /opt/ros/${ROS_DISTRO}/setup.bash #根据您的 ros 版本替换 ${ROS_DISTRO}
+
+# for ros 1 distribution
+roslaunch cobridge cobridge.launch
+
+# for ros 2 distribution
+ros2 launch cobridge cobridge_launch.xml
+```
+
+\*\* 我们的代码是完全开源的,支持您后续根据您的需求直接基于我们的 cobridge 代码进行二次开发,并合入您的专属软件包中,可查看[ coBridge](https://github.com/coscene-io/coBridge) 源码(C++)
+
> 2. 启动 coBridge 节点后,即可在网页端查看设备的实时数据
当设备准入后,在「组织管理-设备」页面找到该设备,点击【实时可视化】按钮即可在浏览器中实时查看设备的运行状态和数据。更多详情请参考[实时可视化](../device/5-device-remote-control.md#实时可视化)。
@@ -141,148 +244,246 @@ sidebar_position: 1

## 采集设备数据
-设备可以与真实设备建立连接,作为数据采集的目标对象。在相关记录中,能够额外添加设备信息,进而实现对该设备上传数据的精准检索与全面统计,详见[设备](../device/1-device.md)。
+
+平台可以与真实设备建立连接,通用主动在平台上下发任务的方式,去采集用户需要上传到平台上的数据。
### 添加设备
+
> 前提条件:支持 Linux 设备,arm64 和 x86_64 架构。
1. 通过右上角「我的」,进入「组织管理-设备」页面,点击【添加设备】按钮。
- 
+
2. 在弹框中,选择【系统生成 ID】,点击【复制】按钮,复制安装命令。
- - 若要使用自定义的 ID,参见[设备 ID 配置](../device/2-create-device.md#设备-id-配置)
-
- 
+ - 若要使用自定义的 ID,参见[设备 ID 配置](../device/2-create-device.md#设备-id-配置)
+
+
3. 在真实设备上打开 shell 终端,执行安装命令,设备端出现 `Installation completed successfully 🎉` 即表示安装成功。
4. 等待 1-2 分钟,设备会自动展示在设备列表中。联系组织管理员,准入设备的使用权限。
- 
+
### 手动采集数据
+
1. **将设备添加到项目**:进入「项目设备」页,点击【添加设备】按钮,选择需要采集数据的设备。
- 
+
2. **配置采集目录**:进入组织设备配置页,设置采集目录 `collect_dirs` 为设备上存储数据的目录,如:`/home/bag/` 和 `/home/log/`。
- 
+
+**注意:在您配置采集目录时,请确保您需要被采集的数据直接存放在该目录下。**
- ```yaml
- mod:
- name: 'default'
- conf:
- enabled: true
- # 设备端的采集目录,作为项目中数据采集任务与规则采集的指定目录
- collect_dirs:
- - /home/bag/
- - /home/log/
- ```
+```yaml
+mod:
+ name: 'default'
+ conf:
+ enabled: true
+ # 设备端的采集目录,作为项目中数据采集任务与规则采集的指定目录
+ collect_dirs:
+ - /home/bag/
+ - /home/log/
+```
3. **创建采集任务**:进入「项目-任务-采集任务」页面,创建采集任务。
- - 选择要采集数据的设备
- - 选择要采集的时间范围:在目标数据路径下,采集「文件更新时间」在指定时间段内的文件
- - 目标数据路径:默认值取自设备配置中的 `collect_dirs`,也可以自定义路径。若填写为文件夹,则采集该文件夹下符合时间范围的文件;若填写为文件,则采集该文件。
- - 任务名称:自定义名称
+ - 选择要采集数据的设备
+ - 选择要采集的时间范围:在目标数据路径下,采集「文件更新时间」在指定时间段内的文件
+ - 目标数据路径:默认值取自设备配置中的 `collect_dirs`,也可以自定义路径。若填写为文件夹,则采集该文件夹下符合时间范围的文件;若填写为文件,则采集该文件。
+ - 任务名称:自定义名称
- 
+
4. **查看采集结果**:进入「项目-任务-采集任务」页面,点击任务名称查看采集结果,采集完成的数据将自动保存到记录中。
- 
- 
+
+
### 自动采集数据
-自动采集数据是通过预定义的规则持续监测设备日志,在触发特定条件时自动采集相关数据,从而实现设备故障的自动分析和潜在风险的预警。详情请参考[数采&诊断](../use-case/data-diagnosis/3-add-rule.md)。
-1. **将设备添加到项目**:进入「项目设备」页,点击【添加设备】按钮,选择需要采集数据的设备。
+自动采集数据是通过预定义的规则持续监测设备日志,或者监听特定的 topic,在触发特定条件时自动采集相关数据,从而实现运维故障数据的自动上传。详情请参考[数采&诊断](../use-case/data-diagnosis/3-add-rule.md)。
- 
+#### 1. **将设备添加到项目**:进入「项目设备」页,点击【添加设备】按钮,选择需要采集数据的设备。
-2. **配置监听与采集目录**:进入组织设备配置页,设置监听目录`listen_dirs` 与采集目录 `collect_dirs`
+
- 
+#### 2. **配置监听与采集目录**:进入组织设备配置页,设置监听目录`listen_dirs` 与采集目录 `collect_dirs`
- ```yaml
- mod:
- name: 'default'
- conf:
- enabled: true
- # 设备端的采集目录,作为项目中数据采集任务与规则采集的指定目录
- collect_dirs:
- - /home/bag/
+**注意:在您配置采集目录时,请确保您需要被采集的数据直接存放在该目录下,暂不支持自动遍历目录下的子目录,如果是存放在子目录下,需要配置完整路径。**
- # 设备端的监听目录,作为项目中规则的监听目录
- listen_dirs:
- - /home/bag/
+**注意:如果我们是基于监听 topic 的方式作为基础规则,那么需要在此处配置 topics ,参考如下示例。**
+
- # 设置文件监听的时效性:若文件的最后更新时间距离当前时间超过 2 小时,则不会被系统监听
- skip_period_hours: 2
- ```
+```yaml
+mod:
+ name: 'default'
+ conf:
+ enabled: true
+ # 设备端的采集目录,作为项目中数据采集任务与规则采集的指定目录
+ collect_dirs:
+ - /home/bag/
-3. **创建规则**:进入「项目-数采&诊断」页面,创建规则。
+ # 设备端的监听目录,作为项目中规则的监听目录。刻行时空的端侧软件将监控此目录下的文件(文件类型支持 mcap, bag , log 等)里是否包含您设置的 topics ,若有则触发采集
+ listen_dirs:
+ - /home/bag/
- 
+ # 设置文件监听的时效性:若文件的最后更新时间距离当前时间超过 2 小时,则不会被系统监听
+ skip_period_hours: 2
+ #监听的 topic 名称,例如您的机器人会持续发布一个叫 /error_status 的 topic 来表示出现了告警可能需要采集数据,您可以在规则中配置监听该 topic
+ topics:
+ - /error_status
+```
-4. **定义规则**:定义规则的触发条件和采集行为。以下是一个示例规则,当检测到 mcap 文件中 /spawn_entity node 状态为 inactive 时,自动上传数据:
+#### 3. **规则组**
- - mcap 文件中的消息:
+规则组是规则的集合,用于对规则进行分类管理。
-
+##### 添加规则组
- - 规则名称:检测 /spawn_entity node 状态
- - 事件匹配条件:msg["nodes"][3]["state"] 包含 INACTIVE
- - 触发操作:采集数据、诊断数据
- - 采集数据:采集触发时间点前后一段时间的数据,保存到记录中;采集目录为设备配置中的 `collect_dirs`;文件的时间取自文件的时间戳,若需采集的时间段与文件有交集,则将上传整个文件
- - 诊断数据:在触发时间点创建一刻
+在项目中,进入「数采&诊断规则」分页,点击【添加规则组】,添加成功后,可在该规则组内添加具体规则。
- 
- 
+
-5. **确认规则**:确认规则已启用,且目标设备已拉取到最新的规则配置。
- - 启用规则组:点击规则组右侧的启用按钮
+##### 规则组的启用与关闭
- 
+新添加的规则组默认处于「关闭状态」,若要让项目设备使用其中的规则进行数据监听,需手动开启;
- - 在设备端执行以下命令,查看是否拉取到最新的规则配置,即出现关键词 `Updated rules`、`listen_dirs`、`collect_dirs`
+若暂时不需要使用,但后续还会用到,也可将其设为「关闭状态」。
- ```bash
- # 查看数采客户端日志
- tail -f ~/.local/state/cos/logs/cos.log
- ```
+
+
+#### 4. 规则组管理
+
+在更多操作中,可进行规则组的重命名和删除操作。
+
+
+
+#### 5.**规则创建与配置**
+
+规则是规则组中的单个规则,用于定义触发数据采集与诊断的条件,以及触发后的操作。
+
+##### 添加规则
+
+在规则组中,可通过点击【创建空白规则】或【从规则模板创建】来添加新规则,下面主要介绍创建空白规则的步骤。
+
+
+
+为规则命名,规则名称用于区分不同规则,方便后续管理和识别。
+
+
+
+##### 设备事件监听
+
+> 此模块是对项目设备进行监控,当预先设定的监听目录里的文件有匹配到您设定的监听话题时,将自动上报事件并记录到当前项目的仪表盘中。
+
+
+
+###### 关注的话题
+
+- 设置关注的触发话题能缩小规则匹配范围,提高规则诊断的性能、速度和准确度。
+
+- 若想监听设备中日志类型的文件,请选择`/error_status`。
+
+- 其他话题选项可在组织的数采客户端配置中设置,详情可参考[ 4-数采客户端配置](https://docs.coscene.cn/docs/device/device-collector#%E8%A7%84%E5%88%99%E8%A7%A6%E5%8F%91%E8%AF%9D%E9%A2%98topics)文档。
+
+###### 匹配事件码表
+
+- 在事件码表中,可定义事件的 code 值、事件名称、等级、解决方案等信息。事件码表必须包含 code 列,作为事件的唯一标识符。
+
+- 上传事件码表(支持 JSON 或 CSV 文件)后,系统会自动解析,还支持预览、下载、删除操作。若要修改表内容,可先下载到本地电脑修改后再上传。
+
+
+
+###### 事件匹配条件
+
+- 根据设备消息字段与某个值的匹配关系判断事件是否触发。
+
+- 点击【切换】按钮可在 code 表头和具体值输入框之间切换。
+
+- 在预定义输入框中,设定了事件码表中的 code 值作为匹配变量。
+
+- 在具体值输入框中,直接输入文字信息。
- 
+- 若要检测 log 文件中是否有关键词 error 1,则需填写:msg.message 包含 error 1,并且「关注的话题」一栏需要选择 /error_status(这里参考我们第二步中配置的 topic 名称)。
-6. **触发规则**:在设备的 `listen_dirs` 与 `collect_dirs` 目录下,创建 mcap 文件,触发规则
+- 若要检测 bag 文件的 /error_status 话题(消息类型为 std_msgs/string)中的 msg.data 消息字段中有关键词 error 1,则需要填写:msg.data 包含 error 1。
- - 在设备端,进入 `listen_dirs` 与 `collect_dirs` 目录,执行命令下载 [mcap 文件](https://coscene-artifacts-prod.oss-cn-hangzhou.aliyuncs.com/sample_data/rule_sample.mcap)
+- 多行逻辑判断条件之间是并且关系,需同时满足才生效。
- ```bash
- # 进入 listen_dirs 目录
- cd /home/bag/
- # 下载 mcap 文件
- wget https://coscene-artifacts-prod.oss-cn-hangzhou.aliyuncs.com/sample_data/rule_sample.mcap
- ```
-
- - 执行命令查看数采客户端日志,查看是否触发规则并上传数据,即出现关键词 `triggered`、`upload all files successfully`
+
- ```bash
+###### 事件去重时长
+
+- 若新事件(同一事件)在上次合并事件后的设定时间内发生,则与原事件合并。每次新事件发生时,都重置时间,直到超出时间窗口都无新事件发生时,完成合并。
+
+- 支持范围设置在 1 秒 \~ 86400 秒(1 天)之间。
+
+
+
+当 log 文件中出现:1001、1002 或 1003 时(即事件码表中的 code 列任一行值),即可判断为事件匹配成功。
+
+触发操作是指规则条件满足后触发后的操作,目前支持了采集数据、诊断数据两个模块。
+
+##### 采集数据
+
+- 规则条件在设备端触发后,会在本项目中自动创建一条采集任务,采集对应时间的设备数据,采集完成后在记录中生成一条记录,包含触发条件满足时的数据。
+
+
+
+
+
+- 可以设定上传文件的时间范围、记录名称、记录描述、记录标签、采集限制。
+
+- 上传文件指上传数采目录中符合时间范围的所有文件。
+
+- 记录名称、记录描述支持使用代码变量(使用 `{scope.表头名称}` 的格式)与正文穿插书写。
+
+
+
+- 在更多设置中,可利用[文件通配符](https://www.malikbrowne.com/blog/a-beginners-guide-glob-patterns/)进行二次筛选。
+
+- 若有具体的附加文件,如地图文件,可在此处写明具体文件所在地址。
+
+
+
+##### 诊断数据
+
+- 对已经采集到平台中的记录执行数据诊断动作,符合触发条件的时间点将自动创建一刻,可在采集后的记录中查看相关一刻。
+
+
+
+- 支持设定一刻名称、一刻描述、一刻的属性值,以及是否为诊断出的一刻创建关联的通用任务进行流转。
+
+- 一刻名称、一刻描述、一刻的属性值支持使用代码变量(使用 `{scope.表头名称}` 的格式)与正文穿插书写。
+
+
+
+#### 6.**确认规则**:确认规则已启用,且目标设备已拉取到最新的规则配置。
+
+- 启用规则组:点击规则组右侧的启用按钮
+
+
+
+- 在设备端执行以下命令,查看是否拉取到最新的规则配置,即出现关键词 `Updated rules`、`listen_dirs`、`collect_dirs`
+
+```bash
# 查看数采客户端日志
tail -f ~/.local/state/cos/logs/cos.log
- ```
+```
- 
+
-7. **查看采集结果**:在「项目-记录」页面,查看设备自动创建的记录。点击记录名称进入详情,查看文件与一刻信息。通过播放记录,在[可视化](../viz/1-about-viz.md)页面查看采集的数据。
+#### 7.**查看采集结果**:在「项目-记录」页面,查看设备自动创建的记录。点击记录名称进入详情,查看文件与一刻信息。通过播放记录,在[可视化](../viz/1-about-viz.md)页面查看采集的数据。
- 
- | 内容 | 示例 |
- | :---: | :---: |
- | 文件 |
|
- | 一刻 |
|
+
+| 内容 | 示例 |
+| :---: | :---: |
+| 文件 |
|
+| 一刻 |
|
## 了解更多
+
- [自动化处理数据](../workflow/1-quick-start-workflow.md)
-- [更新日志](https://docs.coscene.cn/changelog)
\ No newline at end of file
+- [更新日志](https://docs.coscene.cn/changelog)
diff --git a/docs/get-started/img/01-quick-start-01.png b/docs/get-started/img/01-quick-start-01.png
new file mode 100644
index 000000000..0ef9d5eea
Binary files /dev/null and b/docs/get-started/img/01-quick-start-01.png differ
diff --git a/docs/get-started/img/9-4-click-rule-set.png b/docs/get-started/img/9-4-click-rule-set.png
new file mode 100644
index 000000000..6e803f0d3
Binary files /dev/null and b/docs/get-started/img/9-4-click-rule-set.png differ
diff --git a/docs/get-started/img/9-4-disable-rule-set-confirm.png b/docs/get-started/img/9-4-disable-rule-set-confirm.png
new file mode 100644
index 000000000..f0ad7b660
Binary files /dev/null and b/docs/get-started/img/9-4-disable-rule-set-confirm.png differ
diff --git a/docs/get-started/img/9-4-enable-rule-set.png b/docs/get-started/img/9-4-enable-rule-set.png
new file mode 100644
index 000000000..6f73b04c7
Binary files /dev/null and b/docs/get-started/img/9-4-enable-rule-set.png differ
diff --git a/docs/get-started/img/9-4-pro-rule-manage-delete-2.png b/docs/get-started/img/9-4-pro-rule-manage-delete-2.png
new file mode 100644
index 000000000..cc684ba08
Binary files /dev/null and b/docs/get-started/img/9-4-pro-rule-manage-delete-2.png differ
diff --git a/docs/get-started/img/9-4-pro-rule-manage-delete.png b/docs/get-started/img/9-4-pro-rule-manage-delete.png
new file mode 100644
index 000000000..510b129b0
Binary files /dev/null and b/docs/get-started/img/9-4-pro-rule-manage-delete.png differ
diff --git a/docs/get-started/img/9-add-rule-set.png b/docs/get-started/img/9-add-rule-set.png
new file mode 100644
index 000000000..85a9f098e
Binary files /dev/null and b/docs/get-started/img/9-add-rule-set.png differ
diff --git a/docs/get-started/img/9-add-rule.png b/docs/get-started/img/9-add-rule.png
new file mode 100644
index 000000000..18d79df2c
Binary files /dev/null and b/docs/get-started/img/9-add-rule.png differ
diff --git a/docs/get-started/img/9-enable-rule-set.png b/docs/get-started/img/9-enable-rule-set.png
new file mode 100644
index 000000000..800f7ac87
Binary files /dev/null and b/docs/get-started/img/9-enable-rule-set.png differ
diff --git a/docs/get-started/img/add-rule-group.png b/docs/get-started/img/add-rule-group.png
new file mode 100644
index 000000000..6db004667
Binary files /dev/null and b/docs/get-started/img/add-rule-group.png differ
diff --git a/docs/get-started/img/add-rule.png b/docs/get-started/img/add-rule.png
new file mode 100644
index 000000000..fbb4e46e9
Binary files /dev/null and b/docs/get-started/img/add-rule.png differ
diff --git a/docs/get-started/img/add-rule_1.png b/docs/get-started/img/add-rule_1.png
new file mode 100644
index 000000000..6db004667
Binary files /dev/null and b/docs/get-started/img/add-rule_1.png differ
diff --git a/docs/get-started/img/add-rule_10.png b/docs/get-started/img/add-rule_10.png
new file mode 100644
index 000000000..77921a640
Binary files /dev/null and b/docs/get-started/img/add-rule_10.png differ
diff --git a/docs/get-started/img/add-rule_11.png b/docs/get-started/img/add-rule_11.png
new file mode 100644
index 000000000..c8de96204
Binary files /dev/null and b/docs/get-started/img/add-rule_11.png differ
diff --git a/docs/get-started/img/add-rule_12.png b/docs/get-started/img/add-rule_12.png
new file mode 100644
index 000000000..3209b0fac
Binary files /dev/null and b/docs/get-started/img/add-rule_12.png differ
diff --git a/docs/get-started/img/add-rule_13.png b/docs/get-started/img/add-rule_13.png
new file mode 100644
index 000000000..0530e1b9f
Binary files /dev/null and b/docs/get-started/img/add-rule_13.png differ
diff --git a/docs/get-started/img/add-rule_14.png b/docs/get-started/img/add-rule_14.png
new file mode 100644
index 000000000..3db1e7b38
Binary files /dev/null and b/docs/get-started/img/add-rule_14.png differ
diff --git a/docs/get-started/img/add-rule_15.png b/docs/get-started/img/add-rule_15.png
new file mode 100644
index 000000000..5962bdf80
Binary files /dev/null and b/docs/get-started/img/add-rule_15.png differ
diff --git a/docs/get-started/img/add-rule_16.png b/docs/get-started/img/add-rule_16.png
new file mode 100644
index 000000000..9a13360dd
Binary files /dev/null and b/docs/get-started/img/add-rule_16.png differ
diff --git a/docs/get-started/img/add-rule_17.png b/docs/get-started/img/add-rule_17.png
new file mode 100644
index 000000000..fbd6ac80f
Binary files /dev/null and b/docs/get-started/img/add-rule_17.png differ
diff --git a/docs/get-started/img/add-rule_18.png b/docs/get-started/img/add-rule_18.png
new file mode 100644
index 000000000..834e1a2c2
Binary files /dev/null and b/docs/get-started/img/add-rule_18.png differ
diff --git a/docs/get-started/img/add-rule_19.png b/docs/get-started/img/add-rule_19.png
new file mode 100644
index 000000000..5df9d491c
Binary files /dev/null and b/docs/get-started/img/add-rule_19.png differ
diff --git a/docs/get-started/img/add-rule_2.png b/docs/get-started/img/add-rule_2.png
new file mode 100644
index 000000000..a697571a0
Binary files /dev/null and b/docs/get-started/img/add-rule_2.png differ
diff --git a/docs/get-started/img/add-rule_20.png b/docs/get-started/img/add-rule_20.png
new file mode 100644
index 000000000..2332ff8ef
Binary files /dev/null and b/docs/get-started/img/add-rule_20.png differ
diff --git a/docs/get-started/img/add-rule_21.png b/docs/get-started/img/add-rule_21.png
new file mode 100644
index 000000000..3626c388c
Binary files /dev/null and b/docs/get-started/img/add-rule_21.png differ
diff --git a/docs/get-started/img/add-rule_22.png b/docs/get-started/img/add-rule_22.png
new file mode 100644
index 000000000..3ab91c38b
Binary files /dev/null and b/docs/get-started/img/add-rule_22.png differ
diff --git a/docs/get-started/img/add-rule_3.png b/docs/get-started/img/add-rule_3.png
new file mode 100644
index 000000000..2a2fe88ed
Binary files /dev/null and b/docs/get-started/img/add-rule_3.png differ
diff --git a/docs/get-started/img/add-rule_4.png b/docs/get-started/img/add-rule_4.png
new file mode 100644
index 000000000..fbb4e46e9
Binary files /dev/null and b/docs/get-started/img/add-rule_4.png differ
diff --git a/docs/get-started/img/add-rule_5.png b/docs/get-started/img/add-rule_5.png
new file mode 100644
index 000000000..393d056a4
Binary files /dev/null and b/docs/get-started/img/add-rule_5.png differ
diff --git a/docs/get-started/img/add-rule_6.png b/docs/get-started/img/add-rule_6.png
new file mode 100644
index 000000000..a9760c38f
Binary files /dev/null and b/docs/get-started/img/add-rule_6.png differ
diff --git a/docs/get-started/img/add-rule_7.png b/docs/get-started/img/add-rule_7.png
new file mode 100644
index 000000000..dffeef049
Binary files /dev/null and b/docs/get-started/img/add-rule_7.png differ
diff --git a/docs/get-started/img/add-rule_8.png b/docs/get-started/img/add-rule_8.png
new file mode 100644
index 000000000..dbacf725a
Binary files /dev/null and b/docs/get-started/img/add-rule_8.png differ
diff --git a/docs/get-started/img/add-rule_9.png b/docs/get-started/img/add-rule_9.png
new file mode 100644
index 000000000..1ea2b8ba8
Binary files /dev/null and b/docs/get-started/img/add-rule_9.png differ
diff --git a/docs/get-started/img/auto-record-1.png b/docs/get-started/img/auto-record-1.png
new file mode 100644
index 000000000..bfc87775f
Binary files /dev/null and b/docs/get-started/img/auto-record-1.png differ
diff --git a/docs/get-started/img/auto-record-2.png b/docs/get-started/img/auto-record-2.png
new file mode 100644
index 000000000..d206be751
Binary files /dev/null and b/docs/get-started/img/auto-record-2.png differ
diff --git a/docs/get-started/img/auto-record-3.png b/docs/get-started/img/auto-record-3.png
new file mode 100644
index 000000000..c4883455f
Binary files /dev/null and b/docs/get-started/img/auto-record-3.png differ
diff --git a/docs/get-started/img/data-collection-1.png b/docs/get-started/img/data-collection-1.png
new file mode 100644
index 000000000..5962bdf80
Binary files /dev/null and b/docs/get-started/img/data-collection-1.png differ
diff --git a/docs/get-started/img/data-collection-2.png b/docs/get-started/img/data-collection-2.png
new file mode 100644
index 000000000..9a13360dd
Binary files /dev/null and b/docs/get-started/img/data-collection-2.png differ
diff --git a/docs/get-started/img/data-collection-3.png b/docs/get-started/img/data-collection-3.png
new file mode 100644
index 000000000..8edf07d3a
Binary files /dev/null and b/docs/get-started/img/data-collection-3.png differ
diff --git a/docs/get-started/img/data-collection-4.png b/docs/get-started/img/data-collection-4.png
new file mode 100644
index 000000000..89889b40c
Binary files /dev/null and b/docs/get-started/img/data-collection-4.png differ
diff --git a/docs/get-started/img/data-diagnosis.png b/docs/get-started/img/data-diagnosis.png
new file mode 100644
index 000000000..834e1a2c2
Binary files /dev/null and b/docs/get-started/img/data-diagnosis.png differ
diff --git a/docs/get-started/img/dev-install-1.png b/docs/get-started/img/dev-install-1.png
new file mode 100644
index 000000000..65abd8109
Binary files /dev/null and b/docs/get-started/img/dev-install-1.png differ
diff --git a/docs/get-started/img/device-event-monitoring.png b/docs/get-started/img/device-event-monitoring.png
new file mode 100644
index 000000000..a9760c38f
Binary files /dev/null and b/docs/get-started/img/device-event-monitoring.png differ
diff --git a/docs/get-started/img/diagnosis-settings.png b/docs/get-started/img/diagnosis-settings.png
new file mode 100644
index 000000000..fbd6ac80f
Binary files /dev/null and b/docs/get-started/img/diagnosis-settings.png differ
diff --git a/docs/get-started/img/event-code-table.png b/docs/get-started/img/event-code-table.png
new file mode 100644
index 000000000..dffeef049
Binary files /dev/null and b/docs/get-started/img/event-code-table.png differ
diff --git a/docs/get-started/img/event-deduplication.png b/docs/get-started/img/event-deduplication.png
new file mode 100644
index 000000000..0530e1b9f
Binary files /dev/null and b/docs/get-started/img/event-deduplication.png differ
diff --git a/docs/get-started/img/event-match-condition.png b/docs/get-started/img/event-match-condition.png
new file mode 100644
index 000000000..dbacf725a
Binary files /dev/null and b/docs/get-started/img/event-match-condition.png differ
diff --git a/docs/get-started/img/org-device-1.png b/docs/get-started/img/org-device-1.png
new file mode 100644
index 000000000..344c1d05a
Binary files /dev/null and b/docs/get-started/img/org-device-1.png differ
diff --git a/docs/get-started/img/org-device-2.png b/docs/get-started/img/org-device-2.png
new file mode 100644
index 000000000..905022e66
Binary files /dev/null and b/docs/get-started/img/org-device-2.png differ
diff --git a/docs/get-started/img/org-device-3.png b/docs/get-started/img/org-device-3.png
new file mode 100644
index 000000000..ecc3f428a
Binary files /dev/null and b/docs/get-started/img/org-device-3.png differ
diff --git a/docs/get-started/img/org-device-4.png b/docs/get-started/img/org-device-4.png
new file mode 100644
index 000000000..0271d870b
Binary files /dev/null and b/docs/get-started/img/org-device-4.png differ
diff --git a/docs/get-started/img/org-device-5.png b/docs/get-started/img/org-device-5.png
new file mode 100644
index 000000000..dba897d77
Binary files /dev/null and b/docs/get-started/img/org-device-5.png differ
diff --git a/docs/get-started/img/org-device-6.png b/docs/get-started/img/org-device-6.png
new file mode 100644
index 000000000..106ddb58a
Binary files /dev/null and b/docs/get-started/img/org-device-6.png differ
diff --git a/docs/get-started/img/org-device-7.png b/docs/get-started/img/org-device-7.png
new file mode 100644
index 000000000..8dd1b02c0
Binary files /dev/null and b/docs/get-started/img/org-device-7.png differ
diff --git a/docs/get-started/img/org-device-add.png b/docs/get-started/img/org-device-add.png
new file mode 100644
index 000000000..970236746
Binary files /dev/null and b/docs/get-started/img/org-device-add.png differ
diff --git a/docs/get-started/img/org-device-authorize.png b/docs/get-started/img/org-device-authorize.png
new file mode 100644
index 000000000..804c3d14e
Binary files /dev/null and b/docs/get-started/img/org-device-authorize.png differ
diff --git a/docs/get-started/img/org-device-authorized.png b/docs/get-started/img/org-device-authorized.png
new file mode 100644
index 000000000..1c015b466
Binary files /dev/null and b/docs/get-started/img/org-device-authorized.png differ
diff --git a/docs/get-started/img/org-device-copy-command.png b/docs/get-started/img/org-device-copy-command.png
new file mode 100644
index 000000000..78411cb16
Binary files /dev/null and b/docs/get-started/img/org-device-copy-command.png differ
diff --git a/docs/get-started/img/org-device-install.png b/docs/get-started/img/org-device-install.png
new file mode 100644
index 000000000..24fb03970
Binary files /dev/null and b/docs/get-started/img/org-device-install.png differ
diff --git a/docs/get-started/img/org-device-paste-command.png b/docs/get-started/img/org-device-paste-command.png
new file mode 100644
index 000000000..144fd49ab
Binary files /dev/null and b/docs/get-started/img/org-device-paste-command.png differ
diff --git a/docs/get-started/img/org-role.png b/docs/get-started/img/org-role.png
new file mode 100644
index 000000000..72e68a980
Binary files /dev/null and b/docs/get-started/img/org-role.png differ
diff --git a/docs/get-started/img/pro-1.png b/docs/get-started/img/pro-1.png
new file mode 100644
index 000000000..f9856ea9c
Binary files /dev/null and b/docs/get-started/img/pro-1.png differ
diff --git a/docs/get-started/img/pro-device-add-1.png b/docs/get-started/img/pro-device-add-1.png
new file mode 100644
index 000000000..331be8b17
Binary files /dev/null and b/docs/get-started/img/pro-device-add-1.png differ
diff --git a/docs/get-started/img/pro-device-add-2.png b/docs/get-started/img/pro-device-add-2.png
new file mode 100644
index 000000000..9c8428532
Binary files /dev/null and b/docs/get-started/img/pro-device-add-2.png differ
diff --git a/docs/get-started/img/pro-rule-action-create-moment.png b/docs/get-started/img/pro-rule-action-create-moment.png
new file mode 100644
index 000000000..88a390370
Binary files /dev/null and b/docs/get-started/img/pro-rule-action-create-moment.png differ
diff --git a/docs/get-started/img/pro-rule-action-upload.png b/docs/get-started/img/pro-rule-action-upload.png
new file mode 100644
index 000000000..7aac9c6af
Binary files /dev/null and b/docs/get-started/img/pro-rule-action-upload.png differ
diff --git a/docs/get-started/img/pro-rule-base-info.png b/docs/get-started/img/pro-rule-base-info.png
new file mode 100644
index 000000000..7705cd39b
Binary files /dev/null and b/docs/get-started/img/pro-rule-base-info.png differ
diff --git a/docs/get-started/img/pro-rule-base-rule-1.png b/docs/get-started/img/pro-rule-base-rule-1.png
new file mode 100644
index 000000000..a98b08fd5
Binary files /dev/null and b/docs/get-started/img/pro-rule-base-rule-1.png differ
diff --git a/docs/get-started/img/pro-rule-base-rule-2.png b/docs/get-started/img/pro-rule-base-rule-2.png
new file mode 100644
index 000000000..159cca250
Binary files /dev/null and b/docs/get-started/img/pro-rule-base-rule-2.png differ
diff --git a/docs/get-started/img/pro-rule-condition.png b/docs/get-started/img/pro-rule-condition.png
new file mode 100644
index 000000000..f22195ad3
Binary files /dev/null and b/docs/get-started/img/pro-rule-condition.png differ
diff --git a/docs/get-started/img/pro-rule-limit.png b/docs/get-started/img/pro-rule-limit.png
new file mode 100644
index 000000000..9acef0369
Binary files /dev/null and b/docs/get-started/img/pro-rule-limit.png differ
diff --git a/docs/get-started/img/pro-rule-manage-disable-2.png b/docs/get-started/img/pro-rule-manage-disable-2.png
new file mode 100644
index 000000000..4814efef3
Binary files /dev/null and b/docs/get-started/img/pro-rule-manage-disable-2.png differ
diff --git a/docs/get-started/img/pro-rule-manage-disable.png b/docs/get-started/img/pro-rule-manage-disable.png
new file mode 100644
index 000000000..5ad3f690e
Binary files /dev/null and b/docs/get-started/img/pro-rule-manage-disable.png differ
diff --git a/docs/get-started/img/pro-rule-manage-edit.png b/docs/get-started/img/pro-rule-manage-edit.png
new file mode 100644
index 000000000..f0ca7810d
Binary files /dev/null and b/docs/get-started/img/pro-rule-manage-edit.png differ
diff --git a/docs/get-started/img/pro-rule-save-success.png b/docs/get-started/img/pro-rule-save-success.png
new file mode 100644
index 000000000..4afc53896
Binary files /dev/null and b/docs/get-started/img/pro-rule-save-success.png differ
diff --git a/docs/get-started/img/pro-rule-template-edit-action-create-moment.png b/docs/get-started/img/pro-rule-template-edit-action-create-moment.png
new file mode 100644
index 000000000..60c734a66
Binary files /dev/null and b/docs/get-started/img/pro-rule-template-edit-action-create-moment.png differ
diff --git a/docs/get-started/img/pro-rule-template-edit-condition.png b/docs/get-started/img/pro-rule-template-edit-condition.png
new file mode 100644
index 000000000..a360290ee
Binary files /dev/null and b/docs/get-started/img/pro-rule-template-edit-condition.png differ
diff --git a/docs/get-started/img/pro-rule-template-edit-rule-name.png b/docs/get-started/img/pro-rule-template-edit-rule-name.png
new file mode 100644
index 000000000..1f8d2f524
Binary files /dev/null and b/docs/get-started/img/pro-rule-template-edit-rule-name.png differ
diff --git a/docs/get-started/img/pro-rule-template-edit-template.png b/docs/get-started/img/pro-rule-template-edit-template.png
new file mode 100644
index 000000000..6da51d48d
Binary files /dev/null and b/docs/get-started/img/pro-rule-template-edit-template.png differ
diff --git a/docs/get-started/img/pro-rule-template-success-effect.png b/docs/get-started/img/pro-rule-template-success-effect.png
new file mode 100644
index 000000000..7f68bd2ca
Binary files /dev/null and b/docs/get-started/img/pro-rule-template-success-effect.png differ
diff --git a/docs/get-started/img/pro-rule-template.png b/docs/get-started/img/pro-rule-template.png
new file mode 100644
index 000000000..930d5ec8c
Binary files /dev/null and b/docs/get-started/img/pro-rule-template.png differ
diff --git a/docs/get-started/img/pro-rule-test-1.png b/docs/get-started/img/pro-rule-test-1.png
new file mode 100644
index 000000000..0208e1988
Binary files /dev/null and b/docs/get-started/img/pro-rule-test-1.png differ
diff --git a/docs/get-started/img/pro-rule-test-2.png b/docs/get-started/img/pro-rule-test-2.png
new file mode 100644
index 000000000..aab7a47a8
Binary files /dev/null and b/docs/get-started/img/pro-rule-test-2.png differ
diff --git a/docs/get-started/img/pro-rule-test-3.png b/docs/get-started/img/pro-rule-test-3.png
new file mode 100644
index 000000000..09124b085
Binary files /dev/null and b/docs/get-started/img/pro-rule-test-3.png differ
diff --git a/docs/get-started/img/pro-rule-test-4.png b/docs/get-started/img/pro-rule-test-4.png
new file mode 100644
index 000000000..1371f444d
Binary files /dev/null and b/docs/get-started/img/pro-rule-test-4.png differ
diff --git a/docs/get-started/img/pro-trigger-add.png b/docs/get-started/img/pro-trigger-add.png
new file mode 100644
index 000000000..a285a80d2
Binary files /dev/null and b/docs/get-started/img/pro-trigger-add.png differ
diff --git a/docs/get-started/img/pro-trigger-edit.png b/docs/get-started/img/pro-trigger-edit.png
new file mode 100644
index 000000000..0a5aff6fd
Binary files /dev/null and b/docs/get-started/img/pro-trigger-edit.png differ
diff --git a/docs/get-started/img/rule-basic-info.png b/docs/get-started/img/rule-basic-info.png
new file mode 100644
index 000000000..393d056a4
Binary files /dev/null and b/docs/get-started/img/rule-basic-info.png differ
diff --git a/docs/get-started/img/rule-group-management.png b/docs/get-started/img/rule-group-management.png
new file mode 100644
index 000000000..2a2fe88ed
Binary files /dev/null and b/docs/get-started/img/rule-group-management.png differ
diff --git a/docs/get-started/img/rule-group-toggle.png b/docs/get-started/img/rule-group-toggle.png
new file mode 100644
index 000000000..a697571a0
Binary files /dev/null and b/docs/get-started/img/rule-group-toggle.png differ
diff --git a/docs/get-started/img/rule-log-1.png b/docs/get-started/img/rule-log-1.png
new file mode 100644
index 000000000..e83c8bdfb
Binary files /dev/null and b/docs/get-started/img/rule-log-1.png differ
diff --git a/docs/get-started/img/rule-log-2.png b/docs/get-started/img/rule-log-2.png
new file mode 100644
index 000000000..15b47b198
Binary files /dev/null and b/docs/get-started/img/rule-log-2.png differ
diff --git a/docs/use-case/4-online-simulation-test.md b/docs/use-case/4-online-simulation-test.md
new file mode 100644
index 000000000..936e6a59d
--- /dev/null
+++ b/docs/use-case/4-online-simulation-test.md
@@ -0,0 +1,195 @@
+---
+sidebar_position: 4
+---
+
+# 云端仿真自动化算法验证
+
+## 背景
+
+在泛机器人研发过程中,针对算法和软件的反复测试与验证,是日常工作中最耗时、最容易出错的一环。
+
+你是不是也经历过这样的日常?
+
+- 算法改了一行代码,结果测了一整天
+- 本地仿真环境突然坏掉,重装又踩坑
+- 多人协作,各测各的,结果对不上…
+
+尤其对于**移动机器人、具身智能**等领域的研发人员来说:
+
+- 软件迭代频繁,需要持续验证
+- 仿真环境配置复杂,维护成本高
+- 测试标准不统一,结果难以量化
+- 本地计算资源有限,测试任务排队严重
+
+这些问题导致本地测试效率低下、协作困难。
+
+---
+
+刻行时空一直在思考:有没有一种方法,只要修改完算法,就可以随时进行无痛进行效果验证,还能把测试结果标准输出?
+
+刻行时空在**数据闭环**与**生产力工具**搭建方面拥有丰富经验,基于我们先进的 **ScenenOps 理念**,提供了一站式云端仿真平台:
+**简单五步,完成平台搭建,你只需上传程序,平台自动运行测试、生成可视化结果,全流程在线、零依赖!**
+
+
+本文以 Ubuntu 22.04 + ROS 2 Humble + Gazebo 环境为例,介绍如何在完成算法修改后,通过刻行时空平台进行云端仿真测试。
+
+更多仿真软件的支持,请关注刻行时空官网:[刻行时空平台](https://www.coscene.cn/)。
+
+---
+
+## 🧱 Step 1:构建属于你自己的算法与软件测试底座
+
+我们知道,每支团队的技术栈都不一样。
+因此,我们支持用户基于自己的系统依赖构建专属镜像并上传。
+
+你可以使用如下 Dockerfile 模板来构建环境:
+
+```Dockerfile
+# syntax = docker/dockerfile:1.2
+ARG BASE_IMAGE=osrf/ros:humble-desktop-full
+FROM ${BASE_IMAGE} as base
+...
+WORKDIR /action/ros2_ws
+```
+
+开源示例项目 👉 [Regression_Test-Sample](https://github.com/coscene-io/Regression_Test-Sample/blob/main/Dockerfile)
+
+构建完成后,打包推送至平台镜像仓库,全公司同事可复用这个稳定的测试环境,无需本地重复搭建。
+
+1. 登录刻行时空平台,进入组织管理获取专属镜像仓库地址
+ 
+ 
+ 
+
+2. 登录 Docker 并打包推送镜像
+ 
+
+3. 登录平台查看镜像并获取链接
+ 
+
+完成上述操作后,相当于为后续的各种仿真算法测试验证,搭建了一套完整的运行环境底座,里面包含了所有需要的测试软件依赖环境。
+
+---
+
+## 📦 Step 2:上传你的算法与测试程序
+
+算法/软件代码修改完成后,对代码进行编译。
+
+
+将其压缩为 `.zip` 或 `.tar.gz` 上传至平台,建议上传 `install` 目录的压缩包:
+
+```bash
+tar -czvf install.tar.gz ./install
+```
+
+进入平台项目,点击上传程序按钮,平台将自动解压并在后续执行测试时,在对应容器中运行。
+
+
+
+
+
+同时支持:
+
+- 源码构建与编译后的可执行程序
+
+可参考平台文档 👉 https://docs.coscene.cn/docs/sim-and-tests/regression/test-bundle-management
+
+**_对于企业用户,还支持 GitHub / GitLab 持续集成上传构建产物,跳过手动上传过程。_**
+
+---
+
+## 🧪 Step 3:准备你的测试用例
+
+平台支持通过 `组织 → 项目 → 记录` 的结构,配置多条测试用例。
+
+每条测试记录就像一个预设的虚拟测试现场:
+
+- 地图:`map.pgm` + `map.yaml`
+- 机器人模型:如 `turtlebot3_waffle_pi`
+- 配置文件:如 `case.yaml`
+- Gazebo world 文件:定义仿真环境
+- 其他测试依赖资源
+
+测试记录文件结构示例:
+
+```
+test_case/
+├── map.pgm
+├── map.yaml
+├── case.yaml
+├── world.world
+├── extra_configs/
+```
+
+
+
+:::info 重要说明
+
+### 文件结构规范
+
+请严格遵循[平台规定的路径结构](https://docs.coscene.cn/docs/sim-and-tests/regression/intro):
+
+
+
+:::
+
+### 标签管理
+
+为记录添加标签(如 `Navigation_Error`)用于测试筛选,具体步骤如下:
+
+
+
+
+
+
+完成上述配置后,您可以在下一步使用这些标签(如 `Navigation_Error`)来筛选测试用例。
+
+## ⚙️ Step 4:配置测试触发逻辑
+
+每个项目都可以配置自动化触发策略:
+
+- 每次上传算法自动触发测试
+- 手动选择记录执行
+- 按标签或版本筛选测试集
+
+详细配置参考 👉 https://docs.coscene.cn/docs/sim-and-tests/regression/config-management
+
+
+
+
+---
+
+## 📊 Step 5:运行测试,观测测试过程与结果
+
+测试运行过程中支持:
+
+- 实时查看可视化页面中机器人运行状态,支持导入 gazebo环境同步查看。
+- 自动录制测试过程数据。
+- 输出标准化测试报告。
+
+
+
+
+
+报告内容:
+
+- 📍 机器人运行轨迹
+- ✅ 成功 / 失败评分指标
+- 🪵 日志输出 / 异常信息
+- 🖼️ 可视化图表与统计
+ 
+ 
+
+---
+
+## 🚀 结语:把繁琐的测试交给刻行时空,轻装上阵搞研发
+
+每次代码更新之后,你不再需要:
+
+- 反复搭环境
+- 重复运行脚本
+- 对比日志找结果
+
+只需一键上传,平台自动完成验证,全流程标准化、自动化,帮助你把更多时间投入到真正重要的工作中!
+
+👉 欢迎注册体验:https://www.coscene.cn/
diff --git a/docs/use-case/img/4-online-simulation-test-1.png b/docs/use-case/img/4-online-simulation-test-1.png
new file mode 100644
index 000000000..237a9dc60
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-1.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-10.png b/docs/use-case/img/4-online-simulation-test-10.png
new file mode 100644
index 000000000..5aa6aa25a
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-10.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-11.png b/docs/use-case/img/4-online-simulation-test-11.png
new file mode 100644
index 000000000..8aa9d3dc2
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-11.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-12.png b/docs/use-case/img/4-online-simulation-test-12.png
new file mode 100644
index 000000000..d542f4bb4
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-12.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-13.png b/docs/use-case/img/4-online-simulation-test-13.png
new file mode 100644
index 000000000..e2510b75b
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-13.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-14.png b/docs/use-case/img/4-online-simulation-test-14.png
new file mode 100644
index 000000000..cfea2d7a9
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-14.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-15.png b/docs/use-case/img/4-online-simulation-test-15.png
new file mode 100644
index 000000000..21583cb81
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-15.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-16.png b/docs/use-case/img/4-online-simulation-test-16.png
new file mode 100644
index 000000000..1899e6c16
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-16.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-17.png b/docs/use-case/img/4-online-simulation-test-17.png
new file mode 100644
index 000000000..fa10bf436
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-17.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-18.png b/docs/use-case/img/4-online-simulation-test-18.png
new file mode 100644
index 000000000..2d33cb3c4
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-18.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-19.png b/docs/use-case/img/4-online-simulation-test-19.png
new file mode 100644
index 000000000..9c294971a
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-19.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-2.PNG b/docs/use-case/img/4-online-simulation-test-2.PNG
new file mode 100644
index 000000000..26f5434ef
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-2.PNG differ
diff --git a/docs/use-case/img/4-online-simulation-test-20.png b/docs/use-case/img/4-online-simulation-test-20.png
new file mode 100644
index 000000000..96b677404
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-20.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-21.png b/docs/use-case/img/4-online-simulation-test-21.png
new file mode 100644
index 000000000..2ece08bee
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-21.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-22.png b/docs/use-case/img/4-online-simulation-test-22.png
new file mode 100644
index 000000000..c1ca9a44c
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-22.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-23.gif b/docs/use-case/img/4-online-simulation-test-23.gif
new file mode 100644
index 000000000..7161a785c
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-23.gif differ
diff --git a/docs/use-case/img/4-online-simulation-test-24.png b/docs/use-case/img/4-online-simulation-test-24.png
new file mode 100644
index 000000000..dfc92d798
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-24.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-25.png b/docs/use-case/img/4-online-simulation-test-25.png
new file mode 100644
index 000000000..8438f75d7
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-25.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-3.PNG b/docs/use-case/img/4-online-simulation-test-3.PNG
new file mode 100644
index 000000000..0f8bf476c
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-3.PNG differ
diff --git a/docs/use-case/img/4-online-simulation-test-4.PNG b/docs/use-case/img/4-online-simulation-test-4.PNG
new file mode 100644
index 000000000..261e4e8d4
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-4.PNG differ
diff --git a/docs/use-case/img/4-online-simulation-test-5.PNG b/docs/use-case/img/4-online-simulation-test-5.PNG
new file mode 100644
index 000000000..23990a1a1
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-5.PNG differ
diff --git a/docs/use-case/img/4-online-simulation-test-6.png b/docs/use-case/img/4-online-simulation-test-6.png
new file mode 100644
index 000000000..1fe7bcdd8
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-6.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-7.png b/docs/use-case/img/4-online-simulation-test-7.png
new file mode 100644
index 000000000..07c86eaad
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-7.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-8.png b/docs/use-case/img/4-online-simulation-test-8.png
new file mode 100644
index 000000000..28d211646
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-8.png differ
diff --git a/docs/use-case/img/4-online-simulation-test-9.png b/docs/use-case/img/4-online-simulation-test-9.png
new file mode 100644
index 000000000..2d33cb3c4
Binary files /dev/null and b/docs/use-case/img/4-online-simulation-test-9.png differ