概览
@local/dsh-notebook
Persistent cross-day notebook for DeepSeek Harness: append, list, search and delete notes kept in notes.md under the plugin data directory.
README / ZH
插件文档
目录摘要
Persistent cross-day notebook for DeepSeek Harness: append, list, search and delete notes kept in notes.md under the plugin data directory.
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
1. **所有 agent 共享**：工具注册在 Host 全局，同一 DSH 进程里的每个会话、每个子 agent 都能读写同一本笔记。别把它当私有日记；敏感信息不要写。 2. **删除不可撤销**：没有回收站、没有 undo。 3. **重复判定看「内容 + tag」**：同内容不同 tag 会各存一条；想合并请先删再加。 4. **200 字硬上限**：超长直接报错而不是悄悄截断；长文请拆成多条或存在别处。 5. **行号是物理行号**：手工插行/删行/留空行都会让行号变化。删除前先 `note_list` 确认。 6. **多进程没有跨进程锁**：同一 DSH 进程内安全；两个 DSH 实例（或一个 DSH + 手工编辑）同时写同一文件时，后写者会覆盖前者。用同步盘/Git 同步时尤其要避免同时写。 7. **全量读写**：每次操作都会读一遍整个文件。几千条以内没问题；几十万行会很慢。 8. **没有 `note_edit`**：要改一条，先删掉再重写。 9. **tag 长度不限但不建议过长**：列表和检索里都会完整显示。 10. **明文存储**：`notes.md` 是普通文本，权限跟随系统默认；不要写密码、令牌等秘密。 11. **时间统一 UTC**：显示的是写入时刻的 ISO UTC 时间，和本地时区可能差几小时，这是有意为之（跨时区不歧义）。 12. **版本兼容**：需要带 `tools` 服务的 DSH（当前 0.2.x 桌面版验证通过）。若 `tools` 不可用，插件会明确报错而不是静默失败。