dsh-sansheng-liubu/docs/v1-plan.md

9.2 KiB
Raw Blame History

三省六部第一版方案

状态:2026-11-14 设计稿,供确认功能与交互。最新要求是“做出第一版的方案,还有 dsh-go 的样式也做给我看看”。当前交付为方案及可点击样式预览,不代表已经安装插件、创建真实会话或完成原生适配。

1. 第一版要解决什么

用户在现有 DSH 项目里打开“三省六部”,就能找到固定的十个角色,切到对应会话,并单独配置该角色。Web 与 dsh-go 面向同一个项目和同一套会话,不各建一套团队。普通项目和普通会话保持原来的使用方式。

第一版做到“选项目 → 打开工作台 → 启用十席 → 选角色 → 在原生会话里工作”。启用团队只建立身份和会话,不同时启动十个模型任务。复杂派工、审核门禁和自动流程留到下一版。

2. 已固定的边界

  • 采用 DS Bot 的长期 Bot 身份、角色配置和独立会话思路;不整体安装其客户端,也不接管设置入口。
  • 每项目固定十个 Bot / 十个角色主会话:丞相、中书、尚书、门下、吏部、户部、礼部、兵部、刑部、工部。没有增删编制入口。
  • 角色职责全文沿用 项目规划 中从旧代码恢复的版本;卡片只显示短摘要,详情展开后显示全文。
  • 配置和上下文按项目隔离。相同角色在不同项目里使用不同 session,模型设置也分别保存。
  • 中间直接使用宿主原生会话。输入、附件、历史、流式输出、停止和审批仍由宿主管理。
  • 左侧只加入口,不替换工作区、项目树、会话列表、设置或其他宿主组件。
  • OpenMausBot 不进入本版。

3. Web 交互

入口放在现有左侧功能导航中,名称“三省六部”。点击后展开右侧工作台,并保持当前项目;若没有选项目,只提示“先从左侧选择一个项目”,不猜测或自动创建项目。

工作台顶部显示当前项目和十席数量。主体采用已确认的白蓝卡片:丞相顶部居中,三省一排,六部两排;选中角色以蓝色描边。右栏支持收起和调宽,跟随宿主深浅色。

首次进入尚未启用的项目时,显示“启用此项目的十席”按钮,说明会建立十个独立会话且不会自动运行。启用途中显示实际进度;失败保留已完成绑定,重试只继续未完成项,不从头重复创建。

已启用时,点击角色直接切换原生会话;再次点击当前角色不新建会话。默认只显示角色卡和职责摘要,“角色配置”折叠为一行。展开后可选择宿主已配置的模型、支持的思考强度以及填写角色补充说明。保存只影响当前项目当前角色,不改变宿主默认模型或其他角色。每个角色是独立 session,模型由该 session 独立保存;界面不设“跟随宿主模型”选项。尚未选择时显示“请选择模型”,选择后显示实际模型名称。若新建会话时用宿主默认模型初始化,也只是一次性取值并保存为具体选择,不能随宿主或其他会话之后的改动自动变化。

未保存配置切换角色时要明确提示或保留草稿,不能悄悄丢失。运行中的角色可查看配置;第一版建议等本轮结束后再保存模型变更,避免用户误以为当前请求已换模型。

预览:Web 三栏交互稿。其中聊天与原工作区为布局示意,不是已嵌入的宿主组件。

4. dsh-go 样式和交互

这是单独的原生风格设计,不把 Web 的三列整体缩小塞进手机。

4.1 原生会话页

默认展示现有原生聊天。顶部显示当前角色和当前项目,提供“工作台”入口。原有工作区入口和导航继续使用宿主方式,不再造一棵项目树。点击工作台进入原生会话面板;返回会话时保留输入和滚动位置。

4.2 工作台面板

面板占用手机的可用宽度,采用紧凑十席卡片,仍然保留丞相、三省、六部结构。角色名称全部两字,按钮触摸面积至少 44px。点击角色选中相应会话,面板下方明确显示“进入丞相会话”等按钮;进入后收起工作台。角色详情和配置入口留在卡片下方,不把整屏变成表单。

4.3 角色配置页

顶部显示当前项目和角色;职责以可折叠文字展示。模型通过原生单选列表选择,实际候选来自宿主已配置目录,不让用户在手机上输入 provider/model 字符串。保存后反馈明确,不触发模型运行。

