feat: add note_manager — create/get/list notes via API

[DophinL]

Summary

Add note_manager.py to support creating and reading YouMind notes (thoughts) via API.

Changes

scripts/note_manager.py (new)

• create — create a note with plain text content, optional title and board association (POST /api/v1/createThoughtWithPlain)
• get — fetch a note by ID (POST /api/v1/getThought)
• list — list all notes in the space (POST /api/v1/listThoughts)

scripts/api_client.py

• Added create_note(), get_note(), list_notes() methods

SKILL.md

• Added Note Commands section with usage examples

Usage

# Create a note attached to a board
python3 scripts/run.py note_manager.py create --content "My note" --title "Title" --board-id <board-id>

# AI-generated title
python3 scripts/run.py note_manager.py create --content "My note" --board-id <board-id> --gen-title

# Get / list
python3 scripts/run.py note_manager.py get --id <note-id>
python3 scripts/run.py note_manager.py list

Verified

Tested locally against production API — returns NoteDto with type: "note" as expected.

[DophinL]

新增：create_craft() — 创建 Craft 文档 (type: page)

在原有 note 支持基础上，追加了创建 craft document（即看板里的「Document」类型）的接口。

背景

createThoughtWithPlain 固定返回 type: note，无法创建 craft document。
研究了后端代码后发现：

• POST /api/v1/createPage 需要客户端提供 Yjs binary base64（content.raw），纯 Python 难以生成
• POST /openapi/v1/createDocument 使用了 OpenApiContentInterceptor，接受 plain text string，服务端自动通过 createBase64ByPlainText 转换为 Yjs 格式

所以 create_craft() 走 /openapi/v1/createDocument，和 createThoughtWithPlain 同样的思路，但返回 type: page（craft document）。

使用方式

# Python API
result = client.create_craft(
    board_id='<board-id>',
    content_plain='Your document content',
    title='Document Title',
)
# result['type'] == 'page'

# CLI
python3 scripts/run.py note_manager.py create-craft \
  --content "Your document content" \
  --title "Document Title" \
  --board-id <board-id>

已在生产 API 验证，返回 PageDto with type: 'page'。

[DophinL]

路径 B 实现：客户端 Markdown → Yjs 转换

上一个 commit 修复了 markdown 不渲染的问题。

根本原因

POST /api/v1/createPage 的 content.raw 需要 Yjs binary base64，而 /openapi/v1/createDocument 的 createPage handler 没有 @OpenApiContentFields 装饰器，导致之前发的 plain text string 被直接存储，markdown 完全不解析。

解决方案

新增 scripts/md_to_base64.mjs（Node.js 脚本），在客户端完成转换：

Markdown → HTML (markdown-it) → Tiptap JSON (@tiptap/html) → Yjs binary (y-prosemirror) → base64

create_craft() 通过 subprocess 调用这个脚本，拿到 Yjs base64 后直接调 POST /api/v1/createPage。

渲染效果（截图验证）

标题、加粗/斜体、列表、表格、引用块、代码块全部正常渲染。

---

备选方案（如果 p697 愿意改后端）：在 createPage 上加 @OpenApiContentFields('content')，并在 OpenApiContentInterceptor 里用 markdownToBase64 代替 createBase64ByPlainText，这样服务端统一处理，skill 端更简洁。