dsh-quick-note

DSH PLUGIN记忆与知识

仓库 TomJerryGit/dsh-quick-note · npm @tomjerrygit/dsh-quick-note

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DSH plugin 在 Web GUI 侧栏添加「管理台」:统一管理笔记、任务、SM-2 复习、健康记录与自定义类型,并支持用量、工作区价值分析与空间清理,数据可被 Agent 工具读写。

一句话选型结论

按资料字段整理

dsh-quick-note 是记忆与知识类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-11 创建于 2026-11-10
README 115.2 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add @tomjerrygit/dsh-quick-note@1.0.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名@tomjerrygit/dsh-quick-note可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-quick-note:DeepSeek Harness 侧栏里的本地优先管理台

  • 侧栏管理台与概览仪表盘
  • 笔记、任务、SM-2 复习与健康记录
  • 自定义记录类型与批量表格
  • 用量与工作区价值分析
  • Agent 工具读写同一份数据

适用场景

记忆办公自动化文件读写

上游标签

deepseek-harnessdsh-pluginlocal-firstproductivity

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-10): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
  • L4.4_RESOLVED_ARTIFACT 安装版本已解析 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-quick-note当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方TomJerryGit仓库 dsh-quick-note · 默认分支 main
分类记忆与知识knowledge
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-10 · 2026-11-11最后推送 2026-11-11
本站收录2026-11-11首次进入本站目录的时间

README 全文

115.2 KB
作者原文,中文版优先;只做安全转义,不改内容

侧栏管理台(dsh-quick-note)

在 DSH Web GUI 的左侧栏添加「管理台」入口,一个通用管理工具:默认先进入「概览」仪表盘,再按模块(笔记 / 任务 / 复习 / 健康)管理条目,并提供跨模块批量管理表格;同一份数据既能在面板里用,也能被 Agent 通过工具读写。

> 说明:为保证已安装状态、本机数据与 Agent 工具调用不中断,插件 id 仍为 dsh-quick-note,数据文件仍在 $DSH_HOME/quick-note/items.json,工具名仍为 quick_note_*;只有面向用户的名称与文案改为「管理台」。

功能

  • 概览 / 管理台首页(默认视图):5 个可点击 KPI 卡片(今日到期+逾期任务、待复习卡片、近 7 天复习、今日健康记录+今日用药数、自定义记录数/类型数)、今日简报文本块(任务/复习/用药一览)、一键快捷新建(笔记/任务/卡片/指标/用药/记录)、自定义类型快捷入口(显示类型名与记录数)、最近 6 条更新(点击跳到对应模块并选中);概览下隐藏搜索与新建按钮,保持仪表盘清爽,点标签可进入各模块
  • 全部(管理台表格):跨模块条目列表,可按类型筛选(全部/笔记/任务/复习/健康);支持排序(更新时间 / 标题 / 优先级 / 截止时间)与分页(每页 20 条);勾选条目后可批量「标记完成 / 重新打开 / 改优先级(高/普通/低)/ 删除(两次确认)」,点击行跳到对应模块并选中该条目
  • 自定义记录类型(通用管理):「记录」标签页可新建类型并为它定义字段(文本/数字/日期/复选/单选,单选支持候选值),然后按类型新增/编辑/删除记录;类型内支持搜索、按更新时间/标题排序、勾选批量删除,并可把当前筛选+排序「保存为视图」(视图随类型定义持久化到数据文件 types[].views);删除类型会同时删除其记录
  • 类型视图模板:每个自定义类型可保存多个筛选视图(名称 + 搜索词 + 排序),点击视图一键恢复;视图可两次确认删除;编辑类型时显示「该类型下有 N 条记录,删除会一并删除」提示
  • 跨类型批量:「全部」表格的类型筛选新增「记录」,记录行显示所属类型名,与其他模块一样支持批量标记完成/重开/改优先级/删除
  • 分析模块(系统 / 用量 / 价值合并):「分析」标签页内含三个子标签(价值 / 用量 / 系统),子标签选择持久化;系统子页通过 /api/quick-note/admin 展示运行环境(Profile/DSH 主目录/已装 Bundles/依赖)、数据文件与会话统计,仅读取
  • 用量分析(细化):「用量」子标签按工作区统计 Token(缓存命中/未命中/输出/总量)与估算金额,新增 缓存命中率、均 Token/会话、最近活跃、近 14 天用量折线、会话 Top 12(会话 ID/工作区/Token/金额/最近活跃);单价可在设置中修改
  • 工作区价值分析:「价值」子标签通过 /api/quick-note/workspace-value 给出每个工作区的价值分(A/B/C/D)、现阶段水平(活跃开发 / 维护期 / 近期活跃 / 放缓 / 沉寂)与未来价值(高潜力 / 稳定 / 放缓 / 低),并展示会话数、Tokens、估算金额、活跃天数、最近活跃、文件数/大小、近 14 天会话与动量;可人工评级并填写评价,保存到 settings.workspaceNotes
  • 社会应用价值(深化评价):社会价值改为 6 维加权(文档 20 / 许可证 15 / 测试 10 / 社会影响 25 / 工程沉淀 15 / 持续活跃 15),展示维度进度条与总分、优势 / 短板、按优先级生成的提升建议(补充 README/文档/许可证/测试、关联社会领域、保持活跃);识别领域与信号保留,人工社会评级与说明同样可保存
  • 价值趋势与排序:每天首次打开「价值」页自动记录一次评分快照(每工作区最多 12 次,存 settings.valueHistory),也可点「立即记录快照」手动记录;顶部「价值趋势」叠加最多 6 个工作区的走势(可切换价值分/社会价值,支持 7 天 / 30 天 / 全部时间范围,含 0/50/100 与首末日期坐标刻度,鼠标悬停数据点显示工作区、时间与分数);卡片显示相对上次的变化与迷你趋势线;支持按工作区单独清理快照、全部清理(均两次确认),以及按「价值分 / 社会价值 / 金额」排序
  • 价值榜单导出与归档:价值页「导出 CSV」按当前排序导出工作区榜单(阶段/未来价值/社会等级/评级均输出本地化文案,带 UTF-8 BOM 便于 Excel 打开);「导出 Markdown 报告」生成 .md 报告;「归档为笔记」把同一份报告存为带「工作区 / 价值报告」标签的笔记
  • 模块(v1.11.0 合并后):概览(概览 / 全部)/ 知识(笔记 + 复习)/ 计划(列表 / 看板 / 日历 + 未来 7 天时间轴)/ 健康 / 记录 / 分析;仍可在「设置 → 管理台设置」中分别隐藏笔记、任务、复习、健康、记录
  • 健康模块:指标记录(数值/第二值/单位/测量时间,同指标名自动画趋势折线,顶部有最多 3 个指标的迷你趋势总览)与用药计划(每日 HH:mm 服药时间、启用/停用、今日用药摘要);用药到点会出现在应用内提醒条,今日用药会进入每日简报
  • 复习明细:卡片编辑器显示该卡最近 5 次复习记录(时间 + 忘记/模糊/记得)
  • 统一条目模型:标题、正文、标签、状态(任务 open/done)、优先级(低/普通/高)、截止时间、完成时间、SM-2 复习状态
  • 任务视图:列表 / 看板切换;列表可按优先级或标签分组;过滤条(全部/未完成/已完成/今天/逾期);看板分「未完成/已完成」两列,卡片可直接完成或重新打开
  • 复习模块:闪卡正面=标题、背面=正文;「开始复习」按 SM-2 队列逐张展示,先看正面→显示答案→忘记/模糊/记得,自动安排 1/6/N 天后的复习时间
  • 指标详情:点击健康指标视图顶部的指标卡片进入详情页——该指标的大趋势图、次数/最小/最大/平均值统计、按时间倒序的历史读数列表,可直接「记录一次」快捷录入;点击历史行就地弹出编辑层(数值/第二值/单位/测量时间,保存不离开详情页),行尾按钮两次点击删除该条读数
  • 多指标对比:指标视图工具栏「对比」开关,默认叠加最近 3 个指标(最近 30 天读数归一化到同一张迷你折线图);图例标签可点击勾选/取消指标(最多 3 个),全部取消时显示提示
  • 复习建议:卡片编辑器底部显示 SM-2 建议的下次复习间隔(按当前 ease/间隔与「记得」评分推算);已过下次复习时间的卡片额外提示「已逾期,建议尽快复习」
  • 复习记忆保持率:复习视图按「距上次复习的间隔」分桶统计保持率(1 天内 / 2–6 天 / 7–29 天 / 30 天以上,展示次数与百分比),来自复习日志
  • 复习统计:复习视图顶部显示待复习数、今日已复习数、连续复习天数、近 30 天评级分布(忘记/模糊/记得),以及近 30 天复习热力图;评分会写入复习日志(存于数据文件 reviews,最多保留 5000 条),因此热力图与连续天数是精确值
  • 指标总览:健康指标视图顶部最多 3 个指标卡片,点击进入该指标详情(大趋势图 + 统计 + 历史读数)
  • 看板拖拽与排序:看板卡片可拖到「未完成 / 已完成」列直接改状态,也可在同一列内拖到另一张卡片上前/后自定义顺序(order 字段持久化,未设置顺序的项目按更新时间排在后面);拖到卡片上时该卡片顶部显示插入指示线
  • 搜索:匹配标题、正文、标签;Esc 清空
  • 自动保存:改动先落浏览器镜像,再同步到 Host 数据文件;Host 不可达时显示「仅保存在本机浏览器」,恢复后可再同步
  • 导入 / 导出:导出 JSON 备份(version 2,含条目与自定义记录类型 types);导入按 id 合并条目与类型(不覆盖已有;兼容只有 items 的旧备份)
  • 提醒:应用内右下角到期提醒条(今天/逾期任务 + 用药到点,可当日关闭);用药到点还会尝试系统通知(同一剂每天一次,点击通知直接打开面板,需在「设置 → 管理台设置 → 提醒」授权;不支持的环境会显示提示);可在设置里开启「每轮对话注入今日待办简报」,让 Agent 每轮收到今天/逾期任务与今日用药摘要
  • Agent 工具(Host 半区):
  • quick_note_search — 搜索条目(query / kind / priority / includeDone / limit)
  • quick_note_create — 新建笔记、任务、闪卡、健康读数/用药或自定义记录(kind / title / body / tags / priority / due;kind: "record" 时传 recordTypeId + recordValues)
  • quick_note_update — 更新既有条目(标题/正文/标签/优先级/截止/完成状态/记录字段,只改传入字段)
  • quick_note_complete — 完成任务或重新打开(id / status)
  • quick_note_type — 管理自定义记录类型(action: list/create/update/delete;create/update 传 name + fields,并可传 views 直接设置筛选视图;delete 会级联删除该类型的记录)
  • quick_note_workspace — 工作区价值分析与报告(action: list 列出价值/社会价值/阶段/未来价值/Token/金额/评价;rate 按路径保存人工评级与说明(含社会价值);snapshot 把当前分数写入价值趋势历史;report 返回所有工作区的 Markdown 价值报告;archive 把该报告保存为带「工作区/价值报告」标签的笔记)
  • 对话捕获:每条已完成的助手消息的操作行里有一个速记图标,点击即可把该回答存为一条笔记(自动加标签「对话」,内容重复时不会重复保存)
  • 错误边界:渲染失败时显示错误详情,不会只剩空白
  • 旧数据迁移:旧版单草稿(dsh.quick-note.draft)与旧便签列表(dsh.quick-note.notes)首次读取时自动迁移为条目

