From 7d18a6f537b41591c446c0a8e5b3717a4d7c95b4 Mon Sep 17 00:00:00 2001 From: Yutong Date: Mon, 14 Sep 2026 15:08:38 +0800 Subject: [PATCH 1/2] docs: clarify workbench bindings and business UI independence --- docs/workbench-standard.zh.md | 50 +++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 docs/workbench-standard.zh.md diff --git a/docs/workbench-standard.zh.md b/docs/workbench-standard.zh.md new file mode 100644 index 000000000..5ef5cd7fc --- /dev/null +++ b/docs/workbench-standard.zh.md @@ -0,0 +1,50 @@ +# 工作台开发与验收规范 + +本文记录工作台的产品约定，供开发、提交和验收使用。具体 SDK 接口及实现状态以对应版本的开发文档为准。 + +## 1. 定义与界面边界 + +工作台是一种面向具体工作场景的特殊插件。规范约束工作台、会话、工作区的关联关系和切换行为，不规定统一的业务面板设计。 + +工作台作者或用户可以定义业务面板的布局、内容、工具栏和业务操作。接入已有工作台时，优先复用原有界面和业务绑定流程，不要求加入统一顶部工具栏、会话下拉框、业务区折叠按钮或“通用聊天”按钮。 + +市场、工作台切换和设置等公共入口由 DSH 保留，业务面板不得遮挡。原生会话能力与模式切换沿用 Desktop 的规则。 + +## 2. 工作台、会话与工作区 + +- 一个工作台可以关联多个会话，每个会话最多归属一个工作台。 +- 工作区是 DSH Desktop 的项目资料环境；每个会话如绑定工作区，最多绑定一个工作区。同一工作区内的不同会话可以属于不同工作台。 +- 一个工作台可以处理多个工作区，不同工作台也可以使用同一个工作区。 +- 工作台内部的档案、业务项目不等同于 DSH 工作区，不要求重复绑定。例如，玄学档案和选址项目继续使用各自原有的创建、选择流程。 + +## 3. 未绑定会话时的使用 + +打开工作台后，即使没有会话或工作区，也应立即显示业务面板。浏览、创建、选择业务档案或项目，不得以已有原生会话或工作区为前提。 + +仅当用户执行向 Agent 发起请求、写入会话草稿等依赖会话的操作时，才检查当前会话是否属于该工作台。尚未绑定时，在该操作处引导创建或打开会话，不阻断其他业务功能。 + +右侧原生会话区应支持直接新建工作区并开始对话，也支持使用已有工作区。没有已有工作区时，创建入口仍可用；选择或新建目录后，完成工作区与会话创建并关联当前工作台。取消选择不创建会话，失败可重试。实现不应默默改用无关的工作区。 + +先选择业务档案或项目，再创建第一条会话时，应保留当前业务选择。打开已有会话时，优先恢复该会话已有的业务映射，不被其他会话最近选择覆盖。 + +## 4. 固定入口与切换 + +多个工作台可保留固定入口，支持拖动排序，同时只有一个前台工作台。打开另一个工作台时切换展示，不执行卸载重装，不停止已有后台任务。 + +首次进入可以显示首页或空会话状态，也可以按工作台约定初始化会话；无论哪种方式，都不能将业务面板的显示依赖于会话初始化完成。后续进入恢复最近会话。 + +点击会话时，如其工作台仍可用，则唤起对应工作台并打开这条会话；工作台已卸载时不自动唤起或重装。异步创建期间发生切换，不得将用户拉回旧工作台或将会话误绑到新工作台。 + +## 5. 提交检查 + +提交者声明工作台标识、版本、兼容要求和依赖能力，并提供可复现的安装及使用说明。验收重点包括： + +- 全新用户没有工作区和会话时，业务面板仍可显示并完成业务资料创建、选择。 +- 原生会话区能直接创建工作区和对话；取消、失败重试、重复点击都有合理结果。 +- 业务资料与原生工作区独立；首次会话保留当前业务选择，已有会话恢复原有映射。 +- Agent 操作仅作用于当前工作台所属会话，隐藏工作台不得向其他会话写入请求。 +- 工作台固定、排序、切换和精确会话恢复符合约定，切换不停止后台任务。 +- 已卸载工作台不会因打开旧会话被自动恢复；移除不误删会话和业务资料。 +- 不注入强制统一的业务工具栏，不覆盖公共入口，复用已有业务界面和业务流程。 + +每次提交的新版本都需要验收；个人创建的工作台可以先在本地使用。GitHub 提交、官方审核及市场收录流程属于第二期，不能将本地可用等同于已通过官方收录。 From 0def22e3f012a7ca4f94f7a524beaaf0d6821f06 Mon Sep 17 00:00:00 2001 From: Yutong Date: Mon, 14 Sep 2026 15:37:30 +0800 Subject: [PATCH 2/2] docs: preserve business-triggered session creation and interpretation --- docs/workbench-standard.zh.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/workbench-standard.zh.md b/docs/workbench-standard.zh.md index 5ef5cd7fc..20a191daa 100644 --- a/docs/workbench-standard.zh.md +++ b/docs/workbench-standard.zh.md @@ -27,6 +27,10 @@ 先选择业务档案或项目，再创建第一条会话时，应保留当前业务选择。打开已有会话时，优先恢复该会话已有的业务映射，不被其他会话最近选择覆盖。 +接入时应保留工作台原有的项目创建引导。玄学和选址工作台创建业务资料后，使用业务资料目录自动创建对应工作区和会话，保存关联，再填入开场提示词草稿；已有业务资料恢复其保存的会话，缺失时新建。用户无需先手工新建会话。工作台通过 Desktop 接口发起创建或恢复，由宿主校验并登记会话归属。业务面板不等待会话创建完成才显示。 + +开场提示词保留用户已输入的内容，由用户发送；会话创建失败或延迟时，待填入提示词保留用于重试。玄学原有的自动解读属于独立业务行为，不能与开场草稿混为一谈或在适配时删除；应在正确归属的会话中运行，避免隐藏工作台触发误发送。 + ## 4. 固定入口与切换 多个工作台可保留固定入口，支持拖动排序，同时只有一个前台工作台。打开另一个工作台时切换展示，不执行卸载重装，不停止已有后台任务。 @@ -40,7 +44,8 @@ 提交者声明工作台标识、版本、兼容要求和依赖能力，并提供可复现的安装及使用说明。验收重点包括： - 全新用户没有工作区和会话时，业务面板仍可显示并完成业务资料创建、选择。 -- 原生会话区能直接创建工作区和对话；取消、失败重试、重复点击都有合理结果。 +- 创建玄学档案或选址项目后，自动创建对应工作区和会话、保存关联并填入开场草稿。 +- 原生会话区也能直接创建工作区和对话；取消、失败重试、重复点击都有合理结果。 - 业务资料与原生工作区独立；首次会话保留当前业务选择，已有会话恢复原有映射。 - Agent 操作仅作用于当前工作台所属会话，隐藏工作台不得向其他会话写入请求。 - 工作台固定、排序、切换和精确会话恢复符合约定，切换不停止后台任务。