- ホーム
- プラグイン
- セッションとメッセージ
- dsh-session-note
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.
インストール
dsh plugin --profile web add github:gznofeng/dsh-session-noteREADME
dsh-session-note
会话备忘录插件:在 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。