Files
mesalogo 56ebd40bd8 feat: unify execution and add workspace file imports
Remove Ask/Execute modes and general product tool approvals so requests use the selected runtime, enabled capabilities, and execution account permissions. Migrate retired application metadata while preserving user content.

Retire the Results page while retaining conversation images and stored artifacts. Add local and remote workspace file imports, timestamps and sorting, improve image discovery and saving, and refine workspace navigation and supervision responsiveness. Include the accompanying web-search changes, tests, probes, and product documentation.

Remote imports require an updated Agent. Existing artifacts are not automatically copied into project directories. Validation evidence and outstanding failures remain documented in feature progress files; no full test suite or real-model calls were rerun for this commit.

Release note: Run requests without switching work modes, import files into a selected local or remote workspace folder, sort workspace files by date, and keep using conversation images after removal of the Results page.
2026-10-04 20:02:59 +08:00

32 KiB

应用导航与系统工具入口 User Stories

文档信息

项目 内容
状态 应用中心与本机推理监控已接入源码,整体验收待完成
版本 0.4
日期 2026-09-17
关联 PRD 应用导航与系统工具入口 PRD
关联逻辑 功能逻辑设计

1. 角色

1.1 普通用户

使用对话、笔记和知识功能,希望常用入口稳定,不需要理解工作栏实例模型。

1.2 本地工作用户

经常查看项目文件、打开终端、使用受控浏览器或检查电脑负载,希望从任意一级页面快速进入 这些工具。

2. Epic A:固定系统入口

US-A1 始终访问运行记录

作为用户,我希望运行记录保持在固定位置,以便应用入口变化后仍能检查 Agent 和工具活动。

验收:

  • Given 用户隐藏任意可选内置应用
  • When 用户查看主导航
  • Then “运行记录”仍显示在应用区之后
  • And 设置中没有隐藏、卸载或固定运行记录的选项

US-A2 从固定入口进入设置

作为用户,我希望设置入口始终位于侧栏底部,以便应用状态变化时仍能进入配置。

验收:

  • Given 任意主页面和任意侧栏宽度
  • When 用户查看侧栏底部
  • Then “设置”与“应用”为始终显示文字的独立按钮,点击区域不重叠
  • And 点击后继续遵守未保存内容的离开确认

3. Epic B:管理应用入口

本节的启用、常驻和共同设置适用于智能心跳、魔法笔记、本机推理监控;五个应用均可排序,知识库始终启用并常驻。设备共享在测试阶段默认关闭,提供启用开关,不提供常驻开关;启用后可从应用菜单和管理 Modal 打开,关闭后退出当前页面并保留目录及发布记录,旧设置缺失时默认关闭,明确启用值在重启后保留。业务验收见设备共享首期需求。心跳的默认关闭及执行边界按应用启停与执行验收,保留既有故事 ID。

US-B1 识别完整应用

作为用户,我希望魔法笔记、知识库和智能心跳显示在主导航,以便知道它们会打开完整页面。

验收:

  • Given 始终显示的应用,或已启用且常驻的可选应用
  • When 用户打开主侧栏
  • Then 应用位于“当前对话”和“运行记录”之间
  • And 点击知识库、智能心跳或魔法笔记在主内容区打开对应一级页面;本机推理监控打开保留底层工作区的 Modal,验收见 US-F3
  • And 原有待办或建议徽标按已保存的显示设置继续显示
  • And 当前对话之后按保存顺序显示应用;知识库始终显示,可调整位置,无启用或常驻开关;心跳按启用及常驻过滤

US-B2 取消低频应用常驻

作为用户,我希望隐藏不常用的内置应用,以便缩短主导航,但保留已有数据。

验收:

  • Given 应用已启用且已有内容
  • When 用户关闭该应用的“常驻左侧菜单”Switch 并保存成功
  • Then 主导航不再显示该应用,当前已打开页面保持不变
  • And 应用数据、计划和业务启停状态不变
  • And 用户可从应用中心打开该应用,或从同一设置位置恢复常驻

US-B4 保留功能启停语义

作为魔法笔记用户,我希望导航显隐与功能启停相互独立,以免整理导航时关闭功能。