UI 升级(v1.1.0 / v1.1.1 / v1.1.2)

  • 设计系统:在原有主题令牌之上新增独立的 v3 样式层(间距节奏、圆角层级、hover/active 过渡、focus-visible、响应式与 prefers-reduced-motion),全部使用 --dsw-alias-* 令牌与 color-mix,无任何字面色值
  • 外壳:头部改为 Hero 卡(品牌色渐变底、图标、标题、副标题、同步状态 pill、带图标刷新按钮);标签页使用分段控件 + 线性图标;搜索框带内嵌图标;主要操作按钮使用品牌色实底
  • 概览:新增「今日概览」Hero(日期、四项即时指标 chips、快捷 CTA);5 张 KPI 卡带图标与状态色强调条;6 张快捷新建卡(图标 + 说明文字);「最近更新」改为图标 + 类型徽标列表;空状态统一使用 EmptyState 组件
  • 业务页:价值 / 用量 / 系统 / 全部 / 记录页统一 SectionHead;价值卡等级徽标按 A/B/C/D 着色并新增卡片头部布局;列表、看板、设置分组圆角与 hover 统一;设置页增加图标化头部
  • 可访问性与适配:保留所有 aria 与 focus-visible 语义;宽度 <860px 自动单列/换行;尊重系统 reduced-motion 偏好
  • 外观设置:设置页新增「外观」组——界面密度(舒适 / 紧凑,作用于面板与设置页)与强调色(默认品牌色 / 绿 / 黄 / 红,或自定义取色器中的十六进制色),偏好存 localStorage 的 dsh.quick-note.prefs.v2
  • KPI 迷你趋势线:五张概览 KPI 卡内嵌近 7 天迷你折线(任务=未来 7 天到期分布、卡片=待复习分布、复习=近 7 天复习量、健康=近 7 天指标记录、记录=近 7 天新建记录)
  • 骨架屏加载态:首屏、价值、用量、系统页加载时显示带 shimmer 动画的骨架卡片,替代纯文字提示
  • 拖拽排序动画:任务看板卡片悬停抬升、拖拽缩放、放置脉冲、目标列高亮,全部基于 CSS 过渡/关键帧并尊重 reduced-motion
  • 布局修正(v1.1.2,依据真机截图):标签页 white-space: nowrap + 横向滚动,避免中文标签逐字换行;Hero 去掉与页头重复的标题/副标题,改为「日期 + 今日概览 + 摘要 + CTA」;按钮内图标与文字统一 6px 间距;宽屏(≥1080px)概览 KPI 固定五列;KPI 迷你趋势线在零数据时也绘制基线,卡片视觉更完整
  • 中英文案同步(新增外观相关 10 键,移除 3 个不再展示的加载提示键),回归测试新增 UI 结构断言、交互样式断言与 CSS 括号平衡检查

深度功能(v1.2.0)

  • 命令面板:头部「Ctrl/⌘ K」按钮或快捷键打开,支持搜索全部条目(标题/正文/标签)与快捷操作(视图跳转、新建各类条目);↑/↓ 选择、Enter 执行、Esc 关闭
  • 置顶收藏:编辑器图钉按钮可置顶/取消,概览页新增「置顶条目」区块;置顶保存在本机偏好
  • 任务快捷截止:任务编辑器提供「今天 / 明天 / 下周」一键设为当天 18:00 截止
  • 复习增强:复习页显示「今日已复习 x / 目标 y」进度条(目标在 设置 → 外观 → 每日复习目标 调整);每次评分后可「撤销上次评分」,同步回滚卡片 SM-2 状态与复习日志
  • 完整路线图见 docs/ROADMAP.md(P0–P3 优先级、模块差距矩阵、技术质量目标)

