Sequence Flow Experiment With Desktop Commander

🚀 序列流与桌面指挥官实验 - 层级任务网络规划系统

序列流是一款基于Flutter开发的应用程序，主要用于可视化和管理层级任务网络（HTN）。它借助引导式AI对话，帮助用户轻松建模复杂的规划问题，为规划管理带来了极大便利。

🚀 快速开始

序列流是一个交互式的HTN规划系统，允许用户通过引导式AI对话建模复杂的规划问题。它提供了一个可视化的有向图来展示规划任务及其复杂依赖关系，并支持对子图进行层次压缩以管理复杂性，同时保留跨边界引用。

先决条件

• Flutter（>= 3.6.1）
• Dart（>= 3.6.0）
• 一个IDE（VS Code、Android Studio 或 IntelliJ）

安装

1. 克隆仓库：

git clone https://github.com/yourusername/sequence_flow.git
cd sequence_flow

2. 安装依赖项：

flutter pub get

3. 运行应用程序：

flutter run

✨ 主要特性

• 交互式建模：通过引导式AI对话处理复杂的规划问题
• 有向图可视化：将规划任务以有向图的形式展示，包含复杂的依赖关系
• 层次压缩：压缩子图以管理复杂性，同时保留引用
• 三列界面：包括AI聊天、交互式图形和层级任务列表
• 迭代问题解决：根据当前规划状态动态选择问题
• 外部持久化：防止因LLM上下文限制而导致的数据丢失

📦 安装指南

先决条件

• Flutter（>= 3.6.1）
• Dart（>= 3.6.0）
• 一个IDE（VS Code、Android Studio 或 IntelliJ）

安装步骤

1. 克隆仓库：

git clone https://github.com/yourusername/sequence_flow.git
cd sequence_flow

2. 安装依赖项：

flutter pub get

3. 运行应用程序：

flutter run

📚 详细文档

项目结构

sequence_flow/
├── lib/
│   ├── behaviors/      # 实现HTN规划行为
│   ├── models/         # 应用程序数据模型
│   │   └── entities/   # 核心实体定义
│   ├── screens/        # 应用程序界面
│   ├── services/       # 外部服务集成
│   ├── utils/          # 工具函数和辅助功能
│   └── widgets/        # 可重用UI组件
├── assets/             # 静态资源（图标、图像）
└── test/               # 单元测试和 widget 测试

核心组件

实体

• Task：HTN规划的基本构建块
• Method：定义任务分解的方式
• TaskDecomposition：任务之间的层次关系
• TaskDependency：任务之间的非层次依赖关系
• CrossBoundaryReference：跨越压缩子图边界的引用
• WorldState：表示规划过程中世界状态
• Plan：解决问题的规划方案
• Conversation：AI引导的规划对话

行为

• HierarchicalCompression：管理子图的压缩与展开
• AIGuidedPlanning：控制AI驱动的规划对话
• GraphStateManagement：管理图形状态的持久化和历史记录

用户界面

• ThreeColumnLayout：应用程序的主要布局，包含三个面板
• AIChat：左侧面板用于与AI进行对话
• DirectedGraph：中间面板用于显示有向图
• TaskList：右侧面板用于显示层级任务视图

开发

代码风格

该项目遵循官方的Dart 风格指南，并使用推荐的Flutter代码规范。

构建

构建Web版本：

flutter build web

🔧 技术细节

实体

• Task：作为HTN规划的基本构建块，是整个规划系统的基础元素。
• Method：明确了任务分解的具体方式，为任务的细化提供了规则。
• TaskDecomposition：构建了任务之间的层次关系，使得规划具有清晰的结构。
• TaskDependency：定义了任务之间的非层次依赖关系，丰富了任务之间的关联。
• CrossBoundaryReference：实现了跨越压缩子图边界的引用，增强了系统的灵活性。
• WorldState：表示规划过程中世界状态，为规划提供了环境信息。
• Plan：作为解决问题的规划方案，是整个系统的目标体现。
• Conversation：通过AI引导的规划对话，实现了与用户的交互。

行为

• HierarchicalCompression：通过管理子图的压缩与展开，有效地管理了系统的复杂性。
• AIGuidedPlanning：控制AI驱动的规划对话，使得规划过程更加智能。
• GraphStateManagement：管理图形状态的持久化和历史记录，确保了数据的稳定性和可追溯性。

用户界面

• ThreeColumnLayout：应用程序的主要布局，包含三个面板，提供了清晰的界面结构。
• AIChat：左侧面板用于与AI进行对话，方便用户输入和获取信息。
• DirectedGraph：中间面板用于显示有向图，直观地展示了规划任务及其依赖关系。
• TaskList：右侧面板用于显示层级任务视图，便于用户查看和管理任务。