┌─────────────────────────────────────────────────────┐
│                   Aster Desktop                      │
│  ┌─────────────────────────────────────────────────┐│
│  │              Tauri/Wails Shell                  ││
│  │  ┌─────────────────┐  ┌─────────────────────┐  ││
│  │  │   Web Frontend  │  │   Native Features   │  ││
│  │  │   (Vue3 + UI)   │  │  (Tray, Shortcuts)  │  ││
│  │  └────────┬────────┘  └──────────┬──────────┘  ││
│  └───────────┼──────────────────────┼─────────────┘│
│              │ HTTP/WebSocket       │              │
│  ┌───────────▼──────────────────────▼─────────────┐│
│  │              Aster Backend (sidecar)           ││
│  │  ┌─────────┐ ┌─────────┐ ┌─────────────────┐  ││
│  │  │ Agent   │ │ Session │ │   Local Tools   │  ││
│  │  │ Engine  │ │ (SQLite)│ │ (Bash, FS, MCP) │  ││
│  │  └─────────┘ └─────────┘ └─────────────────┘  ││
│  └─────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────┘

package sqlite

import (
    "database/sql"
    _ "github.com/mattn/go-sqlite3"
)

type Store struct {
    db   *sql.DB
    path string
}

func New(dbPath string) (*Store, error) {
    // 自动创建数据库文件
    // 初始化 schema (sessions, events 表)
}

func (s *Store) CreateSession(ctx context.Context, sess *session.Session) error
func (s *Store) AppendEvent(ctx context.Context, sessionID string, event *session.Event) error
func (s *Store) GetSession(ctx context.Context, id string) (*session.Session, error)
func (s *Store) ListSessions(ctx context.Context, opts ListOptions) ([]*session.Session, error)

package config

import (
    "os"
    "path/filepath"
    "runtime"
)

// Paths 提供跨平台的配置路径
type Paths struct{}

// ConfigDir 返回配置目录
// macOS: ~/Library/Application Support/Aster
// Linux: ~/.config/aster (XDG_CONFIG_HOME)
// Windows: %APPDATA%/Aster
func ConfigDir() string {
    switch runtime.GOOS {
    case "darwin":
        return filepath.Join(os.Getenv("HOME"), "Library", "Application Support", "Aster")
    case "windows":
        return filepath.Join(os.Getenv("APPDATA"), "Aster")
    default:
        if xdg := os.Getenv("XDG_CONFIG_HOME"); xdg != "" {
            return filepath.Join(xdg, "aster")
        }
        return filepath.Join(os.Getenv("HOME"), ".config", "aster")
    }
}

// DataDir 返回数据目录 (sessions, memories)
func DataDir() string { ... }

// LogDir 返回日志目录
func LogDir() string { ... }

// CacheDir 返回缓存目录
func CacheDir() string { ... }

# ~/.config/aster/recipes/code-review.yaml
version: "1.0"
title: "Code Review Assistant"
description: "AI-powered code review helper"

# 基于现有 template
template_id: "default"

# 覆盖系统提示词
instructions: |
  You are a senior code reviewer. Focus on:
  - Code quality and best practices
  - Security vulnerabilities
  - Performance issues

# 初始提示
prompt: "Please review the code in the current directory."

# 启用的工具
tools:
  - filesystem
  - bash

# MCP 扩展
extensions:
  - type: stdio
    name: git-mcp
    cmd: npx
    args: ["-y", "@anthropic/git-mcp"]

# 参数化
parameters:
  - key: language
    type: select
    options: ["go", "python", "javascript", "rust"]
    default: "go"

# 权限模式
permission_mode: smart_approve  # auto_approve | smart_approve | always_ask

package permission

type Mode string

const (
    ModeAutoApprove  Mode = "auto_approve"   // 自动批准所有操作
    ModeSmartApprove Mode = "smart_approve"  // 智能判断，只读自动批准
    ModeAlwaysAsk    Mode = "always_ask"     // 总是询问
)

// Inspector 检查工具调用是否需要用户确认
type Inspector struct {
    mode          Mode
    readOnlyTools map[string]bool
    trustedTools  map[string]bool
}

// Check 返回是否需要用户确认
func (i *Inspector) Check(toolName string, args map[string]any) (needConfirm bool, reason string)

// 在工具执行前
if needConfirm, reason := inspector.Check(tool.Name, args); needConfirm {
    // 发送到 Control Channel
    agent.ControlChannel() <- &events.ToolApprovalRequest{
        ToolName: tool.Name,
        Args:     args,
        Reason:   reason,
    }
    // 等待用户响应
    response := <-agent.ControlChannel()
    if !response.Approved {
        return nil, ErrToolDenied
    }
}

