DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

plants13 /

plants13/dsh-touch

Topic repository only

DeepSeek Harness 触屏适配插件:长按会话/工作区行呼出触屏操作面板(归档、置顶、改名、新建会话、删除工作区)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@823ca653

dsh-touch

给 DeepSeek Harness 的 触屏适配插件:长按会话行或工作区行,弹出插件自己的底部操作面板;右键则等同于点该行的「...」,用宿主自己的菜单。

桌面端的会话列表、工作区列表原本都依赖鼠标悬停来露出操作按钮(... 菜单、归档、置顶)。触屏上既没有 hover,长按也只会触发文本选择或系统菜单。这个插件把「长按」变成一等交互:手指按住 = 插件面板,鼠标右键 = 宿主菜单,两条路互不干扰。

许可证:MPL-2.0。


功能

长按会话行 → 会话操作

插件自己实现的行:

操作 说明
打开 打开该会话
归档 / 取消归档 按当前状态自动切换
置顶 / 取消置顶 已归档的会话不提供置顶
重命名 面板内直接输入,Enter 保存、Esc 取消
复制标题 剪贴板

后面接着的是宿主自己提供、而插件没有重复实现的动作,直接来自宿主的会话右键菜单:

操作 来源
分叉会话 session.fork
复制会话 ID session.id(DSH 0.2.2 新增)
在文件资源管理器中显示 open-in-app.reveal(DSH 0.2.2 新增,macOS 显示为「在访达中显示」)
以后新增的会话动作 任何新注册到 session 目标族的贡献者

这些行不是逐个硬编码的:插件向宿主的 contextMenus 服务要一份同一目标的动作列表,点哪一行就按宿主的 ID 执行。所以宿主以后往会话菜单加东西,面板会自动跟上,不需要改插件。

置顶 / 重命名 / 归档三个动作插件已经自己做了,宿主的同项会被跳过,不会出现两遍。

长按工作区行 → 工作区操作

操作 说明
展开 / 收起 工作区头部本身没有「打开」语义,点击行就是切换展开
在此新建会话 复用该行自己的「+」按钮
重命名工作区 打开宿主菜单并选中「重命名」
删除工作区 打开宿主菜单并选中「删除工作区」,确认弹窗仍是宿主的
复制名称 剪贴板

工作区的重命名和删除没有自己实现一遍:插件点开该行自己的 ...,再点中对应菜单项,所以确认弹窗、default-workspace 不可删的规则、操作后的 toast 全部由宿主负责。

「未分组」那个头没有工作区归属,宿主既不给它渲染 ...,它的「+」在宿主里也是空操作,所以那个面板只给「展开 / 收起」和「复制名称」。

右键 → 宿主自己的「...」菜单

鼠标右键(以及触屏设备上的右键)不做任何自研 UI,而是直接点开该行的 ...:会话行给会话菜单,工作区行给工作区菜单。这与手动点击那个按钮完全等价。

识别依据是指针类型而不是事件名:Chromium 对「手指长按」也会发 contextmenu,但那属于长按路径,插件会拦掉平台的菜单并交给自己的面板;只有来自鼠标、且 button === 2 的 contextmenu 才走宿主菜单。

这条边界有自动化断言守着(见下方验证):长按不会点 ...,右键不会开面板,且两条路都不会误点「+」。

触屏命中区

只在 (hover:none) 或 (pointer:coarse) 下生效,不影响鼠标桌面:

  • 行操作按钮常显(原本只在 hover 时出现,触屏根本摸不到)
  • 行最小高度 44px,图标按钮 26px
  • 输入框 16px(避免 iOS 聚焦缩放)
  • touch-action: pan-y + 关闭长按文本选择

设置

设置 → 触屏:

  • 长按延迟:200–1200ms,默认 420ms
  • 触感反馈:真实触摸按压时轻微震动(设备支持时)

设置存 localStorage 的 dsh-touch.settings.v1,不写宿主配置。


安装

前置:已安装 DeepSeek Harness(桌面版或 Web 版)。

git clone https://github.com/plants13/dsh-touch.git

然后用 Harness 的 plugin_manager 安装本地包目录(目录路径指向 plugin/dsh-touch,那里才是包本体):

plugin_manager  action: install_bundle
                target: <克隆路径>\plugin\dsh-touch

安装会由 Plugin Manager 自动完成这些事,不要手动改 profile:

  • 把包加入 profile 的 package.json 依赖
  • 把 @local/dsh-touch 加进 dsh.profile.bundles
  • 应用 plugin/dsh-touch/cordis.patch.yml

装好后重载页面或重启 Harness。客户端模块图在启动时快照,新插件需要一次重新加载。

