dsh-session-active-top

DSH PLUGIN工具与能力

仓库 JohnshyCY/dsh-session-active-top · npm dsh-session-active-top

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH plugin 将正在运行的会话自动上浮到工作区会话列表顶部,并按活跃时间排序,多对话并行时也能快速切换。

一句话选型结论

按资料字段整理

dsh-session-active-top 是工具与能力类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类工具与能力 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-09 创建于 2026-11-08
README 7.0 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-session-active-top
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求>=20来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-session-active-top可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-session-active-top:让 DeepSeek Harness 的活跃会话自动排到最前

  • 运行中会话自动上浮置顶
  • 上浮块按活跃时间降序
  • 运行结束仍保留位置
  • 兼容时间与手动排序模式

适用场景

通知文件读写

上游标签

dsh-plugin

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在工具与能力场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-session-active-top当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方JohnshyCY仓库 dsh-session-active-top · 默认分支 main
分类工具与能力storage
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-08 · 2026-11-09最后推送 2026-11-09
本站收录2026-11-09首次进入本站目录的时间

README 全文

7.0 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-session-active-top

让正在运行的会话自动浮到工作区会话目录最上方,多会话来回翻找不再费劲。




特性 · 安装 · 验证 · 实现原理 · 故障排查 · 已知限制 · 反馈


快速开始

dsh plugin --profile desktop add dsh-session-active-top

装完即时生效(HMR,无需重启桌面应用):让任意会话进入运行态,它就会跳到会话目录顶部。完整说明见安装。

这是什么

DSH 工作区左侧的会话目录默认按时间或手动顺序排列。多个对话同时进行时,正在对话的那条常常沉到列表中间甚至底部,来回滚动才能找到。

本插件把处于 running 状态的会话提到所在工作区会话目录的最上方,并在它停止后保留这个位置 —— 不自动归位,方便随时切回来。它只调整显示顺序,不改动任何会话内容。

特性

  • 运行即上浮:会话一进入 running,立刻排到所在工作区目录最上方。
  • 停止不归位:浮上来后一直留在那里,运行结束也不会掉回去。
  • 块内按活跃度:上浮的会话之间按真实 updatedAt 降序,当前正在对话的那条永远在最前。
  • 不占用置顶:不写 pinnedSessionIds、不显示图钉图标;用户手动置顶的会话仍在图钉分区里更靠前,两者互不干扰。
  • 保留手动顺序:上浮块之外(你自己拖过的顺序)完全不动。
  • 刷新 / 重启仍在:位置写入内核自身的排序状态,刷新页面或重启应用后依旧生效。
  • 纯前端、零运行时依赖:只有 client 半个插件,Host 侧是空实现;不启后台进程、不联网、不碰会话数据。

安装

要求:DSH 客户端及其 dsh CLI(随 DSH 安装,位于安装目录 resources/runtime/cli/bin/dsh.cmd)。已在 DSH 0.2.2-rc.1 上验证。插件作用于浏览器侧的 Web UI 层,无构建步骤。

方式 A:命令行(npm,推荐)

dsh plugin --profile desktop add dsh-session-active-top

从 npm 拉正式包注册进 profile。核心已启用 HMR,Host 侧实时重组、client 侧经 plugins/events 的 type: "graph" 帧交付,装完即时生效;若页面未自动加载,刷新一次 Web GUI 即可。

> --profile 指向你正在使用的 profile;若 dsh 已默认选中它,可省略该参数。profile 目录一般在 $DSH_HOME/profiles/,若在工作区之外,安装时需放开对应目录权限。

方式 B:插件市场

在 DSH 插件市场搜索 dsh-session-active-top,一键安装(社区收录审核通过后可用)。

方式 C:本地目录(开发调试)

dsh plugin --profile desktop add link:<本插件目录的绝对路径>

以 junction 链接本地目录,改文件即热重载,适合边改代码边验证。

卸载

