会话草稿 ne-ilyxa/dsh-session-drafts

dsh-session-drafts

给 DeepSeek Harness（DSH）用的 Cursor 风格草稿会话：新建会话会复用已有的空草稿——只有当每个草稿里都写了没发出去的文字时，才会新建一个——所以空占位符永远不会越堆越多，跟 Cursor（或 Telegram）的会话列表一模一样。每个草稿都以普通一行的形式待在侧边栏树里：标题是没发出去的文字预览，带创建时间、一个铅笔标记和一层灰色底，刷新页面、重启宿主都不会丢。没有弹窗，也没有草稿菜单。

原版 web shell 会复用工作区里那个唯一的空白会话，不管你打了什么字（每个工作区只有一个空会话，你写的草稿会被悄悄丢掉），而且会把其他所有空白会话从树里藏起来。这个插件把这两种行为都换掉了。

它做什么

1. 任何新建路径上都不会堆叠空草稿。 从 harness 0.2 重构之后，新建流程落在 uiWorkspace 导航服务上，而 uiWorkspace.connectWorkspace 是所有「新建会话」入口的必经之路（侧边栏按钮、文件夹上的 ＋、Ctrl+Alt+N、首屏工作区选择器、启动时的初始选择）——所以规则就补在这个位置。连接时先跳到工作区里已有的空草稿（宿主说它没有任何已发送轮次，且输入框里也没有没发出去的文字），只有当每个草稿都被占用时，才新建一个持久会话（session.create）。原方法是被替换掉的——不是包一层——因为它那套空白复用扫描不管你有没有打字，都会复用工作区里的空白会话（每个工作区只有一个空会话，你正在写的草稿会被悄悄丢掉）。补丁里保留了按工作区去重的在途请求（快速双击会合并成一次连接），从未启用过的占位符会走原版 create 握手被接管，遇到 session/writer-held 拒绝则回落到新建。打了字的草稿就留在原地，作为自己的会话；空占位符永远不会变多。
2. 草稿作为树中的行。 原生树会隐藏除当前会话之外的空白会话，因此插件在数据层做了覆盖：在实时 store 对象上遮蔽 sessions.list.getSnapshot（保持身份稳定，HMR 安全），把每个草稿投影为 blank: false 并带上草稿标题。原生树随后会把每个草稿渲染成其工作区下的一等行——创建时间显示在尾部单元格，点击即可打开。「草稿」遵循宿主自己的判定（sessionListMetadata.blank——折叠后的前缀不包含任何轮次），这一判定在 0.2 的语义变更后依然成立：打开会话会翻转客户端的 blank 位，而打开过但从未发过提示词的草稿仍保留自己的行、预览和 ×。第一条消息发出后，草稿状态结束，该行变成普通聊天，不再受覆盖影响。投影对自身输出是幂等的（它产生的行都带有标记），因此重新捕获的 snapshot 面永远不会冻结标题。

3. 只有一个操作入口：×。 草稿是占位符，不是聊天——所有原生行控件（⋯ 菜单、行级归档/置顶按钮）都被静音，唯一的尾部控件是同一个悬停单元格里的 ×：未悬停时隐藏，灰色，16px，点一下即丢弃草稿（工作区归档——行消失，会话日志保留；当它是当前打开的草稿时，主选中项会清除）。第一条消息发出后，该行升级为普通聊天，原生控件回归。

4. 实时预览标题。 草稿的行标题就是未发送的输入框文本（Telegram 风格，折叠空白，60 字符），通过 conversation.input 实时读取，并镜像到 localStorage，让预览在重新加载后依然存在；输入框为空时显示本地化的 New Session。标题会写入树所消费的两个 summary 面——title（渲染器的行标签）和 displayTitle（归档确认与悬停复制）——并且仅覆盖层的变更会唤醒 store 的原始订阅者，因此每次按键都会让树重新设置标题。

5. 草稿的视觉标识。 草稿行获得灰色标题（主题感知的设计 token——深色下是灰配白，浅色下是柔和色配黑），并在行内空的状态槽位放一个铅笔图标，由 MutationObserver 标记绘制。行的识别依据是 0.2 渲染器打上的显式 data-row-key="session:<id>" 属性，React fiber 遍历作为回退——绝不依据文本，因为文本可能与已升级聊天的标题冲突。灰色着色直接作用于标题 span 本身（自 0.2 起，原生行 CSS 带有显式的标题颜色）。纯装饰且可自愈：如果 DOM 结构漂移，行仍能正常工作，只是失去着色。

6. 零核心改动。 实例级属性遮蔽由 Symbol.for 标记守护（跨 HMR 幂等），插件卸载时恢复，任何同步失败都回退到原生行为。不修改任何 harness 文件——安装插件即可使用。