验收:

  • Given 魔法笔记功能已启用
  • When 用户只取消其侧栏常驻并保存成功
  • Then 笔记及待办处理能力继续按原设置工作
  • And 重新常驻只恢复入口,不自动导航;再次打开时保留原页面状态和数据

US-B5 保持设置保存一致

作为用户,我希望应用设置保存期间和失败后各入口保持一致,以免界面与实际配置不符。

验收:

  • Given 配置已加载且没有待确认的更新
  • When 用户修改启用、常驻、顺序或魔法笔记配置
  • Then 更新串行保存,在请求确认前,应用中心、应用页及全局设置中修改这组配置的所有控件均暂不可操作
  • And 各处保留最后确认值,不提前改变导航、业务可用性、徽标或会话入口
  • When 保存成功
  • Then 各入口同时采用确认配置,后续修改基于该配置提交
  • And 工具配置写入持久化成功后也同步各入口;较新的确认快照不被迟到的读取或保存响应覆盖
  • When 关闭后重新打开应用中心
  • Then 刷新最新配置期间锁定修改,读取失败保留重试入口,不允许用旧快照提交
  • When 保存明确失败
  • Then 各入口仍使用相同的最后确认配置,操作处显示可重试错误,保留焦点和编辑上下文,不重复通知
  • Given 响应中断,无法确认保存结果
  • When 用户查看设置
  • Then 显示正在确认保存结果,重读权威配置成功后才恢复修改;读取失败可重试读取,不自动重发变更或写回旧值

US-B6 从应用中心访问内置应用

作为用户,我希望从固定应用中心找到应用,以便未常驻或已关闭的应用仍有访问和恢复入口。

验收:

  • Given 用户位于任意一级页面,包括全部可选应用均已关闭的情况
  • When 点击侧栏底部应用中心
  • Then 向上打开轻量锚定菜单,无模态遮罩;按保存顺序列出知识库和已启用的可选应用,不按打开历史或常驻筛选
  • When 点击菜单中的应用行
  • Then 菜单关闭;知识库、智能心跳和魔法笔记经既有离开检查在主内容区打开,本机推理监控打开保留底层工作区的 Modal,不自动常驻
  • When 点击菜单底部“管理应用”
  • Then 菜单关闭并打开既有管理 Modal,可按名称或用途搜索全部内置应用,包含未常驻及已关闭的可选应用
  • And 知识库行提供“打开”和排序,没有通用设置、启用或常驻开关;心跳行可管理启用和常驻,单条计划 enabled 不变
  • And 首期没有商店、推荐、安装、市场 URL、YAML 操作或系统工具入口
  • Given 应用已启用但未常驻
  • When 用户选择打开
  • Then 本机推理监控打开 Modal,底层内容无需离开;其余应用经既有未保存内容离开检查进入页面,不自动常驻
  • Given 应用已关闭
  • When 用户在管理 Modal 中找到该应用
  • Then 显示关闭状态,保留禁用的“打开”按钮,可通过“设置”进入共同设置重新开启
  • Given 搜索无匹配结果
  • Then 显示无结果及清除搜索入口,搜索不修改启用和常驻
  • Given 配置正在加载或读取失败
  • Then 中心保留加载状态或重试入口,不用默认值冒充已保存配置

US-B7 保存常驻及应用顺序

作为用户,我希望常驻和顺序按设备保存,以便重启后仍使用熟悉的导航。

