notes README

The project's README from github.com/zhaoolee/notes. As one markdown file: README.md.

开源版锤子便签

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

通过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分配一个账号，人类分配一个账号，数据严格隔离

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

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

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

子公司主题 母公司主题

网页版

暖白纸感 深夜便签

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

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

许可证

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

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

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

notes (zhaoolee/notes)

Searching Database…

310 ·GitHub
Notes
这是什么？这是锤子便签（Smartisan）知名笔记应用的开源复刻，重现了其设计，支持多条笔记、分类存储，以及模仿暖纸、暗夜笔记、iPhone 备忘录和 Bear 极简排版的导出样式。
这是需要安装的应用，还是在浏览器里直接打开的东西？它是纯 Web 应用——无需安装，在电脑或手机的浏览器里打开即可，数据可在多设备间同步。
这个怎么部署？拉取 Docker Hub 镜像，它把 Web 前端和后端打包进单个容器，供本地使用。如果需要登录、多设备同步或 Skill 工作区管理，先复制 .env.example 并配置 SUPERADMIN、SUPERADMINPASSWORD 和高熵的 SESSIONSECRET，然后再启动。
运行它除了 Docker 还需要什么？匿名编辑和导出只需要 Docker；配置 .env 只在需要登录、局域网/公网访问或 AI 润色功能时才需要。
把它暴露到公网之前有什么额外设置吗？有——公网部署应放在 HTTPS 反向代理之后，并且 storage/data 文件夹（账户、工作区）和保存图片的目录都需要持久化并做好备份。
像 OpenClaw 这样的 AI 智能体实际上是怎么通过它创建笔记的？登录后，你复制一个内嵌认证信息的个人链接，交给 Hermes Agent 或 OpenClaw；这会授予智能体一个签名的 Skill 包，让它可以直接调用 API，比如把一段聊天导出为笔记。
可以更改“Smartisan Notes”品牌标识吗？可以，页脚品牌文字一键即可编辑，你可以把它改成任何喜欢的名字。
笔记可以导出为哪些格式？笔记可以导出为 PNG 图片、以 Markdown 复制、下载为离线 HTML 页面，或打包成包含图片的 Markdown 资源包。
AI 和人可以安全地共用同一个工作区吗？不行——应用支持多租户隔离，你可以给 AI 一个账号、给人另一个账号，数据严格分离。
What are similar projects?open-design, awesome-deepseek-harness-plugins, univer-workspace, EverOS, dsh-top100, html-anything, dsh-Mimir-Academic-research, skill
Which topics is it in?multi-tenant, notes, hermes-agent, image, note-taking, wechat, openclaw, dsh-plugin, deepseek-harness, authentication, skill, deepseek
Creator
zhaoolee
Size
60.6 MB
Stars
310
Updated
CommitOct 11Release1.0.0Mar 28
Age
7mo
Commits · 90 Days