不想用了:plugin_manager 的 remove_bundle,目标 @local/dsh-touch。


仓库结构

plugin/dsh-touch/          插件本体(可安装包)
├── package.json           bundle 清单 + dsh.client 声明
├── cordis.patch.yml       插入插件行
├── index.js               Host 半边(空实现)
├── client.js              页面半边:手势 + 面板 + 触屏 CSS
├── icon.svg               插件卡片图标
└── locale/{en,zh-CN}.json 插件卡片文案

tools/                     验证与排障脚本
├── verify.ps1             一键跑全部检查
├── check-inject.js        静态检查 ctx 服务声明
├── apply_harness.js       真实执行 apply() 并渲染组件
├── branch_test.js         工作区/会话两种面板的分支断言
├── diagnose-touch.js      浏览器 Console 诊断脚本
├── disable-bundle.ps1     启动崩溃时的凭外恢复
├── asar_extract.py        Electron asar 解包(研究宿主 API 用)
├── css_rules.py           从产物 CSS 里抽取规则
└── count_identifiers.js   死代码统计

dsh-touch 这个名字带 @local/ 前缀是有意的:它不发布到 npm,由用户本地安装。


实现要点

Host 半边是空的

全部逻辑在页面侧(client.js)。Host 只需有一个可被 Loader 解析的入口,所以 index.js 只导出空的 apply()。

长按给触屏,右键给鼠标

两个输入各走各的路,因为它们服务的东西不同:

  • 长按是触屏场景。宿主的 ... 按钮只在 hover 时出现,手指根本摸不到;所以这条路由插件接管,给一个大按钮的底部面板。会话的操作直接调 Client 服务(ctx.uiWorkspace.archiveSession() 等);工作区的重命名/删除则转交给那个已经存在的宿主菜单,保留确认弹窗和默认工作区规则。
  • 右键是鼠标场景,本来就有宿主菜单可用,插件只负责把 contextmenu 转成「点那个 ...」,不引入任何自研 UI。

会话行为什么不用宿主菜单做长按:那个菜单是 dsh-client-ui-primitives 里的私有组件(closeOnPointerLeave + 200ms 关闭),插件不允许 require 宿主 Client 包,也拿不到它;而且它没有「打开」和「复制标题」。

为什么宿主动作能自动出现在面板里

DSH 0.2.2 把会话右键菜单从 slot 换成了 contextMenus 服务,动作变成「按目标族注册」的贡献者。这个服务有两个能力正好够用:

  • resolve({ kind: 'session', value: { sessionId, displayTitle } }) —— 拿到与宿主菜单同一份的动作列表;由别的渲染器自己画,不会抢宿主的菜单。
  • select(actionId) —— 按宿主发布的动作 ID 执行,回调仍在宿主的注册表里。

于是面板里这一段的做法是:打开面板时 resolve 一次,把返回的动作按宿主顺序渲染;点某一行就 select 那一行的 ID。因此:

  • 宿主 0.2.2 新增的「复制会话 ID」「在文件资源管理器中显示」不用写任何代码就出现了;
  • 以后宿主再往 session 目标族加动作,也会自动出现;
  • 权限判断、归档会话时停止活动的处理、失败提示,全部沿用宿主那次 resolve 的结果。

两条规则避免出错:

  • 不重复:置顶 / 重命名 / 归档由插件自己渲染,这三个 provider (session.pin / session.rename / session.archive) 的动作会被跳过。
  • 跳过带子菜单的动作:面板没有子菜单,而 select() 本来也拒绝父级动作。这类动作宁可不显示,也不显示成点了没反应。

服务是懒查找的(ctx.get('contextMenus')),没有写进 exports.inject。原因是硬依赖会让插件在还没有这个服务的旧版 DSH 上停在 pending —— 那本身就是启动失败。找不到时这一段就为空,面板仍是完整的旧行为。

手势怎么挂上去

宿主的会话/工作区行没有为手势预留 slot,所以只能在 document 上捕获 pointerdown。插件只观察事件,不改写宿主 DOM:面板通过 shell.overlay 这个 slot 渲染。

行身份来自宿主自己带的语义锚点:

行 锚点
会话 [data-row-key="session:<id>"]
工作区 [data-row-key="workspace:<key>"]

三种触发路径,互为兜底:

  1. pointerdown + 420ms 定时器(移动超过 12px 视为滚动并取消)
  2. pointercancel 后延迟 250ms 清理,给下一条留时间
  3. contextmenu(Chromium 对「手指按住行」会自己发这个,绕开定时器被取消的情况)

鼠标按住也会触发 —— 这样在桌面上也能测。

一个容易踩死的坑:exports.inject

