dsh-note-sidebar

对话中遇到关键内容，一键存入每会话独立的笔记侧边栏；保存时可选整理方向， 由受限子代理提炼核心内容（Markdown 渲染、可展开原文、面板与卡片均可自由拉伸）。

功能

• 消息「✎ 存入笔记」：点击弹出整理方向选择（通用总结 / 清单提取 / 自定义指令）， 保存后后台子代理按方向提炼核心内容写入摘要
• 面板手动添加：同样支持方向选择，归属当前会话
• 按会话隔离：切换会话，面板只显示该会话自己的笔记
• 自由缩放：面板右下角/左边缘拖拽调整宽高（记住尺寸）；每条笔记卡片右下角拖拽拉伸高度
• Markdown 渲染：摘要与原文都按 Markdown 渲染；「原文」按钮展开显示完整原文
• 笔记操作：删除 / 标记已整理 / 展开收起

在不同电脑上安装

# 1. 克隆仓库到任意目录
git clone https://github.com/<你的用户名>/dsh-note-sidebar.git
cd dsh-note-sidebar

# 2. 把插件装进当前机器的 web profile（link 方式，改代码即时生效）
dsh plugin --profile web add "C:\path\to\dsh-note-sidebar"

# 3. 在 $DSH_HOME/profiles/web/cordis.patch.yml 追加：
#    - insert:
#        - id: dsh-note-sidebar
#          name: dsh-note-sidebar
#    然后刷新浏览器页面

插件激活时自动在 $DSH_HOME/.agent-presets/note-organizer/ 生成整理预设（幂等）。 笔记数据存在 $DSH_HOME/notes/notes.json（每台机器独立，不入库）。

结构

文件	角色
lib/index.js	host 半边：ctx.notes Remote 服务 + JSON 持久化（@Remote 方法纯 JS 复刻）
lib/summarize.js	提炼逻辑（受限子代理 + 结构化输出），每次保存动态加载，改它免重启
lib/tool.js	整理预设工具（notes_read/update/markOrganized，agent 平面）
lib/client.js	browser 半边（手写 bundle，无需构建）：按钮 / 面板 / 方向选择 / 缩放
scripts/verify-*.mjs	离线验证脚本（host SRC 发现、工具输出 schema）

热修改（开发时改代码怎么生效）

改动	生效方式	是否重启 dsh
lib/client.js（UI）	在 $DSH_HOME/profiles/web/cordis.patch.yml 末尾加一行注释（触发重扫）→ 硬刷新页面	否
lib/summarize.js（提炼逻辑）	保存一条新笔记即重新加载	否
lib/index.js（服务骨架）	需要重启 dsh web	是

开发验证

node scripts/verify-host.mjs          # host 服务发现 + CRUD 冒烟（需要能解析 @deepseek-ai/*，通常放 profile link 下跑）
node scripts/verify-tool-schema.mjs   # 工具输出 schema 校验

机制要点

• host↔browser 走 DSH Typert Remote 通道（connection.rpc.call("/api", "notes/<method>", …)）， 不依赖客户端 descriptor/$mount，host 端网关按 SRC 模式从活服务寻址
• 提炼用 one-shot 子代理：toolFilter: { allow: [] } 屏蔽全部工具（不允许发散）+ outputSchema 强制 structured_output 结构化提交；不设 token 上限
• 所有 slot（sidebar.footer.action / shell.overlay / conversation.chat.assistant-actions） 均为官方扩展点，不修改任何官方包