@baimingtao/lbs-agent 1.0.0

package/extensions/skills/builtin/productivity/nano-pdf/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: nano-pdf
+description: "通过 nano-pdf CLI 编辑 PDF 文本/错别字/标题（自然语言提示）。"
+version: 1.0.0
+author: community
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [PDF, Documents, Editing, NLP, Productivity]
+    homepage: https://pypi.org/project/nano-pdf/
+---
+
+# nano-pdf
+
+使用自然语言指令编辑 PDF。将其指向某一页并描述要更改的内容。
+
+## 前置条件
+
+```bash
+# Install with uv (recommended — already available in Hermes)
+uv pip install nano-pdf
+
+# Or with pip
+pip install nano-pdf
+```
+
+## 用法
+
+```bash
+nano-pdf edit <file.pdf> <page_number> "<instruction>"
+```
+
+## 示例
+
+```bash
+# Change a title on page 1
+nano-pdf edit deck.pdf 1 "Change the title to 'Q3 Results' and fix the typo in the subtitle"
+
+# Update a date on a specific page
+nano-pdf edit report.pdf 3 "Update the date from January to February 2026"
+
+# Fix content
+nano-pdf edit contract.pdf 2 "Change the client name from 'Acme Corp' to 'Acme Industries'"
+```
+
+## 说明
+
+- 页码可能是从 0 开始或从 1 开始的，具体取决于版本——如果编辑命中了错误的页面，请尝试将页码 ±1 后重试
+- 编辑后请务必检查输出的 PDF（使用 `read_file` 检查文件大小，或直接打开查看）
+- 该工具底层使用了 LLM——需要 API 密钥（查看 `nano-pdf --help` 了解配置方法）
+- 适用于文本修改；复杂的版式调整可能需要其他方法

package/extensions/skills/builtin/productivity/notion/SKILL.md

