tkmind_go/documentation/docs/guides/mindspace/03-ux-and-pages.md

---
sidebar_position: 4
title: Information Architecture and Pages
sidebar_label: UX and Pages
description: MindSpace navigation, page specifications, card fields, states, and mobile behavior
---

# 信息架构与页面原型

## 导航结构

桌面端：

```text
聊天
我的空间
  首页
  OA 工作区
  私人区
  公开区
  页面草稿
  发布记录
模板中心
发布中心
安全中心
设置
```

移动端底部导航：

```text
首页 / 空间 / 生成 / 发布 / 我的
```

移动端“空间”内使用分段标签切换 OA、私人、公开和草稿，避免展示深层目录树。

## 全局交互规则

- 页面必须支持桌面和移动端。
- 列表默认使用卡片视图，可选文件列表视图。
- 删除、下线、覆盖版本、公开发布和处理高风险内容需要确认。
- 所有异步任务展示排队、处理中、成功、失败和可重试状态。
- 所有表单保留未提交内容，离开时提示。
- 操作按钮根据权限和状态显示，不能只在点击后返回 403。
- 错误提示使用可行动语言，并保留稳定错误码用于支持排查。

## 1. 登录和注册页

### 目标

完成账号创建和认证，并在注册成功后自动初始化个人空间。

### 字段

- 用户名
- 个人 URL slug
- 邮箱
- 密码
- 确认密码
- 服务条款和隐私政策确认

### 行为

- 即时检查用户名、邮箱和 slug 是否可用。
- 显示密码要求。
- 注册成功后创建 Space、默认分类和免费套餐配额。
- 初始化失败时不得留下可登录但无空间的半成品账号；需要事务或补偿任务。

### 状态

- 初始
- 校验中
- 提交中
- 字段冲突
- 注册成功
- 账号冻结或禁用

## 2. 聊天页保存入口

### 布局

左侧导航增加“我的空间”和“发布中心”。AI 消息操作区增加：

- 保存为页面
- 生成分享页
- 保存到 OA
- 发布到主页

### 保存为页面流程

1. 点击消息操作。
2. 打开侧边面板。
3. 自动带入标题建议、摘要、来源会话和消息 ID。
4. 选择模板和目标分类。
5. 生成草稿。
6. 跳转页面预览。

### 约束

- 只保存必要的消息快照，不把整个会话暴露给公开页面。
- 工具输出引用的文件必须重新授权并复制到页面资源中。
- 消息仍在流式生成时禁用保存。

## 3. 我的空间首页

### 顶部

- 头像、用户名、套餐。
- 已用容量、总容量和进度条。
- 上传文件、新建页面、从聊天生成、发布中心。

### 快捷入口

- OA 工作区及文件数。
- 私人区及风险提示。
- 公开区及在线页面数。
- 页面草稿及待处理数量。

### 内容区

- 最近生成。
- 待继续编辑。
- 最近发布。
- 风险待处理。

### 首页原则

- 优先展示成果和下一步操作。
- 文件数量是辅助信息。
- 空状态提供示例模板和明确入口。

## 4. 页面卡片流主页

### 筛选

- 全部
- 公开
- 私有
- 草稿
- OA
- 图片
- HTML
- 报告

### 卡片字段

- 封面或缩略图
- 标题
- 页面或资产类型
- 来源：聊天、上传、模板、手动
- 状态：公开、私有、密码、草稿、过期、下线
- 浏览量
- 更新时间
- 风险标识

### 卡片操作

- 预览
- 编辑
- 发布
- 复制链接
- 下线
- 移动
- 归档
- 删除

移动端将次要操作收纳到操作菜单，保留预览和编辑为主操作。

## 5. 文件上传页

### 输入

- 拖拽或选择一个或多个文件。
- 目标分类：OA、私人、公开。
- AI 处理方式：仅保存、自动总结、生成页面、提取表格、识别图片。

### 上传前

- 显示文件名、类型、大小和总容量。
- 检查单文件限制和剩余配额。
- 私人区显示安全说明。
- 公开区上传 HTML 时显示严格限制。

### 上传中

- 每个文件独立进度。
- 支持取消和失败重试。
- 成功上传后展示 AI 任务状态。

### 上传后

- 查看资产。
- 继续 AI 处理。
- 生成页面。
- 返回空间。

## 6. OA 工作区页

### 功能

- 卡片和列表切换。
- 类型、时间、处理状态筛选。
- 上传、批量处理、移动、删除。
- 对单个资产执行总结、分析、生成报告和生成页面。

### 列表字段

- 名称
- 类型
- 大小
- AI 状态
- 更新时间
- 来源
- 操作