已查到的原生面板协议支持按钮、单选、开关、tabs、accordion,但不提供自由文本输入。因此第一版把角色补充说明作为只读详情,提示“请在 Web 端编辑”;不在原生样式里画一个无法兑现的文本编辑器。若后续核验到宿主独立文本编辑接口,再增加编辑能力。

窄屏按会话、工作台、配置分屏;宽屏布局如何利用更多空间,以 dsh-go 实机接口为准。本次不承诺原生左导航能加入口,也不把 GenUI 的聊天快捷入口误当成全局导航注册。

预览:dsh-go 原生风格交互稿。可切深浅色、选角色、进入演示会话并选择模型。图中宿主导航外壳是样式提案,模型名称为示例;没有假装已拿到 App 的真实截图。

5. 第一版功能范围

功能 第一版安排 验收要点
十席身份及角色职责 包含 名称固定;职责全文与旧代码一致
项目内十个独立主会话 包含 重开不重复建会话;项目切换不串线
原生会话复用 包含 不注册主聊天替换槽,不自写聊天引擎
角色切换、职责查看 两端包含 始终落到当前项目对应 session
模型和思考强度选择 两端规划包含 只显示可用选项,不改宿主默认;原生 API 接通后验收
角色补充说明编辑 Web 包含;dsh-go 先只读 原生无自由文本控件时不伪造可编辑功能
浅色、深色及收起面板 包含 不污染其他插件样式
权限/审批/运行控制 复用宿主 角色称号不提升权限,不重复实现审批
自动派工、审核门禁、返工流程 留后续 先规划规则,不从官职名称推导强制流程
群聊、额外团队会话、任务大屏 留后续 第一版不额外生成第十一个团队主会话
文件安全隔离 遵从宿主权限 项目数据隔离不等于沙箱隔离,不做过度承诺

6. 接入方案及已核实事项

独立插件分为“角色与绑定服务、Web 工作台、dsh-go 原生面板”。二者读取同一项目状态,原生会话负责实际执行。不会通过读取 DS Bot 的私有状态文件来冒充兼容,也不依赖 DS Bot 前端。

宿主已有公开 workspaceRegistry、sessionController 和 systemPrompt.section。模型选择可以通过原生 Agent 的会话级 model.select 记录为会话事件;controller.selectModel 会额外改变默认模型,不能直接拿来实现项目内设置。具体证据见 宿主契约调研。

会话创建不能简单当作永久幂等操作。需要先持久化计划会话 ID,先检查是否已存在,再创建缺失项;任何返回 ID 不一致或工作区附着失败,都应保留待核对记录,不能静默重试生成更多会话。

dsh-go 已有原生插件面板桥接证据,来自本机 GenUI 插件说明及实现。原生面板需要现有 dshGo bridge;GenUI 的持久状态实现另需 DSH 0.2.1-rc.2 或更新的 session-state API,这不是整个 dsh-go 的最低版本声明。原生作用域只已证实含 sessionId/messageId/callId,没有 workspaceId;需由会话反查项目。已核实的 effect 不包含会话跳转,详见 客户端契约调研。本地引擎有覆盖描述,SSH/relay 场景仍取决于对应 bridge;没有桥接时显示不支持,不私自换成 WebView、补丁 App 或自动降级创建另一套 session。角色导航到指定 session 的原生 effect、插件入口位置仍需正式开发时核验。

7. 实现顺序与验收

  1. 对照这两份样式确认第一版范围;当前交付到此。
  2. 实现项目内身份及十席会话绑定,先在隔离测试目录验证创建、恢复、失败重试和跨项目隔离。
  3. 接 Web 导航和右侧工作台,确认原项目树、普通会话、设置入口均未被接管。
  4. 接 dsh-go 原生面板,做真实设备触摸、返回、滚动、模型选择和目标会话导航验收;本地/SSH/relay 分开报告支持情况。
  5. 两个项目同时开启,分别修改工部模型;重启后确认十席不重复、配置和会话不交叉,再打包发布。

必须单独检查过期操作:切换项目后才回来的请求结果不能覆盖新项目;旧面板按钮携带的项目/session/revision 不匹配时应拒绝并要求刷新。会话被用户删除时明确标成缺失,不能把另一个普通会话绑上来。

当前没有安装/发布可用插件。仓库中早期角色/存储试写为探索文件,不作为第一版实现完成的证据;现有宿主、真实模型、用户 profile 和会话都未改动。