notes

One-line Positioning

Let the DeepSeek Harness intelligent agent organize the current conversation into Markdown and export it as a Smartisan Note—when the note service is configured, it directly writes to the cloud workspace; when not configured, it falls back to the demo server to generate a note long image.

Core Capabilities

• Organize conversation content into Markdown, call to create or update a Smartisan Note
• Support updating existing notes by note_id; when updating, category, starred, and pinned attributes that are not explicitly passed retain their original values
• When note service is not configured, fall back to the default demo server, render Smartisan Note long image PNG and save locally
• Support note metadata writing such as category (folder), starred, and pinned
• Image mode supports six note themes (warm white paper, late night notes, iPhone notes light/dark, Bear minimal, Telegra.ph)
• Handle workspace concurrent conflicts: if server returns 409 during write, automatically re-read and retry up to 4 times

Technical Implementation

• Language: TypeScript (compiled to ES Module)
• Key Dependencies: @deepseek-ai/dsh-tools, @deepseek-ai/cordis, @deepseek-ai/schemastery, Node built-in node:fetch/node:fs/node:crypto
• Architecture Pattern: Insert notes-export line in the host composition via cordis.patch.yml, registered as a Host-side tool by apply(ctx, config) calling ctx.tools.register(defineTool(...)); client only depends on Node built-in capabilities and can be tested independently without DSH
• Entry Files: dsh-plugin/src/index.ts (tool registration); dsh-plugin/src/notes-client.ts (note service API client)

Use Cases

Used when intelligent agent users want to沉淀 the current conversation or long-form content into their Smartisan Notes list; especially suitable for one-click saving of code reviews, research summaries, and conversation minutes. When note service is not configured, can also generate note long images for direct sharing, posting to WeChat public accounts, or screenshot saving.

Prerequisites and Compatibility

Installation

dsh plugin --profile web add github:zhaoolee/notes

Configuration

Configuration priority: plugin config > process environment variable NOTES_API_* > built-in defaults.

FAQ

Q: After installation, the intelligent agent won't call it automatically. What do I need to say?

A: Restart the target profile after installation to activate the plugin. The intelligent agent has registered the notes_export_conversation tool. Say "export our conversation as a note" or similar to trigger it. The tool will automatically organize the conversation into Markdown and call it.

Q: Can I use it directly without any configuration?

A: Yes. The plugin will automatically fall back to the default demo server notes.fangyuanxiaozhan.com, render the conversation as a Smartisan Note long image PNG and save it locally. This mode cannot write to the note list, only suitable for trial or temporary sharing.

Q: I want to save notes to my own service. How do I configure it?

A: Set the note service address (NOTES_API_BASE_URL or plugin config's baseUrl), and provide a token or username/password. The intelligent agent will write the conversation as a note to the current account's cloud workspace, creating new or updating by note_id. If baseUrl is configured but no credentials are provided, it will explicitly error and won't silently fall back to the demo server.

Q: What are the action types returned by the tool, and what do they mean?

A: created means a new note was written; updated means an existing note was updated by note_id; exported-image means it was rendered as a note long image via the demo server (image mode), returning the local PNG path instead of a note link.

Q: Where does the note title come from?

A: It takes the first line of the full Markdown; the plugin removes heading symbols, quotes, and list markers, truncating to within 38 characters. It is recommended to write the title as # Title on the first line of the body.

Q: What note themes are supported?

A: Image mode supports default, smartisan-dark, apple-notes, apple-notes-light, bear, telegraph six themes; in write mode, the theme is determined by the note service side, and the tool does not modify the theme.

Q: Can I use version 0.1.0?

A: Not recommended. 0.1.0 will abort the session on first call with DSH 0.1.0-rc.6 due to duplicate installation of the host runtime. Please use version 0.1.1 or above (current latest 0.1.2).

Q: How to completely uninstall?

A: Execute dsh plugin --profile web remove @zhaoolee/dsh-notes, then restart the target profile; also clean up NOTES_API_* environment variables and credentials in the plugin config.

Ease of Use

Beginner — no configuration needed to generate note long images via the demo server; to write to your own note list, just set an address and credentials, which ordinary conversation users can complete.

Known Issues and Limitations

• When note service is not configured, conversation content will be sent to the default demo server notes.fangyuanxiaozhan.com's anonymous export interface for image rendering; the interface does not save to any account workspace, but for sensitive conversations, please configure your own note service first
• When only baseUrl is configured but no token or username/password provided, write mode will explicitly error and won't silently fall back to demo server
• In write mode, the note theme is determined by the note service side, and the tool does not modify the theme; theme parameter only takes effect in image mode
• Plugin version in repository source (github:zhaoolee/notes) is 0.1.2; old version 0.1.0 will abort the session on first call with DSH 0.1.0-rc.6 due to duplicate installation of the host tool runtime, please avoid using it
• Automatic re-read up to 4 times for workspace concurrent conflicts; after 4 consecutive conflicts, it will throw "Workspace has been changing during consecutive retries, please try again later"
• Notes in trash cannot be updated by note_id; the interface will return error "Notes in trash cannot be modified"

• 一个锤子便签风格的导出器，预览与图片导出支持暖白纸感、深夜便签、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 对话中说：把我们的对话导出成便签， 智能体会自动整理当前对话并调用插件生成便签。

通过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 反向代理。