# XWorkmate UI Feature Flag Roadmap

> Generated by `tool/render_release_docs.dart`
> Source manifest: [`config/feature_flags.yaml`](../../config/feature_flags.yaml)
> Generated at: `2026-05-27T15:05:31.224939`

## 规划规则

- `release_policy` 决定 build mode 的总开关上限：`debug` 可见 `stable / beta / experimental`，`profile` 可见 `stable / beta`，`release` 仅可见 `stable`。
- 单个 flag 的交付状态由三层共同决定：`enabled`、`release_tier`、`build_modes`。
- `enabled: false` 或 `build_modes: []` 的项，会在文档里继续保留，但不会进入当前 build mode 的用户可见范围。

## Build Visibility Summary

| 平台 | Debug Visible | Profile Visible | Release Visible | Suppressed |
| --- | --- | --- | --- | --- |
| `mobile` | 14 | 10 | 10 | 1 |
| `desktop` | 14 | 11 | 11 | 1 |
| `web` | 8 | 8 | 8 | 7 |

## Release Baseline

| 平台 | 数量 | Flag 列表 |
| --- | --- | --- |
| `mobile` | 10 | `navigation.assistant`, `navigation.settings`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `settings.gateway`, `settings.archived_tasks`, `settings.account_access`, `settings.vault_server` |
| `desktop` | 11 | `navigation.assistant`, `navigation.settings`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `assistant.local_runtime`, `settings.gateway`, `settings.archived_tasks`, `settings.account_access`, `settings.vault_server` |
| `web` | 8 | `navigation.assistant`, `navigation.settings`, `assistant.direct_ai`, `assistant.relay_gateway`, `assistant.file_attachments`, `settings.gateway`, `settings.archived_tasks`, `settings.account_access` |

## Profile-only Lane

| 平台 | 数量 | 相比 Release 新增 |
| --- | --- | --- |
| `mobile` | 0 | - |
| `desktop` | 0 | - |
| `web` | 0 | - |

## Debug-only Experimental Lane

| 平台 | 数量 | 相比 Profile 新增 |
| --- | --- | --- |
| `mobile` | 4 | `assistant.multi_agent`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug` |
| `desktop` | 3 | `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug` |
| `web` | 0 | - |

## Explicitly Suppressed

| 平台 | 数量 | Flag 列表 |
| --- | --- | --- |
| `mobile` | 1 | `assistant.local_runtime` |
| `desktop` | 1 | `assistant.multi_agent` |
| `web` | 7 | `assistant.local_gateway`, `assistant.multi_agent`, `assistant.local_runtime`, `settings.vault_server`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug` |

## Tier Inventory

### Mobile

- `stable`: `navigation.assistant`, `navigation.settings`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `settings.gateway`, `settings.archived_tasks`, `settings.account_access`, `settings.vault_server`
- `experimental`: `assistant.multi_agent`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug`
- `disabled`: `assistant.local_runtime`

### Desktop

- `stable`: `navigation.assistant`, `navigation.settings`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `assistant.local_runtime`, `settings.gateway`, `settings.archived_tasks`, `settings.account_access`, `settings.vault_server`
- `experimental`: `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug`
- `disabled`: `assistant.multi_agent`

### Web

- `stable`: `navigation.assistant`, `navigation.settings`, `assistant.direct_ai`, `assistant.relay_gateway`, `assistant.file_attachments`, `settings.gateway`, `settings.archived_tasks`, `settings.account_access`
- `disabled`: `assistant.local_gateway`, `assistant.multi_agent`, `assistant.local_runtime`, `settings.vault_server`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug`

