Back to Details

apple-notes

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Apple Notes Creation & Editing

Apple Notes 创建与编辑

Overview

概述

Tools to interact with Apple Notes. Notes are scoped to an automatically created 
agent-notes
folder. Notes are formatted using HTML—supported elements are listed below.
用于与Apple Notes交互的工具。笔记会被限定在自动创建的
agent-notes
文件夹中。笔记使用HTML格式编写——支持的元素如下所列。

When to Use

适用场景

  • Storing information that should persist across sessions
  • Saving notes, ideas, or data the User wants to keep
  • Creating task lists, reminders, or reference material
  • When the User explicitly asks to save/remember something in notes
  • 存储需要跨会话持久化的信息
  • 保存用户想要留存的笔记、想法或数据
  • 创建任务列表、提醒事项或参考资料
  • 当用户明确要求在笔记中保存/记住某些内容时

How to Use

使用方法

  1. List existing notes to see what's available
  2. Read a note to get its HTML content
  3. Create new notes with HTML-formatted body
  4. Delete notes by title (to edit: read → delete → create)
  1. 列出现有笔记以查看可用内容
  2. 读取笔记以获取其HTML内容
  3. 创建带有HTML格式正文的新笔记
  4. 删除指定标题的笔记（编辑流程：读取 → 删除 → 创建）

Usage

使用示例

bash
undefined
bash
undefined

List notes

List notes

python scripts/list-notes.py
python scripts/list-notes.py

Create note (heredoc for reliable input)

Create note (heredoc for reliable input)

cat << 'EOF' | python scripts/create-note.py --title "My Note"
<div>Content here</div> EOF
cat << 'EOF' | python scripts/create-note.py --title "My Note"
<div>Content here</div> EOF

Read note

Read note

python scripts/read-note.py --title "My Note"
python scripts/read-note.py --title "My Note"

Delete note

Delete note

python scripts/delete-note.py --title "My Note"

> **Note:** The `--title` is automatically formatted as an `<h1>` header. Body content is piped via stdin using heredoc (`<< 'EOF'`) to avoid shell escaping issues.
python scripts/delete-note.py --title "My Note"

> **注意：** `--title`会自动格式化为`<h1>`标题。正文内容通过标准输入使用heredoc（`<< 'EOF'`）传递，以避免shell转义问题。

HTML Reference

HTML参考

ElementHTMLExample
Title
<h1>
<h1>Title</h1>
Heading
<h2>
<h2>Heading</h2>
Subheading
<h3>
<h3>Subheading</h3>
Paragraph
<div>
<div>Text here</div>
Bold
<b>
<b>bold</b>
Italic
<i>
<i>italic</i>
Underline
<u>
<u>underline</u>
Strikethrough
<strike>
<strike>deleted</strike>
Monospace
<tt>
<tt>code</tt>
Line break
<br>
<br>
Bullet list
<ul><li>
<ul><li>Item 1</li><li>Item 2</li></ul>
Numbered list
<ol><li>
<ol><li>First</li><li>Second</li></ol>
Table
<object><table>
See below
元素HTML示例
标题
<h1>
<h1>Title</h1>
二级标题
<h2>
<h2>Heading</h2>
三级标题
<h3>
<h3>Subheading</h3>
段落
<div>
<div>Text here</div>
粗体
<b>
<b>bold</b>
斜体
<i>
<i>italic</i>
下划线
<u>
<u>underline</u>
删除线
<strike>
<strike>deleted</strike>
等宽字体
<tt>
<tt>code</tt>
换行
<br>
<br>
无序列表
<ul><li>
<ul><li>Item 1</li><li>Item 2</li></ul>
有序列表
<ol><li>
<ol><li>First</li><li>Second</li></ol>
表格
<object><table>
见下方示例

Table Example

表格示例

html
<object><table><tbody><tr><td>A</td><td>B</td></tr><tr><td>1</td><td>2</td></tr></tbody></table></object>
html
<object><table><tbody><tr><td>A</td><td>B</td></tr><tr><td>1</td><td>2</td></tr></tbody></table></object>

Limitations

局限性

  • Checklists - Stored internally, checkbox state not accessible (renders as regular bullet list)
  • Links - Stripped on save
  • Highlights - Stored internally by Apple Notes
  • Images - Technically possible (base64) but impractical for LLM use
  • Attachments - Cannot be added programmatically
  • 复选清单 - 内部存储，但无法访问复选框状态（显示为普通无序列表）
  • 链接 - 保存时会被移除
  • 高亮 - 由Apple Notes内部存储
  • 图片 - 技术上可行（base64编码）但对LLM使用不切实际
  • 附件 - 无法通过编程方式添加