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
