前言¶

DSH（DeepSeek Harness）的扩展思路是「一切皆插件」。对 Web 客户端的使用来说，长对话中的提问回溯、内容列宽度调整、Markdown 标题定位，都属于会影响阅读效率的细节问题。dsh-chat-tools 是 DSH Web 客户端插件，package.json 中显示版本为 0.1.0，许可证为 MIT，仓库路径为 Free-corner/dsh-chat-tools，可作为维护线索。它在右上角增加宽度与位置控件、提问历史菜单，并在对话区与文件预览区提供 Markdown 大纲横条。下面介绍它的功能、安装方式和典型用法。

这是什么¶

dsh-chat-tools 是一个 Web 客户端插件。package.json 中 dsh.client.platform 为 web，dsh.bundle.patch 为 ./cordis.patch.yml。它主要提供三类能力：

• 对话内容列宽度按百分比调节，并支持居中或靠左显示。
• 提问历史带序号、按对话顺序排列，并支持按钮或快捷键跳转。
• 对 Markdown 标题生成大纲横条，覆盖对话区和 better-sidebar 等文件预览区。

核心功能¶

对话列宽度与位置¶

在右上角可以做两个调整：

• 宽度：使用滑块按百分比调节对话内容列宽度。0% 为默认宽度，100% 为占满内容区且避开左侧大纲区。
• 位置：选择内容居中或靠左显示。靠左时自动避开左侧大纲区，不会相互覆盖。

这些设置会自动保存到浏览器本地。

提问历史¶

提问历史位于右上角「提问历史」下拉菜单。已核实的能力包括：

• 每个提问带序号，按对话顺序排列，最新提问在底部。
• 打开菜单时自动定位到最新提问。
• 顶部提供 ↑ 上一个 / ↓ 下一个 按钮，也可以使用快捷键 Ctrl+↑ / Ctrl+↓ 在提问间跳转。
• 点击任意历史条目，会跳转到对话中的对应位置。
• 菜单左边缘可拖拽调整宽度，底边缘可拖拽调整高度；设置会持久化。
• 提问记录按会话持久化保存，服务重启后仍在；跨会话按会话 ID 分别保存。
• 早期内容未加载时显示为「未加载」。点击后会分页加载更早内容，并跳转到对应位置；资料提到有上限保护，不会拖垮浏览器。

Markdown 大纲目录¶

当内容包含 Markdown 标题时，插件会用大纲横条展示结构：

• 针对当前回答的 #~###### 标题生成横条，横条长度随标题层级递减。
• 鼠标移入大纲横条区域时弹出完整大纲。
• 点击大纲条目会跳转到对应标题。
• 在 better-sidebar 等文件预览的 Markdown 渲染中，大纲横条显示在预览区右边缘，功能相同。
• 大纲横条仅在内容包含标题时显示；无标题内容不打扰。

安装与启用¶

手动安装¶

资料将插件市场安装状态标注为「待收录」，因此这里给出手动安装方式。先执行：

dsh plugin --profile web add dsh-chat-tools

这一步会把 dsh-chat-tools 加入 web profile。

然后在 cordis.patch.yml 中加入：

- insert:
    - id: dsh-chat-tools
      name: 'dsh-chat-tools'

这段配置用于声明插件条目。

最后重启 dsh web 生效。

本地开发安装¶

如果需要在本地开发环境中使用，执行：

pnpm add "file:/path/to/dsh-chat-tools"

之后同样在 cordis.patch.yml 中加入上面的 dsh-chat-tools 配置，并重启 dsh web。

典型用法¶

调节对话列¶

1、打开 DSH Web 客户端。
2、在右上角使用宽度滑块按百分比调节对话内容列宽度。0% 为默认宽度，100% 为占满内容区且避开左侧大纲区。
3、使用位置选项选择内容居中或靠左显示；靠左时自动避开左侧大纲区。

浏览提问历史¶

1、打开右上角「提问历史」下拉菜单。
2、查看带序号的提问列表，列表按对话顺序排列，最新提问在底部。
3、打开菜单后会自动定位到最新提问。
4、使用顶部 ↑ 上一个 / ↓ 下一个 按钮，或快捷键 Ctrl+↑ / Ctrl+↓ 在提问间跳转。
5、点击任意历史条目，跳转到对话中的对应位置。
6、拖拽菜单左边缘调整宽度，拖拽底边缘调整高度；设置会持久化。

使用 Markdown 大纲¶

1、当回答包含 Markdown 标题时，查看对话区中的大纲横条。
2、鼠标移入大纲横条区域，弹出完整大纲。
3、点击大纲条目，跳转到对应标题。
4、在 better-sidebar 等文件预览中查看 Markdown 文件时，大纲横条显示在预览区右边缘，操作方式相同。

适用场景与注意¶

比较适合以下使用方式：

• 使用 DSH Web 客户端处理较长对话。
• 需要频繁回溯某一次提问的位置。
• 在文件预览中浏览 Markdown 标题结构。
• 习惯用序号和快捷键完成导航。

使用前注意：

• 插件市场状态在资料中标注为「待收录」，本文不展开市场一键安装步骤。
• 手动安装或本地开发安装后，都需要重启 dsh web 生效。
• 宽度、位置、菜单尺寸等设置自动保存到浏览器本地。
• 提问历史按会话 ID 分别保存；早期内容未加载时显示为「未加载」，点击后分页加载，并带有上限保护。
• 大纲横条只在内容包含 Markdown 标题时显示。
• 插件会运行在当前 dsh 客户端进程中。安装前应检查源码、依赖和许可证；本插件许可证为 MIT。
• 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应把它理解为官方应用商店。

结尾¶

dsh-chat-tools 的价值比较集中：把对话列布局、提问历史跳转、Markdown 标题定位整理到 Web 客户端的固定控件里。它适合日常使用 DSH Web 客户端、经常浏览长对话或 Markdown 文件的开发者。已核实资料未给出目录页 URL；仓库地址如下：

https://github.com/Free-corner/dsh-chat-tools