qux-bbb/dsh-plugin-notepad ↗★ 0
dsh-plugin-notepad
Simple notepad plugin for DeepSeek Harness: record short notes in a global ($DSH_HOME) or project (<projectRoot>/.dsh) level 适合需要在对话过程中随时记录、检索和管理临时笔记与标签的用户。
インストール
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:qux-bbb/dsh-plugin-notepadドキュメント
README 全文を読む ↗使用
工具
| 工具 | 参数 | 说明 |
|---|---|---|
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 |