会话状态

状态是会话的工作流标签，标识每个会话当前处于哪个阶段。状态是互斥的——每个会话同一时间只能有一个状态。

状态与收件箱

状态分为两类：

类别	说明	显示位置
开放（open）	任务进行中	收件箱
关闭（closed）	任务已完成或取消	归档

开放状态的会话出现在收件箱，关闭状态的会话移至归档，保持界面整洁。

默认状态

每个工作区默认提供以下五个状态：

状态	类别	说明
Backlog	开放	已记录但暂未开始，可自定义
Todo	开放	待处理，已准备好开始（固定，不可删除）
Needs Review	开放	需要审查或反馈，可自定义
Done	关闭	已完成（固定，不可删除）
Cancelled	关闭	已取消（固定，不可删除）

标记为"固定"的状态（Todo、Done、Cancelled）不可删除，但可以修改名称和颜色。

自定义状态

新增状态

打开 工作区设置 → 状态

点击 新建状态

填写名称，选择颜色、图标和类别（开放/关闭）

保存

修改状态

可以修改任何状态的名称、颜色和图标。固定状态的类别不可更改。

删除状态

只有非固定且非默认的自定义状态才能删除。删除后，使用该状态的会话会自动迁移到 todo。

调整顺序

在状态列表中拖拽可以调整显示顺序。

状态图标

图标支持三种格式，按优先级从高到低：

本地 SVG 文件：{工作区}/statuses/icons/{id}.svg

URL：填写图片链接，Hifox 会自动下载到本地

Emoji：直接填写 emoji 字符（如 🔥、✅）

状态颜色

颜色支持两种格式：

系统色：accent、info、success、foreground/50 等，随深色/浅色模式自动适配

自定义色：{ "light": "#EF4444", "dark": "#F87171" }，分别为浅色和深色模式指定颜色

在自动化中使用状态

状态变更可以触发自动化：

{
  "automations": {
    "SessionStatusChange": [
      {
        "matcher": "done",
        "actions": [
          {
            "type": "prompt",
            "prompt": "任务已完成，帮我写一个简短的完成总结"
          }
        ]
      }
    ]
  }
}

matcher 是正则表达式，匹配变更后的状态 ID。

存储结构

~/.anakin/workspaces/{workspaceId}/
└── statuses/
    ├── config.json          # 状态配置
    └── icons/
        ├── todo.svg          # 默认图标（自动创建）
        ├── done.svg
        └── {custom-id}.svg   # 自定义图标

config.json 格式：

{
  "version": 1,
  "defaultStatusId": "todo",
  "statuses": [
    {
      "id": "todo",
      "label": "Todo",
      "category": "open",
      "isFixed": true,
      "isDefault": false,
      "order": 1
    }
  ]
}

状态与收件箱#

默认状态#

自定义状态#

新增状态#

修改状态#

删除状态#

调整顺序#

状态图标#

状态颜色#

在自动化中使用状态#

存储结构#