feat: Admin/Workbench 双入口架构

- 抽取 ConsoleShell 共享外壳（Layout/Header/Sider/主题切换/侧边栏折叠）
- Sidebar 纯化为接受 menuItems prop 的展示组件
- Admin 管理台：/ 总览 + /projects 项目管理
- Workbench 工作台：/workbench/:projectId 项目作用域
- WorkbenchProjectGate 入口守卫（loading/error/archived/不存在拦截）
- ProjectContext 提供当前项目上下文
- 项目管理表格 active 行增加'进入工作台'按钮
- 项目名称 trim 后最多 10 字符（前后端一致）
- Workbench 总览页展示项目 Descriptions
- Header 区分：管理台显示副标题，工作台显示项目名 + 返回管理台按钮
- 28/28 前端测试通过
- 文档更新：frontend.md ConsoleShell 规范、usage.md 双入口说明

docs/development/frontend.md

@@ -120,6 +120,17 @@ token 和 CSS 变量规则：
 
 ## 运行时外壳规范
 
+前端提供两个入口外壳，共享通用 Console Shell 组件：
+
+- **Admin（管理台）**：`src/web/consoles/admin/AdminConsoleLayout.tsx`，菜单配置在 `menu.tsx`，路由 `/` 和 `/projects`。
+- **Workbench（工作台）**：`src/web/consoles/workbench/WorkbenchProjectGate.tsx` → `WorkbenchConsoleLayout.tsx`，菜单配置和路由构造在 `routes.ts`，路由 `/workbench/:projectId`。
+
+通用 Console Shell（`src/web/components/ConsoleShell/ConsoleShell.tsx`）包含 Layout、Header、Sider、Content、主题切换、版本展示和侧边栏折叠状态，由 Admin 和 Workbench 复用。Header 显示品牌名、版本号和控制台标题（Admin 显示"管理台"，Workbench 显示"工作台 · 项目名"）。
+
+Sidebar（`src/web/components/Sidebar/index.tsx`）是纯展示/导航组件，通过 `menuItems` props 接收菜单配置，由调用方决定菜单内容和路径。Admin 传入静态路径 `/`、`/projects`；Workbench 通过 route builder（`buildWorkbenchPath`）将相对菜单路径拼成 `/workbench/:projectId` 的子路径。
+
+Workbench 项目上下文通过 `ProjectContext` 提供，在 `WorkbenchProjectGate` 中从 URL path param 读取 `projectId`，通过 `useProject(projectId)` 加载项目，仅 active 项目渲染工作台布局，不存在或 archived 项目显示"项目不存在或不可访问"。
+
 - 生产入口必须启用 `ErrorBoundary`，运行时渲染异常使用 antd `Result status="500"` 或等价组件展示。
 - `ReactQueryDevtools` 仅在 `import.meta.env.DEV` 条件下渲染，不进入生产渲染路径。
 - 主题切换统一通过 `ConfigProvider` 的 antd theme algorithm 控制，不使用硬编码主题色。

docs/user/usage.md

@@ -32,9 +32,17 @@ bun run dev config.yaml
 
 ## 功能介绍
 
-| 功能     | 路径        | 说明                                 |
-| -------- | ----------- | ------------------------------------ |
-| 仪表盘   | `/`         | 应用总览，展示运行时元信息           |
-| 项目管理 | `/projects` | 创建、编辑、归档、恢复和永久删除项目 |
-| 用户管理 | `/users`    | 页面建设中                           |
-| 系统设置 | `/settings` | 页面建设中                           |
+| 功能       | 路径                    | 说明                                     |
+| ---------- | ----------------------- | ---------------------------------------- |
+| 总览       | `/`                     | Admin 管理台总览，展示运行时元信息       |
+| 项目管理   | `/projects`             | 创建、编辑、归档、恢复和永久删除项目     |
+| 工作台总览 | `/workbench/:projectId` | Workbench 工作台总览，按项目维度查看信息 |
+| 用户管理   | `/users`                | 页面建设中                               |
+| 系统设置   | `/settings`             | 页面建设中                               |
+
+平台提供两个入口：
+
+- **Admin（管理台）**：全局管理视角，包含总览和项目管理。默认入口，访问 `/` 即可进入。
+- **Workbench（工作台）**：项目维度视角，通过 `/workbench/:projectId` 进入指定项目的工作台。URL 可保存为浏览器书签，下次直接进入。仅 active 状态的项目可进入工作台，archived 项目不可访问。
+
+从项目管理页面的 active 项目行可点击"进入工作台"跳转到对应项目的工作台。