验收:

  • Given 首次使用且未配置导航偏好
  • Then 默认顺序为知识库、智能心跳、魔法笔记、本机推理监控、设备共享;心跳默认关闭且保留默认常驻偏好,魔法笔记默认常驻,本机推理监控默认启用但不常驻,仍可从应用菜单打开;设备共享默认关闭,启用后只在应用菜单和管理 Modal 提供入口;侧栏只按启用与常驻过滤可选项
  • When 用户修改常驻,或通过拖动、键盘可操作的上移和下移按钮排序并保存成功
  • Then 管理列表从上到下、菜单和侧栏按同一保存顺序显示,知识库和智能心跳可移动;当前对话、运行记录及底部系统入口位置不变,重启后恢复保存结果
  • And 每行均提供上下移动,以完整保存顺序中的相邻应用为目标;未常驻及关闭应用仍可排序,设置详情不提供排序控件
  • And 搜索时箭头仍按完整顺序移动,保留未命中应用,拖动禁用;清除搜索后显示完整保存结果
  • Given 旧设置仅保存本机推理监控、魔法笔记的顺序
  • When 升级后读取设置
  • Then 知识库、智能心跳补在前面,两个可选应用保留原有相对顺序和常驻值,设备共享追加到末尾
  • Given 应用已关闭或取消常驻
  • When 用户重新开启或常驻
  • Then 按保存顺序恢复入口;关闭或取消常驻不删除顺序,已关闭应用仍可管理常驻偏好
  • Given 保存失败
  • Then 按 US-B5 保留原常驻和顺序,在操作处提供重试并保留键盘焦点
  • Given 没有可见的可选应用或仅有一个
  • Then 固定入口和应用中心仍可用,没有移动目标的排序按钮禁用,不产生空白占位项

US-B8 独立控制启用与常驻

作为用户,我希望关闭应用时保留数据和导航偏好,并能明确知道哪些业务操作已不可用。

验收:

  • Given 应用已启用
  • When 仅取消常驻并保存成功
  • Then 业务能力和后台操作保持原状,仍可从应用中心打开
  • Given 知识库已有会话关联,智能心跳已有启用或暂停的计划
  • When 用户关闭全部可选应用或修改其常驻与顺序
  • Then 知识库始终启用,侧栏位置稳定,页面可打开;知识控件及关联保持可用,请求遵守知识库自身规则,心跳单条计划 enabled 原值不变
  • And 心跳应用关闭后显示不可用状态,可从应用中心设置重新开启;新运行、在途运行及侧栏查询按应用启停与执行验收
  • Given 关闭的应用页面或本机推理监控 Modal 仍打开
  • Then 原位置显示“应用已关闭”,保留草稿及页面状态,阻止新业务操作而不强制跳转;用户从应用中心对应行的设置重新启用,监控 Modal 需先关闭
  • When 用户重新开启并保存成功
  • Then 仍停留的页面恢复可用;已离开时不自动导航,不重放或补发旧请求和任务
  • And 保留原常驻及顺序,未常驻应用不自动常驻
  • Given 启用变更保存失败
  • Then 按 US-B5 保留原业务状态和入口,不执行关闭或恢复副作用

US-B9 迁移魔法笔记共同设置

作为魔法笔记用户,我希望在应用中心统一管理笔记设置,并在升级后保留已有选择。

验收:

  • Given 用户从应用中心的魔法笔记行进入设置
  • Then 显示笔记设置表单;笔记页面不提供重复入口,也不保留“显示魔法笔记入口”开关
  • And 全局设置不再显示魔法笔记页签或跳转入口,已有配置值和业务数据保持不变
  • And 启用、常驻、显示未完成待办数量分别控制业务、导航和徽标;隐藏数量不修改待办
  • Given 升级前已有明确保存的布尔值和评论选择
  • When 迁移配置并重启
  • Then 保留已有 true、false、评论单选值及业务数据;缺失导航配置时,本机推理监控默认不常驻,魔法笔记默认常驻;未配置的应用启用和笔记相关布尔项默认 true
  • And 旧入口开关若实际控制笔记启用,保留其启用含义和原值,不将其改作常驻
  • Given AI 评论方式或评论形式未配置
  • Then 分别默认“即时”和“长评 + 要点”,均为单选,不同时启用所有模式
  • When 任一入口修改配置并保存成功
  • Then 应用中心、主导航、笔记页、会话及其他设置入口同步采用确认值;保存中和失败均遵守 US-B5

4. Epic C:使用系统工具

US-C1 一键查看文件

作为本地工作用户,我希望从右侧工作栏查看文件,并保留工作区面板的目标模式。

验收:

  • Given 当前项目有有效根目录
  • When 用户展开右侧工作栏并选择已有工作区 Tab,或从“+”选择文件
  • Then 聚焦默认存在且不可关闭的工作区单实例,不创建重复实例;仅迁移或布局修复时补回缺失实例
  • And 保留跟随或固定模式,跟随模式继续按工作栏规则更新上下文
  • And 仅该实例 Tab 显示选中状态,焦点进入目录区域

