本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

notes

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @zhaoolee/dsh-notes

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 一个锤子便签风格的导出器，预览与图片导出支持暖白纸感、深夜便签、iPhone 备忘录深浅模式和 Bear 极简排版。
• 可用来分享与openclaw的对话记录。
• 完美复刻锤子便签网页版和PC版，支持多便签，分类存储。
• 支持Docker一键私有化部署
• 纯WEB应用，无需安装任何App，打开即用

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后智能体不会自动调用，还需要说什么？

安装后重启目标 profile 使插件生效。智能体已注册 notes_export_conversation 工具，对用户说"把我们的对话导出成便签"或类似语句即可触发，工具会自动把对话整理成 Markdown 并调用。

什么都没配置，能直接用吗？

可以。插件会自动回退到默认演示服务器 notes.fangyuanxiaozhan.com，把对话渲染成锤子便签长图 PNG 保存到本地；该模式不能写入便签列表，仅适合尝鲜。

想把便签存到自己的服务上，怎么配？

配置便签服务地址（NOTES_API_BASE_URL 或插件 config.baseUrl），并提供 Token 或用户名密码。智能体会把对话作为便签写入当前账号的云端工作区，新建或按 note_id 更新。

工具返回的 action 有哪几种，分别什么意思？

created 表示新写了一篇便签；updated 表示按 note_id 更新了已有便签；exported-image 表示通过演示服务器渲染成了便签长图（图片模式），返回本地 PNG 路径而不是便签链接。

便签标题是怎么来的？

取自 Markdown 全文第一行；插件会去掉标题符号、引用和列表标记，截断到 38 字以内。建议正文第一行用 # 写标题。

支持哪些便签主题？

图片模式支持 default、smartisan-dark、apple-notes、apple-notes-light、bear、telegraph 六种；写入模式的主题由便签服务侧决定，工具不修改主题。

0.1.0 版本能用吗？

不建议。0.1.0 在 DSH 0.1.0-rc.6 首次调用时会因重复安装宿主运行时而中止会话；请使用 0.1.1 及以上版本（当前最新 0.1.2）。

如何彻底卸载？

执行 dsh plugin --profile web remove @zhaoolee/dsh-notes，然后重启目标 profile；同时清理 NOTES_API_* 环境变量和插件 config 里的凭据。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: 未声明
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则