dsh-smooth-cursor-patched

中文 | English

一个为 DSH（DeepSeek Harness）打造的平滑彗星光标（社区修补版）——把原生输入光标替换成一枚会随输入平滑滑动的发光彗星，支持自定义拖尾、强调色、粗细及 500ms 呼吸节拍。

关于本仓库 这是 Lacquervii/smooth-cursor 的个人修补分支。上游自 2026-09-09 起未再更新，故在此维护一份可用版本。

• 精力有限，不保证及时关注这个仓库，且随时可能断更
• 欢迎提 issue，但回复可能很慢
• 上游若恢复维护，我会优先回归上游

相对上游的改动

上游 dsh-smooth-cursor 在以下场景存在可复现的缺陷，本分支逐项修复：

• 空内容与初次聚焦保活 — 上游在空输入框或初次点击时，光标测量拿到零高度矩形，导致光标不显示。本分支为富文本输入框增加了分层测量与空行兜底。
• 双向划词跟手 — 上游固定取选区第 0 个矩形，正向拖选（从左往右）时光标不跟鼠标。本分支按选区方向（selectionDirection）选择首/末矩形，并把选区终点与方向纳入重测签名。
• 换行空行精准拦截 — 上游依赖 range.getBoundingClientRect()，在空行上会拿到 Chromium 回溯吸附的矩形，光标停留在上一行末尾。本分支在软换行与空段落处优先实测该行自身的 <br> 高度。
• 视口物理纵向裁剪 — 上游没有裁剪，长文本滚动时超界光标会漂浮到聊天区或工具栏上方。本分支按输入框滚动视口剔除并裁切。
• 覆盖询问界面 — 上游只覆盖 textarea[data-phase]。本分支同时覆盖 ask_user_question 交互卡片的作答输入框。

此外新增：光标呼吸（闪烁），对齐 VS Code / 原生 500ms 节拍（无操作 0.5 秒后呼吸，打字时常亮），可在设置中独立开关。

核心特性

• 平滑彗星光标 — 平滑缓动，移动时光标优雅滑向目标字符位置。
• 彗星拖尾 — 移动光标时带有渐细渐隐的粒子拖尾。
• 光标呼吸开关 — 500ms 节拍，可独立开关。
• 浏览器本地持久化 — 设置保存于 localStorage，即开即用。

安装与使用

从 npm 安装（推荐）

dsh plugin --profile web add dsh-smooth-cursor-patched

从 GitHub 安装

dsh plugin --profile web add github:ThinkofRain1213/dsh-smooth-cursor-patched

安装后刷新或重启 dsh web，在 插件 → 本插件 的 bundle 详情页里配置：配置区位于描述与「包含的组件」之间。

版本要求：DSH 0.1.6-alpha.2 及以后。 插件自有设置页由 @deepseek-ai/dsh-client-ui-plugin-manager 提供，该包首次发布于 0.1.6-alpha.2，并从中提供 plugins.bundle.config 槽位。0.1.5 及更早的版本没有插件管理界面，因此没有这个槽位——插件会安静地不渲染配置区（光标特效本身不受影响，走 localStorage 的既有偏好继续生效）。

从本版本起，本插件只提供插件页这一处配置入口：先前注册在「设置 → 通用」的输入光标行已移除，避免同一组开关出现两次。

手动安装（本地开发）

克隆本仓库并作为插件 bundle 添加：

git clone https://github.com/ThinkofRain1213/dsh-smooth-cursor-patched.git
cd dsh-smooth-cursor-patched
pnpm install --ignore-scripts
pnpm build

然后在你的 profile 的 cordis.patch.yml 中注册：

- insert:
    - id: smooth-cursor-patched
      name: dsh-smooth-cursor-patched

注意：id / name 必须与包名一致。改写为上游的 smooth-cursor / dsh-smooth-cursor 会与官方插件条目冲突，DSH 会因 loader id 重复而报 Failed to load plugins。

使用

当输入框获得焦点时特效即生效。打开 插件 → 本插件 的配置区可以：

• 开关整个特效、彗星拖尾或光标闪烁。
• 从色板选择强调色，或使用自定义取色器。
• 选择光标的粗细。

偏好保存在浏览器 localStorage 里，改动即时生效，无需重启或刷新。

开发

pnpm install --ignore-scripts
pnpm run typecheck          # tsc 类型检查
pnpm run build              # tsdown 打包（node 端 + 客户端）
pnpm run check:register-id  # 校验 bundle 注册 id 与 patch name 一致
pnpm run watch              # 增量重建

lib/ 已提交到仓库，即使包管理器阻止了 prepare 构建步骤，也能从 git 安装后直接运行。提交前请确保 pnpm run build 之后 lib/ 无未提交改动——CI 会校验已提交的产物与 src/ 同步。

测试

本仓库目前没有自动化测试。CI 只覆盖类型检查、构建、注册 id 一致性与产物新鲜度；它不能证明光标在各浏览器中的实际行为，那部分依赖手动验证。

致谢

本插件的光标平滑效果受 VSCode 的 smooth cursor 概念启发，并参考了 Obsidian 社区的 animated-cursor 插件（原作者 Copyright (c) 2025 Kotaindah55 (Sheva Ihza)，基于 MIT License）。本项目的渲染与集成是为 DSH Web 独立重写的实现，但效果灵感来源于上述项目，特此致谢。

许可证

MIT