安装

dsh plugin --profile web add link:/path/to/dsh-session-drafts
或者从已发布的副本安装：
dsh plugin --profile web add @ne-ilyxa/dsh-session-drafts

然后重启 DSH web 宿主（配置档启动时会把客户端 bundle 编进启动图；这个插件不会尝试热激活）。

发布渠道

- npm —— @ne-ilyxa/dsh-session-drafts；由维护者手动发布（npm login && npm publish --access public —— prepack 负责构建包）。CI 从不碰 registry。
- 预构建 tarball —— 推送 v 标签会触发 release.yml：检查 → pnpm pack → 把 dsh-session-drafts.tgz 附到 GitHub Release。无需 npm 也能安装，也无需 pnpm 的 allowBuilds 构建审批；应用商店更偏好这种产物。

键盘快捷键

| 快捷键 | 操作 |
| Ctrl+Alt+N | 随处新建会话 —— 规则和按钮一致：跳到空草稿，全都占用了才新建（与布局无关 —— 匹配物理 KeyN，俄语布局也支持） |

（v0.1 的 Ctrl+Alt+D 弹出层开关随弹出层一起没了。）

验证是否生效

1. 工作区下有一个空草稿时，点 New Session —— 你会落到那个空草稿上；不会新建任何东西（空占位符从不叠加）。
2. 在里面输入点内容，再点一次 New Session —— 这时会新建并选中一个全新草稿；刚输入的那个留在树里，标题改成你未发送的文本。刷新页面 —— 一切还在。
3. 悬停到草稿行 —— 其他行显示 ⋯ 的位置会出现灰色 ×；点它丢弃草稿。在某个草稿里发一条消息，它就升级成普通聊天行（⋯ 菜单回来了）。
4. 宿主真相：只在该新建时才新建 —— 会话能扛过页面刷新和宿主重启。

截图

插件在 DSH web UI 里的样子 —— 草稿住在侧边栏树中：

DSH 侧边栏中的草稿

使用草稿

开发

pnpm install
pnpm run check # typecheck + build + node --test tests/.test.mjs
pnpm run build # host no-op + browser bundle (lib/client.js, module-loader wrapped)
pnpm test:e2e # full UI flow on an isolated DSH host (needs a harness checkout + Chrome)
node scripts/capture-screens.mjs # re-shoot assets/drafts-.png against a live isolated host

E2E 冒烟测试会启动一个用完即弃的 DSH web 宿主（自带 DSH_HOME 临时配置档，并安装了这个 checkout），在无头 Chrome 里驱动真实 UI，断言宿主侧会话真相和树的 DOM。环境缺失时以退出码 0 跳过 —— 通过 E2E_DSH_ROOT（harness checkout，默认 /home/ilya/deepseek-harness）和 CHROME_PATH（默认 /usr/bin/google-chrome）配置。

目录结构：

- src/index.ts —— 宿主侧一半，刻意做成 no-op（这个包必须是可加载的 Profile Bundle；所有行为都在浏览器侧）。
- src/client/index.tsx —— 浏览器端部分：uiWorkspace.connectWorkspace 补丁（每条创建路径上的空草稿复用规则）、sessions.list 草稿投影（projectDraftList）、实时预览镜像、DOM 行标记、快捷键、中英文词典。没有 React，没有插槽 —— 草稿由原生组件树渲染。
- tests/ —— 针对构建产物的纯逻辑测试（通过 VM 加载）+ 包结构守卫；tests/e2e/ —— 隔离主机上的 UI 冒烟测试。

兼容性

各插件版本线验证过的 harness 版本：

| 插件 | DSH harness | 状态 |
| 0.7.x | 0.2.0-rc.2 | 当前版本。 已端到端验证（单元测试 + 隔离主机上的完整 UI 冒烟测试）：uiWorkspace 创建流程、sessionListMetadata 草稿真值（0.2 中已启用会话的 blank 语义）、title/displayTitle 行标签、data-row-key 行标识、置灰的行内归档/固定按钮、token 门控的 Web 界面。 |
| 0.6.x 及更早 | 0.1.x（rc.8 时代的服务形态：workspaces.startSession、带点的 RPC 名称、textarea 输入框） | 历史版本。在 0.2+ 的 harness 上，这些版本会降级：每一行草稿都标成 Untitled*，预览卡住，New Session 不再复用空草稿 —— 请升级到 0.7。 |

补丁的降级依然响亮但安全：如果运行时形态再次漂移，控制台会发出警告，对应部分保持原生行为。

License

BSD-3-Clause © ne-ilyxa