@@ -0,0 +1,448 @@
+---
+name: notion
+description: "Notion API + ntn CLI：页面、数据库、markdown、Workers。"
+version: 2.0.0
+author: community
+license: MIT
+platforms: [linux, macos, windows]
+prerequisites:
+  env_vars: [NOTION_API_KEY]
+metadata:
+  hermes:
+    tags: [Notion, Productivity, 说明, Database, API, CLI, Workers]
+    homepage: https://developers.notion.com
+---
+
+# Notion
+
+通过两种方式与 Notion 交互。同一个 integration token 适用于两者——可根据可用性进行选择。
+
+◆ **`ntn` CLI** — Notion 官方 CLI。语法更精简，支持单行文件上传，是使用 Workers 的必选项。截至 2026 年 5 月仅支持 macOS + Linux（Windows 支持“即将推出”）。**安装后默认使用。**
+◆ **HTTP + curl** — 可在任意平台运行（包含 Windows）。当未安装 `ntn` 时**默认的备选方案**。
+
+## 配置
+
+### 1. 获取 integration token（两条路径均需此步骤）
+
+1. 访问 https://notion.so/my-integrations 创建一个 integration
+2. 复制 API key（以 `ntn_` 或 `secret_` 开头）
+3. 将其存储在 `${HERMES_HOME:-~/.hermes}/.env` 中：
+   ```
+   NOTION_API_KEY=ntn_your_key_here
+   ```
+4. **在 Notion 中将目标页面/数据库与该 integration 共享**：点击页面菜单 `...` → `Connect to` → 你的 integration 名称。若不进行此操作，即使页面存在，API 对该页面也会返回 404。
+
+### 2. 安装 `ntn`（macOS / Linux 上的首选路径）
+
+```bash
+# Recommended
+curl -fsSL https://ntn.dev | bash
+
+# Or via npm (needs Node 22+, npm 10+)
+npm install --global ntn
+
+ntn --version    # verify
+```
+
+**跳过 `ntn login`——请改用 integration token。** 这可以在无头模式下运行，无需浏览器：
+```bash
+export NOTION_API_TOKEN=$NOTION_API_KEY      # ntn reads NOTION_API_TOKEN
+export NOTION_KEYRING=0                       # don't try to use the OS keychain
+```
+
+将这些 export 命令添加到你的 shell 配置文件中（或添加到 `${HERMES_HOME:-~/.hermes}/.env`），以便每个会话都能继承它们。
+
+### 3. 在运行时选择路径
+
+```bash
+if command -v ntn >/dev/null 2>&1; then
+  # use ntn
+else
+  # fall back to curl
+fi
+```
+
+Windows 用户：在原生 `ntn` 发布前，请直接跳过步骤 2——路径 B 已经可以正常工作。如果你希望现在就获得 CLI 的良好体验，请在 WSL2 中安装 `ntn`。
+
+## API 基础
+
+所有 HTTP 请求都必须包含 `Notion-Version: 2025-09-03`。`ntn` 会自动为你处理此标头。在此版本中，用户口中的“databases”在 API 里被称为 **data sources**。
+
+## Path A — `ntn` CLI（首选，macOS / Linux）
+
+### 原始 API 调用（curl 的简写形式）
+```bash
+ntn api v1/users                                  # GET
+ntn api v1/pages parent[page_id]=abc123 \         # POST with inline body
+  properties[title][0][text][content]="Notes"
+ntn api v1/pages/abc123 -X PATCH archived:=true   # PATCH; := is non-string (bool/num/null)
+```
+
+语法说明：
+- `key=value` — 字符串字段
+- `key[nested]=value` — 嵌套对象字段
+- `key:=value` — 带类型的赋值（布尔值、数字、null、数组）
+
+### 搜索
+```bash
+ntn api v1/search query="page title"
+```
+
+### 读取页面元数据
+```bash
+ntn api v1/pages/{page_id}
+```
+
+### 以 Markdown 格式读取页面（适合 Agent）
+```bash
+ntn api v1/pages/{page_id}/markdown
+```
+
+### 以 block 形式读取页面内容
+```bash
+ntn api v1/blocks/{page_id}/children
+```
+
+### 从 Markdown 创建页面
+```bash
+ntn api v1/pages \
+  parent[page_id]=xxx \
+  properties[title][0][text][content]="Notes from meeting" \
+  markdown="# Agenda
+
+- Q3 roadmap
+- Hiring"
+```
+
+### 使用 Markdown 更新页面
+```bash
+ntn api v1/pages/{page_id}/markdown -X PATCH \
+  markdown="## Update
+
+Shipped the prototype."
+```
+
+### 查询数据库（data source）
+```bash
+ntn api v1/data_sources/{data_source_id}/query -X POST \
+  filter[property]=Status filter[select][equals]=Active
+```
+
+对于包含 `sorts`、多个 filter 子句或复合逻辑的复杂查询，可通过管道传入 JSON：
+```bash
+echo '{"filter": {"property": "Status", "select": {"equals": "Active"}}, "sorts": [{"property": "Date", "direction": "descending"}]}' | \
+  ntn api v1/data_sources/{data_source_id}/query -X POST --json -
+```
+
+### 文件上传（单行命令——这是 CLI 的最大优势）
+```bash
+ntn files create < photo.png
+ntn files create --external-url https://example.com/photo.png
+ntn files list
+```
+
+相比之下，HTTP 流程需要 3 个步骤（创建上传 → PUT 数据字节数 → 引用文件）。
+
+### 实用的环境变量
+| 变量 | 效果 |
+|---|---|
+| `NOTION_API_TOKEN` | 认证 token（覆盖 keychain）——将其设置为你的 integration token |
+| `NOTION_KEYRING=0` | 在 `~/.config/notion/auth.json` 使用基于文件的凭证，而不是 OS keychain |
+| `NOTION_WORKSPACE_ID` | 跳过工作区选择提示 |
+
+## Path B — HTTP + curl（跨平台，Windows 默认）
+
+所有请求都遵循以下模式：
+
+```bash
+curl -s -X GET "https://api.notion.com/v1/..." \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json"
+```
+
+在 Windows 上，Windows 10+ 自带的 `curl` 可以直接使用。PowerShell 用户也可以使用 `Invoke-RestMethod`。
+
+### 搜索
+```bash
+curl -s -X POST "https://api.notion.com/v1/search" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{"query": "page title"}'
+```
+
+### 读取页面元数据
+```bash
+curl -s "https://api.notion.com/v1/pages/{page_id}" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03"
+```
+
+### 以 Markdown 格式读取页面（适合 Agent）
+
+比 block JSON 更容易喂给模型。
+
+```bash
+curl -s "https://api.notion.com/v1/pages/{page_id}/markdown" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03"
+```
+
+### 以 block 形式读取页面内容（当你需要结构化数据时）
+```bash
+curl -s "https://api.notion.com/v1/blocks/{page_id}/children" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03"
+```
+
+### 从 Markdown 创建页面
+
+`POST /v1/pages` 接受一个 `markdown` body 参数。
+
+```bash
+curl -s -X POST "https://api.notion.com/v1/pages" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent": {"page_id": "xxx"},
+    "properties": {"title": [{"text": {"content": "Notes from meeting"}}]},
+    "markdown": "# Agenda\n\n- Q3 roadmap\n- Hiring\n\n## Decisions\n- Ship MVP Friday"
+  }'
+```
+
+### 使用 Markdown 更新页面
+```bash
+curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}/markdown" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{"markdown": "## Update\n\nShipped the prototype."}'
+```
+
+### 在数据库中创建页面（带类型的 properties）
+```bash
+curl -s -X POST "https://api.notion.com/v1/pages" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent": {"database_id": "xxx"},
+    "properties": {
+      "Name": {"title": [{"text": {"content": "New Item"}}]},
+      "Status": {"select": {"name": "Todo"}}
+    }
+  }'
+```
+
+### 查询数据库（data source）
+```bash
+curl -s -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "filter": {"property": "Status", "select": {"equals": "Active"}},
+    "sorts": [{"property": "Date", "direction": "descending"}]
+  }'
+```
+
+### 创建数据库
+```bash
+curl -s -X POST "https://api.notion.com/v1/data_sources" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "parent": {"page_id": "xxx"},
+    "title": [{"text": {"content": "My Database"}}],
+    "properties": {
+      "Name": {"title": {}},
+      "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
+      "Date": {"date": {}}
+    }
+  }'
+```
+
+### 更新页面 properties
+```bash
+curl -s -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{"properties": {"Status": {"select": {"name": "Done"}}}}'
+```
+
+### 向页面追加 block
+```bash
+curl -s -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "children": [
+      {"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello from Hermes!"}}]}}
+    ]
+  }'
+```
+
+### 文件上传（3 步流程）
+```bash
+# 1. Create upload
+curl -s -X POST "https://api.notion.com/v1/file_uploads" \
+  -H "Authorization: Bearer $NOTION_API_KEY" \
+  -H "Notion-Version: 2025-09-03" \
+  -H "Content-Type: application/json" \
+  -d '{"filename": "photo.png", "content_type": "image/png"}'
+
+# 2. PUT bytes to the upload_url returned above
+curl -s -X PUT "{upload_url}" --data-binary @photo.png
+
+# 3. Reference {file_upload_id} in a page/block payload
+```
+
+## Property 类型
+
+数据库项目的常见 property 格式：
+
+- **Title:** `{"title": [{"text": {"content": "..."}}]}`
+- **Rich text:** `{"rich_text": [{"text": {"content": "..."}}]}`
+- **Select:** `{"select": {"name": "Option"}}`
+- **Multi-select:** `{"multi_select": [{"name": "A"}, {"name": "B"}]}`
+- **Date:** `{"date": {"start": "2026-01-15", "end": "2026-01-16"}}`
+- **Checkbox:** `{"checkbox": true}`
+- **Number:** `{"number": 42}`
+- **URL:** `{"url": "https://..."}`
+- **Email:** `{"email": "user@example.com"}`
+- **Relation:** `{"relation": [{"id": "page_id"}]}`
+
+## API 版本 2025-09-03 — Databases 与 Data Sources
+
+- **Databases 变成了 data sources。** 请使用 `/data_sources/` 端点进行查询和获取。
+- **每个数据库有两个 ID：** `database_id` 和 `data_source_id`。
+  - 创建页面时使用 `database_id`：`parent: {"database_id": "..."}`
+  - 查询时使用 `data_source_id`：`POST /v1/data_sources/{id}/query`
+- 搜索结果会将数据库以 `"object": "data_source"` 的形式返回，并带有 `data_source_id` 字段。
+
+## Notion Workers（进阶，需要 `ntn`）
+
+Workers 是由 Notion 为你托管的 TypeScript 程序。一个 worker 可以暴露以下任意组合：
+- **Syncs** — 按计划（默认 30 分钟）将外部 API 的数据拉取到 Notion 数据库中。
+- **工具** — 在 Notion 的 Custom Agents 中显示为可调用的工具。
+- **Webhooks** — 接收来自外部服务（GitHub、Stripe 等）的 HTTP 事件，并在 Notion 中执行操作。
+
+**套餐 / 平台限制：**
+- CLI 适用于所有套餐。**部署 Workers 需要 Business 或 Enterprise 套餐。**
+- 截至 2026 年 5 月，`ntn` 仅支持 macOS/Linux。Windows 用户需要使用 WSL2 或等待原生支持。
+- 在 2026 年 8 月 11 日之前免费；之后将按 Notion credits 计量收费。
+
+### 最小化 Worker
+
+```bash
+ntn workers new my-worker      # scaffold
+cd my-worker
+# Edit src/index.ts
+ntn workers deploy --name my-worker
+```
+
+`src/index.ts`:
+```typescript
+import { Worker } from "@notionhq/workers";
+
+const worker = new Worker();
+export default worker;
+
+worker.tool("greet", {
+  title: "Greet a User",
+  description: "Returns a friendly greeting",
+  inputSchema: { type: "object", properties: { name: { type: "string" } }, required: ["name"] },
+  execute: async ({ name }) => `Hello, ${name}!`,
+});
+```
+
+### Webhook capability
+
+```typescript
+worker.webhook("onGithubPush", {
+  title: "GitHub Push Handler",
+  execute: async (events, { notion }) => {
+    for (const event of events) {
+      // event.body, event.rawBody (for signature verification), event.headers
+      console.log("got delivery", event.deliveryId);
+    }
+  },
+});
+```
+
+部署后：`ntn workers webhooks list` 会显示 Notion 生成的 URL。请将该 URL 视为机密——除非你添加了签名验证，否则任何拥有该 URL 的人都可以向其 POST 事件。
+
+### Worker 生命周期命令
+
+```bash
+ntn workers deploy
+ntn workers list
+ntn workers exec <capability-key> -d '{"name": "world"}'
+ntn workers sync trigger <key>            # run a sync now
+ntn workers sync pause <key>
+ntn workers env set GITHUB_WEBHOOK_SECRET=...
+ntn workers runs list                     # recent invocations
+ntn workers runs logs <run-id>
+ntn workers webhooks list
+```
+
+当被要求构建 Worker 时，请使用 `ntn workers new` 搭建脚手架，在 `src/index.ts` 中编写代码，使用 `ntn workers env set` 设置任何机密，然后进行部署。Notion 在 https://developers.notion.com/workers 的文档涵盖了完整的 API 接口。
+
+## Notion-Flavored Markdown（由 `/markdown` 端点使用）
+
+标准 CommonMark 加上用于 Notion 特定 block 的类 XML 标签。请使用 **Tab** 进行缩进。
+
+**CommonMark 之外的 Block：**
+```
+<callout icon="🎯" color="blue_bg">
+	Ship the MVP by **Friday**.
+</callout>
+
+<details color="gray">
+<summary>Toggle title</summary>
+	Children indented one tab
+</details>
+
+<columns>
+	<column>Left side</column>
+	<column>Right side</column>
+</columns>
+
+<table_of_contents color="gray"/>
+```
+
+**行内格式：**
+- 提及：`<mention-user url="..."/>`、`<mention-page url="...">Title</mention-page>`、`<mention-date start="2026-05-15"/>`
+- 下划线：`<span underline="true">text</span>`
+- 颜色：`<span color="blue">text</span>` 或位于首行的 block 级别 `{color="blue"}`
+- 数学公式：行内 `$x^2$`，block `$$ ... $$`
+- 引用：`[^https://example.com]`
+
+**颜色：** `gray brown orange yellow green blue purple pink red`，以及用于背景的 `*_bg` 变体。
+
+H5/H6 标题会折叠为 H4。多个 `>` 行会渲染为独立的引用块——若要实现多行引用，请在单个 `>` 内部使用 `<br>`。
+
+## 选择正确的路径
+
+| 任务 | mac / Linux | Windows |
+|---|---|---|
+| 读取/写入页面、搜索、查询数据库 | `ntn api ...` | curl |
+| 读取页面供 agent 总结 | `ntn api v1/pages/{id}/markdown` | curl `/markdown` 端点 |
+| 上传文件 | `ntn files create < file` | 3 步 HTTP 流程 |
+| 一次性 API 探索 | `ntn api ...` | curl |
+| 构建由 Notion 托管的 sync / webhook / agent 工具 | `ntn workers ...` | WSL2 + `ntn workers ...` |
+
+## 说明
+
+- 页面/数据库 ID 是 UUID（带不带连字符均可——两者都被接受）。
+- 速率限制：平均每秒约 3 个请求。CLI 无法绕过此限制。
+- API 无法设置数据库的 **view** 过滤器——那只能在 UI 中设置。
+- 创建 data sources 时使用 `"is_inline": true` 可将其嵌入到页面中。
+- 务必向 curl 传递 `-s` 参数以隐藏进度条（让 agent 的输出更简洁）。
+- 读取时请通过 `jq` 管道处理 JSON：`... | jq '.results[0].properties'`。
+- Notion 现在还推出了一个 MCP server（`Notion MCP`，在数据库操作上比之前的版本节省约 91% 的 token）——如果你希望在会话内部实现对 Notion 的流式访问，可以通过 Hermes 的 MCP 支持来接入它，但对于大多数一次性任务，上述路径已经足够。