US-C2 处理无效工作区

作为用户,我希望目录不可用时看到修复方法,并收到明确反馈。

验收:

  • Given 工作区面板处于跟随模式
  • And 当前项目和默认工作区均不可用
  • When 用户在右侧工作栏选择工作区 Tab 或从“+”选择文件
  • Then 工作区面板仍打开
  • And 面板说明目录不可用并提供选择或修复目录的入口
  • And 应用不静默改用其他目录
  • Given 工作区面板固定的目标已失效,即使当前项目或默认目录可用
  • When 用户选择工作区 Tab
  • Then 保留固定目标并显示该目标的修复状态,不回退到其他目录或切换为跟随模式

US-C3 快速进入终端

作为本地工作用户,我希望选择确切终端继续查看,并能通过“+”创建额外终端。

验收:

  • Given 已有终端 Tab,包括绑定其他执行空间的终端
  • When 用户选择其中一个 Tab
  • Then 仅激活该确切实例,保留执行空间、目录及历史,不按当前项目查找最近匹配实例或重新绑定
  • Given 已选 Tab 正在关闭、已退出、已中断或失败
  • Then 保留其真实状态,不因选中而重建
  • Given 当前执行空间已有正在启动或运行中的终端
  • When 用户从右侧工作栏“+”选择终端
  • Then 每次创建绑定当前执行空间的额外实例,不复用或按目标去重
  • Given 当前没有项目
  • When 用户从“+”选择终端
  • Then 创建使用本机 Home 的新终端,已有终端保持原目标和历史

US-C4 使用远程项目终端

作为远程项目用户,我希望新建终端绑定远程项目目录,以免误在本机执行命令。

验收:

  • Given 当前项目绑定托管 SSH 执行空间
  • When 用户从右侧工作栏“+”选择终端
  • Then 创建绑定该远程项目及其权威目录的额外终端
  • And 面板持续显示远程主机和工作目录
  • And 连接失败时保留远端目标、重连与诊断信息,不回退为本机终端
  • When 切换当前项目后重新选择该终端 Tab
  • Then 仍激活原远程实例,不重绑到新项目

US-C5 打开受控浏览器

作为用户,我希望从右侧工作栏使用 GoodBuddy 受控浏览器,并按需创建独立页面。

验收:

  • Given 已有浏览器 Tab,当前 Conversation 与其目标不同或没有活动 Conversation
  • When 用户选择该 Tab
  • Then 激活该确切实例,保留绑定目标、页面及导航状态,不重绑、重建或改选最近匹配实例
  • Given 当前有活动 Conversation,无论是否已有匹配实例
  • When 用户从工作栏“+”选择浏览器
  • Then 每次创建绑定当前 Conversation 的额外实例,页面和导航状态独立,同一 Conversation 内共享隔离登录上下文
  • Given 当前没有活动 Conversation,无论是否已有浏览器实例
  • When 用户从“+”选择浏览器
  • Then 创建待选择目标的空实例,不复用已有实例
  • And 以上操作均使用 GoodBuddy 受控浏览器,不打开系统默认浏览器

US-C6 查看本机资源

作为本地工作用户,我希望快速查看 CPU、内存和磁盘 IO,以便判断任务变慢是否与本机负载 有关。

验收:

  • Given 资源监控面板尚未打开
  • When 用户从右侧工作栏“+”选择资源监控
  • Then 助手工作栏创建并激活单实例资源监控面板
  • And 页面显示整机 CPU、内存、磁盘读写及 GoodBuddy 桌面进程摘要
  • And 可见活动期间每 2 秒采样一次,前次请求未结束时跳过新请求,图表最多保留 150 个真实时间样本,连续采样约 5 分钟
  • Given 资源监控实例已存在
  • When 用户选择其 Tab 或再次从“+”选择资源监控
  • Then 激活同一本机单实例,不新建重复面板
  • When 用户切换到其他工作栏 Tab、收起工作栏、隐藏窗口或最小化窗口
  • Then 资源监控停止请求新样本
  • When 用户再次显示窗口并返回资源监控
  • Then 首次采样建立区间指标基线,下一次采样开始显示 CPU 和磁盘 IO 速率
  • And 内存等瞬时指标可立即显示,基线未建立时不显示虚构零值
  • Given 某项指标在当前平台不可用
  • When 页面收到部分结果
  • Then 该指标显示“不可用”及原因,其他指标继续更新
  • Given 本次采样全部失败或超时
  • Then 显示失败原因和重试入口,保留已有历史并标明最后更新时间,不把旧值当作实时数据
  • And 失败或暂停采样期间保留真实时间缺口,不补零或伪造中间样本
  • When 可见活动期间自动重试或用户手动重试成功
  • Then 按真实采样结果恢复更新,较晚返回的失活前旧请求不覆盖当前结果