### 批量行为

- 批量操作必须创建 Agent job 并展示资产数量和权限范围。
- 批量删除和移动需要确认。

## 7. 私人区页

### 视觉和交互

- 明确标识高风险区域。
- 默认隐藏敏感预览。
- 下载、预览、Agent 读取和生成副本都记录审计。

### 功能

- 上传和分类。
- 风险扫描状态。
- 查看风险详情。
- 生成摘要。
- 生成脱敏副本。
- 禁止直接“发布”原资产。

### 风险卡片

- 风险等级。
- 命中类型和数量。
- 最近扫描时间和规则版本。
- 可用动作。

## 8. 公开区页

### 功能

- 展示可发布资产和已发布页面。
- 区分“可公开资产”和“线上发布记录”。
- 检查资源引用是否全部来自公开副本。
- 提供发布、重新发布、下线和复制链接。

### 空状态

- 从聊天生成。
- 从 OA 生成公开页面。
- 从私人区生成脱敏副本。
- 使用模板创建。

## 9. 页面详情页

### 头部

- 标题
- 当前状态
- 浏览量
- 更新时间
- 预览、编辑、复制链接、重新发布、下线

### 页面信息

- 分类
- 页面类型
- 来源会话
- 来源资产
- 公开地址
- 当前模板
- 当前版本

### 关联资产

- 文件名
- 类型
- 所属分类
- 是否已复制为公开资源
- 引用状态

### 发布历史

- 版本号
- 发布时间
- 发布人
- 访问模式
- 安全扫描结果
- 当前版本标识

## 10. 页面编辑与预览页

### 编辑能力

- 标题、摘要、封面和内容。
- 模板切换。
- 资源替换。
- 页面 slug。
- SEO 标题和描述在第二期提供。

### 预览

- 草稿预览使用独立 sandbox iframe。
- 提供桌面、平板和手机视口。
- 预览 URL 短期有效且要求本人认证。
- 不执行未批准的脚本和外部资源。

## 11. 发布设置页

### 访问模式

- 公开访问
- 密码访问
- 私密链接
- 限时访问
- 仅登录用户
- 仅自己可见

首期仅启用公开和仅自己可见，其他选项可以显示“即将支持”或不显示。

### 地址设置

- 用户 slug。
- 页面 slug。
- 可用性即时检查。
- 最终 URL 预览。

### 安全检查

- 身份证、手机号、邮箱、地址、金额等敏感命中。
- 外部链接和外部资源。
- 危险 HTML、脚本、iframe 和跳转。
- 私有资源引用。

### 发布动作

- 无风险：确认发布。
- 中风险：查看详情并明确确认。
- 高风险或 critical：禁止发布，要求处理后重新扫描。

## 12. 脱敏确认页

### 内容

- 文件或页面名称。
- 风险等级。
- 每类敏感信息数量和定位。
- 推荐替换结果。

### 策略

- 保留前后几位。
- 替换为星号。
- 替换为语义标签。
- 完全删除。
- 只生成摘要。
- 禁止发布。

### 输出

- 永远生成新资产和新版本。
- 显示原始资产与脱敏副本的关联。
- 生成后再次扫描。

## 13. 发布中心

### 标签

- 已公开
- 密码访问
- 私密链接
- 即将过期
- 已过期
- 已下线

### 操作

- 搜索和筛选。
- 查看统计。
- 修改访问设置。
- 重新发布。
- 下线。
- 复制链接。

## 14. 安全中心

### 功能

- 待处理风险。
- 脱敏规则。
- 最近私有文件访问。
- Agent 授权记录。
- 发布安全报告。
- 登录和分享安全事件。

用户只能查看自己的记录；管理员有独立后台入口。

## 15. 模板中心

### 模板卡片

- 封面
- 名称
- 类别
- 适用文件类型
- 示例
- 所需输入
- 使用按钮

### 首批模板

- 个人主页、简历、作品集、学习计划、家庭记录、旅行攻略。
- 周报、月报、项目总结、会议纪要、Excel 分析、招投标摘要。
- 产品介绍、活动报名、课程、门店、报价、客户案例。
- 单词学习、学习报告、错题总结、成长记录。
- 体检摘要、健康档案、用药提醒。

健康模板必须显示“不能替代医生诊断”。

## 无障碍和国际化

- 表单字段有可访问标签。
- 键盘可完成主要操作。
- 状态不能只依赖颜色。
- 对话框管理焦点并支持 Escape。
- 日期、数字、容量和时区使用本地化格式。
- 中文为首发语言，但文案 key 不直接硬编码在组件中。