notes

开源版锤子便签

支持手机版 · 一键发送公众号 ·

• 一个锤子便签风格的导出器，预览与图片导出支持暖白纸感、深夜便签、iPhone 备忘录深浅模式和 Bear 极简排版。
• 可用来分享与openclaw的对话记录。
• 完美复刻锤子便签网页版和PC版，支持多便签，分类存储。
• 支持Docker一键私有化部署
• 纯WEB应用，无需安装任何App，打开即用
• 支持PC端和手机版，多端数据同步，支持公网部署
• 支持图片插入。
• 支持一键粘贴到公众号助手。
• 支持直接导出便签为图片，或复制为markdown格式进行分享。
• 自带浏览器持久化，关闭页面也不会丢失数据。
• 开源免费，可私有化部署。
• 工匠精神沁入AI，可以通过AI Skill直接调用工具，生成便签。
• 支持自定义底部标识（点击即可编辑）
• API原生封装支持Hermes Agent，OpenClaw直接通过skill驱动管理便签
• 支持 DeepSeek Harness（DSH），让智能体将对话导出为锤子便签。
• 支持接入DeepSeek润色书写内容，语法标点检查，重点加粗，复杂概念通俗化释义。
• 支持一键下载包含图片的Markdown资源包
• 支持下载为html离线查看

通过DSH调用

可以在 DSH 的“插件市场”中搜索 notes 直接安装；源码仓库已经携带预编译产物， 无需开启 allowBuilds。也可以通过命令行安装 npm 版本：

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

安装后请重启目标 profile，使插件生效。重启后，在 DeepSeek Harness 对话中说：把我们的对话导出成便签， 智能体会自动整理当前对话并调用插件生成便签。

Deepseek Harness 生成分享便签 · 导出效果 ·

通过skill调用

clawhub地址 https://clawhub.ai/zhaoolee/notes-export-api

从clawhub安装 notes-export-api这个 skill,
联网获取最近一周 AI 相关的新闻，将新闻转化为 markdown 生成便签图片，把便签图片绝对路径返回给我，把图片往“下载”文件夹复制一份

支持自定义底部品牌标识(点击就能改)

只要你喜欢，可以把底部的「锤子便签」改成「凿子便签」或「榔头便签」

支持下载文章，包含网页，markdown以及管理的图片资源

支持接入DeepSeek，修正语法错误，重点加粗，通俗化润色

零配置，复制即可将权限导入hermes agent

登陆后，复制一行专属链接，粘贴给Hermes Agent或OpenClaw，即可获取包含登身份认证的skill包，实现人机协同

支持多用户隔离

可以给AI分配一个账号，人类分配一个账号，数据严格隔离

支持一键粘贴到公众号助手

在手机的网页写完，直接一键粘贴到公众号即可发送，文本格式和图片，统统自动处理好！

导入微信公众号文章

登录后，在桌面顶栏、手机便签列表或便签侧栏点击「导入公众号文章」，粘贴一条公开文章链接。 未登录点击入口会打开登录窗口；该接口始终要求登录，不受全站匿名体验开关影响。 支持 https://mp.weixin.qq.com/s/文章ID，也支持带 __biz、mid、idx、sn 的 https://mp.weixin.qq.com/s?... 链接。解析完成后先看标题、来源、Markdown 预览和图片成功/失败数量，再点「创建便签」。取消不会新建便签，也不会覆盖当前 正在编辑的内容。

正文图片会下载到本服务的 /images/{内容哈希}.{扩展名}，相同图片不会重复保存。 某一张图片下载失败时，文章其余内容仍然可以导入，预览里会标出失败项。视频、语音、 小程序等暂时不能直接转换，会保留占位和能确认的原链接。

常见失败：

• 链接不是 mp.weixin.qq.com 上的文章页。
• 文章已删除、审核中，或微信弹出验证码 / 访问频率限制。服务不会尝试绕过验证。
• 网络超时或微信没有返回正文。可以把正文复制到原来的 Markdown 编辑器。

公众号导入始终要求登录，每个账号大约每小时 30 次，同时最多使用 2 个浏览器抓取。 公网环境建议再在反向代理上限制 POST /api/import/wechat/preview。需要紧急关闭时设置 WECHAT_IMPORT_ENABLED=false。REQUIRE_LOGIN 只控制全站匿名体验，不会放开导入权限。

支持子公司和各类知名主题

子公司主题 · 母公司主题 ·

网页版

暖白纸感 · 深夜便签 · ·

Skill 服务地址

便签管理和 PNG 导出统一使用 NOTES_API_BASE_URL，可写入 skills/notes-export-api/.env，或通过 --base-url 传入：

NOTES_API_BASE_URL=http://127.0.0.1:18080

认证及完整配置见 skills/notes-export-api/SKILL.md。

使用 Docker Hub 镜像部署

单镜像同时包含 Web 前端和后端服务，便签管理、图片导入和 PNG 导出均可在本地 运行。公众号复制和 AI 等可选功能需另行配置相应服务。

需要登录、多端同步或 Skill 工作区管理时，先复制 .env.example，并配置 SUPERADMIN、SUPERADMINPASSWORD 和高熵 SESSION_SECRET：

cp .env.example .env
mkdir -p ./storage/images ./storage/data

docker run -d \
  --restart unless-stopped \
  --name notes \
  -p 127.0.0.1:18080:3001 \
  --env-file .env \
  -v "$(pwd)/storage/images:/app/storage/images" \
  -v "$(pwd)/storage/data:/app/storage/data" \
  zhaoolee/notes:latest

私有部署还可设置 REQUIRE_LOGIN=true。开启后首页只显示不可关闭的登录页，匿名 请求不能调用编辑、上传、导出、公众号文章导入等后端 API；默认值为 false，现有公开体验部署不受 影响。开启前请确保已配置超级管理员，以便登录 /superadmin 创建普通账号。 WECHAT_IMPORT_ENABLED=false 可单独关闭公众号文章导入。该功能始终仅限登录用户， 并有每小时次数限制；面向公网时仍建议由反向代理限制该接口。

启动后访问 http://127.0.0.1:18080。storage/images 保存图片和导出的 PNG， storage/data 保存账号与云端工作区，两者都应持久化和备份。仅使用匿名编辑与导出 时可省略 --env-file .env；需要局域网访问时可将端口映射改为 -p 18080:3001，公网部署应使用 HTTPS 反向代理。

许可证

本项目自有代码采用 Apache License 2.0，版权声明见 NOTICE。

以下组件保留各自的许可证：

• DSH 插件：见 dsh-plugin/LICENSE，采用 MIT。
• 便签导出 API Skill：见 skill-card.md，采用 MIT-0。

第三方依赖及图片、字体、图标等第三方资源不因本项目的代码许可证而被重新授权， 其权利与使用条件以各自权利方的许可为准。本项目的代码许可证不授予第三方商标权。