npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@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。