标签（Labels）

标签是会话的附加标记，用于组织、分类和筛选。与状态不同，标签是叠加的——一个会话可以同时拥有多个标签。

标签 vs 状态

	标签	状态
每个会话可以有几个	多个	一个
可以携带值	是（如 `priority::3`）	否
控制收件箱/归档	否	是
用途	分类、筛选、元数据	工作流阶段

标签层级

标签支持多层嵌套，形成树状结构：

bug
  └── frontend
  └── backend
feature
  └── ui
  └── api
priority
  └── high
  └── low

子标签自动继承父标签的分组语义。列表中的位置决定显示顺序，无需单独排序字段。

带值的标签

标签可以携带值，格式为 标签ID::值：

格式示例	说明
`priority::3`	数字值
`sprint::2024-W12`	字符串值
`deadline::2024-12-31`	日期值
`bug`	纯布尔标签（无值）

在工作区设置中，可以为标签配置 valueType（string、number、date），UI 会根据类型显示对应的输入组件。

自动标签规则

通过正则表达式，Hifox 可以在扫描到用户消息时自动应用标签：

{
  "id": "linear-issue",
  "name": "Linear Issue",
  "autoRules": [
    {
      "pattern": "https://linear\\.app/.+/issue/([A-Z]+-\\d+)",
      "valueTemplate": "$1",
      "description": "匹配 Linear issue URL，提取 issue ID 作为标签值"
    },
    {
      "pattern": "\\b([A-Z]+-\\d+)\\b",
      "valueTemplate": "$1",
      "description": "匹配裸 issue ID（如 ENG-123）"
    }
  ]
}

pattern：正则表达式（支持捕获组）

valueTemplate：用 $1、$2 引用捕获组生成标签值

flags：正则标志，默认 gi（全局、忽略大小写）

自动标签规则在每次用户发送消息时运行，匹配到的标签自动添加到会话。

新建标签

打开 工作区设置 → 标签

点击 新建标签

填写名称，选择颜色，可选填值类型

如需嵌套，选择父标签

保存

在会话中使用标签

手动添加

在会话列表中右键会话 → 添加标签，或在会话详情的标签区域点击。

通过 AI 添加

直接告诉 AI：

给这个会话加上 "bug" 和 "priority::high" 标签

筛选会话

在侧边栏点击标签名称，可以筛选出所有带该标签的会话。

在自动化中使用标签

标签的添加和删除可以触发自动化：

{
  "automations": {
    "LabelAdd": [
      {
        "matcher": "^urgent$",
        "actions": [
          {
            "type": "prompt",
            "prompt": "这个任务被标记为紧急，请分析并列出需要立即处理的事项"
          }
        ]
      }
    ]
  }
}

存储结构

~/.anakin/workspaces/{workspaceId}/
└── labels/
    └── config.json

config.json 格式：

{
  "version": 1,
  "labels": [
    {
      "id": "bug",
      "name": "Bug",
      "color": "destructive",
      "children": [
        {
          "id": "frontend",
          "name": "Frontend",
          "color": { "light": "#3B82F6", "dark": "#60A5FA" }
        }
      ]
    },
    {
      "id": "priority",
      "name": "Priority",
      "valueType": "number",
      "autoRules": [
        {
          "pattern": "p(\\d+)",
          "valueTemplate": "$1"
        }
      ]
    }
  ]
}

标签 vs 状态#

标签层级#

带值的标签#

自动标签规则#

新建标签#

在会话中使用标签#

手动添加#

通过 AI 添加#

筛选会话#

在自动化中使用标签#

存储结构#