bilbillm/dsh-motion

克制而语义化的界面动效,用于 DeepSeek Harness

Project Overview项目介绍

dsh-motion is a native lightweight UI plugin built exclusively for DeepSeek Harness that adds subtle transition animations to core interface elements. To install the plugin from source, you first run pnpm install and pnpm run build to generate the production bundle. After building, you use the DSH CLI command dsh plugin --profile web add /path/to/dsh-motion to add the plugin to your isolated DSH profile. The package includes all required DSH-specific files, including a cordis.patch.yml profile patch and a client bundle manifest, and you must restart your DSH profile after installation completes.

The plugin follows a conservative design principle that prioritizes existing animations from the base Harness installation or user-installed third-party themes. It automatically skips animations for any interface elements that do not have clear, reliable semantic markup, to avoid visual glitches or broken page layout. It only animates opacity, translation, scale, and color properties for transient UI elements, rather than modifying core layout dimensions controlled by the Harness host. It respects system accessibility settings by listening for the prefers-reduced-motion media query, and disables all non-essential transition animations when the user has opted to reduce motion. This keeps the plugin lightweight, accessible, and non-intrusive for most users, with no extra configuration required out of the box.

The plugin is currently tested against Harness version 0.1.0-rc.5 source code and the released 0.1.0-rc.6 client runtime. It works with the default light and dark Harness themes, as well as the popular angelina-light and angelina-dark themes, and does not rely on CSS Module hash class names to function. It includes a full end-to-end test suite that covers multiple themes, viewport sizes, transition behaviors, accessibility states, and layout invariants. The plugin is released under the open source MIT license, and app and theme developers can disable animations for specific UI subtrees by adding the data-dsh-motion="off" attribute to the container element.

这是一个专为 DeepSeek Harness 开发的轻量零配置原生插件,功能是为带有稳定语义标记的各类界面元素添加短促克制的进场、退场与状态切换动效。覆盖的界面元素包括菜单、列表框、对话框、标签面板、对话内容层、标签页、开关控件以及工作区分组的展开折叠状态。

该插件设计风格偏向保守,优先保留 Harness 或已安装主题自带的动画,会自动跳过无法可靠判断语义的界面元素,遵循无障碍设计规范,会监听系统「减少动态效果」设置并在开启后关闭动效。它不提供额外设置页、动效强度调节控件,也不会增加轮询或常驻动画帧循环,对性能影响极小。

源码构建完成后,可通过 Harness 标准插件流程安装到隔离配置文件,安装后需要重启或重新加载对应配置。当前插件已针对 Harness 0.1.0-rc.5 源码和 0.1.0-rc.6 客户端运行时测试,适配默认深浅主题和 Angelina 主题,采用 MIT 许可证开源分发。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:bilbillm/dsh-motion

把 bilbillm/dsh-motion 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-motion

@dsh-external/dsh-motion 是一个面向 DeepSeek Harness 的轻量、零配置浏览器插件。它为具有稳定语义标记的菜单、列表框、对话框、标签面板、对话页面内容层、Tab、Switch 和工作区分组展开状态增加短促、克制的进入、退场与状态切换动效。

插件有意保持保守:

  • Harness 或主题自带的动画优先;无法可靠判断的界面会被跳过。
  • 瞬态界面只动画 opacity、独立的 translate/scale 和颜色属性。只有工作区语义分组会动画自身高度;AppFrame 列宽和侧栏几何仍由宿主管理。
  • 菜单、列表框、对话框和遮罩使用成对退场效果。退场副本始终设置为 aria-hidden、inert、不可点击,并在动画结束后立即移除。
  • 模型和推理等级卡片换页采用带方向提示的 through-fade;命令列表筛选不会因选项更新而反复触发动效。
  • 对话框挂载时由外层面板统一负责入场,内部 slot 不会重复动画。带 backdrop-filter 的玻璃面板只在短动画期间暂停背景采样,结束后精确恢复主题原声明。
  • 实时监听 prefers-reduced-motion;启用减少动态效果后,会关闭位移和淡入。
  • 不增加设置页面、强度滑杆、轮询或常驻动画帧循环。

English: README.en.md

安装

构建源码后,通过 Harness 的标准插件流程安装到隔离 profile:

pnpm install
pnpm run build
dsh plugin --profile web add C:\path\to\dsh-motion

包中包含 cordis.patch.yml、dsh.client 声明和 Harness 模块加载器需要的客户端 bundle。安装后请重启或重新加载对应 profile。

兼容性

当前版本针对本地 Harness 0.1.0-rc.5 源码和已发布的 0.1.0-rc.6 客户端运行时依赖进行测试。插件适配默认的 light/dark 主题和 angelina-light/angelina-dark 主题所使用的语义标记,不依赖 CSS Module 哈希类名。

构建与测试

pnpm install
pnpm run check
pnpm run pack:check

pnpm run check 会执行类型检查、构建 Node/Browser 两个 half,并运行单元测试、JSDOM 测试和 bundle 冒烟测试。可选浏览器矩阵需要一个正在运行的隔离 Web profile:

$env:DSH_MOTION_E2E_URL = 'http://127.0.0.1:3080/'
pnpm run test:e2e

该测试矩阵覆盖四个主题、桌面和窄屏视口、瞬态界面的成对退场、模型/推理卡片换页、工作区展开折叠、对话框、Tab/Tabpanel、布局与焦点不变量,以及减少动态效果模拟。最新的宿主验证矩阵和明确保留的测试缺口见 docs/compatibility.md。

设计边界

应用或主题可以显式关闭某个子树的动效:

<section data-dsh-motion="off">...</section>

以下由宿主负责的区域不属于插件的控制范围:AppFrame 与侧栏几何、Trajectory 交互、Tooltip、Toast、Composer 排版、流式对话行、大型页面退场副本以及 Angelina 视差图层。Composer 内的语义菜单/列表框和工作区树分组展开是两个范围明确的例外。改变这些语义的主题应增加显式适配器,而不是依赖宽泛选择器。

分发入口

  • .:由 Harness Loader 挂载的无操作 Node half(apply())。
  • ./client:通过 window.__ModuleLoader__.load({ id, factory }) 注册的浏览器 half。
  • ./cordis.patch.yml:profile patch row。

许可证

采用 MIT 许可证。

← 上一个 Prev dsh-deepseek-quota 下一个 Next dsh-ima-copilot →