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 添加：

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。

使用

当输入框获得焦点时特效即生效。打开 设置 → 通用 → 输入光标 可以：

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

开发

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