cmd/
├── aster/              # CLI 工具 (已有)
├── aster-server/       # 服务端 (已有)
└── aster-desktop/      # 桌面应用 (新增)
    ├── main.go         # Wails 入口
    ├── app.go          # 应用逻辑
    ├── backend.go      # 后端服务管理
    └── frontend/       # 软链接到 ui/dist

package main

import (
    "context"
    "fmt"
    "net"
    "os/exec"
    "time"
)

type BackendManager struct {
    cmd     *exec.Cmd
    port    int
    dataDir string
}

// FindAvailablePort 找到可用端口
func FindAvailablePort() (int, error) {
    listener, err := net.Listen("tcp", "127.0.0.1:0")
    if err != nil {
        return 0, err
    }
    defer listener.Close()
    return listener.Addr().(*net.TCPAddr).Port, nil
}

// Start 启动后端服务
func (m *BackendManager) Start(ctx context.Context) error {
    port, err := FindAvailablePort()
    if err != nil {
        return err
    }
    m.port = port

    // 启动 aster serve 作为子进程
    m.cmd = exec.CommandContext(ctx, "aster", "serve",
        "--port", fmt.Sprintf("%d", port),
        "--data-dir", m.dataDir,
        "--store", "sqlite",
    )

    if err := m.cmd.Start(); err != nil {
        return err
    }

    // 健康检查
    return m.waitForReady(ctx, 10*time.Second)
}

// waitForReady 等待后端就绪
func (m *BackendManager) waitForReady(ctx context.Context, timeout time.Duration) error {
    deadline := time.Now().Add(timeout)
    for time.Now().Before(deadline) {
        resp, err := http.Get(fmt.Sprintf("http://127.0.0.1:%d/health", m.port))
        if err == nil && resp.StatusCode == 200 {
            return nil
        }
        time.Sleep(100 * time.Millisecond)
    }
    return fmt.Errorf("backend failed to start within %v", timeout)
}

// Stop 停止后端服务
func (m *BackendManager) Stop() error {
    if m.cmd != nil && m.cmd.Process != nil {
        return m.cmd.Process.Kill()
    }
    return nil
}

# 交互式会话 (类似 goose session)
aster session [--recipe <name>] [--dir <path>]

# 运行 recipe
aster run --recipe code-review.yaml

# 配置管理
aster configure              # 交互式配置
aster configure providers    # 配置 LLM Provider
aster configure extensions   # 配置 MCP 扩展

# Recipe 管理
aster recipe list            # 列出可用 recipes
aster recipe create          # 创建新 recipe
aster recipe validate <file> # 验证 recipe 格式

package main

import (
    "bufio"
    "fmt"
    "os"

    "github.com/astercloud/aster/pkg/agent"
)

func runSession(args []string) error {
    // 解析参数
    recipeFile := flagSet.String("recipe", "", "Recipe file to use")
    workDir := flagSet.String("dir", ".", "Working directory")

    // 加载配置
    cfg := loadConfig()

    // 创建 Agent
    a, err := agent.New(agent.WithConfig(cfg))
    if err != nil {
        return err
    }

    // REPL 循环
    scanner := bufio.NewScanner(os.Stdin)
    fmt.Print("aster> ")

    for scanner.Scan() {
        input := scanner.Text()

        // 处理特殊命令
        switch input {
        case "/exit", "/quit":
            return nil
        case "/clear":
            a.ClearHistory()
            continue
        case "/help":
            printHelp()
            continue
        }

        // 发送到 Agent
        for event := range a.Run(ctx, input) {
            switch e := event.(type) {
            case *events.TextChunk:
                fmt.Print(e.Text)
            case *events.ToolApprovalRequest:
                // 处理工具确认
                if confirm := askUserConfirm(e); confirm {
                    a.ApproveToolCall(e.ID)
                } else {
                    a.DenyToolCall(e.ID)
                }
            }
        }

        fmt.Print("\naster> ")
    }

    return nil
}

# LLM Provider 配置
providers:
  default:
    provider: anthropic
    model: claude-sonnet-4-20250514
    env_api_key: ANTHROPIC_API_KEY

  fast:
    provider: openai
    model: gpt-4o-mini
    env_api_key: OPENAI_API_KEY

# 默认 Provider
default_provider: default

# 权限模式
permission_mode: smart_approve

# MCP 扩展
extensions:
  - name: filesystem
    type: builtin
    enabled: true

  - name: git
    type: stdio
    cmd: npx
    args: ["-y", "@anthropic/git-mcp"]
    enabled: true

# 存储配置
storage:
  type: sqlite
  path: ~/.config/aster/data/aster.db

# 日志配置
logging:
  level: info
  path: ~/.config/aster/logs/

# 继承全局配置
extends: global

# 项目特定的 recipe
recipe: code-review

# 覆盖权限模式
permission_mode: always_ask

# 项目特定的 MCP 扩展
extensions:
  - name: project-docs
    type: stdio
    cmd: python
    args: ["-m", "docs_mcp", "--root", "."]