US-C7 从任意应用打开工具

作为用户,我希望在魔法笔记、知识库、智能心跳和运行记录页面也能打开系统工具。

验收:

  • Given 用户位于任意一级页面
  • When 用户展开右侧工作栏,选择已有工具 Tab 或通过“+”选择文件、终端、浏览器或资源监控
  • Then 主页面保持不变
  • And 右侧工作栏打开对应面板
  • And 工具不会覆盖主内容或伪装成一级页面
  • And 创建失败时工作栏保持展开并显示对应错误,主页面和其他实例不被清空
  • And 后台事件不自动展开工作栏或切换当前 Tab,左侧和应用中心不复制工具入口或选中状态

5. Epic D:可访问性和布局

US-D1 使用键盘管理应用与访问工具

作为键盘用户,我希望浏览和管理应用,并通过右侧工作栏访问工具,以便不依赖鼠标。

验收:

  • Given 用户使用键盘访问侧栏底部
  • Then 应用中心和设置是独立按钮,Tab 顺序与视觉顺序一致,Enter 和 Space 可激活,图标按钮有可访问名称和工具提示
  • When 打开应用中心
  • Then 入口提供菜单展开状态和控制关系,焦点进入首个可用菜单项;上下方向键循环移动,Home、End 到首尾,Enter、Space 激活
  • When 按 Escape 关闭菜单
  • Then 焦点返回应用中心入口;Tab 关闭菜单后继续正常焦点顺序,点击外部或焦点离开也关闭
  • When 选择“管理应用”
  • Then 关闭菜单并进入既有 Modal,焦点进入搜索;每行的打开、设置、排序及详情中的启用、常驻控件按正常 Tab 顺序可达,不伪装成单个菜单项;进入详情及返回时滚动归顶,返回后聚焦搜索
  • When 通过键盘修改常驻或顺序
  • Then Switch 使用共享开关语义并支持 Space,上移和下移按钮名称包含应用名,结果通过 polite 状态区播报,失败保留焦点
  • Given 用户进入右侧工作栏
  • Then Tab 选择、游标焦点、方向键及 Home、End 由工作栏负责,使用 tablist、tab、tabpanel 和 aria-selected,按确切实例表达选中状态
  • And “+”为普通按钮,工具状态纳入 Tab 可访问名称;激活后焦点进入面板,关闭工作栏后返回固定工作栏开关
  • And 焦点环不被边界裁切,应用中心及设置沿用共享浮层和原生浏览器遮挡处理

US-D2 在窄窗口访问应用中心与工作栏

作为小屏用户,我希望应用管理和工具实例在窄窗口中仍可操作。

验收:

  • Given 侧栏宽度为 220px 至 420px,或窄窗口使用侧栏抽屉
  • Then 底部应用中心和设置不重叠,不因宽度不足隐藏入口或缩小点击区域
  • When 打开应用菜单或通过“管理应用”进入 Modal
  • Then 菜单向上锚定且限制在窗口内,可内部滚动;Modal 中长名称可换行,搜索、常驻、排序、设置及重新开启入口均可达
  • And 触控不依赖悬停,工具提示保持在窗口内,点击区域符合统一规范
  • When 关闭侧栏抽屉
  • Then 焦点返回原触发按钮
  • Given 右侧工作栏有多个工具实例
  • Then Tab 单行横向滚动且“+”持续可见,工作栏停靠回流,不遮罩主页面;布局和 Tab 交互仍由工作栏负责

