前言¶
在用 DeepSeek Harness（DSH）开发或调试时，经常需要在会话中临时记下需求、报错信息或待办事项，但又不想打断当前的对话流。已有的方式要么是手动复制到记事本，要么依赖对话中的临时草稿，不够结构化，也不易跨会话复用。
项目便笺（Project Notes）是一套原生插件，为每个工作区提供一张便笺和一份轻量待办清单，内容自动保存在本地，需要时可以一键插入 DSH 的输入框。
是什么¶
项目便笺是 DeepSeek Harness 原生插件，由 yxue301603 维护。它为每个 DSH 工作区提供一张自动保存的便笺和一份可勾选的待办清单，支持导出为 Markdown。数据仅保存在当前 DSH 来源的浏览器本地存储中，不调用模型、不读取密钥、不扫描项目文件，也不向外发送数据。
核心功能¶
工作区隔离¶
在 DSH 中，每个工作区对应一个目录路径。点击「项目便笺」后，顶端会显示当前工作区路径。同一路径下的会话共享记录；不同工作区相互隔离。没有工作区时，使用「通用便笺」。Windows 路径的大小写和结尾斜杠会被归一化。
便笺¶
便笺是一个可编辑的文本区域。直接编辑内容，系统会自动保存在本机。支持复制、插入整篇或选中文字。插入时保留当前光标选区文字，不会自动发送给模型。未保存的编辑会留在内存中，退出 DSH 后会丢失。
待办¶
待办采用简单的勾选清单模式。在待办区域按回车添加新条目，点击勾选框标记完成，再次点击可编辑内容。支持按「未完成/已完成/全部」筛选，并显示完成进度。删除后可撤销最近一条删除的待办。
带入对话¶
单条待办可以插入到当前草稿中，再由你确认发送。插入使用官方输入接口，保留原有的附件和引用。
导出¶
将当前便笺和待办导出为 Markdown 文件，未保存的编辑也会包含在导出中。
数据边界¶
数据仅保存在当前 DSH 来源的浏览器本地存储中，包括文字内容和勾选状态。不调用模型、不读取密钥、不扫描项目文件、不向外发送数据。工作区路径仅用于分组，不参与其他逻辑。
便笺不会因重命名项目或移动目录而自动搬迁，需要先导出再在新工作区粘贴内容。
限制与错误处理¶
每个项目便笺最多 48,000 个字符、150 条待办，每条最多 2,000 个字符。最多支持 60 个工作区，总计约 800,000 个字符。达到上限时提示整理旧内容，不会自动删除便笺。
存储失败时显示错误，并保留当前便笺的内存文本，可重试、复制或导出。退出 DSH 会丢失尚未保存的内存编辑。损坏数据不会静默重置。清除 DSH 站点数据会移除插件数据。
界面支持中文、英文，以及深色与浅色主题。
安装与启用¶
在 DSH 中进入「插件 → 添加插件」，填写以下 GitHub 仓库地址：
https://github.com/yxue301603/dsh-project-notes
启用后按宿主提示重新加载。插件依赖 DeepSeek Harness 0.2.1-rc.2 或更新的 0.2.x 版本。
整套安装、迁移和升级步骤可参考 工具箱安装指南。
典型用法¶
- 在 DSH 中进入某个项目的工作区。
- 点击输入框旁的「项目便笺」按钮。
- 在便笺中记录当前会话的需求或报错信息，或在待办中列出待办事项。
- 完成后按需插入整篇或选中文字到对话输入框，确认发送。
- 需要整理或归档时，将便笺和待办导出为 Markdown。
适用场景与注意¶
适合需要在会话中临时记录信息、整理待办、并在多个会话间共享同一份便笺的开发者或 AI 助手使用者。
插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
结尾¶
项目便笺为每个工作区提供一张自动保存的便笺和一份轻量待办清单，帮助在 DSH 中快速记录与整理信息。更多细节可参考插件目录页或GitHub 仓库。
