zzh-github/dsh-plugin-sparknote

---

kind: package-bundle description: "在 DSH 回复中先划线，再将全文与标记一起收藏。"

SparkNote

中文 | English

兼容版本： 插件 0.1.3 要求 DSH 0.2.1-rc.2 · Web 端。

package.json 中的 engines.dsh 精确限定此版本。其他 DSH 版本（包括更新版本）及桌面端安装尚未验证。

概述

阅读回复时直接划线，读完后将整条回复与全部标记一起收藏。划线在收藏前就会自动保存。收藏夹保留回复副本，原会话删除后仍可阅读。这个可选 bundle 为你的 Web profile 添加收藏夹。

目录

• 效果展示
• 使用
• 实现
• 模型体验
• 已知限制与后续工作
• 计划功能
• 社区与贡献
• 开发备注

效果展示

以下截图使用中文界面的本地示例会话；插件同时支持中文与英文。

边读边划线：选中文字并选择颜色，无需先收藏。

在收藏夹中，通过对话名称和回复开头识别已保存的内容。

打开收藏，同时回看当时的用户问题、完整回复和彩色划线。

使用

通过插件页面安装 SparkNote 0.1.3，或运行以下命令将其安装到 Web profile，然后重启 DSH Web：

dsh plugin --profile web add https://github.com/zzh-github/dsh-plugin-sparknote/releases/download/v0.1.3/dsh-sparknote-0.1.3.tgz

在已完成的回复中选中文字，再选择黄色、绿色、蓝色或粉色。点击已有划线可改色或删除。回复下方的五角星按钮默认会把完整 Markdown、已有划线和对应的用户问题一起收藏。默认标题为“对话名称 · 回复开头”，之后可以重命名。从侧栏打开收藏夹，可搜索回复、已保存的问题与划线，重命名收藏、阅读、编辑划线或打开原对话。收藏中的彩色划线直接显示在回复原文中，也支持跨 Markdown 块的选区；下方“管理划线”默认收起，需要查看摘录或使用管理控件时再展开。取消收藏会保留划线草稿。

主机提交成功后，界面才会显示已保存。操作失败会保留已有数据，并提供重试。数据使用 profile 配置的存储提供方，保存在 Harness 主目录下。卸载 bundle 会移除界面，不会删除数据。

开发插件时，在此目录运行 pnpm install、pnpm run typecheck、pnpm test 和 pnpm run pack:bundle。bundle 有自己的锁文件，不修改 Harness 工作区的依赖关系。

此目录是独立的 Git 仓库。插件的 Git 操作在此目录运行，Harness 的 Git 操作在 DSH 源码目录运行。运行 pnpm run prepare:smoke --dsh-root D:/00-code/DSH 可准备无密钥的录制会话检查；省略 --dsh-root 时使用并列的 DSH 目录。脚本输出隔离的测试路径，不会启动服务器。

实现

Profile 补丁挂载一个主机插件和对应的浏览器贡献。主机验证仅所有者可调用的 RPC 请求，并按顺序写入带版本的存储记录。浏览器通过 Chat、侧栏、主面板和浮层插槽添加功能。适配当前版本的 DOM 适配器将选区对应到已完成的 Chat 节点，使用 CSS Custom Highlight 绘制，不修改 React 管理的正文。原文摘录和前后文用于在布局变化后定位划线，并将 Markdown 分隔换行的差异映射回实际正文位置；无法唯一定位时不绘制，已保存的摘录仍可查看。

模型体验

此 bundle 不添加模型工具或提示词。收藏与标记属于个人阅读数据，不进入模型上下文。

已知限制与后续工作

收藏前需先在当前对话历史中加载对应的用户问题；暂不复制问题中的附件。未保存问题的旧收藏仍可阅读，并显示提示。仅支持带标准操作行的已完成文字回复。不支持流式生成中的回复、思考过程、图片、自由手绘或跨回复选区。文字高亮需要支持 CSS Custom Highlight 的新版浏览器。DOM 适配器限定于声明的 DSH 版本；桌面端安装尚未验证。其他浏览器窗口在获得焦点时刷新收藏；首版不包含多窗口实时更新和收藏导出。打开来源会返回原对话，不会自动翻页到具体历史消息。

计划功能

以下功能仍在计划中，当前版本尚未提供：

• 用标签整理收藏。
• 按分类筛选。
• 按分类统计。
• 生成使用报告。
• 为收藏添加注释并分享。
• 与第三方笔记工具联动。

社区与贡献

这是独立维护的社区插件。DSH 贡献指南建议插件作者为 GitHub 仓库添加 dsh-plugin 话题，方便其他人发现项目。插件问题与改进建议请提交到本仓库的 Issues。

开发备注

0.1.3 版将内部插件 ID 和存储域统一为 sparknote。v0.1.2 或更早本地构建保存的收藏不会迁移，也不会显示在此版本的收藏夹中。