6. Epic E:统一工作空间菜单

US-E1 从摘要进入确切会话

对应 FR-14。用户在当前项目工作时,可从项目选择器下方 查看跨项目活动,先定位项目,再进入需要处理的会话。

  • Given 多个项目存在运行中和待处理会话,当前搜索仅匹配当前项目
  • When 打开全项目活动并悬停或键盘聚焦另一个项目
  • Then 同一菜单右栏预览该项目会话,待处理、运行中优先,最近会话最多 10 条,当前页面和会话保持原选择
  • And 分类依次为全部项目、本地、远程、消息通道;远程能力关闭时隐藏远程分类及项目,搜索跨分类,远程主机可折叠
  • When 点击项目
  • Then 进入该项目,恢复本次应用会话内上次打开的有效会话,否则选择最近会话;普通项目没有会话时新建,消息通道保持空态
  • When 点击会话
  • Then 进入该确切 Conversation ID,清除搜索、任务选择和会话菜单,窄窗口关闭侧栏
  • Given 设置页有未保存修改
  • Then 会话跳转仍需通过既有离开检查,取消离开保留设置草稿和原项目
  • Given 用户选择的确切 Conversation ID 未在内存中或已被删除
  • When 请求进入该会话
  • Then 刷新持久化会话列表后仍只查找同一 ID;刷新失败或会话不存在时显示通知并保留原页面和选择,不回退到项目最新会话或其他会话
  • Given 从项目入口打开菜单
  • Then 默认预览当前项目;点击“全部项目”恢复全局范围,“已完成”筛选列出全部完成未查看会话,不受最近 10 条限制
  • When 实际打开会话、产生新消息或活动状态变化
  • Then 菜单按最新消息与本次应用会话内访问/状态变化时间中的较晚者排序;首次状态载入和仅清除完成提醒不更新时间,悬停不改变排序
  • And 行右侧显示会话实际更新时间,中英文格式与会话侧栏一致;访问或任务状态变化不冒充会话更新时间,没有会话摘要时省略时间且不请求详情
  • When 点击与状态筛选同排的“新建会话”
  • Then 在预览项目创建,全部项目范围使用当前项目;消息通道禁用手动新建并说明自动创建规则
  • When 点击项目行独立设置按钮或左栏底部“新建项目”
  • Then 打开真实设置或创建表单;设置不触发项目切换,创建成功后经离开检查进入新项目
  • And 项目进入或新建会话已获准离开后,提交聊天视图不再次触发同一离开检查

US-E2 键盘、窄窗口与实时结束

  • Given 菜单已打开
  • Then 初始焦点进入选中分类,上下方向键与 Home、End 移动列表焦点,右方向键进入会话列表,左方向键返回预览项目或选中分类;Enter、Space 激活按钮
  • And 菜单顶部距完整入口底边 8px,短窗口内保留底部 16px 边距,列表内部滚动;入口两行仍可点击,时间与标题不重叠
  • When 按 Escape
  • Then 关闭整个工作空间菜单并恢复可用触发入口焦点,窄侧栏保持打开
  • Given 窄窗口或长列表
  • Then 两栏有清晰分隔并独立滚动,搜索框不越过左栏边界,全部项目及搜索结果按本地、远程、消息通道显示分组标题;紧凑状态筛选可横向滚动,新建按钮保持可见,触控点击项目直接进入
  • Given 当前项目已无待处理、运行中或已完成未查看会话
  • Then 显示最近会话或空态;全局无活动时第二行显示“暂无活动”,仍可打开菜单并在其中切换全部项目范围,已打开的菜单仍可使用,新活动不自动打开菜单
  • And 左上角是一个固定两行高度的按钮,项目名和全局活动共用一个键盘焦点;点击任一行都默认预览当前项目,恢复提示显示在按钮下方并关联可访问描述
  • When 点击外部、焦点离开或隐藏侧栏
  • Then 菜单关闭,后台新活动不自动重新展开
  • And Tab 可在菜单内访问搜索、分类、项目设置、创建及会话按钮,焦点离开后关闭

US-E3 完成后保留至查看