深度功能(v1.3.0)

  • 数据备份与还原:Host 每次写入后自动滚动备份($DSH_HOME/quick-note/backups/,最多 10 份、约 5 分钟一份)+ 手动「立即备份」;设置页列出备份并可两步确认恢复;支持「导出完整备份 / 导入完整备份」(items + settings + reviews + types 全量 JSON),导入走乐观锁写入
  • 任务深度:检查清单(子任务,可勾选/删除,最多 50 条)、重复任务(每天/每周/每月,完成时自动生成下一次),任务页工具栏显示「今日完成 x/y、本周完成 n、逾期 n」统计
  • 复习深度:复习范围(到期 / 新卡 / 全部)、键盘快捷评分(1 重来 / 2 困难 / 3 记住 / 空格显示答案 / Esc 退出 / U 撤销)、专注模式(隐藏页头与工具栏,居中复习卡)
  • 健康参考范围:指标编辑器可设置参考下限/上限(本机偏好);详情页显示「正常 / 偏高 / 偏低」徽标,异常读数在历史列表中高亮
  • Agent 增量:新增 quick_note_batch 批量工具(完成/重开/软删除/优先级/标签/截止),quick_note_search 支持 tag、overdue、dueWithinDays 过滤;任务创建/更新支持 checklist 与 repeat
  • 新增 GET/POST /api/quick-note/backups 路由(token 保护),完整路线图与进度见 docs/ROADMAP.md

