前言¶
在 DSH web 会话中,回答内容可能与思考块和工具调用内容混在一起。dsh-session-state 是一个 DSH 界面插件:默认折叠 Think 思考块和工具调用内容,让回答内容直接展示;并在会话输入框上方增加会话活动状态条,实时展示 Think / Edit / Bash / Read 的累计次数,可展开与收起。
这是什么¶
一句话:面向 DeepSeek Harness web 的界面插件,用来折叠会话中的思考与工具内容,并在输入框上方提供可展开的会话活动状态条。
仓库地址:https://github.com/Hanice404/dsh-Session-State。许可证:MIT。
目标平台是 DeepSeek Harness web(dsh --profile web),版本要求 0.1.0-rc.7 及以后。
核心功能¶
折叠思考过程¶
默认开启。隐藏会话中的 Think 思考块,让回答内容直接展示。在设置中关闭后恢复原生折叠样式。
折叠工具内容¶
默认开启。隐藏会话中的工具调用内容(Bash / Edit / Write / Read / Search / Code),与思考块一样折叠,只保留回答内容。
会话活动状态条¶
在输入框上方显示 Think / Edit / Bash / Read 四类活动的累计次数。工具条与展开面板都左右两侧对齐输入框。
展开查看内容¶
点击状态条展开后,每个类别都是一个可折叠的分区,列出该类别每次活动的实际内容,整个面板可滚动。
运行指示¶
运行中的类别带呼吸灯。prefers-reduced-motion 下自动关闭动画。
持久化¶
collapseThinking、collapseTools、statusBar 三个开关都保存在 ~/.dsh/settings.yaml 的 dsh-session-state 一节。
安装与启用¶
先确认运行在 dsh --profile web 环境,且 DSH 版本为 0.1.0-rc.7 及以后。
从 GitHub 安装¶
README 将这条命令标注为发布后:
dsh plugin --profile web add https://github.com/Hanice404/dsh-Session-State/archive/refs/heads/main.tar.gz
从本地目录安装¶
开发调试时可以使用本地目录:
dsh plugin --profile web add file:/path/to/dsh-Session-State
也可以直接在 profile 目录用 pnpm 安装:
cd ~/.dsh/profiles/web && pnpm add "file:/path/to/dsh-Session-State"
避免使用 link:¶
不要用 link: 安装本插件。本 profile 使用 nodeLinker: hoisted,link: 会生成指向插件源码目录的软链接,Node 会按软链接的真实路径解析插件内部的 @deepseek-ai/* 导入,导致:
Cannot find package '@deepseek-ai/dsh-settings'
重启 dsh web¶
安装后重启 dsh web,使浏览器端加载新插件 bundle。先 Ctrl+C 停止当前 dsh web,再运行:
dsh web
典型用法¶
直接编辑设置¶
目前 collapseThinking、collapseTools、statusBar 无独立设置页,可直接编辑 ~/.dsh/settings.yaml 的 dsh-session-state 一节:
dsh-session-state:
collapseThinking: true
collapseTools: true
statusBar: true
字段含义:
collapseThinking:默认true,折叠思考过程,直接输出回答内容collapseTools:默认true,折叠工具调用内容(Bash / Edit / Write / Read / Search / Code),直接输出回答内容statusBar:默认true,显示会话活动状态条
DSH 0.1.0-rc.7 及以上版本会自动把设置暴露给浏览器,无需额外步骤。
在界面中查看¶
状态条显示 Think / Edit / Bash / Read 的累计次数。点击状态条展开后,每个类别都是一个可折叠的分区,可以查看该类别每次活动的实际内容。运行中的类别带呼吸灯;prefers-reduced-motion 下自动关闭动画。
适用场景与注意¶
适合:
- 希望 DSH web 会话中优先看到回答内容,减少 Think 块和工具调用内容的干扰
- 需要在输入框上方查看 Think / Edit / Bash / Read 的累计次数
- 需要展开状态条查看每次活动的实际内容
注意:
- 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
- 目标平台是 DeepSeek Harness web(
dsh --profile web),版本要求0.1.0-rc.7及以后。 - 目前三个开关无独立设置页,可直接编辑
~/.dsh/settings.yaml。 - 依赖声明见
package.jsonpeerDependencies: @deepseek-ai/cordis ^4.0.1@deepseek-ai/dsh-client-ui-settings ^0.1.0-rc.6@deepseek-ai/dsh-client-ui-slots ^0.1.0-rc.6@deepseek-ai/dsh-settings ^0.1.0-rc.6@deepseek-ai/schemastery ^3.18.1react ^18.0.0
结尾¶
dsh-session-state 的价值在于把思考过程、工具调用和会话活动分成两层:回答内容直接展示,活动状态在输入框上方汇总,需要细节时再展开。
GitHub 仓库:https://github.com/Hanice404/dsh-Session-State。许可证:MIT。