对应 FR-14,具体状态规则见活动逻辑。

  • Given 用户正在其他会话或应用中工作
  • When 本次应用会话内的运行成功完成,或已观察到的后台任务转为完成
  • Then 活动会话保留为“已完成”,全局与项目的已完成计数同步更新
  • When 从活动菜单或普通侧栏实际进入该会话的可见聊天
  • Then 清除其完成通知;没有其他活动行时第二行恢复“暂无活动”,已查看会话仍可出现在最近会话中
  • Given 聊天被设置覆盖或文档隐藏
  • When 对应运行完成
  • Then 完成通知保留,直到设置关闭且目标聊天在可见文档中显示;取消设置离开不清除通知
  • Given 目标聊天已可见且未被设置覆盖
  • When 运行成功完成
  • Then 不保留该会话的完成通知
  • Given 初始加载已完成任务历史,或任务失败、取消
  • Then 不产生新的完成通知;重载或重启也不恢复上一应用会话的通知
  • Given 同一会话仍有待处理或运行中工作
  • Then 按实时状态优先展示,只计入一个类别

US-E4 恢复归档项目并显式进入

对应 FR-14。

  • Given 用户打开项目菜单
  • When 点击左下角“已归档”
  • Then 在左栏查看和搜索已归档用户项目,右栏保持原预览;首次加载显示进度,失败提供重试及应用通知
  • When 点击某个项目的“恢复”
  • Then 项目回到原本地/远程分类,当前项目和聊天保持不变;失败保留该行并允许重试,提交期间禁止重复恢复
  • Given 恢复后的项目已有会话
  • When 返回项目列表,预览该项目并点击右下角“进入项目”
  • Then 通过离开检查后按既有规则恢复会话,不因摘要尚未刷新创建替代会话
  • Given 范围为全部项目
  • Then “进入项目”目标为当前项目,按钮提示及可访问名称包含项目名;悬停和键盘预览不导航
  • Given 远程项目功能关闭,或项目属于系统消息通道
  • Then 归档列表不提供对应恢复操作,正常消息通道分类继续可用

7. 后续需求场景

US-F1、US-F2 为后续市场计划;US-F3 至 US-F5 的本机推理监控已接入源码,当前支持边界见技术设计,验证范围见实施进度。

US-F1 连接组织应用市场

对应 FR-15。

  • Given 组织已部署提供应用市场的 ShareServer
  • When 用户配置市场 URL,并在来源要求时完成登录
  • Then 可以浏览该来源的应用目录、详情及可获取版本
  • And 市场 URL 按设备保存,重启后恢复;认证信息使用受保护凭据存储,不作为可导出配置
  • Given 市场不可达、URL 无效、登录过期或认证失败
  • When 用户访问该来源
  • Then 显示具体原因及修改地址、重新登录或重试入口,已安装和内置应用仍可打开,不静默切换公共市场或其他来源
  • Given 用户修改市场来源或开始获取应用资源
  • Then 市场配置不改变模型、应用更新及 Runtime 等独立下载源;已开始的下载保持原来源,失败不静默切源

US-F2 导入导出应用定义

对应 FR-15。

  • Given 用户需要在私有部署间迁移应用
  • When 导出应用为 YAML,并在另一台设备选择 .yml 或 .yaml 文件导入
  • Then 预览应用身份、版本、可迁移配置和依赖,凭据与业务数据不包含在导出文件中
  • When 用户确认有效定义且所需依赖已满足,导入成功
  • Then 应用目录显示导入的身份、版本和配置,可按其启用状态打开或配置,不自动启动模型或任务
  • Given 同标识应用已存在
  • When 用户查看导入预览
  • Then 可选择更新或取消,取消后原应用与配置保持不变
  • When 更新成功
  • Then 显示已确认的新定义和配置
  • When 更新失败
  • Then 显示具体原因及重试入口,保留原应用定义、版本和配置,不留下部分更新
  • Given 文件格式无效、版本不支持或离线环境缺失程序包或模型资源
  • Then 显示具体问题与补充要求,不将应用误报为可运行,也不自动启动模型或任务

US-F3 查看本机推理服务与资源

对应 FR-16。

  • Given 用户使用依赖本机模型的应用
  • When 从常驻入口、应用菜单或管理 Modal 的“打开”进入“本机推理监控”
  • Then 均打开同一管理 Modal,来源菜单或管理 Modal 关闭,底层工作区、当前项目、会话和未提交草稿保持不变
  • And 直接显示服务列表,不出现任务页签、任务历史或外部连接;知识库、智能心跳和魔法笔记仍打开主内容区页面
  • And 初始焦点进入关闭按钮,背景不可交互,Tab/Shift+Tab 在 Modal 内循环;标题与关闭按钮保持可见,正文独立滚动
  • Given 没有影响确认且没有操作提交
  • When 点击关闭按钮或按 Escape
  • Then 关闭并卸载管理 Modal,底层工作区继续显示,模型服务不停止;点击遮罩不关闭
  • And 焦点恢复到仍可用的原触发元素;原入口已移除时回到应用中心,窄侧栏已隐藏时回到侧栏开关
  • When 查看服务列表
  • Then 显示服务名、模型、引擎、简短状态及错误;共享服务只展示一次
  • Given 向量服务独立进程正在运行
  • Then 显示带 PID 和进程范围的 CPU、工作集内存;CPU 首次采样显示预热状态
  • Given 服务 worker 与宿主共享进程,或进程已退出、采样失败
  • Then 在服务行显示不能独立统计或当前不可用的原因,不展示虚构零值或借用整个应用进程指标
  • Given ASR 有活动请求但没有 Worker 就绪观测
  • Then 显示“按需运行(状态未知)”,不推断服务正在运行

US-F4 单任务取消入口(已移除)

保留故事 ID。FR-16 已收窄为服务监视,Modal 不再提供任务取消按钮。执行路径的原有取消行为和活动请求登记继续用于服务影响校验,见逻辑设计。

US-F5 管理实际执行服务生命周期

对应 FR-16;当前引擎支持清单见技术设计。 ASR 取消独立 Worker,向量停止核对所有活动请求,OCR 有活动或排队请求时拒绝释放。 运行阶段包括排队、加载和执行;当前未接入统一进度及来源项目对象关联。资源指标按服务进程统计,见 US-F3。

  • Given 多个应用共用一个由 GoodBuddy 受管子进程承载的模型服务
  • When 用户启动、停止或重启服务
  • Then 仅提供引擎实际支持的操作,按同一服务串行处理;重复请求不重复创建进程或并发执行同一服务的重启
  • And 以真实进程退出和服务就绪确认结果,不将命令已发送当作操作成功
  • Given 用户准备停止、重启或释放服务或模型
  • When 用户发起操作
  • Then 在管理 Modal 上方打开紧凑影响确认,列出使用方、任务及影响;无已登记活动任务时说明执行前再次核对,取消后不发送操作指令且运行状态不变
  • And 初始焦点进入“保留运行状态”,Tab/Shift+Tab 在确认内循环,底层管理 Modal 不可交互;Escape 只关闭确认并恢复服务操作按钮焦点,按钮不可用时回到管理 Modal
  • When 确认提交尚未完成
  • Then 禁止重复执行,确认和取消按钮均禁用,两层 Modal 都不能通过关闭按钮或 Escape 关闭
  • When 操作成功
  • Then 只关闭影响确认,管理 Modal 保持打开
  • Given 执行前出现确认清单未包含的新任务
  • Then 拒绝执行,关闭旧确认并显示错误,自动刷新状态;刷新期间或失败时禁用服务操作,再次发起操作须确认新的影响清单
  • Given 停止失败,或重启时停止成功但启动失败
  • Then 显示实际状态、原因和可重试错误,不假报已停止或已恢复;无法确认时显示未知
  • When 服务再次启动或重启成功
  • Then 已中断任务不自动重放,由来源应用显式重新发起
  • Given 模型连接由外部程序管理
  • Then 在既有模型与连接设置中查看,不将其列入本机服务或提供停止、重启
  • Given 模型在进程内运行
  • Then 仅提供引擎实际支持的加载、释放,不显示虚构 PID、进程数或进程启动停止状态
  • When 用户关闭管理 Modal、关闭管理应用或取消常驻
  • Then 模型服务运行状态不变,取消常驻不关闭当前 Modal,卸载模型文件为独立操作