Skip to content

dsh-instruction-notes

Verified

dsh-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