@mzzsfy/dsh-think-expand
v0.4.4
Published
流式回复时自动展开最新一条思考行;可选开启工具行展开机,独立自动展开最新一条工具调用等折叠行(思考与工具两台状态机互不接管);手动操作优先,插件展开收起后回补置底保持官方滚动跟随
Readme
@mzzsfy/dsh-think-expand
DeepSeek Harness 插件:流式输出思考时自动展开最新一条思考行,免去每次手点;可选「展开全部消息」模式,追加一条独立的工具行展开机(自动展开最新一条工具调用/命令卡等折叠行)。思考与工具两台状态机独立计算:思考行要看完,工具行展开可见性低,互不接管。
行为
默认仅思考模式:
| 场景 | 行为 |
|---|---|
| 流式思考行出现(data-state="running") | 自动展开该行(running 缺失时以最后一条可识别行为准) |
| 新思考行出现 | 收起上一条由插件展开的行,展开新行 |
| 用户手动展开任意行 | 插件收起自己展开的行,此后不再干预该手动行 |
| 用户手动收起插件展开的行 | 视为已读,本轮不再展开,直到下一条新思考行 |
| 流式结束(running → ok) | 保留最后一条展开状态 |
| 打开会话 / 刷新页面 / 切换会话 | 最后一条思考行自动展开,其余保持收起 |
| 自动展开后用户手动收起 | 不再重展开,直到下次打开或切换会话 |
| 用户手动展开较旧行 | 手动意图优先,插件不展开最后一条 |
| 用户收起最新回合过程组 | 该回合内容隐藏,插件不介入;过程组折叠不视为用户对行的收起 |
| 用户再次展开最新回合过程组 | 撤销该回合的收起意图,末条思考行恢复自动展开(仅最新回合;旧回合不再自动展开) |
| 用户收起步骤组 | 组内由插件展开的行视为用户收起(与行头收起同义),不再自动展开 |
| 插件展开/收起动作改变内容高度 | 动作前置底的视口在高度落定后回补置底,官方自动滚动跟随不失联;用户主动滚开则不干预 |
「展开全部消息」模式(设置卡片开关,实时生效,持久 localStorage)——追加独立的工具行展开机,思考机行为不变:
| 场景 | 行为 | |---|---| | 开关开启 | 思考机照常运行;工具机启动,自动展开最新一条可折叠工具行(工具调用/命令卡等),其余保持收起 | | 新工具行出现 | 工具机收起上一条由插件展开的工具行(手动行除外),展开新行——与思考机同形态、独立节奏 | | 用户手动收起插件展开的工具行 | 视为已读,该行不再展开;不影响思考机 | | 用户手动展开任意工具行 | 手动意图优先,工具机不展开最新一条且不收回该行 | | 打开会话 / 刷新页面 / 切换会话 | 最后一条思考行与最后一条可展开工具行各自动展开(两机独立),其余保持收起 | | 开关关闭 | 工具机停止,插件展开的工具行收回,手动展开行保留;思考机契约不变 |
卸载插件:重载页面即恢复官方默认行为;唯一残留为本插件写入的 localStorage 开关键,不被任何代码读取。
实现要点
- Think 行识别:官方 ReasoningRow 根节点字面量属性
[data-variant="think"]+data-state,折叠头[data-disclosure-row],滚动容器[data-conversation-scroll];思考正文容器按thinkBody哈希段子串匹配(折叠头摘要_content_不是正文,不读取);识别失败即不干预。 - 工具机(全部消息模式):第二状态机
planTools,独立 registry/current/manual/read,与思考机零共享状态;行根 = flowItem[data-chat-node-key]全集减思考行根(思考行在 flow 后代,按后代判定排除),可展开性按官方data-expandable标记判定(preparing 行无标记天然落选),正文按bodyWrap哈希段子串匹配;目标行 = 文档序最后一个可展开行(工具流 state 形态多样,不按 state 选行);手动识别仅在插件已展开过行后激活(首轮既存展开行视为中性,与思考机流式守卫同构)。 - 完成态恢复:回合完成后官方会隐藏整个过程组并重置子折叠(useDisclosure version 自增);扫描前检测插件仍负责的末行位于
hidden祖先内时,向祖先派发官方beforematch(与浏览器查找同入口)恢复过程可见,再按需重新展开;用户手动收起的行已解除插件所有权,不恢复。 - 最新回合过程组:回合完成折叠后官方把过程组内容置
hidden="until-found"(工具行随内容不可见)。扫描发现最新回合data-turn-process按钮收起时,先点击展开(展开成功后清除点击记录,回合完成再折叠仍可再展开);判断行决策是否整体不可见时,只看「最后一个已关闭回合按钮收起 + 没有可见的同期/更新回合行」——整段隐藏或只剩更旧回合的可见行才跳过,进行中的回合即使渲染了收起按钮、行仍可见就继续决策;用户手动收起的回合记入 manual,再次手动展开时撤销该记录,末行随之恢复自动展开。 - 首扫时机:首屏水合期间行头点击会被宿主吞掉,过早扫描会白点一次并留下假闩锁。容器就绪后延迟首扫(等首屏交互就绪),点击后再校验
aria-expanded:未提交即按固定间隔重试同一行头,重试期间暂停行决策(避免把未生效点击误判成用户收起),行元素被替换或点击提交即结束。 - 首扫去重:首扫与收尾兜底都会展开最后一条,同一拍内对同一行各点一次会把展开切换回收起。首扫/常规扫描处理完当前行集即消费兜底标记,同一拍不再对同一行二次点击。
- 无 current 接管:正文未挂载时展开的行来不及登记 current,新行紧接着出现时按"插件展开记录 + 闩锁仍在 + 非手动行"识别旧行并收起,避免同一回合内两条思考行同时展开。
- 所有权让渡:capture 阶段监听容器点击,行头的收起动作把该行所有权还给用户;步骤组头收起把组内行所有权还给用户;过程组头(
data-turn-process)按点击方向登记、最终态校正/回滚用户意图,不解除内部行闩锁——过程组折叠会隐藏行但不改变行的归属,清闩锁会让宿主折叠被误判成人对行的收起;插件自身点击经 applyingAction 屏蔽。 - 工具开关(setMode):只作用于工具机——关闭前把已收起的插件 current 行同步登记已读(不依赖 50ms 防抖),撤回插件展开并保留手动行;开启前把关闭期间用户手动展开的工具行登记 manual,不收编;思考机 registry 全程不动。
- 展开/收起模拟点击折叠头(按
aria-expanded判定),与官方组件状态机一致,不直改 DOM 内部状态;会话区不写任何 DOM 属性,设置卡片样式元素自带data-plugin标记(claimStyles/HMR 契约)。 - 行标识 = 控制器侧元素稳定 uid(WeakMap 计数),标记命中 uid 优先、已见文本前缀兜底,标记载体为模块级 Map(键为登记时文本);client 端插件展开过的行另以元素 WeakSet 记闩锁(展开记入、收起解除,会话切换重置),供决策层区分手动展开,不写 DOM 属性;全部标记随页面生命周期存活,不持久化。body 哨兵观察器常驻 document.body 监视容器身份变化(会话切换,仅 childList 通道);容器重挂后首扫抑制手动识别,既存展开行视为中性;观察器句柄挂 window 代际槽,HMR 重评估先拆上一代,防多套决策机并行同扫。
- 纯逻辑层(行分类、展开决策、标记存活性、置底判定、工具机)在
src/logic.mjs,src/client.js内嵌同源实现,node --test以同一套 BDD 场景对两份实现做 parity 验证,并逐函数对比源码文本(含内部助手)防双写漂移。 - 置底保持:官方滚动跟随以"视口贴近底部"为前提(距离底部不超过阈值判定置底),插件展开/收起改变内容高度会把置底视口推离底部,官方跟随随即失联。动作前记录置底状态,高度落定(rAF 帧计数)后偏离量可被本次高度变化解释才回补置底,用户主动滚开不干预;判定函数进纯逻辑层。
- 设置卡片:client 半区
inject: ['slots']声明式挂载(cordis inject waiting 门控,服务未就绪整体挂起即干净禁用),两代槽位并存注册(settings.plugin.item/plugins.bundle.config,context-manager 同构)。开关持久于 localStorage(dsh-think-expand:expandAll),切换实时生效;样式注入 head 带data-plugin标记,视觉走--te-*包局部 token(引用宿主--dsw-alias-*带亮色 fallback)。 - Host 半区
src/index.js为空壳,profile 行仅用于让 client 模块系统发现本包的 dsh.client 声明。
安装
dsh plugin --profile web add @mzzsfy/dsh-think-expand重启 dsh 后流式会话即生效;设置入口(0.1.6- 为设置页插件条目,0.1.7+ 为插件管理页本包条目)可切换「展开全部消息」。
升级 / 卸载
dsh plugin --profile web add @mzzsfy/dsh-think-expand # 升级到最新发布版本
dsh plugin --profile web remove @mzzsfy/dsh-think-expand # 卸载插件 Host 半区为空壳,无任何 Host 端状态;卸载后重载页面即恢复官方默认行为。旧版本开关的 settings 字段残留不影响任何行为。
测试
pnpm --dir packages/dsh-think-expand test
# 或
node --test packages/dsh-think-expand/test/*.test.mjs覆盖:上表全部行为场景、置底判定与置底回补判定(阈值边界/高度变化可解释偏离/用户滚开不回补)、uid 行身份(同开头历史行不劫持定位、已读标记不拦同开头新行)、suppressManual 首扫、批量 running 降级、识别失败降级、空正文降级、工具机场景(目标行展开/已读/手动/manual 接管不收/接管收起/preparing 跳过/无行不干预/首扫中性/双机状态隔离)、工具开关切换(双向实时/思考已读不丢/插件工具撤回恢复/手动工具保留/关闭前已读结算/开启前 manual 收编)、完成态恢复(插件末行 hidden 揭示重开/用户收起不重开)、控制器生命周期(禁用后旧观察器与计时器不动作/重启单套控制器/卸载后旧滚动帧不写滚动)、双实现 parity(场景 + 导出键守卫 + 逐函数源码对比)、client.js 语法检查与样式 data-plugin 守卫。
License
MIT
dsh 版本兼容
按仓库动态窗口验证(scripts/compat/window.mjs),不预置任何固定版本槽:主测 = 渠道 dist-tag 最新 rc,完全适配口径;基线 = npm latest,不崩溃底线口径;主测与基线同版时收敛单槽。兼容面以窗口实测为准,不逐版本承诺。逐轮实测结论见 docs/兼容性测试/逐包测试进度.md(本地维护,不入库)与本包 兼容性测试.md。
