# dsh-ui-enhancements [English](./README.md) | 中文为 DeepSeek Harness 提供独立、克制的小型界面增强。 ## 当前功能 ### 无工作区对话点击 **新会话** 即可直接输入。输入框默认选择 **无工作区**，也可通过原有工作区选择器选择或添加工作区。工作区自己的新建会话操作仍然在对应工作区中开始。 - 对话显示在侧栏的 **无工作区** 分组中。这些是正常持久保存的 DSH 对话，沿用原生模型选择、附件、工具、历史、搜索、分支、归档和删除操作。 - **无工作区** 在侧栏、输入框的工作区按钮和选择菜单中使用一致的对话气泡图标。支持键盘展开与折叠，右侧 **+** 可新建无工作区对话。 - 发送前，悬浮或聚焦已选工作区按钮，点击 **×** 即可直接切换为 **无工作区**，并携带草稿和附件。触屏设备始终显示 **×**。此操作清除新对话的工作区选择，不会删除工作区。 - 侧栏的淡蓝色背景用于标记当前对话所属的工作区，包含 **无工作区**；折叠时仍然显示。其他分组没有常驻高亮。 - 每个新对话都有独立的真实工作目录：`/projectless/session-projectless-`，DSH home 根据当前配置档确定。不会注册工作区，也不会借用已有项目目录。可在 **设置 → 对话管理 → 无工作区** 查看存放位置；原生 **在 Finder 中打开工作区** 操作可打开该对话的目录。 - 同一浏览器标签页会复用空白草稿，刷新后也可继续使用。有消息后再点 **新会话**，则分配另一个目录；分支沿用来源对话的目录。并发点击共用一次分配；创建失败可用同一标识重试，较晚完成的创建不会打断已切换到其他对话的导航。 - 发送前，在 **无工作区** 和工作区之间切换，会通过 DSH 原生草稿流程携带文字和附件。携带的文字会同步到原生草稿存储，刷新后可恢复。未发送附件使用 DSH 的内存草稿存储，请在刷新前发送。 - 归档和恢复保持同一个目录。删除对话会移除日志和列表记录，保留生成的文件和分支；空白草稿目录也会保留，此功能不会自动删除工作文件。 - 安装 [dsh-session-workspace](https://github.com/Unintendedz/dsh-session-workspace) 后，已有对话可通过 **移动到其他工作区** 关联工作区。请先切换到其他对话，等待原会话关闭。之后的文件操作使用新工作区，已有生成文件仍留在原目录。交互参考 [Codex 的无项目对话方式](https://learn.chatgpt.com/docs/projects)，保留 DSH 原有对话控件。 ### 工作区按最近活动排列 - 默认的 **最近更新** 视图将工作区与 **无工作区** 一起按各组最近可见对话的更新时间排序。折叠分组也遵循同一规则；置顶对话不会置顶整个工作区。空工作区按创建时间排列，时间相同时保留 Host 原有顺序。 - 对话活动、归档、恢复、删除及工作区归属变化直接通过已有会话事件更新排序。重排保留分组元素、展开状态和当前草稿，无需重新加载会话列表。 - **视图选项 → 手动排序** 保留 DSH 保存的工作区顺序和工作区拖拽操作。自动排序模式关闭工作区拖拽；需要自行排列时可切换到手动排序。原生单列表对话视图不受影响。 ### 配置档插件开关打开 **设置 → 插件 → 插件列表**，即可启用或停用当前 DSH 配置档中安装的每个插件包。 - 修改会立即应用到 Host Loader，并在 DSH 重启后继续生效。刷新页面可同步浏览器插件：开关成功后会显示明确提示和刷新按钮，提醒先保存未发送的内容；插件不会自动刷新。 - 选择结果保存在该配置档 `cordis.patch.yml` 的托管区块中，保留其他设置和注释。支持行内和块状序列（行内格式可能转换为块状格式）；非法 YAML 或补丁条目会在原子替换文件前被拒绝。 - `dsh-ui-enhancements` 自身的开关保持可见但锁定为启用，避免恢复入口停用自己。 - DSH 内置运行组件仍然只读，因为停用核心服务可能导致 Web 界面或插件管理器不可用。 - 如果运行时更新失败，插件会恢复原有持久化状态，开关仍可重试。 `0.5.2` 版本需要 DSH `0.1.5-rc.1` 及其 JSONL 会话存储后端。安装后请重启 DSH，以便插件跟踪每个对话的原生生命周期。 ### 会话快捷操作悬停已有内容的会话行时，在原生菜单旁直接显示 **置顶/取消置顶**、**归档** 和 **立即删除**。 - 置顶会话保持在当前工作区分组或单列表顶部。 - Pin 偏好只保存在当前浏览器的本地存储中。 - 归档沿用 DSH 原生的非破坏性归档操作。 - 立即删除会弹出一次确认，默认聚焦 **取消**。确认后停止这个对话，删除它的所有 JSONL 日志版本、工作区记录、归档记录和搜索记录，并通过 DSH 的移除事件更新侧栏。操作失败会显示错误，允许重试。 - 删除仅针对这个会话，保留工作区文件、独立分支和共享附件文件。日志不会移入回收站，删除无法撤销。 - 运行中会话更新状态时，hover 按钮仍保持稳定。 - 键盘焦点和触屏设备同样可以访问这些操作。 ### 已归档对话打开 **设置 → 对话管理 → 归档对话 → 管理**，即使普通会话列表为空也可进入。设置随后关闭，管理页在 DSH 主内容区打开；点击 **返回对话** 回到当前对话。 - 紧凑行显示标题、工作区名称（或 **无工作区**）和创建日期。悬停或键盘聚焦后显示 **恢复对话** 和 **立即删除**；触屏设备始终显示操作，并提供更大的点击区域。完整工作区路径可悬停查看，也可搜索。 - 搜索匹配标题和工作区路径。选择对话后，在列表旁显示只读文本预览；窄屏切换到带返回按钮的预览页。恢复后可在完整对话中查看工具和附件。 - **恢复对话** 会取消归档，保留原工作区归属或无工作区状态。管理页保持打开，便于继续整理。 - **立即删除** 使用一次确认，默认聚焦 **取消**。删除或恢复成功只移除对应行，保留搜索和滚动位置；失败时保留该行并允许重试。两种操作均不会重新加载归档列表或全部会话。 - 恢复后再次归档的对话，会在重新打开或刷新列表时出现。较晚返回的旧列表请求仍不能把请求期间已移除的行加回来。 - 首屏使用 DSH 已有的会话头与标题缓存，不读取对话日志。缺失标题在后台每批最多补读八条，同一条并发读取会合并；补读标题保留在 Host 内存中，一分钟后在后台检查日志版本；未变化的日志不会重复读取。检查期间保留已知标题，Host 重启后重新补读时也不会把已显示的标题换成加载提示。再次进入时保留现有列表并检查变化；点击 **刷新** 可重试读取失败的记录。 - 只显示 Host 的真实归档记录，不包含 `dsh-conversation-tree` 折叠隐藏的版本。缺失或不可读取的记录仍保持可见；不可用记录不能恢复，可以重试文本预览或删除记录。本插件不添加 Agent 工具，不创建对话副本。补全标题可能读取会话日志；只有选择对话时才把消息文本发送到浏览器。浏览器内存最多保留三份文本预览，插件卸载时清空。 ### 兼容性 DSH `0.1.5-rc.1` 没有原生的恢复和删除接口。本版本复用其工作区串行写入、Agent 原生生命周期句柄、JSONL 写锁及 SQLite 搜索清理。升级 DSH 前需要重新验证这些集成。如果某个会话在插件加载前已经启动，请重启 DSH。由其他 Agent 管理的子代理会话不能直接删除。无工作区功能对原生对话、侧栏组件和工作区导航服务做版本适配，保留原输入框及其子插槽。DSH 未提供分组、分组行及工作区按钮插槽，因此工作区排序、选中高亮和选择器图标也适配原生渲染函数；卸载时恢复这些适配。DSH 升级后需要重新验证这一集成。存储根目录及各对话子目录必须是真实目录，不能是符号链接。 ## 安装 ```sh dsh plugin --profile web add github:Unintendedz/dsh-ui-enhancements#v0.5.2 ``` 安装或卸载后请重启 DSH Web 服务。 ## 卸载 ```sh dsh plugin --profile web remove dsh-ui-enhancements ``` ## 开发 ```sh npm install npm test ``` `tests/browser/workspace-choice.js` 浏览器回归检查一键清除、统一图标、当前分组高亮、键盘操作和草稿转移。在全新隔离配置档中创建合成的 **Alpha Workspace** 与 **Beta Workspace** 数据后，执行 `playwright-cli run-code --filename=tests/browser/workspace-choice.js`。测试保护要求临时 DSH home 名称匹配 `dsh-workspace-choice-test-*`，并使用独立回环端口；禁止使用现有配置档。 ## 许可证 MIT