dsh-instruction-notes
Verifieddsh-instruction-notes · v1.1.0 · MIT · Web UI
DSH plugin: star any instruction you send and keep it in a left-sidebar page and a right-sidebar panel — search, edit, copy, or refill the composer with one click.
Install
dsh plugin add dsh-instruction-notes Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Readme
dsh-instruction-notes · 指令笔记
DSH 插件:把你发出去的每一条指令收进笔记本——左侧栏有整页、右侧栏有面板、消息气泡里有个星标。随时搜索、收藏、编辑、复制,或一键填回输入框。
发送本身不会自动写笔记,要不要留下由你点一下决定。
安装
在任意 DSH 会话里让 AI 执行(需要 DSH 的 plugin_manager 工具):
plugin_manager install_bundle target=dsh-instruction-notes
装完刷新页面即可,左侧栏会出现「指令笔记」图标。卸载:
plugin_manager remove_bundle target=dsh-instruction-notes
在 DSH 0.2.1-rc.5(web profile)实测;需要右侧栏与聊天界面存在(默认 web profile 都有)。
四处界面
| 位置 | 槽位 | 能做什么 |
|---|---|---|
| 消息气泡内 | conversation.user.text.node(key text) |
每条已发送指令的文本末尾有个小星标,点一下把它收进笔记 |
| 左侧栏图标 | sidebar.panellist + main |
完整页面:搜索、筛选、新建、编辑、复制、删除、清空 |
| 右侧栏面板 | sidebarRightTabs + sidebar.right.pane.tab |
边聊天边查;每条笔记可「填入输入框」直接复用 |
| 输入框下方细条 | conversation.composer.dock |
有草稿时出现「收藏这条草稿」(还没发出去的走这里) |
为什么星标在气泡里:消息下方那排「时间 + 复制」是宿主内置 UI,当前版本只给助手消息留了操作扩展位(
conversation.chat.assistant-actions),用户消息没有。气泡内文本是唯一可用的每消息扩展位。 代价:带@文件//技能引用的复合消息会被拆成多段文本,星标跟在文本段后面,只收藏那一段文字。
用法
- 收藏:点消息末尾的星标 → 星标变实心绿色、1.5 秒复原,笔记来源标「发送」。
- 草稿:输入框里有内容时,下方细条出现「收藏这条草稿」,来源标「手动」。
- 手动新建:页面 / 面板里点「新建」。
- 笔记的星标:这是真正的「收藏」——置顶、左边框高亮,可用「已收藏」筛选。
- 清空:完整页右上角垃圾桶,两步确认后清空全部。
数据
- 存放在浏览器
localStorage,键dsh.instruction-notes.v1。 - 结构:
{ version: 1, notes: [{ id, text, createdAt, starred, source }] }。 source:sent(消息星标)或manual(草稿 / 新建)。- 只由点击写入,没有后台自动收集;最多 300 条,连续重复的相同文本不会重复写入。
- 跨会话共享(是「个人指令库」,不是单会话记录);不同浏览器 / 不同机器各存一份。
实现要点
- 宿主侧
index.js是空实现;界面源码在src/client/(多文件),构建产物是lib/client.js(仍是window.__ModuleLoader__.load单文件格式)。 - 接管了
conversation.user.text.node的text渲染器:必须保持一个不设置white-space/line-height的内联 span,换行策略归使用方(气泡pre-wrap、队列预览单行 nowrap),否则消息排版会坏。 - 样式只用
--dsw-alias-*主题令牌,浅色 / 深色自动适配。 - 文案:
locale/{zh,en}.json供插件管理页显示,client.js内的zh/en字典供界面使用。
本地开发
cd D:\Projects\DSH默认工作区\instruction-notes
npm install # 安装 esbuild
npm run build # src/client/*.js -> lib/client.js
# 直接装本地目录(link 安装,改完重新 build + 刷新页面)
plugin_manager install_bundle target=D:\Projects\DSH默认工作区\instruction-notes
# 发布
npm publish --registry https://registry.npmjs.org
目录:
src/client/index.js 入口:注册槽位、样式、locale
src/client/store.js localStorage 存储
src/client/hooks.js useNotes / useLocaleTick / useFlash
src/client/format.js 时间与剪贴板
src/client/navigation.js 打开右侧栏 / 主页面
src/client/icons.js SVG 图标
src/client/components/ NoteEditor、NoteRow、NotesList、NotesPage、NotesTab、CaptureDock、UserTextNode
scripts/build-client.mjs esbuild 构建,外层包 __ModuleLoader__
lib/client.js 构建产物(发布物)
legacy/client.legacy.js 改造前的单文件版本,仅留档
License
MIT © 2026 MZHuangJie