dsh-session-state

DeepSeek Harness 的界面插件：折叠思考过程，直接输出回答内容；并在会话输入框上方增加一个会话活动状态条，实时展示 Think / Edit / Bash / Read 的累计次数，可展开与收起。

A UI plugin for the DeepSeek Harness: folds the thinking process so answers render directly, and adds a session-activity status bar above the composer that shows live totals for Think / Edit / Bash / Read, expandable and collapsible.

功能

状态条类别归属

计数口径：已完成的工具调用按结果节点统计，进行中的按在途调用统计，两者互斥、不会重复；思考按「已完成 + 正在流式」统计。

安装

# 从 GitHub 安装（发布后）
dsh plugin --profile web add https://github.com/Hanice404/dsh-Session-State/archive/refs/heads/main.tar.gz

# 或从本地目录（开发调试）
# 推荐 file:（复制进 profile，依赖解析正确）；link: 软链接会让插件自身的依赖解析失败
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: 安装本插件：本 profile 使用 nodeLinker: hoisted，link: 会生成指向插件源码目录的软链接，Node 会按软链接的真实路径解析插件内部的 @deepseek-ai/* 导入，导致 Cannot find package '@deepseek-ai/dsh-settings'。file: 会把插件复制进 node_modules，与 dsh-width 的安装方式一致，依赖解析正常。

安装后重启 dsh web（Ctrl+C 后重新运行 dsh web），使浏览器端加载新插件 bundle。

设置

三个开关都通过 DSH 设置系统持久化（~/.dsh/settings.yaml 的 dsh-session-state 一节）：

目前这三个开关无独立设置页，可直接编辑 ~/.dsh/settings.yaml，或在后续版本中提供图形界面。命名空间由节点端通过 settings.register() 注册，DSH 0.1.0-rc.7+ 会自动暴露给浏览器，无需额外步骤。

工作原理

• 节点端（lib/index.js）：注册 dsh-session-state 设置命名空间（三个布尔开关，默认 true），值持久化到 ~/.dsh/settings.yaml。
• 浏览器端（lib/client.js）：
  • 通过 ctx.settingsScope.bind 订阅设置；collapseThinking 开启时注入 CSS 隐藏 [data-chat-flow] [data-variant="think"]，collapseTools 开启时隐藏 bash / edit / write / read / search / code 工具行——选择器限定在聊天流内，不影响详情面板等其他表面；
  • 在 conversation.input.dock 槽位（输入框上方的整行区域）注册状态条组件；组件用 useLayoutEffect 实时测量 [data-composer-card]（输入框）相对其父容器的左偏移与宽度，把状态条左右两侧都对齐输入框（同宽、左右边缘对齐；--dsh-composer-card-max-width 变量会被 dsh-width 等插件覆盖，故不能依赖它），工具条整行与展开面板都占满输入框宽度，窗口缩放或卡片尺寸变化时自动重新对齐；
  • 组件用标准 useSession 钩子读取会话快照（nodes / partial / runningCalls / running），实时汇总四类活动的次数、运行状态与逐条内容（思考取首行摘要，工具从 argsRaw 提取命令/路径/查询），渲染为可展开/收起的胶囊；展开后是四个可折叠分区的内容面板，整面板可滚动；
  • 状态条在无活动时隐藏，会话运行中或已有累计时显示。

目录结构

dsh-Session-State/
├── package.json          # 包清单 + dsh.client 注入配置
├── dsh.plugin.json       # 插件元数据清单
├── cordis.patch.yml      # bundle 组合补丁（loader 条目）
├── lib/
│   ├── index.js          # 节点端：注册 dsh-session-state 设置命名空间
│   └── client.js         # 浏览器端：折叠思考 + 会话活动状态条
├── README.md
├── CHANGELOG.md
└── LICENSE

兼容性

• 目标平台：DeepSeek Harness web（dsh --profile web），版本 0.1.0-rc.7 及以后；
• 依赖：见 package.json peerDependencies。

License

MIT