Saltar al contenido principal
G

dsh-session-note

gznofeng/dsh-session-note

A memos tab in the conversation view: each conversation keeps its own handwritten notes on this machine — add, edit in place, one-click copy and confirm-guarded delete, most recently touched first. Scoped strictly by session id (a missing id refuses to write rather than guessing), stored in one plugin-data JSON with atomic writes and v1 migration; an unparsable file refuses all writes instead of being cleared. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.

Instalar

dsh plugin --profile web add github:gznofeng/dsh-session-note

README

dsh-session-note

dsh-plugin License: MIT

会话备忘录插件:在 DSH 的对话视图里加一个「备忘录」标签页,每个会话有自己独立的手写笔记列表, 存在本机文件里。

对话视图中的备忘录标签页

它只加这一个界面——注册在 conversation.view 插槽的一个标签页——别的什么都不做: 没有工具、没有提示词注入、没有后台任务,也没有任何出网的请求。

功能

  • 添加备忘录:标题可选、正文必填;没写标题的显示为「未命名备忘」。
  • 编辑:就地修改,createdAt 保留、updatedAt 更新,列表自动把最近动过的排最前。
  • 复制:一键把正文复制到剪贴板,按钮短暂变成「已复制」;浏览器拒绝写入时会明说, 正文保持可选中。写入被禁用时复制仍然可用,损坏文件里的备忘录也能拷出来。
  • 删除:一行二次确认挡着,误点不会丢笔记。
  • 初始为空列表,不预置任何内容。

快捷键:Ctrl/Cmd + Enter 保存打开的表单,Escape 关闭。界面文案有中英两份,跟随宿主语言。

安装

dsh plugin add gznofeng/dsh-session-note

装好后对话视图里即出现备忘录标签页,无需任何配置。

按会话隔离

conversation.view 插槽是会话维度的:宿主把当前渲染的会话 id 传给标签页,这个 id 是决定读写哪个数据桶的唯一依据:

  • 浏览器端按会话 id 各存一份,上限为最近使用的 32 个会话,切换会话绝不会串到别的会话的笔记。
  • 每个 HTTP 请求都带 id:两条读路由用 ?sessionId=,写路由放在请求体里。
  • 缺失或超长的 sessionId 一律 400,绝不静默读到错误的桶。
  • 拿不到 id 时标签页拒绝写入并提示「无法识别当前会话」,而不是显示一个看似「这个会话没有备忘录」的空列表。

数据存哪

$DSH_HOME/plugin-data/dsh-session-note.json

$DSH_HOME 默认 ~/.dsh。一个文件、一种结构——sessions 把会话 id 映射到该会话自己的列表:

{
  "version": 2,
  "sessions": {
    "session-9b9100a3-…": [
      {
        "id": "9f0c…",
        "title": "购物清单",
        "body": "牛奶\n鸡蛋",
        "createdAt": 1763000000000,
        "updatedAt": 1763000000000
      }
    ]
  }
}

没有备忘录的会话不写条目、绝不写 [],文件不会积累死键。写入走「临时文件 + rename」, 写一半崩溃时留下的是上一个完整文件,不会是截断的半个文件。

文件不存在是正常的首次运行:标签页打开为空。文件存在但解析不了时会明确报出来, 并且拒绝一切写入——那些字节可能还能手工救回来,用一个空列表覆盖掉就毁了唯一的副本。 修好或挪走文件后重启 DSH 即可:插件在激活时读文件,那时就能读到修复后的版本。

旧版 v1 文件

更早的结构是单个扁平列表({ "version": 1, "memos": [ … ] }),没有会话维度,至今仍可读取。 那些笔记无法归属到任何会话,所以 v1 文件会读入保留桶 __legacy__,而不是猜测归到某个会话或直接丢弃。 没有任何界面渲染这个桶;它只是让旧笔记还在磁盘上、还能查看。下次写入时文件升级到 v2, __legacy__ 原样保留。

HTTP 接口(仅限本机回环)

三条路由,都在插件自己的前缀下:

用途路由
读一个会话的备忘录GET /plugins/dsh-session-note/state?sessionId=<id>
写入POST /plugins/dsh-session-note/memos —— { op: "upsert", sessionId, memo } 或 { op: "delete", sessionId, id }
从磁盘重读文件POST /plugins/dsh-session-note/reload?sessionId=<id>

所有路由只接受本机回环请求:来自网络的请求在任何处理逻辑(包括读取请求体)之前就被拒绝。 每个响应都是 JSON 对象——成功是 { memos, corrupt? },失败是 { error } 配 400 / 403 / 405 / 409 / 500。 corrupt 只在为真时出现,读的人不用区分「false」和「没有」。

写路由在更新的备忘录已不存在时(被另一个窗口删了)答 409;请求格式错、正文为空、 或该会话已达 2,000 条上限时答 400。超长字段会被截到上限而不是拒绝:标题 200 字符,正文 100,000 字符。

出错时的表现

情况用户看到什么
首次运行,没有文件空状态和「添加」按钮
文件存在但解析不了拒绝写入并在页面明说;添加、编辑、删除全部停用
读取失败(I/O、权限)报错并附重试按钮,让宿主重读文件;绝不假装一个空列表
浏览器拒绝复制备忘录下方提示「无法复制」;正文留在屏幕上可手动选中
本窗口编辑时备忘录刚被别的窗口删除提示「已不存在」并刷新——不产生重复条目
插件卸载标签页、样式、文案字典随宿主一起清掉

技术说明

  • 无依赖、无构建步骤:纯 JavaScript 加 Node 内置模块。唯一声明的 peer dependency 是宿主自己的 @deepseek-ai/cordis。
  • index.js 是宿主入口:打开状态文件、注册回环路由;profile 里没有 web 服务器时也保持激活 (此时只是不注册路由,而不是挂载失败)。
  • client.js 是浏览器产物,经 window.__ModuleLoader__.load 注册,单文件自包含: 它渲染的一切(包括样式)都在这一个文件里。
  • lib/ 放纯 store、文件生命周期和路由。
  • icon.svg 是插件自绘图标;assets/icon-180.png 是同一幅图的 180×180 位图 (插件市场不收 SVG),assets/icon-180.html 是渲染它的页面。这些都不参与运行时,也不打进发布包。

备忘录特意放在文件里而不是会话日志里:它们必须活过重启,而且属于这台机器而不属于某个会话的事件流。 所以隔离靠文件里按会话 id 分桶,而不是靠会话自有事件。

许可

MIT —— 见 LICENSE。

Plugins relacionados