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

94 lines
9.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 三省六部第一版方案
状态:2026-11-14 设计稿,供确认功能与交互。最新要求是“做出第一版的方案,还有 dsh-go 的样式也做给我看看”。当前交付为方案及可点击样式预览,不代表已经安装插件、创建真实会话或完成原生适配。
## 1. 第一版要解决什么
用户在现有 DSH 项目里打开“三省六部”,就能找到固定的十个角色,切到对应会话,并单独配置该角色。Web 与 dsh-go 面向同一个项目和同一套会话,不各建一套团队。普通项目和普通会话保持原来的使用方式。
第一版做到“选项目 → 打开工作台 → 启用十席 → 选角色 → 在原生会话里工作”。启用团队只建立身份和会话,不同时启动十个模型任务。复杂派工、审核门禁和自动流程留到下一版。
## 2. 已固定的边界
- 采用 DS Bot 的长期 Bot 身份、角色配置和独立会话思路;不整体安装其客户端,也不接管设置入口。
- 每项目固定十个 Bot / 十个角色主会话:丞相、中书、尚书、门下、吏部、户部、礼部、兵部、刑部、工部。没有增删编制入口。
- 角色职责全文沿用 [项目规划](project-plan.md) 中从旧代码恢复的版本;卡片只显示短摘要,详情展开后显示全文。
- 配置和上下文按项目隔离。相同角色在不同项目里使用不同 session,模型设置也分别保存。
- 中间直接使用宿主原生会话。输入、附件、历史、流式输出、停止和审批仍由宿主管理。
- 左侧只加入口,不替换工作区、项目树、会话列表、设置或其他宿主组件。
- OpenMausBot 不进入本版。
## 3. Web 交互
入口放在现有左侧功能导航中,名称“三省六部”。点击后展开右侧工作台,并保持当前项目;若没有选项目,只提示“先从左侧选择一个项目”,不猜测或自动创建项目。
工作台顶部显示当前项目和十席数量。主体采用已确认的白蓝卡片:丞相顶部居中,三省一排,六部两排;选中角色以蓝色描边。右栏支持收起和调宽,跟随宿主深浅色。
首次进入尚未启用的项目时,显示“启用此项目的十席”按钮,说明会建立十个独立会话且不会自动运行。启用途中显示实际进度;失败保留已完成绑定,重试只继续未完成项,不从头重复创建。
已启用时,点击角色直接切换原生会话;再次点击当前角色不新建会话。默认只显示角色卡和职责摘要,“角色配置”折叠为一行。展开后可选择宿主已配置的模型、支持的思考强度以及填写角色补充说明。保存只影响当前项目当前角色,不改变宿主默认模型或其他角色。每个角色是独立 session,模型由该 session 独立保存;界面不设“跟随宿主模型”选项。尚未选择时显示“请选择模型”,选择后显示实际模型名称。若新建会话时用宿主默认模型初始化,也只是一次性取值并保存为具体选择,不能随宿主或其他会话之后的改动自动变化。
未保存配置切换角色时要明确提示或保留草稿,不能悄悄丢失。运行中的角色可查看配置;第一版建议等本轮结束后再保存模型变更,避免用户误以为当前请求已换模型。
预览:[Web 三栏交互稿](../preview/index.html)。其中聊天与原工作区为布局示意,不是已嵌入的宿主组件。
## 4. dsh-go 样式和交互
这是单独的原生风格设计,不把 Web 的三列整体缩小塞进手机。
### 4.1 原生会话页
默认展示现有原生聊天。顶部显示当前角色和当前项目,提供“工作台”入口。原有工作区入口和导航继续使用宿主方式,不再造一棵项目树。点击工作台进入原生会话面板;返回会话时保留输入和滚动位置。
### 4.2 工作台面板
面板占用手机的可用宽度,采用紧凑十席卡片,仍然保留丞相、三省、六部结构。角色名称全部两字,按钮触摸面积至少 44px。点击角色选中相应会话,面板下方明确显示“进入丞相会话”等按钮;进入后收起工作台。角色详情和配置入口留在卡片下方,不把整屏变成表单。
### 4.3 角色配置页
顶部显示当前项目和角色;职责以可折叠文字展示。模型通过原生单选列表选择,实际候选来自宿主已配置目录,不让用户在手机上输入 provider/model 字符串。保存后反馈明确,不触发模型运行。
已查到的原生面板协议支持按钮、单选、开关、tabs、accordion,但不提供自由文本输入。因此第一版把角色补充说明作为只读详情,提示“请在 Web 端编辑”;不在原生样式里画一个无法兑现的文本编辑器。若后续核验到宿主独立文本编辑接口,再增加编辑能力。
窄屏按会话、工作台、配置分屏;宽屏布局如何利用更多空间,以 dsh-go 实机接口为准。本次不承诺原生左导航能加入口,也不把 GenUI 的聊天快捷入口误当成全局导航注册。
预览:[dsh-go 原生风格交互稿](../preview/dsh-go.html)。可切深浅色、选角色、进入演示会话并选择模型。图中宿主导航外壳是样式提案,模型名称为示例;没有假装已拿到 App 的真实截图。
## 5. 第一版功能范围
| 功能 | 第一版安排 | 验收要点 |
| --- | --- | --- |
| 十席身份及角色职责 | 包含 | 名称固定;职责全文与旧代码一致 |
| 项目内十个独立主会话 | 包含 | 重开不重复建会话;项目切换不串线 |
| 原生会话复用 | 包含 | 不注册主聊天替换槽,不自写聊天引擎 |
| 角色切换、职责查看 | 两端包含 | 始终落到当前项目对应 session |
| 模型和思考强度选择 | 两端规划包含 | 只显示可用选项,不改宿主默认;原生 API 接通后验收 |
| 角色补充说明编辑 | Web 包含;dsh-go 先只读 | 原生无自由文本控件时不伪造可编辑功能 |
| 浅色、深色及收起面板 | 包含 | 不污染其他插件样式 |
| 权限/审批/运行控制 | 复用宿主 | 角色称号不提升权限,不重复实现审批 |
| 自动派工、审核门禁、返工流程 | 留后续 | 先规划规则,不从官职名称推导强制流程 |
| 群聊、额外团队会话、任务大屏 | 留后续 | 第一版不额外生成第十一个团队主会话 |
| 文件安全隔离 | 遵从宿主权限 | 项目数据隔离不等于沙箱隔离,不做过度承诺 |
## 6. 接入方案及已核实事项
独立插件分为“角色与绑定服务、Web 工作台、dsh-go 原生面板”。二者读取同一项目状态,原生会话负责实际执行。不会通过读取 DS Bot 的私有状态文件来冒充兼容,也不依赖 DS Bot 前端。
宿主已有公开 workspaceRegistry、sessionController 和 systemPrompt.section。模型选择可以通过原生 Agent 的会话级 model.select 记录为会话事件;controller.selectModel 会额外改变默认模型,不能直接拿来实现项目内设置。具体证据见 [宿主契约调研](host-contract-research.md)。
会话创建不能简单当作永久幂等操作。需要先持久化计划会话 ID,先检查是否已存在,再创建缺失项;任何返回 ID 不一致或工作区附着失败,都应保留待核对记录,不能静默重试生成更多会话。
dsh-go 已有原生插件面板桥接证据,来自本机 GenUI 插件说明及实现。原生面板需要现有 dshGo bridge;GenUI 的持久状态实现另需 DSH 0.2.1-rc.2 或更新的 session-state API,这不是整个 dsh-go 的最低版本声明。原生作用域只已证实含 sessionId/messageId/callId,没有 workspaceId;需由会话反查项目。已核实的 effect 不包含会话跳转,详见 [客户端契约调研](client-contract-research.md)。本地引擎有覆盖描述,SSH/relay 场景仍取决于对应 bridge;没有桥接时显示不支持,不私自换成 WebView、补丁 App 或自动降级创建另一套 session。角色导航到指定 session 的原生 effect、插件入口位置仍需正式开发时核验。
## 7. 实现顺序与验收
1. 对照这两份样式确认第一版范围;当前交付到此。
2. 实现项目内身份及十席会话绑定,先在隔离测试目录验证创建、恢复、失败重试和跨项目隔离。
3. 接 Web 导航和右侧工作台,确认原项目树、普通会话、设置入口均未被接管。
4. 接 dsh-go 原生面板,做真实设备触摸、返回、滚动、模型选择和目标会话导航验收;本地/SSH/relay 分开报告支持情况。
5. 两个项目同时开启,分别修改工部模型;重启后确认十席不重复、配置和会话不交叉,再打包发布。
必须单独检查过期操作:切换项目后才回来的请求结果不能覆盖新项目;旧面板按钮携带的项目/session/revision 不匹配时应拒绝并要求刷新。会话被用户删除时明确标成缺失,不能把另一个普通会话绑上来。
当前没有安装/发布可用插件。仓库中早期角色/存储试写为探索文件,不作为第一版实现完成的证据;现有宿主、真实模型、用户 profile 和会话都未改动。