DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

SaberQing /

SaberQing/dsh-study-notes

Verified

DSH 插件:划词提问进入独立分支,不占用主对话上下文;持久高亮、笔记索引、定位回对话、可选记忆、回注、Markdown/KaTeX 渲染与 Word 导出。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@4db44ace

dsh-study-notes(学习笔记)

中文 | English

在 DSH 对话里划词提问,问题进入独立的右侧栏分支,不占用主对话上下文;之后随时点回高亮或索引即可回到当时的问题。

License: MIT npm

状态:0.1.0-beta — 已发布到 npm(dsh-study-notes),已在 DSH desktop 0.2.2-rc.3 上自测;接口依赖 DSH 扩展位,升级 DSH 后可能需要适配。

为什么

用 AI 学习时,遇到不懂的段落通常只有两种选择:

  • 直接在主对话里追问:问题越积越多,主上下文被稀释、越聊越乱;
  • 另开一个对话:丢失前文,需要重新复述,而且事后很难找回当时的疑问。

学习笔记把这类提问从主对话中分离出来:划词 → 右键「问这个」→ 右侧栏独立分支对话(不进入主对话上下文)。文字会被持久高亮,之后点击高亮或从右栏索引即可回到当时的分支,不必重问。

主要功能

  • 划词分支提问:独立上下文、流式回答、可停止;可选是否携带主对话记忆。
  • 高亮持久化:按会话隔离;切换会话、刷新、重启 DSH 都不丢。
  • 索引与定位:右栏「学习笔记」索引 + 开始页入口;点问题行可滚动定位到原对话位置并闪烁;旧消息自动分页加载;原文失效时提示并复制原文。
  • 分支记忆(可选,默认关闭):主对话摘要 + 最近 10–15 条原文;懒刷新、本地持久化(加密存储)、摘要可查看/编辑/重建/清空。
  • 回注主对话:把分支问答压成 3–5 条要点,以「预填草稿」或「直接注入」(主对话中出现折叠的 Context injection 行,持久保留)送回主对话。
  • 回答渲染:Markdown、代码块、表格、KaTeX 公式;截断提示 + 继续、卡顿/重试状态条、自动滚动。
  • 管理:批量删除、Markdown / Word(.docx) 导出、单条导出。
  • 模型控制:思考开关、无输出长度上限;支持 DSH 内置模型或显式选择自定义 OpenAI 兼容 API。
  • 隐私:API Key 由 Host 端 DPAPI(Windows)或 AES-256-GCM 加密保存,页面只显示前 7 位与后 4 位,不可查看/修改,只能删除后重输。

环境要求

  • DSH desktop 0.2.2-rc.3(其他版本未验证)
  • 无需额外 Node 依赖;使用 Windows 时获得最强的 API Key 保护(DPAPI)

安装

方式 A:npm 包(推荐)

插件已发布到 npm:dsh-study-notes(作者维护,当前 latest 指向 0.1.0-beta.1)。在 DSH 插件管理器里按包名安装,或直接对 DSH 说“用 plugin_manager 安装 dsh-study-notes”:

plugin_manager install_bundle  dsh-study-notes

需要固定版本时写成 dsh-study-notes@0.1.0-beta.1。安装后完全退出 DSH 再启动(Host 代码只在启动时加载)。

方式 B:本地目录(开发 / 离线)

  1. 把本仓库放到一个固定目录;
  2. 用插件管理器安装该目录:
plugin_manager install_bundle  <插件目录绝对路径>

本地目录方式适合开发或离线调试:本仓库的开发包名是 @local/dsh-study-notes;npm 包由 npm run build:npm 生成到 dist-npm/。

方式 C:手动挂载 profile(不推荐)

  1. 在 DSH profile 的 package.json 中把插件加入依赖(路径按实际位置修改):
{
  "dependencies": {
    "@local/dsh-study-notes": "link:<插件目录绝对路径>"
  },
  "dsh": {
    "profile": {
      "bundles": ["...", "@local/dsh-study-notes"]
    }
  }
}
  1. 完全退出并重启 DSH(Host 代码只在启动时加载,刷新页面不够)。

详细步骤、卸载与常见问题见 docs/public/installation.md。

快速上手

  1. 在对话中划选一段文字 → 右键 → 「问这个」;
  2. 右侧栏打开「学习笔记」并显示该分支,直接提问;
  3. 之后点击该处高亮,或右栏索引里的条目,即可回到这个分支;
  4. 列表行点击 = 定位到原对话并闪烁;行上「打开」= 进入分支详情;
  5. 全局设置在 设置 → 学习笔记(模型来源、思考、记忆、回注方式、API Key)。

设置项(设置 → 学习笔记)

设置 默认 说明
模型来源 DSH 内置模型 内置 / 自定义 OpenAI 兼容 API(显式选择,不互相回退)
思考 开 内置模型走 DSH 能力;自定义 API 可选参数格式
记忆 关 开启后分支提问携带主对话摘要 + 最近 N 条原文
主对话窗口 10 10–15 条
回注方式 预填草稿 预填草稿(不自动发送)/ 直接注入

隐私与安全

  • 会话、笔记、分支问答、摘要均保存在本机(浏览器 localStorage + ~/.dsh/study-notes/);
  • API Key:Host 端加密存储,前端仅显示脱敏 preview;请求体不含 Key;
  • 除模型请求外,不向任何第三方发送数据;
  • 完整说明见 docs/public/privacy.md。

已知限制

  • 依赖 DSH 的扩展位与部分内部接口(右栏 tab、settings.section、agent.inject/session.append、会话消息派生、对话 DOM 的 data-* 约定),DSH 升级可能导致功能失效;
  • 「直接注入」仅在主对话空闲时持久落盘;主对话生成中会排队并提示“尚未落盘”;
  • 定位到对话依赖对话 DOM 约定,旧消息需要分页加载;
  • 笔记/分支问答保存在浏览器 localStorage,未加密(本地同用户可读;如需更强保护请使用系统账户隔离或清空数据);
  • 右栏宽度 < 768px 时按 DSH 设计变为全屏抽屉;
  • 界面目前为中文;记忆摘要与回注摘要使用 DSH 内置模型。

详见 docs/public/known-limitations.md。

开发与结构

package.json      DSH bundle / client 清单
cordis.patch.yml  插件挂载
index.js          Host:LLM 路由、摘要/记忆/回注/密钥路由
client.js         Client:右栏 tab、高亮、索引、定位、设置分区、导出
locale/           本地化文本
icon.svg          图标
  • 无构建步骤:client.js 为手写 window.__ModuleLoader__ bundle;
  • Host 改动需要完全重启 DSH,客户端改动刷新页面即可。

许可证

MIT © 2026 SaberQing

免责声明

本项目为独立开发的第三方插件,与 DeepSeek 官方无隶属关系。使用自定义 API 时请自行确认供应商条款与费用。

—/ 5

No ratings yet

Verified DSH bundle

Commit 4db44ace5a72

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout