Skip to content

dsh-sticky-prompt

Verified

dsh-sticky-prompt · v0.1.2 · MIT · Web UI

Pin the nearest user prompt to the top of a DeepSeek Harness transcript (DSH 0.2.x, verified 0.2.2-rc.1)

Install

dsh plugin add dsh-sticky-prompt

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

dsh-sticky-prompt

将距离当前滚动位置最近的用户提问钉在 DeepSeek Harness 对话顶部。

dsh-sticky-prompt 是 DeepSeek Harness 的独立 Web 插件。长回复往上滚时, 距离当前滚动窗口最近的那条用户提问,会收成通栏摘要钉在对话顶部。原文 气泡保持原布局;本插件不编辑消息、不 fork 会话、不恢复工作区文件。

本项目是 dsh-oil-sticky-prompt 面向 DeepSeek Harness 0.2.x(已在 0.2.2-rc.1 上验证)的重构版, 功能特性与实现效果沿用原项目。

安装

npx @deepseek-ai/dsh plugin --profile web add file:$PWD

重启 Harness,然后强制刷新浏览器。存在至少一条用户消息后滚动对话: 当某条提问滚出滚动窗口顶部时,吸顶条出现。

功能

  • 钉住最后一条越过 [data-conversation-scroll] 顶部的用户提问。
  • 覆盖 0.2.x 对话的两种用户行:data-chat-flow-kind="user"(开轮提问)与 data-chat-flow-kind="steering"(轮中插入的提问)——两者都渲染为用户气泡。
  • 只用一个覆盖条,两个话题不会互相争抢闪烁。
  • 两行截断前把原有换行压成空格。
  • 上滚时从原气泡变形为吸顶条;下滚时淡出。
  • 点击吸顶条跳回原气泡。
  • 跳过零高度行(折叠 turn-process 分组内隐藏的成员)。
  • 与 DSH 自身的顶部吸顶元素共存:吸顶条排在代码块 banner(z-index 6)与 压缩摘要头(7)之上;显示期间由运行时把 --dsh-sticky-prompt-inset 发布到滚动容器,使代码块 banner 与展开的 Think 头停在吸顶条下方,各自的复制/换行与折叠控件不再与之重叠遮挡。 吸顶条隐藏时该变量未设置,DSH 自身的 top: 0 照常生效。

不做什么

  • 不替换 UserStyleBubble,不替换会话头。
  • 不编辑、回滚或 fork 会话日志。
  • 不持久化设置:没有设置卡片,没有 Host 存储。

兼容性

面向 DeepSeek Harness 0.2.x(已在 0.2.2-rc.1 上验证):

  • 没有 @deepseek-ai/dsh-* peer 依赖,无需版本豁免即可通过 0.2.x 的插件 兼容性门禁(原插件依赖的 @deepseek-ai/dsh-client-runtime 已在 0.2.x 中移除;本插件客户端完全自包含)。@deepseek-ai/cordis peer (^4.0.1)覆盖当前 DSH 内置的 cordis 4.1。
  • 客户端产物按当前 window.__ModuleLoader__.load 闭包工厂契约注册,与 DSH 自带客户端包完全一致。
  • 用户气泡优先通过稳定的 data-message-bubble 属性定位 (UserMessageBubble,DSH 自身测试也用它);找不到时回退到 CSS modules 类名匹配,同时覆盖两种生成形态([hash]_[local] 后缀形式用 [class$="_bubble"],lightningcss 的 _<local>_<hash> 前缀形式用 [class^="_bubble_"]),再找不到时以整行作为变形起点。

安装时若 profile 根未声明 @deepseek-ai/cordis peer,出现 WARN Issues with peer dependencies found 属预期,不是加载失败。

开发

pnpm install
pnpm check   # 类型检查 + 测试 + 构建

源码改动后重新构建 lib/;发布树自带 lib/,安装不需要 allowBuilds。

许可

MIT —— 衍生自 oil-oil 的 dsh-oil-sticky-prompt。