# 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-03-27T13:11:11.957747`

## 规划规则

- `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` | 25 | 18 | 18 | 8 |
| `desktop` | 25 | 20 | 19 | 8 |
| `web` | 16 | 16 | 16 | 4 |

## Release Baseline

| 平台 | 数量 | Flag 列表 |
| --- | --- | --- |
| `mobile` | 18 | `navigation.assistant`, `navigation.tasks`, `navigation.workspace`, `navigation.settings`, `workspace.skills`, `workspace.nodes`, `workspace.agents`, `workspace.ai_gateway`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `settings.general`, `settings.workspace`, `settings.gateway`, `settings.appearance`, `settings.diagnostics`, `settings.about` |
| `desktop` | 19 | `navigation.assistant`, `navigation.tasks`, `navigation.skills`, `navigation.nodes`, `navigation.agents`, `navigation.secrets`, `navigation.ai_gateway`, `navigation.settings`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `assistant.local_runtime`, `settings.general`, `settings.workspace`, `settings.gateway`, `settings.appearance`, `settings.diagnostics`, `settings.about` |
| `web` | 16 | `navigation.assistant`, `navigation.tasks`, `navigation.skills`, `navigation.nodes`, `navigation.secrets`, `navigation.ai_gateway`, `navigation.settings`, `assistant.direct_ai`, `assistant.relay_gateway`, `assistant.file_attachments`, `assistant.multi_agent`, `assistant.local_gateway`, `settings.general`, `settings.gateway`, `settings.appearance`, `settings.about` |

## Profile-only Lane

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

## Debug-only Experimental Lane

| 平台 | 数量 | 相比 Profile 新增 |
| --- | --- | --- |
| `mobile` | 7 | `navigation.secrets`, `workspace.mcp_server`, `assistant.multi_agent`, `settings.experimental`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug` |
| `desktop` | 5 | `navigation.mcp_server`, `settings.experimental`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug` |
| `web` | 0 | - |

## Explicitly Suppressed

| 平台 | 数量 | Flag 列表 |
| --- | --- | --- |
| `mobile` | 8 | `workspace.claw_hub`, `workspace.connectors`, `workspace.account`, `assistant.local_runtime`, `settings.account_access`, `settings.vault_server`, `settings.gateway_setup_code`, `settings.agents` |
| `desktop` | 8 | `navigation.claw_hub`, `navigation.account`, `workspace.claw_hub`, `workspace.connectors`, `settings.account_access`, `settings.vault_server`, `settings.gateway_setup_code`, `settings.agents` |
| `web` | 4 | `assistant.local_runtime`, `settings.account_access`, `settings.vault_server`, `settings.gateway_setup_code` |

## Tier Inventory

### Mobile

- `stable`: `navigation.assistant`, `navigation.tasks`, `navigation.workspace`, `navigation.settings`, `workspace.skills`, `workspace.nodes`, `workspace.agents`, `workspace.ai_gateway`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `settings.general`, `settings.workspace`, `settings.gateway`, `settings.appearance`, `settings.diagnostics`, `settings.about`
- `experimental`: `navigation.secrets`, `workspace.mcp_server`, `assistant.multi_agent`, `settings.experimental`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug`
- `disabled`: `workspace.claw_hub`, `workspace.connectors`, `workspace.account`, `assistant.local_runtime`, `settings.account_access`, `settings.vault_server`, `settings.gateway_setup_code`, `settings.agents`

### Desktop

- `stable`: `navigation.assistant`, `navigation.tasks`, `navigation.skills`, `navigation.nodes`, `navigation.agents`, `navigation.secrets`, `navigation.ai_gateway`, `navigation.settings`, `assistant.direct_ai`, `assistant.local_gateway`, `assistant.relay_gateway`, `assistant.file_attachments`, `assistant.local_runtime`, `settings.general`, `settings.workspace`, `settings.gateway`, `settings.appearance`, `settings.diagnostics`, `settings.about`
- `beta`: `assistant.multi_agent`
- `experimental`: `navigation.mcp_server`, `settings.experimental`, `settings.experimental_canvas`, `settings.experimental_bridge`, `settings.experimental_debug`
- `disabled`: `navigation.claw_hub`, `navigation.account`, `workspace.claw_hub`, `workspace.connectors`, `settings.account_access`, `settings.vault_server`, `settings.gateway_setup_code`, `settings.agents`

### Web

- `stable`: `navigation.assistant`, `navigation.tasks`, `navigation.skills`, `navigation.nodes`, `navigation.secrets`, `navigation.ai_gateway`, `navigation.settings`, `assistant.direct_ai`, `assistant.relay_gateway`, `assistant.file_attachments`, `assistant.multi_agent`, `assistant.local_gateway`, `settings.general`, `settings.gateway`, `settings.appearance`, `settings.about`
- `disabled`: `assistant.local_runtime`, `settings.account_access`, `settings.vault_server`, `settings.gateway_setup_code`