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

sidebar_position, title, sidebar_label, description

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

信息架构与页面原型

导航结构

桌面端：

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

移动端底部导航：

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

移动端“空间”内使用分段标签切换 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 不直接硬编码在组件中。