Cordis 的客户端上下文有注入闸门。插件没在 exports.inject 里声明的服务,读一下就直接抛:

Error: cannot get property "locale" without inject

这个异常会让插件 fiber 进入 FAILED,而 Web boot 审计把「fiber 不在 active」当成致命错误,直接把整个应用 boot 掉:

Error: web boot: 1 entry did not activate
@local/dsh-touch: failed

表现就是白屏。所以这个插件声明了它实际读取的全部四个服务:

exports.inject = ['slots', 'locale', 'uiWorkspace', 'sessions'];

这条规则反直觉的地方在于:少声明比多声明更致命。多声明一个不存在的服务只会让插件停在 pending;少声明一个则会在第一次读取时抛异常。

不让插件拖垮启动

即使如此,插件仍然做了三层兜底,因为插件崩了不该让整个应用起不来:

  1. apply() 里每块用 step() 隔离,坏一块只禁用那一块
  2. 每个注册进去的组件都套 SafeBoundary(React 错误边界)——渲染期崩溃会降级成空渲染 + 一行 Console 日志
  3. useSyncExternalStore 不存在时退回 useState + 订阅

验证

powershell -NoProfile -ExecutionPolicy Bypass -File tools\verify.ps1

四步,全过才建议安装:

PASS  1. syntax (node --check)                  语法
PASS  2. inject contract (check-inject)         每个 ctx 读取都已声明,且声明都被用到
PASS  3. activation + render (apply_harness)    真实执行 apply() 并渲染注册的组件
PASS  4. workspace vs session branches          两种面板不串味

其中 apply_harness.js 的假上下文是个 Proxy,会像真实 Cordis 一样对未声明的服务抛 cannot get property ... without inject —— 这是刻意的,否则这个台子会给出「看起来干净」的假通过。

浏览器内诊断

装好后如果在桌面窗口按 F12 打开 DevTools,Console 里有:

__dshTouch.status        // 激活状态、按了几次、开了几次/菜单几次、最后一次指针类型、被吞掉的错误
__dshTouch.rows()        // 当前可见的手势目标
__dshTouch.describe(0)   // 第 0 行被识别成 workspace 还是 session,以及有没有「...」菜单
__dshTouch.open(0)       // 模拟长按:为第 0 行弹出插件面板
__dshTouch.openMenu(0)   // 模拟右键:点开第 0 行的宿主「...」菜单

也可以直接粘 tools/diagnose-touch.js,它会报行锚点匹配情况、媒体查询结果,并派发一次真实 pointerdown 验证整条链路。

启动崩溃的恢复

如果某个版本装了之后白屏、进不了设置(装插件这一步本身没问题、但客户端 boot 失败),在 Harness 关闭 状态下跑:

powershell -NoProfile -ExecutionPolicy Bypass -File tools\disable-bundle.ps1 `
  -Profile desktop -Bundle '@local/dsh-touch'

它只重写 profile package.json 里的 dsh.profile.bundles 数组,其余字段和别的 bundle 原样保留,并写一个带时间戳的备份。


已知限制

  • 依赖宿主的行标记。data-row-key 前缀和 archived / pinIndicator / rowActions / projectText 这些类名子串是从当前版本的产物里读出来的。DSH 以后改命名的话,识别会失效;手势本身还在,但状态判断可能不准。
  • 工作区动作依赖宿主行的「...」按钮。右键与工作区的重命名/删除都是点那个按钮来实现的,并用 aria-label 先把旁边的「+」排除掉。宿主以后若改动行按钮结构,这几条路会失效——但排除逻辑会先拦住,不会误建会话。
  • 右键只接管会话行与工作区行。其他区域保持宿主/浏览器原本的右键行为。
  • 宿主动作需要 contextMenus。这是 DSH 0.2.2 才有的服务;更早的版本上面板只剩插件自己实现的那几行(打开 / 归档 / 置顶 / 重命名 / 复制标题),不会出错,只是没有分叉、复制 ID、打开所在目录这些。
  • 面板不支持子菜单。宿主里带子级的动作会被跳过而不是显示成死行。
  • 没有在真机触屏上验证过。开发与验证都在桌面环境完成,长按手势、命中区尺寸只经过鼠标与合成 pointerdown 测试。
  • 只覆盖会话行与工作区行。消息、工具卡片等区域的长按没有处理。

欢迎提 issue 补充真机结果。


许可证

Mozilla Public License 2.0。

简单说:可以自由使用、修改、商用;修改过的本插件源文件需要以同样许可证公开;把它和其他代码组合成一个更大的作品时,那个作品不受此限制。

—/ 5

No ratings yet

Manifest verification required

Commit 823ca6538f03

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout