# 墨语笔记 InkScribe

> 把文字整理为手写风格的单页笔记（康奈尔结构 + 手账排版），返回可以直接发给用户查看的链接。

墨语笔记是一个在线工具（https://scribe.orangely.xyz）：用户粘贴文字或上传 TXT、Markdown、HTML、DOCX、PDF 文件，Workers AI 把内容整理为标题、线索关键词、分节要点与总结，再以手写字体排版在纸张上，可添加贴纸与插图，并导出 1x/2x/3x 的 PNG/JPG 图片。无需注册；原文不会被保存，服务端日志只记录元数据。

## 页面

- [编辑器](https://scribe.orangely.xyz/)：粘贴文字、整理、排版与导出
- [图库](https://scribe.orangely.xyz/gallery)：公开的笔记
- 笔记查看页：`https://scribe.orangely.xyz/n/<id>`，HTML 中包含笔记全文（标题、线索、分节与总结）

## 给 AI agent 的用法

- 认证：`Authorization: Bearer <API 密钥>`（由站点管理员发放）。
- 创建笔记：`POST https://scribe.orangely.xyz/api/v1/notes`，JSON 请求体提供 `text`（原文，服务端用 Workers AI 整理）或 `note`（你已整理好的结构）二选一。
- 返回的 `url` 即笔记查看页，直接发给用户。
- `visibility` 默认 `unlisted`（仅持有链接可见）；只有用户明确要求公开时才使用 `public`，公开笔记会出现在 https://scribe.orangely.xyz/gallery。
- 重试时带上相同的 `Idempotency-Key` 头，避免重复创建。

示例：

```bash
curl -X POST https://scribe.orangely.xyz/api/v1/notes \
  -H "Authorization: Bearer $INKSCRIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: weekly-review-2026-10-22" \
  -d '{"text": "……原文……", "template": "meeting-minutes", "appearance": {"paper": "kraft", "ink": "brown"}}'
```

模板：general, reading-notes, meeting-minutes, lecture-summary, idea-fragments；版式：hybrid-cornell, classic-cornell, free-journal, minimal；纸张：grid, lined, dot, ivory, textured, kraft, parchment；墨水：carbon, blue, brown, green, bordeaux。

## 文档

- [OpenAPI 规范](https://scribe.orangely.xyz/api/v1/openapi.json)
- [图库](https://scribe.orangely.xyz/gallery)
- [站点地图](https://scribe.orangely.xyz/sitemap.xml)