代码整洁与相似功能合并(v1.3.1 / v1.3.2)

  • 分段控件统一:新增 Segmented 组件,替换价值排序、趋势时间范围、趋势指标、复习范围、外观密度共 5 处内联 tab/filter 渲染
  • 价值标签统一:删除价值卡内的 stage/future/social 三张本地映射表,统一复用 valueStageText / valueFutureText / valueGradeText(报告与 CSV 已在用)
  • 创建入口统一:createItem 直接委托 quickCreate(viewKind),去掉两份几乎相同的创建逻辑
  • 设置写入统一:新增模块级 writeSettings(mutator) 与面板级 saveSettings,替换快照/清理历史/工作区评价/简报开关/定价保存等 7 处「readState → putState → 更新 refs」重复代码
  • 概览行组件统一:新增 OverviewRow,置顶与最近更新两个区块共用
  • 导出统一下载:新增 downloadTextFile,替换 CSV / Markdown / 条目导出 / 完整备份 4 处 Blob+anchor 重复代码
  • 受保护请求统一:protectedRequest 合并 read/post 两套 token 重试逻辑
  • 保存调度统一:scheduleSave 合并 applyItems / applyTypes 的防抖写入
  • Host 只读路由统一:createReadRoute 合并 admin/usage/value 三处方法/路径/token/异常样板;costOfTokens 合并用量与价值报告的金额计算
  • 视图/类型元数据统一(v1.3.2):新增 VIEW_META / KIND_META 中央表,替换标签页文案、tab 图标、创建按钮文案、命令面板动作、快捷新建卡共 5 处分散映射
  • 表格行统一(v1.3.2):新增 TableRow,全部表与记录表共用同一行结构
  • Host 工具文本统一(v1.3.2):新增 renderText,替换 16 处 [{ type: &#x27;text&#x27;, … }] 重复返回
  • 说明:设置页与面板的共享状态层经评估暂缓(生命周期与宿主注入不同,强行共享会引入跨组件订阅),已用 writeSettings 复用写路径把重复降到最低
  • 结果:client.js 约 396KB → 389.6KB、index.js 约 103KB → 101.7KB,行为与 81/65 回归基线保持一致

聊天即录入(v1.13.0)

  • 斜杠命令(Host commands 服务):在对话输入框直接录入/查询,不打开面板也能工作
  • /note &lt;文本&gt; 保存笔记;/capture &lt;文本&gt; 捕获对话片段(自动加「对话」标签)
  • /task &lt;标题&gt; [--due 2026-11-06|今天|明天] [--priority low|normal|high] [--tag 标签]
  • /search &lt;关键词&gt; 搜索并返回条目 id;/plan 汇总未来 7 天任务/复习/用药;/review 查看今日待复习
  • 命令注册失败(名称冲突等)会被安全跳过,不影响插件加载
  • 会话行捕获:侧栏会话悬停操作新增「保存会话为笔记」(带来源会话 id、「会话」标签,自动去重)
  • 输入区快速入口:对话输入工具行新增「快速记录」按钮;输入框下方显示环境提示 chip「N 待办 · N 复习 · N 用药」,点击直达管理台
  • R2 真实浏览器冒烟:新增 test/browser-smoke.mjs,用本地 Edge/Chrome headless + CDP 在真实 DOM/CSS 中验证:6 个合并标签、知识子标签、计划→日历 42 格 + 时间轴、无横向溢出、无未捕获异常,并输出截图 test/artifacts/panel-smoke.png;默认用内置 fixture(真实 React + 真实浏览器),也支持 --url= 对真实 GUI 冒烟

省钱模式效果追踪(v1.44.0)

  • 自动省钱面板新增「省钱模式效果」:对比启用前日均费用与启用后日均费用,显示变化百分比
  • 未启用过省钱模式时回退为「近 7 天 vs 前 7 天」趋势对比
  • 数据来自 30 天费用序列,不额外请求 Host
  • 回归:Host 214 + Client 168 + 浏览器冒烟 20;client 约 660KB、index 约 266KB、文案 804 键

模型策略选择与预算护栏验证(v1.43.0)

  • 自动省钱面板新增「省钱模型」下拉:列出当前 provider 暴露的全部模型,可手动指定;留空为自动选择
  • 「发现省钱模型」会刷新候选与全量模型目录
  • 用量页预计月费用改为按月内进度推算(月至今费用 ÷ 已过天数 × 当月天数),无数据时回退 7 日均值 × 30
  • Host 预算护栏新增回归:自动设置极低预算后,检查预算即时检查能自动开启省钱模式
  • 回归:Host 214 + Client 168 + 浏览器冒烟 20;client 约 657KB、index 约 266KB、文案 800 键

系统/清理计划/价值/用量 UI 统一(v1.42.0)

  • 系统:新增「预算与省钱策略」卡片,展示每日/月度预算、省钱模式、省钱模型,并提供「打开优化中心」入口
  • 清理计划:顶部新增「下次执行 / 最近结果 / 成功次数」KPI,包含自动清理摘要(次数、删除文件、释放空间)
  • 价值:新增「高价值工作区 vs 高消耗工作区」并排卡片
  • 用量:
  • 新增工作区费用趋势横向条形图
  • 新增「预计月费用」KPI(近 7 天日均 × 30)
  • 会话排行增加 #1 排名
  • 回归:Host 213 + Client 168 + 浏览器冒烟 20;client 约 656KB、index 约 264KB、文案 798 键

可配置省流名单与省钱前后趋势(v1.41.0)

  • 可配置高消耗工作区省流名单:面板直接勾选费用 Top 3 工作区;名单持久化到 thriftWorkspaces,省钱模式系统提示会点名这些工作区,要求定向读取、禁止整文件粘贴
  • 省钱前后费用对比:30 天费用图新增「实际费用」与「无缓存基线」双折线,并显示累计节省金额
  • 自动发现低价模型:从当前 LLM provider 发现 flash/lite/mini/fast/turbo 类模型,自动排除 max/pro/ultra/reason/thinking;候选出现在面板,一键「发现省钱模型」强制刷新,开启省钱模式时自动选最优候选
  • 基线:Host 213 + Client 165 + 浏览器冒烟 18;client 约 647KB、index 约 264KB、文案 782 键
  • 构建预算 680KB / 280KB

预算护栏与一键省钱模式(v1.40.0)

  • 自动预算护栏:
  • 每日/月度预算达到 80% 发送 Webhook 告警
  • 达到 100% 自动开启省钱模式(savingsGuard 默认开启)
  • 预算状态在自动省钱面板实时显示
  • v1.40.1:新增「检查预算」按钮,可立即执行预算判断并触发降级
  • 一键省钱模式:
  • 优化中心「开启省钱模式」按钮,Host POST /api/quick-note/savings-policy 持久化
  • 自动选择 flash/lite/mini/fast 类省钱模型并写入 DSH 默认模型(新会话生效)
  • 注入精简系统提示:不重复全文、优先 diff、限制输出约 1200 tokens
  • 面板显示当前默认模型与省钱模型
  • 压缩/裁剪插件保持自动运行(阈值 70%)
  • 高消耗工作区省流:
  • 自动省钱面板显示费用最高的 3 个工作区
  • 省流提示纳入系统提示:优先定向读取、避免整文件粘贴
  • 基线:Host 213 + Client 165 + 浏览器冒烟 18;client 约 643KB、index 约 262KB、文案 775 键
  • 构建预算相应调整为 client 680KB / index 280KB(大版本功能增加)

自动省钱面板与自动压缩(v1.39.0)

  • 启用并验证 DSH 官方自动降费插件:
  • @deepseek-ai/dsh-compaction-basic:自动上下文压缩,auto: true,阈值 70%,保留 35%
  • @deepseek-ai/dsh-compaction-tool-result-pruner:自动裁剪超长工具结果
  • @deepseek-ai/dsh-command-compact:/compact 手动压缩
  • 优化中心新增「自动省钱」面板:
  • 显示自动压缩 / 工具结果裁剪 / 压缩命令是否开启
  • 显示当前会话上下文占比、压力 Token、预计可压缩 Token
  • 显示每日/月度预算状态
  • 「打开插件设置」一键跳转,刷新按钮即时更新
  • 新增 Host 只读接口 /api/quick-note/savings:汇总 compaction、pruner、command、
    tokenMeter、agents 状态与当前会话压力;新会话、高压力会话均可见
  • 验证:当前会话 35.1%(368,238 / 1,048,576 tokens);高压力会话 68.8%(720,972 / 1,048,576),预计可压缩 196,684
  • 基线:Host 211 + Client 165 + 浏览器冒烟 18;client 约 639KB、index 约 252KB、文案 767 键

费用/命中率深度可视化(v1.38.0)

在 v1.37 仪表盘基础上新增:

  • 按工作区费用横向条形图:最多 6 个工作区,按费用排序,显示金额、Token 数和相对长度
  • 近 30 天费用趋势折线图:带日期轴、最新值、渐变面积和数值网格
  • 近 30 天缓存命中率折线图:带 70% 目标虚线、最新命中率和日期轴
  • “预计可节省”可展开:
  • 计算口径:输入 Token 总量、当前/目标/可达命中率、命中/未命中单价差
  • 明确公式:输入 Token × 提升命中率 × 单价差 ÷ 1,000,000 = 可省金额
  • Host 的 efficiency.daily30 增加每日 cacheHitRate,供趋势线使用
  • 真实浏览器冒烟新增工作区条形图、趋势线、展开计算过程断言与截图

基线:Host 210 + Client 164 + 浏览器冒烟 18;client 约 632KB、index 约 249KB、中英各 754 个文案键。

Token 效率与费用可视化(v1.37.0)

管理台 分析 → 优化中心 新增可视化仪表盘:

  • 预计可节省:缓存命中率提升到目标后的累计金额估算,最显眼展示
  • 效率评分环:综合评分圆环 + 缓存/成本/输出三项分数
  • 费用构成环图:缓存命中输入 / 未命中输入 / 输出三段的金额占比与图例
  • 费用可视化:当前累计与优化后预计的双进度条,并显示可省百分比与金额
  • 优化建议:带 可省 ¥x 金额徽标
  • 响应式:卡片自适应网格,窄屏自动换行
  • 实机浏览器冒烟新增“优化中心”截图与无横向溢出检查

当前基线:Host 209 + Client 162 + 浏览器冒烟 16;client 约 622KB、index 约 249KB、中英各 742 个文案键。

管理台审计与日历/工具修复(v1.36.0)

  • Agent 工具输出 Schema 修复:quick_note_search 等工具返回的 health.intakes 未在共享 ITEM_SCHEMA 中声明,运行时校验会拒绝整个工具结果;已补齐并加回归检查
  • 日历/时间轴用药聚合:同一用药计划在同一天只显示一个事件(Drug A ×2),不再为每个服药时间生成重复 chip;悬停/选中详情显示完整时间列表
  • 日历性能与可访问性:42 天网格事件按天缓存;日期按钮增加事件数 aria-label 与 aria-pressed
  • 日历 v1.36.1 补充:新增「用药」显隐切换、聚合文案走 i18n、窄屏月历横向滚动
  • 回归:Host 209 + Client 161 + 浏览器冒烟 13 全通过
  • 审计报告:docs/AUDIT-2026-11-10.md

曲线拟合 / 用药提醒 / 自定义快捷键 / 备份可视化 / 多时区等(v1.35.0)

  • 遗忘曲线指数拟合:按 ln(保持率)~天数最小二乘拟合,输出 1/7/30 天预测与半衰期
  • 用药提醒 + 依从性周报:设置 medReminderEnabled(Host reminders 过滤用药);健康页 7 天逐日 ✓/完成数周报与提醒开关
  • 快捷键自定义:设置 shortcuts.palette/help,标题快捷键与 ? 均可改;帮助面板显示当前值
  • 备份自动间隔可视化:设置页显示下次自动备份进度条与百分比
  • Cron 多时区对照:cron-preview-multi 同时返回 local/UTC/Asia/Shanghai 各 3 次
  • PNG 标题/坐标:480×260,含 SHARE ACCESS 标题、坐标轴、网格与柱状图
  • Webhook 队列导出/导入:webhook-export / webhook-import(JSON 数组,去重合并)
  • 预设排序:回收站自定义预设支持 ↑/↓ 调整顺序
  • 回归:Host 208 + Client 157 + 浏览器冒烟 13 全通过

A 包:复习曲线 / 用药依从 / 快捷键 / 备份差异 + Cron 修正(v1.34.0)

  • 复习遗忘曲线预测 + 目标完成历史:复习页新增 1/7/30 天保持率预测,以及最近 7 天每日完成数 vs 目标条形
  • 用药依从性周统计:med 条目新增 health.intakes 记录;本周依从率 + 「记录已服」按钮,Host/Client 双向归一化
  • 快捷键帮助面板:按 ? 或标题栏 ? 打开,列出 Ctrl/⌘K、1/2/3、Space、U、Esc;Esc 关闭
  • 备份差异预览 + 自动备份间隔:Host 新增 GET /backups?diff=name(新增/删除/修改/设置变化);设置可配置 1–1440 分钟自动备份间隔
  • Cron 技术债:日/周字段同时受限时改为标准 OR 语义;清理定时器由 15 分钟轮询改为 15 秒
  • 回归:Host 203 + Client 157 + 浏览器冒烟 13 全通过

IANA 时区 / PNG 图表 / 队列入 store / 自定义预设(v1.33.0)

  • 完整 IANA 时区:Cron 时区支持 Asia/Shanghai、Asia/Tokyo、Europe/London、America/New_York 等 IANA 名称(Host 用 Intl 计算时区日历字段),预览仍为 10 次
  • 分享 PNG 图表:新增 {action:&#x27;share-chart-png&#x27;},Host 自带 PNG 编码器生成 480×240 条形图并保存 share-chart.png;面板提供「导出 PNG 图表」
  • Webhook 队列持久化到 store:队列从独立文件迁入 items.json 文档字段 webhookQueue(由 store 锁与 revision 管理),旧文件仍作兼容回退
  • 回收站自定义预设:可命名保存当前类型/工作区/搜索组合到设置 trashPresets,面板一键应用或删除
  • 回归:Host 198 + Client 152 + 浏览器冒烟 13 全通过

Cron 时区/10 次预览 / 分享图表区间 / Webhook 批量 / 回收站预设(v1.32.0)

  • Cron 时区:新增 cleanupScheduleTimezone(local / UTC±h),cron 匹配按指定固定时区计算;预览扩展为未来 10 次
  • 分享图表日期区间:分享统计条形图按报告日期输入过滤(与 CSV 导出一致)
  • Webhook 队列批量操作:多选队列项,支持批量编辑 payload、批量重发、批量删除
  • 回收站组合预设:快速预设(全部/仅附件/仅临时/仅构建)叠加类型、工作区、搜索、分页
  • 回归:Host 195 + Client 152 + 浏览器冒烟 13 全通过

Cron 预览 / CSV 区间 / Webhook 编辑重发 / 工作区筛选(v1.31.0)

  • 可视化 Cron 预览:新增 cron-preview 动作,返回未来 5 次执行时间;优化面板提供「预览下 5 次」按钮并展示时间列表;非法表达式返回 400
  • 分享 CSV 日期区间:share-csv 支持 from/to 过滤(按 lastAt/firstAt),客户端复用报告日期输入;返回 range
  • Webhook 队列编辑/重发:新增 webhook-edit(修改 URL/JSON payload、重置 attempts)与 webhook-resend(立即重发单条);面板逐条提供「重发 / 编辑 / 删除」
  • 回收站按工作区筛选:trash records 新增 roots,面板新增工作区下拉(全部工作区 + 各 root),与类型/搜索/分页组合
  • 回归:Host 192 + Client 152 + 浏览器冒烟 13 全通过

Cron 表达式 / 分享 CSV / Webhook 队列面板 / 回收站类型筛选(v1.30.0)

  • Cron 表达式:新增 cleanupScheduleCron,支持五段式(分 时 日 月 周,如 0 3 * * 1);计划模式新增 cron,Host 按表达式计算下次执行并判断到期;优化面板与计划页均可设置
  • 分享统计导出 CSV:新增 {action:&#x27;share-csv&#x27;},导出 share-stats.csv(name/count/firstAt/lastAt/refs),客户端显示保存路径与行数
  • Webhook 队列持久化面板:队列项展示 URL/错误/时间,可单条删除(webhook-remove);保留手动重试全部
  • 回收站按类型筛选:全部/附件/临时/缓存/构建 五个筛选按钮,与搜索、分页组合生效;trash records 保留类别信息
  • 回归:Host 186 + Client 150 + 浏览器冒烟 13 全通过

Cron 时间 / 分享图表与来源 / Webhook 重试队列 / 回收站分页(v1.29.0)

  • Cron 自定义时间:新增 cleanupScheduleTime(HH:MM,默认 03:00);自动清理计划页与优化面板都可设置执行时间,Host 按“当天该时刻”判断 daily/weekly 是否到期并计算 nextRunAt
  • 分享统计图表 + 来源分析:分享访问记录增加 referrer 主机名;扫描返回带 refs 的 shareStats,优化面板以条形图显示 Top 分享访问量,并列出 direct/来源域名分布
  • Webhook 失败重试队列:发送失败写入 webhook-queue.json(最多 20 条,指数退避,5 次上限);Host 每 5 分钟自动重试,面板显示队列数量与「重试队列」按钮(手动立即重试全部到期项)
  • 回收站分页 + 容量预警:回收站记录每页 5 条(‹ / › 翻页,搜索自动回到第一页);使用率达到 80% 时显示容量预警
  • 回归:Host 182 + Client 149 + 浏览器冒烟 13 全通过

计划页 / Webhook 模板 / 回收站批量恢复 / 分享统计(v1.28.0)

  • 清理计划独立页:分析新增「清理计划」子标签,展示计划模式、上次/下次执行、最近 20 条运行记录;有失败项时出现「重试」,可立即触发自动清理
  • Webhook 模板 + 测试发送:支持 generic / slack / feishu 三种载荷;优化标签提供模板选择与「测试发送」按钮(Host 强制发送一次示例,不走按天去重)
  • 回收站搜索与批量恢复:trash records 列表支持按记录 id/日期搜索、多选与批量恢复;Host 新增 {action:&#x27;restore&#x27;, ids},最多一次 20 条
  • 报告分享访问统计:每次访问 share HTML 计入 share-stats.json(count/firstAt/lastAt);扫描结果返回 shareStats,优化标签显示 Top 分享与访问次数
  • 回归:Host 178 + Client 147 + 浏览器冒烟 13 全通过

计划日志 / 自定义日期区间 / 预算 Webhook / 回收站限额(v1.27.0)

  • 自动清理计划日志:扫描结果新增 schedule {mode,lastRunAt,lastResult,nextRunAt};面板显示上次执行/下次预计时间,历史里自动清理记录带「自动」标记
  • 报告自定义日期区间:优化标签新增开始/结束日期输入,导出/分享的报告 HTML 按区间过滤每日费用并显示「统计区间」;Host 返回 range
  • 预算 Webhook:设置新增 budgetWebhookUrl;Host 定时器在 80% 预警/超支时 POST JSON(含 event/todayCost/limit/percent/monthly 字段),按天去重;客户端提供保存入口
  • 回收站容量上限:最多 20 条或 1GB,超出按最旧记录自动淘汰并标记历史不可撤销;面板显示 count/20
  • 回归:Host 175 + Client 144 + 浏览器冒烟 13 全通过

回收站管理 / 报告区间 / 月度预算 / 自动清理(v1.26.0)

  • 回收站管理:扫描结果新增 trash {count,bytes,records};面板显示回收站条数/占用,支持「清空回收站」;可撤销历史显示「剩余约 N 小时可撤销」与「撤销清理」
  • 报告快照时间范围:优化报告 HTML 新增 range-filter(近 7 天 / 近 30 天切换),daily30 数据驱动每日费用表
  • 月度预算 + 30 天曲线:设置新增 tokenBudgetMonthly;优化标签增加月度预算输入、月度进度/超支状态与近 30 天费用曲线;reminders budget 增加 monthly 字段
  • 自动清理计划:设置新增 cleanupSchedule(off/daily/weekly);Host 每 15 分钟检查并按天/周执行安全类别自动清理(pluginTemp/workspaceJunk/workspaceCaches,进回收站可撤销);面板支持「立即自动清理」
  • 回归:Host 171 + Client 143 + 浏览器冒烟 13 全通过

回收站撤销 / 快照筛选 / 80% 预警 / 会话跳转(v1.25.0)

  • 回收站(真撤销):清理不再直接删除,文件/目录先移入 $DSH_HOME/quick-note/trash//;历史记录 recoverable:true、24 小时有效
  • 客户端历史记录出现「撤销清理」按钮;POST /cleanup {action:&#x27;undo&#x27;, id} 恢复原路径(目标被占用时加 .restored- 后缀)
  • 扫描时自动清理超过 24h 的 trash;过期记录拒绝撤销
  • 优化报告 HTML 筛选/搜索:报告快照新增搜索框 + 工作区下拉;按工作区/关键词过滤工作区与会话表格、以及优化建议
  • 80% 预算预警:reminders budget 增加 warn/status;达到 80% 先发一次预警通知,超支再发一次超支通知(均按天去重)
  • 会话跳转:优化标签的「高消耗会话」「工作区会话」变为可点击,调用 uiWorkspace.openSession(sessionId) 直接打开对应对话(无此服务时静默忽略)
  • 回归:Host 165 + Client 140 + 浏览器冒烟 13 全通过

预算提醒 / 报告快照 / 工作区下钻(v1.24.0)

  • 预算超支接入 Host 提醒:tokenBudget 改为持久化在文档设置(Host 可见);reminders 快照新增 budget {limit,todayCost,percent,over},客户端 ReminderBridge 在超支时按天去重发送系统通知(预算超支:今日已用 ¥x / 预算 ¥y)
  • 报告分享为只读快照:POST /api/quick-note/optimizer-report 支持 {format:&#x27;html&#x27;},生成带暗色主题的独立 HTML 到 shares/,返回 /api/quick-note/share/ 链接;客户端新增「分享报告快照」按钮
  • 按工作区成本下钻:优化标签新增「工作区费用明细」,点击工作区展开该工作区的高消耗会话(session id / tokens / 费用)
  • 清理历史细化:历史记录新增 recoverable: false 标记;UI 明确显示「不可撤销」并按类别展示重建/恢复提示
  • 回归:Host 163 + Client 137 + 浏览器冒烟 13 全通过

清理历史、会话下钻与优化报告(v1.23.0)

  • 清理历史与恢复提示:每次清理写入 $DSH_HOME/quick-note/cleanup-history.json(最多 20 条);优化标签展示最近记录(时间/删除项/释放空间)与按类别的恢复提示(附件不可恢复、构建产物如何重建、缓存会按需重建等)
  • 高消耗会话下钻:优化标签新增「高消耗会话」列表,展示工作区、tokens、费用(取用量报告 topSessions 前 6)
  • 优化报告导出:新增 POST /api/quick-note/optimizer-report,Host 汇总效率评分/建议/高消耗工作区与会话/清理统计,生成 Markdown 到 $DSH_HOME/quick-note/reports/optimizer-.md;客户端一键导出并显示路径
  • 回归:Host 160 + Client 133 + 浏览器冒烟 13 全通过;token 保护、构建一致性门禁保持

优化中心并入管理台 + 每日预算(v1.22.0)

  • 合并入口:优化中心不再单独占侧栏,已并入管理台 分析 → 优化 子标签(与价值 / 用量 / 系统并列);侧栏只保留「管理台」一个入口
  • 每日预算:优化标签新增「每日预算(¥)」输入;设置后显示今日消耗进度条与超支提醒(超额变红),预算保存在本地偏好(tokenBudget)
  • 保留能力:效率评分、费用 KPI/14 天柱图、缓存节省估算、优化建议、跨工作区扫描/清理全部保留
  • 回归:Host 156 + Client 130 + 浏览器冒烟 13 全通过;构建一致性门禁照常

优化中心:Token 效率可视化 + 工作区空间清理(v1.21.0)

> v1.22.0 起优化中心已并入管理台「分析 → 优化」子标签,不再单独侧栏显示;以下能力仍在。

  • 侧栏新增「优化中心」面板(id quick-note-optimizer):
  • Token 效率评分(0–100):缓存命中 50% + 会话成本 30% + 输出占比 20% 加权
  • 费用可视化:今日/近 7 日费用、会话均费、累计 Token/费用、近 14 天费用柱状图
  • 可节省估算:缓存命中率提升到目标(70%)可省的金额(按未命中/命中单价差计算)
  • 优化建议卡片:缓存命中、高消耗工作区占比、输入占比过高、会话均费基线,含高/中/提示分级
  • 空间清理(跨工作区):
  • 扫描插件数据:孤立附件、更新暂存安装包、插件临时文件
  • 扫描所有已登记工作区:temp/log/系统残留(.DS_Store、Thumbs.db 等)、缓存目录(__pycache__/.pytest_cache/.cache/node_modules/.cache)、构建产物(dist/build/out/target/coverage/.next,需显式勾选)
  • >50MB 且 90 天未改的大文件仅报告(不可删除),供人工判断
  • 清理流程:先扫描 → 勾选类别 → 清理所选;Host 重新扫描后只删除本轮扫描产物且校验路径在记录 root 内,防目录穿越;不触碰源文件、未勾选类别与未引用校验失败的附件
  • 扫描本身有界(每个扫描最多 5000 个文件 / 6 秒,超出标记 truncated),避免大工作区卡住面板;清理仅针对本轮扫描结果
  • 全部通过 loopback token 保护,扫描本身只读
  • 测试:Host 156 项(效率评分/建议、扫描类别、清理删除与保留校验、token 401)、Client 131 项(优化中心注册/评分/清理类别渲染)

R1 收尾:entry 壳 + 构建一致性门禁(v1.20.0)

  • src/entry.mjs:PanelBoundary 类、常量和 apply 注册代码整体迁入(27KB)
  • src/client.template.js 缩到 181B,只含 window.__ModuleLoader__.load 壳、factory 与 apply 返回;所有逻辑/数据均来自 src/ 模块
  • 构建一致性检查:
  • build-client.mjs 导出纯函数 composeClient()
  • check-build.mjs 比对 client.js 与重新生成的文本,不一致退出 1
  • Host 回归新增 build artifact matches source;npm test 在跑回归前执行 build + check,手改产物会直接失败
  • 构建产物保持 517,514B 字节不变,回归 150 + 126 全通过
  • 可选 helpers 按域拆分本轮未执行:119 个函数源块的注入顺序与位置有语义依赖,需要先建立依赖/顺序清单再拆;建议作为独立重构(见 NEXT-FEATURES)

R1 第四步:面板主体模块化(v1.19.0)

  • 119 个顶层函数/组件源码迁入 src/helpers.mjs,包括:
  • WorkbenchPanel 面板主体
  • 全部数据归一化/格式化/提醒/附件/语音等辅助函数
  • 其余独立组件
  • src/client.template.js 仅保留常量、PanelBoundary 类与 apply 注册代码,从 361KB 降到约 26KB
  • 构建脚本按原顺序注入 119 个函数块;产物 client.js 仍为单文件,字节数与迁移前一致(517,514B),等价性回归通过
  • scripts/extract-helpers.mjs 记录迁移过程;R1 主体迁移完成,后续可继续把 PanelBoundary 类与 apply 拆出

组件模块化、Host 提醒与性能预算(v1.18.0)

  • R1 第三步(组件模块化):SectionHead、SettingsSection、DueReminder 三个组件源码迁入 src/components.mjs,template 再缩至约 353KB;构建仍输出单文件 client.js,完整回归通过
  • P1-4 Host 定时器 + 通知桥:Host 每 60s 计算提醒快照(到期任务/用药/复习卡片),新增 token 保护的 GET /api/quick-note/reminders;客户端新增 ReminderBridge 覆盖层,消费 Host 快照并按天去重发送系统通知(原页面提醒条保留)
  • 性能预算:
  • 构建体积上限:client.js < 640KB、index.js < 220KB、template < 500KB(Host 测试断言)
  • 面板渲染预算:<100ms(客户端测试实测 0ms)
  • 浏览器启动预算:<5000ms(R2 冒烟实测,CI 守护)
  • 快照增强:只读 HTML 增加搜索框、全部/笔记/任务/卡片筛选、prefers-color-scheme 暗色跟随;筛选脚本内联、无外部依赖

只读快照与 R1 第二步(v1.17.0)

  • P1-5 只读快照:设置 → 数据区新增「生成只读快照」,Host 生成独立 HTML(笔记/任务/卡片、转义安全、内联样式),保存到 $DSH_HOME/quick-note/shares/,返回本地路径;GET /api/quick-note/share/?token=... 可带 token 在浏览器打开;文件名白名单校验,防目录穿越
  • R1 第二步:ICON_PATHS、STYLES、STYLE_UPGRADES 迁出到 src/ui-assets.mjs;template 从约 464KB 降到约 386KB,构建产物仍为单文件 client.js
  • 等价性:构建后完整回归通过(Host 145 / Client 125),CSS 大括号平衡、主题令牌检查保持
  • 后续 R1:继续迁移组件与面板逻辑到 src/,每步重建并跑回归

语音、Markdown 与构建拆分(v1.16.0)

  • P1-1 语音速记:输入区工具栏新增麦克风按钮,浏览器录音后在前端重采样为 16kHz 单声道 WAV,上传到 Host /api/quick-note/transcribe,由 DSH speechToText 服务转写并保存为「语音」标签笔记;服务缺失/无 provider 时给出明确提示
  • P1-3 Markdown 文件夹导入/导出:设置 → 数据区新增目录输入与导出/导入按钮;导出带 front matter 的 .md(source: quick-note),导入按 id/标题+正文去重并打「导入」标签;路由 token 保护
  • R3 写入开关:设置新增「同步写入方式」,默认增量 PATCH,可切全量 PUT 用于调试/兼容;flush 按开关选择路径,冲突仍走全量合并兜底
  • R1 构建拆分(第一步):client.js 改为生成产物——文案字典迁出到 src/locale.mjs,其余代码在 src/client.template.js,scripts/build-client.mjs 注入生成;npm run build 重建,npm test 先构建再跑回归;本轮已通过完整等价性回归(Host 141 + Client 124)
  • 后续 R1 迁移:把组件、样式、面板逻辑继续迁入 src/,每步跑等价性回归

网页剪藏与提醒增强(v1.15.0)

  • PATCH 增量写入(R3 完成):PATCH /api/quick-note/state 接收 upserts(新增/修改/墓碑)并支持 If-Match,409 冲突返回当前完整文档;客户端 flush 改为按内容签名 diff 只上报变更条目,冲突时回退全量 PUT 合并;实机/客户端测试确认编辑使用 PATCH 而非整包写入
  • 网页剪藏(P1-2):新增 /clip 斜杠命令与 POST /api/quick-note/clip 路由;Host 抓取网页(15s 超时、2MB 上限、跟随重定向)提取 og:title/``、描述与正文摘要,保存为带「剪藏」标签的笔记(正文含来源 URL)
  • 提醒增强(P1-4 客户端 + Host 简报):
  • 页面内提醒条新增 复习到期卡片 数量(复习到期 N 张),并像用药一样对到期卡片发送每日一次系统通知
  • Host 每日简报新增「管理台待复习:N 张(卡片名…)」,Agent 上下文可直接感知复习任务
  • R1 构建拆分:本轮未执行;需要在插件目录安装 esbuild 并把 10k 行 client.js 拆成 src/ 模块,属于高风险机械重构,建议单独迭代(见 NEXT-FEATURES 的 R1 计划)

知识库升级与性能(v1.14.0)

  • 附件与图片笔记:笔记/任务/卡片编辑器新增「附件」区,可上传图片(缩略图预览)与文件(pdf/txt/md/csv/json/zip/音视频),单文件 ≤25MB、单条最多 12 个;支持删除引用;存储于 $DSH_HOME/quick-note/files/(loopback token + 随机 id 保护;``/下载链接带 token query);JSON 备份只含附件引用,文件本体单独保留在该目录
  • 增量同步(R3 读路径):GET /api/quick-note/state?since= 只返回该水位之后变更的条目、新增复习与设置,客户端 12 秒轮询携带本地水位并合并(保留本地墓碑);首次加载/冲突仍走全量;写路径仍为整包 PUT(下一步做 diff 写入)
  • 列表虚拟化(R4):超过 150 行的扁平列表自动窗口化(VirtualRows,60 行缓冲),仅渲染可视区附近行;短列表保持原样,快捷键/批量/选中逻辑不变
  • 命令与捕获保留:v1.13 的 6 个斜杠命令、会话行保存、输入区快速记录、dock chip 全部保留

Harness 版本管理(v1.12.0)

  • 位置:分析 → 系统 子标签底部「Harness 版本管理」分组
  • 版本通道(稳定版 + 其他版本):
  • 官方稳定版直链:一键完成 HEAD 构建检查 → 下载 → 本地 SHA-256 → 审批;约 276MB 流式下载,无需配置更新源
  • 其他版本(GitHub Releases):拉取官方 Release 列表(含预发布),逐条显示版本号 / 预发布徽标 / 发布时间 / 是否有安装包;有资产可直接下载该版本,无资产时提示并提供 Release 页面链接
  • 自定义安装包 URL:可粘贴任意 https 安装包地址(可选 SHA-256);下载后展示本地哈希,审批确认后安装(适用于官方离线包/社区构建等)
  • 审批安装:三类来源(manifest 校验哈希 / 官方直链 / 自定义 URL)均需显式勾选确认 + 本地 SHA-256 一致;Host 二次校验暂存文件哈希,未开启高风险开关也可审批安装
  • 更新说明可读性:GitHub Release notes 清洗 HTML/锚点/Markdown、截断,并提供「展开全文 / 收起」与 Release 页面链接
  • 无安装包资产指引:官方 Release 无资产时显示提示与官方直链/自定义 URL 入口,不会误触发下载
  • 操作反馈:所有操作点击后立即显示「正在处理…」,失败附带 Host 具体原因
  • 版本信息 / 更新源:读取 app.asar 当前版本;仍支持自定义 JSON manifest 更新源
  • 自动检查更新(仅提醒,不自动安装):每 6 小时最多检查一次,发现新版本页头徽标 + 系统通知,点击直达分析 → 系统
  • 官方源配置模板:一键填入官方源占位模板(替换 host 为官方发布地址)、一键复制 manifest 模板;仓库另附 docs/update-manifest.example.json 可直接托管到 GitHub Releases / 静态站点
  • 下载更新:下载到 $DSH_HOME/quick-note/staging/,上限 256MB,超时 20s,提供 SHA-256 时强制校验;可「打开下载目录」
  • 安装更新:审批路径需校验通过;旧路径 Windows .exe 静默安装(/S)、.msi 走 msiexec /quiet,其他类型返回不支持并给出文件路径供手动安装;只执行本次下载并核验过的暂存文件,不接受任意路径
  • 重启 DSH(需开启开关 + 二次确认):重新拉起 process.execPath 后退出当前进程;会结束当前会话
  • 安全默认:自动更新开关默认关闭;自动检查只读且不下载;所有版本管理请求需 loopback token;下载源与文件哈希均需人工确认

分析模块(v1.5.0)

  • 三合一:原「系统 / 用量 / 价值」三个顶层标签合并为一个「分析」标签,内部用 Segmented 子标签切换(价值 / 用量 / 系统),选择写入偏好 insightTab
  • 用量细化:4 张 KPI(Tokens / 金额 / 缓存命中率 / 会话数)、近 14 天用量折线、每工作区缓存命中率/均 Token/最近活跃、会话 Top 12(会话 ID、工作区、Token、金额、最近活跃)
  • 社会价值深化:6 维加权评分(文档/许可证/测试/社会影响/工程沉淀/持续活跃)、维度进度条、优势/短板标签、提升建议(README/文档/许可证/测试/领域/活跃)
  • 新增 Host 字段:daily[]、topSessions[]、totals.cacheHitRate、totals.avgTokens、行级 cacheHitRate/avgTokens/lastAt;价值行新增 socialBreakdown/socialStrengths/socialGaps/socialSuggestions

模块合并(v1.11.0)

  • 知识 = 笔记 + 复习(学习):原「笔记」「复习」两个顶层标签合并为「知识」,内部 Segmented 子标签切换(笔记 / 复习),选择写入偏好 knowledgeTab;卡片复习、SM-2、目标/专注/撤销、卡片明细等全部保留
  • 计划 = 任务 + 日历 + 用药时间轴:原「日历」并入「任务」并更名为「计划」,布局为「列表 / 看板 / 日历」;日历页新增 未来 7 天计划时间轴,把任务截止、卡片复习、用药提醒聚合为按天分组的时间线(点击事件跳转条目)
  • 概览 = 概览 + 全部:「全部」跨模块表格并入「概览」子视图(概览 / 全部),批处理与筛选能力不变,overviewTab 偏好持久化
  • 标签数量:11 → 6(概览 / 知识 / 计划 / 健康 / 记录 / 分析),设置中的模块开关、路由、数据结构、Agent 工具完全不变
  • 共享组件:所有子标签/布局复用 Segmented 与统一偏好持久化,无新增数据字段

任务日历(v1.4.0)

  • 新增「日历」标签页:月视图网格(42 格,含上/下月灰显),同时展示 任务截止(due)+ 卡片复习(review.dueAt)+ 用药计划(每日 times)
  • 顶部工具栏:上一月 / 下一月 / 今天、本月事件总数;事件按颜色区分(任务=强调色、复习=黄色、用药=绿色、逾期=红色、已完成=删除线)
  • 点击任意日期查看「当日安排」完整列表,点击事件直接跳转到对应条目;跨月事件仍在上/下月格中显示
  • 响应式:窄屏隐藏格内事件 chip,仅保留日期与当日详情;全部使用主题令牌与强调色变量

数据与通道

项目 说明
数据文件 $DSH_HOME/quick-note/items.json(未设置 DSH_HOME 时为 ~/.dsh/quick-note/items.json)
同步接口 GET/PUT /api/quick-note/state(Host 半区注册在 Web 服务器上的普通路由;桌面版只监听 127.0.0.1,无鉴权;支持 If-Match/ETag 乐观锁)
只读分析接口 GET /api/quick-note/admin、/usage、/workspace-value;需 GET /api/quick-note/auth 获取的 loopback token(x-quick-note-token 头,每次 Host 启动轮换),缺失或错误返回 401
备份接口 GET/POST /api/quick-note/backups(列表 / ?name= 读取 / 立即创建),同样需要 token;备份目录 $DSH_HOME/quick-note/backups/
浏览器镜像 localStorage 的 dsh.quick-note.mirror.v2,Host 不可达时兜底
模块偏好 localStorage 的 dsh.quick-note.prefs.v2

文件

文件 作用
package.json 插件包清单:dsh.bundle.patch 指向 Cordis 补丁层,dsh.client 声明浏览器半区
cordis.patch.yml 插入 quick-note 行,加载 dsh-quick-note
index.js Host 半区:JSON 存储、状态路由、只读分析路由与 6 个 Agent 工具
client.js 浏览器半区:侧栏图标、工作台面板、设置页、中英文案
locale/en.json、locale/zh.json 插件管理页展示用的标题与描述
icon.svg 插件图标(原创)
docs/ROADMAP.md 功能规划:现状、模块差距、P0–P3 路线图与质量目标

安装、更新与卸载

从 npm 安装(推荐)

dsh plugin --profile web add @tomjerrygit/dsh-quick-note
# desktop profile
dsh plugin --profile desktop add @tomjerrygit/dsh-quick-note

插件市场索引(可添加到 DSH Plugins → Discover):

https://tomjerrygit.github.io/dsh-quick-note/index.json

本地目录(开发)

本目录也可以本地目录方式(link)装进 profile:

  • 安装:插件管理页「安装第三方插件」填本地目录路径,或用 agent 的 plugin_manager install_bundle。
  • 更新:改完 client.js 后浏览器半区通常由 DSH 热更新自动重载;改了 index.js(Host 半区)需要触发热重组装或重启 DSH 才会加载新代码。
  • 卸载:插件管理页移除 @tomjerrygit/dsh-quick-note,或用 plugin_manager remove_bundle。

回归测试(审计后新增)

test/ 目录包含插件自身的回归测试(无需浏览器/DSH 实例):

  • test/host.test.mjs:Host 半区——数据归一化与恶意输入夹取、state/admin/usage/workspace-value/backups/files 路由边界与 token 鉴权(401/403/415/正确 token)、乐观锁(ETag/If-Match/409/兼容旧写)、增量轮询 delta(since 水位)、用量 Token 与金额、价值分/社会价值/缓存失效、7 个 Agent 工具、滚动备份、每日简报、6 个斜杠命令、附件上传/读取/类型限制、i18n/主题令牌静态检查
  • test/client.test.mjs:客户端半区——React 桩渲染整个面板、冲突合并、token 刷新、命令面板、任务/复习/健康/日历、附件编辑器(token URL/删除持久化)、300 条笔记窗口化(VirtualRows)、捕获槽位组件
  • test/browser-smoke.mjs:真实浏览器冒烟(R2,Edge/Chrome headless + CDP),默认自带 fixture;需要 Chromium,DSH 沙箱下需以完整权限运行
  • test/run.mjs:依次运行两个 Node 套件并输出 RESULT PASS/FAIL
  • test/helpers.mjs:自建 fake Cordis ctx、HTTP 请求(支持二进制 body)、临时 DSH_HOME、React/browser/fetch 桩、渲染器

运行方式(在插件目录下):

$env:ELECTRON_RUN_AS_NODE=&#x27;1&#x27;; &amp; &#x27;D:\Programs\DeepSeek Harness\DeepSeek Harness.exe&#x27; &#x27;test\run.mjs&#x27;
# 真实浏览器冒烟(默认 fixture,截图写到 test\artifacts\panel-smoke.png):
$env:ELECTRON_RUN_AS_NODE=&#x27;1&#x27;; &amp; &#x27;D:\Programs\DeepSeek Harness\DeepSeek Harness.exe&#x27; &#x27;test\browser-smoke.mjs&#x27;
# 或已安装 Node 22+ 时:npm test / npm run test:smoke

当前基线:Host 214 项 + Client 168 项 + 浏览器冒烟 20 项全部通过(退出码 0)。构建:npm run build 由 src/ 生成 client.js;npm run check 校验产物与源一致;npm test 依次执行 build + check + 回归。

并发写入、条目版本、软删除与只读鉴权(审计后新增)

  • PUT /api/quick-note/state 支持标准 If-Match: &quot;&quot;(也接受不带引号的数字);版本不匹配返回 409 与当前完整文档(含 revision、items/settings/reviews/types),不写盘
  • GET/PUT 响应都带 ETag: &quot;&quot;;不带 If-Match 的写请求保持旧行为兼容(面板升级前/第三方调用不会失效)
  • 条目级版本:每个条目带 rev,Host 写入时按内容差异自增;冲突合并先比 rev,再比 updatedAt,较新者胜(完全相同时本地优先),避免整文档「本地优先」丢失 Agent 的较新修改
  • 冲突后主动回填:合并重试成功后,若面板没有更新的本地编辑,立即采用服务端合并结果(Host 并发新增、恢复的条目无需等 12 秒轮询)
  • 软删除:删除写为 deletedAt 墓碑(服务端保留最多 200 条,客户端/服务端自动修剪);列表、看板、提醒、每日简报、Agent 搜索默认隐藏;quick_note_search 传 includeDeleted:true 可查墓碑;quick_note_update 传 restore:true 可恢复;删除自定义类型会软删除其记录
  • 墓碑参与合并:较新的墓碑优先,旧的活动版本不会复活已删除条目;删除状态随同步传播到面板、其他窗口与 Agent 工具
  • 合并范围:条目(含墓碑)按 rev/时间;类型本地优先并保留 Host 新增;设置本地优先,workspaceNotes 按路径、valueHistory 按时间点合并;复习日志按 itemId+at+quality 去重
  • 只读接口鉴权:GET /api/quick-note/auth 返回 loopback token(Host 启动时随机生成、常驻内存、不落盘;带非 loopback Origin 返回 403),admin/usage/workspace-value 必须携带 x-quick-note-token,否则 401;面板自动获取 token,遇到 401(如 Host 重启轮换)自动刷新并重试一次
  • 测试覆盖:较新远端编辑胜出、本地编辑保留、Agent 新增保留、软删除隐藏/恢复/墓碑合并、冲突结果立即回填、token 401 后自动刷新

性能与稳定性(审计后)

  • 只读路由(/admin、/usage、/workspace-value)精确匹配 pathname,未知子路径返回 404;并要求 loopback token(/auth 获取,401 时面板自动刷新重试)

README 较长,此处只展示前 60 KB。完整内容请到仓库查看 ↗。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-quick-note 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add @tomjerrygit/dsh-quick-note@1.0.0` 即可。对应的 npm 包名是 `@tomjerrygit/dsh-quick-note`。

dsh-quick-note 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-quick-note 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-quick-note 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-quick-note 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-quick-note 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-quick-note 有哪些功能?

侧栏管理台与概览仪表盘、笔记、任务、SM-2 复习与健康记录、自定义记录类型与批量表格、用量与工作区价值分析、Agent 工具读写同一份数据。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

TomJerryGit 的其它插件

3 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-10。