Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 55 additions & 0 deletions docs/workbench-standard.zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# 工作台开发与验收规范

本文记录工作台的产品约定,供开发、提交和验收使用。具体 SDK 接口及实现状态以对应版本的开发文档为准。

## 1. 定义与界面边界

工作台是一种面向具体工作场景的特殊插件。规范约束工作台、会话、工作区的关联关系和切换行为,不规定统一的业务面板设计。

工作台作者或用户可以定义业务面板的布局、内容、工具栏和业务操作。接入已有工作台时,优先复用原有界面和业务绑定流程,不要求加入统一顶部工具栏、会话下拉框、业务区折叠按钮或“通用聊天”按钮。

市场、工作台切换和设置等公共入口由 DSH 保留,业务面板不得遮挡。原生会话能力与模式切换沿用 Desktop 的规则。

## 2. 工作台、会话与工作区

- 一个工作台可以关联多个会话,每个会话最多归属一个工作台。
- 工作区是 DSH Desktop 的项目资料环境;每个会话如绑定工作区,最多绑定一个工作区。同一工作区内的不同会话可以属于不同工作台。
- 一个工作台可以处理多个工作区,不同工作台也可以使用同一个工作区。
- 工作台内部的档案、业务项目不等同于 DSH 工作区,不要求重复绑定。例如,玄学档案和选址项目继续使用各自原有的创建、选择流程。

## 3. 未绑定会话时的使用

打开工作台后,即使没有会话或工作区,也应立即显示业务面板。浏览、创建、选择业务档案或项目,不得以已有原生会话或工作区为前提。

仅当用户执行向 Agent 发起请求、写入会话草稿等依赖会话的操作时,才检查当前会话是否属于该工作台。尚未绑定时,在该操作处引导创建或打开会话,不阻断其他业务功能。

右侧原生会话区应支持直接新建工作区并开始对话,也支持使用已有工作区。没有已有工作区时,创建入口仍可用;选择或新建目录后,完成工作区与会话创建并关联当前工作台。取消选择不创建会话,失败可重试。实现不应默默改用无关的工作区。

先选择业务档案或项目,再创建第一条会话时,应保留当前业务选择。打开已有会话时,优先恢复该会话已有的业务映射,不被其他会话最近选择覆盖。

接入时应保留工作台原有的项目创建引导。玄学和选址工作台创建业务资料后,使用业务资料目录自动创建对应工作区和会话,保存关联,再填入开场提示词草稿;已有业务资料恢复其保存的会话,缺失时新建。用户无需先手工新建会话。工作台通过 Desktop 接口发起创建或恢复,由宿主校验并登记会话归属。业务面板不等待会话创建完成才显示。

开场提示词保留用户已输入的内容,由用户发送;会话创建失败或延迟时,待填入提示词保留用于重试。玄学原有的自动解读属于独立业务行为,不能与开场草稿混为一谈或在适配时删除;应在正确归属的会话中运行,避免隐藏工作台触发误发送。

## 4. 固定入口与切换

多个工作台可保留固定入口,支持拖动排序,同时只有一个前台工作台。打开另一个工作台时切换展示,不执行卸载重装,不停止已有后台任务。

首次进入可以显示首页或空会话状态,也可以按工作台约定初始化会话;无论哪种方式,都不能将业务面板的显示依赖于会话初始化完成。后续进入恢复最近会话。

点击会话时,如其工作台仍可用,则唤起对应工作台并打开这条会话;工作台已卸载时不自动唤起或重装。异步创建期间发生切换,不得将用户拉回旧工作台或将会话误绑到新工作台。

## 5. 提交检查

提交者声明工作台标识、版本、兼容要求和依赖能力,并提供可复现的安装及使用说明。验收重点包括:

- 全新用户没有工作区和会话时,业务面板仍可显示并完成业务资料创建、选择。
- 创建玄学档案或选址项目后,自动创建对应工作区和会话、保存关联并填入开场草稿。
- 原生会话区也能直接创建工作区和对话;取消、失败重试、重复点击都有合理结果。
- 业务资料与原生工作区独立;首次会话保留当前业务选择,已有会话恢复原有映射。
- Agent 操作仅作用于当前工作台所属会话,隐藏工作台不得向其他会话写入请求。
- 工作台固定、排序、切换和精确会话恢复符合约定,切换不停止后台任务。
- 已卸载工作台不会因打开旧会话被自动恢复;移除不误删会话和业务资料。
- 不注入强制统一的业务工具栏,不覆盖公共入口,复用已有业务界面和业务流程。

每次提交的新版本都需要验收;个人创建的工作台可以先在本地使用。GitHub 提交、官方审核及市场收录流程属于第二期,不能将本地可用等同于已通过官方收录。
Loading