xworkmate-app/docs/plans/xworkmate-ui-feature-matrix.md
2026-05-27 15:10:07 +08:00

86 lines
7.3 KiB
Markdown

# XWorkmate UI Feature Matrix
> 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 | 可见 Tier | 说明 |
| --- | --- | --- |
| `debug` | `stable, beta, experimental` | 内部开发与功能联调 |
| `profile` | `stable, beta` | 预发布验收与性能验证 |
| `release` | `stable` | 面向用户交付的正式版本 |
`release_policy` 是全局上限;单个 flag 还必须同时满足 `enabled: true` 和自身 `build_modes` 才会真正出现在 UI 中。
## Snapshot Summary
| 平台 | Flag 总数 | 已启用 | Stable | Beta | Experimental | Disabled |
| --- | --- | --- | --- | --- | --- | --- |
| `mobile` | 15 | 14 | 10 | 0 | 4 | 1 |
| `desktop` | 15 | 14 | 11 | 0 | 3 | 1 |
| `web` | 15 | 8 | 8 | 0 | 0 | 7 |
| `total` | 45 | 36 | 29 | 0 | 7 | 9 |
## Mobile
| 模块 | Flag | 状态 | Tier | Build Modes | UI Surface | 说明 |
| --- | --- | --- | --- | --- | --- | --- |
| `navigation` | `assistant` | enabled | `stable` | `debug, profile, release` | `mobile_shell` | Mobile assistant destination |
| `navigation` | `settings` | enabled | `stable` | `debug, profile, release` | `mobile_shell` | Mobile settings destination |
| `assistant` | `direct_ai` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Mobile direct AI assistant mode |
| `assistant` | `local_gateway` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Mobile local gateway assistant mode |
| `assistant` | `relay_gateway` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Mobile relay gateway assistant mode |
| `assistant` | `file_attachments` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Mobile file attachment action in assistant composer |
| `assistant` | `multi_agent` | enabled | `experimental` | `debug, profile, release` | `assistant_page` | Mobile multi-agent assistant controls |
| `assistant` | `local_runtime` | disabled | `experimental` | `-` | `assistant_page` | Mobile does not expose desktop runtime controls |
| `settings` | `gateway` | enabled | `stable` | `debug, profile, release` | `settings_page` | Mobile bridge and integration settings |
| `settings` | `archived_tasks` | enabled | `stable` | `debug, profile, release` | `settings_page` | Mobile archived task management |
| `settings` | `account_access` | enabled | `stable` | `debug, profile, release` | `settings_page` | Mobile account access settings |
| `settings` | `vault_server` | enabled | `stable` | `debug, profile, release` | `settings_page` | Mobile vault server settings |
| `settings` | `experimental_canvas` | enabled | `experimental` | `debug, profile, release` | `settings_page` | Mobile experimental canvas host toggle |
| `settings` | `experimental_bridge` | enabled | `experimental` | `debug, profile, release` | `settings_page` | Mobile experimental bridge toggle |
| `settings` | `experimental_debug` | enabled | `experimental` | `debug, profile, release` | `settings_page` | Mobile experimental debug runtime toggle |
## Desktop
| 模块 | Flag | 状态 | Tier | Build Modes | UI Surface | 说明 |
| --- | --- | --- | --- | --- | --- | --- |
| `navigation` | `assistant` | enabled | `stable` | `debug, profile, release` | `sidebar_navigation` | Desktop assistant destination |
| `navigation` | `settings` | enabled | `stable` | `debug, profile, release` | `sidebar_navigation` | Desktop settings destination |
| `assistant` | `direct_ai` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Desktop direct AI assistant mode |
| `assistant` | `local_gateway` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Desktop local gateway assistant mode |
| `assistant` | `relay_gateway` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Desktop relay gateway assistant mode |
| `assistant` | `file_attachments` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Desktop file attachment action in assistant composer |
| `assistant` | `multi_agent` | disabled | `beta` | `-` | `assistant_page` | Desktop multi-agent assistant controls hidden by default |
| `assistant` | `local_runtime` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Desktop local runtime and gateway orchestration controls |
| `settings` | `gateway` | enabled | `stable` | `debug, profile, release` | `settings_page` | Desktop bridge and integration settings |
| `settings` | `archived_tasks` | enabled | `stable` | `debug, profile, release` | `settings_page` | Desktop archived task management |
| `settings` | `account_access` | enabled | `stable` | `debug, profile, release` | `settings_page` | Desktop account access settings |
| `settings` | `vault_server` | enabled | `stable` | `debug, profile, release` | `settings_page` | Desktop vault server settings |
| `settings` | `experimental_canvas` | enabled | `experimental` | `debug, profile, release` | `settings_page` | Desktop experimental canvas host toggle |
| `settings` | `experimental_bridge` | enabled | `experimental` | `debug, profile, release` | `settings_page` | Desktop experimental bridge toggle |
| `settings` | `experimental_debug` | enabled | `experimental` | `debug, profile, release` | `settings_page` | Desktop experimental debug runtime toggle |
## Web
| 模块 | Flag | 状态 | Tier | Build Modes | UI Surface | 说明 |
| --- | --- | --- | --- | --- | --- | --- |
| `navigation` | `assistant` | enabled | `stable` | `debug, profile, release` | `web_shell` | Web assistant destination |
| `navigation` | `settings` | enabled | `stable` | `debug, profile, release` | `web_shell` | Web settings destination |
| `assistant` | `direct_ai` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Web direct AI assistant mode |
| `assistant` | `local_gateway` | disabled | `experimental` | `-` | `assistant_page` | Web does not expose local gateway controls |
| `assistant` | `relay_gateway` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Web relay gateway assistant mode |
| `assistant` | `file_attachments` | enabled | `stable` | `debug, profile, release` | `assistant_page` | Web file attachment action in assistant composer |
| `assistant` | `multi_agent` | disabled | `experimental` | `-` | `assistant_page` | Web multi-agent controls disabled |
| `assistant` | `local_runtime` | disabled | `experimental` | `-` | `assistant_page` | Web does not expose local runtime controls |
| `settings` | `gateway` | enabled | `stable` | `debug, profile, release` | `settings_page` | Web bridge and integration settings |
| `settings` | `archived_tasks` | enabled | `stable` | `debug, profile, release` | `settings_page` | Web archived task management |
| `settings` | `account_access` | enabled | `stable` | `debug, profile, release` | `settings_page` | Web account access settings |
| `settings` | `vault_server` | disabled | `experimental` | `-` | `settings_page` | Web vault server settings disabled |
| `settings` | `experimental_canvas` | disabled | `experimental` | `-` | `settings_page` | Web experimental canvas host toggle disabled |
| `settings` | `experimental_bridge` | disabled | `experimental` | `-` | `settings_page` | Web experimental bridge toggle disabled |
| `settings` | `experimental_debug` | disabled | `experimental` | `-` | `settings_page` | Web experimental debug runtime toggle disabled |