dsh plugin --profile desktop remove dsh-session-active-top

注意:卸载不会还原已写入的手动顺序(等价于你曾经拖动过一次),上浮名单也会留在 localStorage。要彻底清空,可在 DevTools 执行:

localStorage.removeItem('dsh-session-active-top:raised');

验证

  1. 设置 → 插件列表可见 dsh-session-active-top 且为启用;/plugins/events 的 graph 帧含该插件条目。
  2. 让另一个会话进入 running(发一条消息),它应立刻跳到会话目录顶部。
  3. 停止该会话:仍留在顶部,不会回落。
  4. 其余会话顺序不变;手动置顶的会话与图钉图标不受影响。

实现原理

内核(dsh-client-ui-workspace)没有提供「会话列表排序」扩展点,排序在组件里写死,且两种排序模式落点不同:

目录排序模式 实际生效的顺序来源 插件做法
时间(orderBy: "updated") orderByRecency 读快照里的 updatedAt 包装 sessions.list.getSnapshot(),给上浮会话一个远大于真实时间戳的合成 updatedAt(只存在于运行时副本,不回写真实数据)
手动(orderBy: "manual") reconcileManualOrder 回放持久化的 sessionOrderByAccount 调用视图 store 自己的 setSessionOrder(accountKey, order, orders),把上浮会话前置进已保存顺序

手动模式下只改快照是无效的 —— 这正是第一版「看不出上浮」的原因:老会话都在已保存的手动顺序里,改 updatedAt 只会影响「其余」段。必须写持久化顺序;写入走内核自己的 action,等价于用户拖动一次,所以刷新 / 重启后位置仍在,且运行结束不会自动回落。

每次快照变化都会重排上浮块内部(按 updatedAt 降序),你正在对话的会话就在最前;上浮块之外完全不动。

  • Node 半(lib/index.js):空实现,不做任何事。
  • 客户端(lib/client.js):注入 sessions 与 slots,解析视图 store、包装快照、订阅变化并重排上浮块;卸载时还原包装。
  • 上浮名单只记在浏览器 localStorage(dsh-session-active-top:raised),按 profile 隔离。

故障排查

现象 原因 / 处理
装了没反应 确认 --profile 指向当前实例、刷新一次 Web GUI、检查插件列表为启用;/plugins/events 的 graph 帧应含该插件
当前对话没在最前 上浮块按 updatedAt 降序,给该会话发一条消息刷新活跃时间即可
置顶会话的顺序没变 置顶会话属于图钉分区,本插件只在普通分区排序,两者互不影响
想清掉上浮名单 DevTools 里 localStorage.removeItem('dsh-session-active-top:raised') 后刷新

已知限制

  • 内核没有「会话列表排序」扩展点,本插件靠运行时包装内部 store 并调用未写入文档契约的内部 action;DSH 升级若改动这部分实现,插件可能需要跟进。详见 FEEDBACK.md。
  • 手动模式下写入的持久化顺序不会因卸载而还原(等价于用户拖动过一次)。
  • 上浮名单存在浏览器 localStorage,换 profile 或换机器不会同步。

发布

在 GitHub 上创建 Release 会触发 .github/workflows/publish.yml,经 OIDC 可信发布自动推送到 npm。版本号以 package.json 为准。

许可证

MIT

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-session-active-top 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-session-active-top` 即可。对应的 npm 包名是 `dsh-session-active-top`。

dsh-session-active-top 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-session-active-top 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-session-active-top 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-session-active-top 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-session-active-top 需要什么运行环境?

Node.js >=20。环境不满足时安装会失败,建议先确认本机版本。

dsh-session-active-top 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-session-active-top 有哪些功能?

运行中会话自动上浮置顶、上浮块按活跃时间降序、运行结束仍保留位置、兼容时间与手动排序模式。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

工具与能力
按星标排序,可作替代方案

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

JohnshyCY 的其它插件

1 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。