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：右側面板用於顯示層級任務視圖，便於用戶查看和管理任務。