package/extensions/skills/builtin/productivity/notion/references/block-types.md

@@ -0,0 +1,112 @@
+# Notion Block 类型
+
+通过 API 创建和读取所有常见 Notion block 类型的参考。
+
+## 创建 block
+
+使用 `PATCH /v1/blocks/{page_id}/children` 并附带一个 `children` 数组。每个 block 遵循以下结构：
+
+```json
+{"object": "block", "type": "<type>", "<type>": { ... }}
+```
+
+### 段落
+
+```json
+{"type": "paragraph", "paragraph": {"rich_text": [{"text": {"content": "Hello world"}}]}}
+```
+
+### 标题
+
+```json
+{"type": "heading_1", "heading_1": {"rich_text": [{"text": {"content": "Title"}}]}}
+{"type": "heading_2", "heading_2": {"rich_text": [{"text": {"content": "Section"}}]}}
+{"type": "heading_3", "heading_3": {"rich_text": [{"text": {"content": "Subsection"}}]}}
+```
+
+### 无序列表
+
+```json
+{"type": "bulleted_list_item", "bulleted_list_item": {"rich_text": [{"text": {"content": "Item"}}]}}
+```
+
+### 有序列表
+
+```json
+{"type": "numbered_list_item", "numbered_list_item": {"rich_text": [{"text": {"content": "Step 1"}}]}}
+```
+
+### 待办事项 / 复选框
+
+```json
+{"type": "to_do", "to_do": {"rich_text": [{"text": {"content": "Task"}}], "checked": false}}
+```
+
+### 引用
+
+```json
+{"type": "quote", "quote": {"rich_text": [{"text": {"content": "Something wise"}}]}}
+```
+
+### 提示框
+
+```json
+{"type": "callout", "callout": {"rich_text": [{"text": {"content": "Important note"}}], "icon": {"emoji": "💡"}}}
+```
+
+### 代码
+
+```json
+{"type": "code", "code": {"rich_text": [{"text": {"content": "print('hello')"}}], "language": "python"}}
+```
+
+### 折叠块
+
+```json
+{"type": "toggle", "toggle": {"rich_text": [{"text": {"content": "Click to expand"}}]}}
+```
+
+### 分割线
+
+```json
+{"type": "divider", "divider": {}}
+```
+
+### 书签
+
+```json
+{"type": "bookmark", "bookmark": {"url": "https://example.com"}}
+```
+
+### 图片（外部 URL）
+
+```json
+{"type": "image", "image": {"type": "external", "external": {"url": "https://example.com/photo.png"}}}
+```
+
+## 读取 block
+
+当通过 `GET /v1/blocks/{page_id}/children` 读取 block 时，每个 block 都有一个 `type` 字段。按以下方式提取可读文本：
+
+| 类型 | 文本位置 | 额外字段 |
+| ------ | -------------- | -------------- |
+| `paragraph` | `.paragraph.rich_text` | — |
+| `heading_1/2/3` | `.heading_N.rich_text` | — |
+| `bulleted_list_item` | `.bulleted_list_item.rich_text` | — |
+| `numbered_list_item` | `.numbered_list_item.rich_text` | — |
+| `to_do` | `.to_do.rich_text` | `.to_do.checked` (bool) |
+| `toggle` | `.toggle.rich_text` | 包含子 block |
+| `code` | `.code.rich_text` | `.code.language` |
+| `quote` | `.quote.rich_text` | — |
+| `callout` | `.callout.rich_text` | `.callout.icon.emoji` |
+| `divider` | — | — |
+| `image` | `.image.caption` | `.image.file.url` 或 `.image.external.url` |
+| `bookmark` | `.bookmark.caption` | `.bookmark.url` |
+| `child_page` | — | `.child_page.title` |
+| `child_database` | — | `.child_database.title` |
+
+Rich text 数组包含带有 `.plain_text` 的对象 —— 将它们拼接起来即可得到可读的输出。
+
+---
+
+*由 [@dogiladeveloper](https://github.com/dogiladeveloper) 贡献*

package/extensions/skills/builtin/productivity/ocr-and-documents/DESCRIPTION.md

@@ -0,0 +1,3 @@
+---
+description: 使用 OCR 和文档解析工具从 PDF、扫描文档、图像及其他文件格式中提取文本的 Skills。
+---