dsh-plugin-notepad

使用

工具

工具	参数	说明
notepad_add	content（必填）、tags?、scope?	记一条，正文自动 trim，标签去重
notepad_list	scope?、query?、limit?	新的在前；省略 scope = 合并所有启用层级；query 对正文 / 标签 / id 做子串过滤
notepad_clear	scope（必填）、confirm: true（必填）	清空指定层级（破坏性）

notepad_add 返回 { id, at, scope, tags, content, file, total }：

Noted p-mv6ieauq-01fmiy at 2026-10-13T09:59:19.922Z in the project notepad (3 note(s) there).
File: D:\work\repo\.dsh\notepad\notes.jsonl

/note 命令

• /note 记一条内容 → 新增一条（走默认层级）
• /note（不带内容）→ 列出最近 5 条

图形面板

侧边栏底部的 速记 图标（sidebar.panellist，order 40）会在中央主面板（main）打开完整界面：

• 跟随当前会话：点开就是当前会话所在项目的 notepad；下拉可临时切到别的项目，「跟随会话」按钮一键切回，切换会话后 1.5s 内自动跟随。
• 两个层级标签页：项目 / 全局，各自独立列表。
• 每条笔记支持新增、编辑（保留 id 与创建时间）、删除、打标签；顶部有搜索、刷新、清空当前层级；底部显示实际文件路径。
• 面板与模型工具、/note 读写的是同一批文件，界面上改完 notepad_list 立刻可见。

配置 level 决定哪几个标签页可用（global / project / both），被禁用的那一页会置灰提示。

配置

写在补丁条目的 config: 下，或由设置界面编辑（dsh --dump-config-schema 能看到）：

字段	类型	默认	说明
level	global | project | both	both	本部署暴露哪些层级
defaultScope	global | project	project	调用省略 scope 时的落点
dshHome	string	''	全局层根目录；空 = $DSH_HOME，再退到 ~/.dsh
globalDir	string	''	覆盖全局笔记目录（支持 ~），空 = /notepad
projectDir	string	''	覆盖项目笔记目录（支持 ~），空 = /.dsh/notepad
fileName	string	notes.jsonl	笔记文件名（只接受纯文件名）
projectRootMarkers	string[]	['.git','.hg','.svn']	向上查找项目根的标记；[] 表示工作目录即项目根
maxNotes	integer	1000	单文件上限，超出丢弃最旧；0 = 不裁剪
maxContentLength	integer	4000	单条正文字符上限
defaultLimit	integer	20	列表默认条数
toolPrefix	string	notepad	工具名前缀（合法值才会被采纳）
enableCommand	boolean	true	是否注册 /note