{"id":"c76e918c-5d44-4a31-a4b2-95839219b912","entityType":"agent","slug":"clawhub-monkeydb-hd-notes-skills","name":"话袋笔记 Skill","canonicalUrl":"https://www.xpersona.co/agent/clawhub-monkeydb-hd-notes-skills","canonicalPath":"/agent/clawhub-monkeydb-hd-notes-skills","generatedAt":"2026-10-11T20:56:25.966Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T18:08:56.854Z","emptyReason":null},"description":"话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。 当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Skill: 话袋笔记 Skill Owner: monkeydb Summary: 话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。 当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-07-13T04:23:22.704Z | user **v1.1.0 update summary:** Skill name, documentation, and structure h","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17bzjcpm1anady2ttcx59s195858va5:hd-notes-skills","sourceUrl":"https://clawhub.ai/monkeydb/hd-notes-skills","homepage":"https://clawhub.ai/monkeydb/skills/hd-notes-skills","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/monkeydb/hd-notes-skills","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/monkeydb/skills/hd-notes-skills","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。 当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:08:56.854Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:08:56.854Z","emptyReason":null},"stars":null,"forks":null,"downloads":1012,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:08:56.840Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T18:08:56.854Z","lastCrawledAt":"2026-10-11T18:08:56.840Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T18:08:56.840Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-07-13T04:23:22.704Z","changelog":"**v1.1.0 update summary:** Skill name, documentation, and structure have been streamlined for clarity and modern usage. - Renamed skill to \"hd-notes-skills\" and updated all relevant metadata. - Simplified API usage: only requires HUADAI_API_KEY; removed OAuth and user UUID support. - Combined and condensed documentation to a single reference file (`references/api.md`). - Added shell scripts for API interaction (`scripts/*.sh`) and removed Python scripts. - Enhanced user guidance for API key configuration and error handling. - Updated rules for data authenticity, security, and result handling to be more concise and deterministic.","fileCount":11,"zipByteSize":15746},{"version":"1.0.0","createdAt":"2026-04-22T07:22:04.831Z","changelog":"话袋笔记 Skill 1.0.0 - 初始发布，支持创建、更新和搜索个人笔记 - 提供详细配置、权限、安全及错误处理规则 - 支持基于自然语言的指令路由及 API 路由表 - 明确区分配置、鉴权、规范响应与多人私密性约束","fileCount":12,"zipByteSize":21636}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17bzjcpm1anady2ttcx59s195858va5:hd-notes-skills","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T20:56:25.965Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-monkeydb-hd-notes-skills/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T18:08:56.854Z","emptyReason":null},"readme":"Skill: 话袋笔记 Skill\n\nOwner: monkeydb\n\nSummary: 话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。\n\n当以下情况时使用此 Skill：\n(1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」\n(1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」\n(2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」\n(3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」\n(4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-07-13T04:23:22.704Z | user\n\n**v1.1.0 update summary:**  \nSkill name, documentation, and structure have been streamlined for clarity and modern usage.\n\n- Renamed skill to \"hd-notes-skills\" and updated all relevant metadata.\n- Simplified API usage: only requires HUADAI_API_KEY; removed OAuth and user UUID support.\n- Combined and condensed documentation to a single reference file (`references/api.md`).\n- Added shell scripts for API interaction (`scripts/*.sh`) and removed Python scripts.\n- Enhanced user guidance for API key configuration and error handling.\n- Updated rules for data authenticity, security, and result handling to be more concise and deterministic.\n\nv1.0.0 | 2026-04-22T07:22:04.831Z | user\n\n话袋笔记 Skill 1.0.0\n\n- 初始发布，支持创建、更新和搜索个人笔记\n- 提供详细配置、权限、安全及错误处理规则\n- 支持基于自然语言的指令路由及 API 路由表\n- 明确区分配置、鉴权、规范响应与多人私密性约束\n\nArchive index:\n\nArchive v1.0.1: 11 files, 15746 bytes\n\nFiles: _meta.json (134b), .idea/workspace.xml (2558b), package.json (889b), README.md (4036b), references/api.md (5499b), scripts/oauth.sh (600b), scripts/search.sh (3001b), scripts/update.sh (2491b), scripts/upload.sh (2441b), skill-card.md (2095b), SKILL.md (7081b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: hd-notes-skills\ndescription: |\n  话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。\n\n  当以下情况时使用此 Skill：\n  (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」\n  (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」\n  (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」\n  (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」\n  (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」\nversion: 1.1.0\nhomepage: https://clawhub.ai/monkeydb/hd-notes-skills\nuser-invocable: true\nmetadata:\n  openclaw:\n    emoji: \"📝\"\n    primaryEnv: HUADAI_API_KEY\n    requires:\n      env:\n        - HUADAI_API_KEY\n    envVars:\n      - name: HUADAI_API_KEY\n        required: true\n        description: 话袋开放平台 API Key（请求头 Authorization）\n    baseUrl: \"https://openapi.ihuadai.cn/open/api/v1\"\n    homepage: \"https://clawhub.ai/monkeydb/hd-notes-skills\"\n    repository: \"https://github.com/monkeyDB/hd-notes-skills\"\n---\n\n# 话袋笔记 Skill\n\n## Agent 必读约束\n\n- **唯一 Base URL**：`https://openapi.ihuadai.cn/open/api/v1`。禁止使用其他域名，禁止重复拼接 `/open/api/v1`。\n- **鉴权方式**：业务 API 仅使用请求头 `Authorization: <HUADAI_API_KEY>`。\n- **API Key 来源**：用户需先在 [话袋开放平台](https://ihuadai.cn/desktop/openai) 创建 API Key。如果用户未配置，引导用户创建并配置 `HUADAI_API_KEY`。\n- **数据真实性**：所有笔记内容、搜索结果、笔记 ID 都必须来自 API 响应。禁止编造「已保存」「已找到」「已更新」。\n- **写操作确认**：只有 API 返回 `code=200` 后，才能回复用户已保存或已更新。\n- **更新笔记约束**：`unique_id` 必须来自搜索结果或用户明确提供，禁止猜测或生成已有笔记 ID。\n- **密钥安全**：不要在对话中要求用户粘贴 API Key，不要回显、记录、总结或展示 `HUADAI_API_KEY`。\n\n## 快速开始：配置 API Key\n\n如果还没有配置 `HUADAI_API_KEY`，引导用户：\n\n- 打开 https://ihuadai.cn/desktop/openai 创建 API Key\n- 设置环境变量：`export HUADAI_API_KEY=<你的Key>`\n\n## 文档索引\n\n| 文档 | 内容 | 何时读取 |\n|------|------|----------|\n| [API 参考](references/api.md) | 完整请求体、curl 示例、响应判断、错误码 | 需要构造 API 调用或处理错误时 |\n\n## 指令路由表\n\n| 指令 | 角色 | 说明 | 详细文档 |\n|------|------|------|----------|\n| `/huadai config` 或「配置话袋」 | 配置 | 引导用户到开放平台创建并配置 API Key | [API 参考](references/api.md) |\n| `/huadai upload` 或「记一下/保存」 | 新建 | 新建 Block 笔记 | [API 参考](references/api.md#新建笔记) |\n| `/huadai update` 或「更新笔记」 | 更新 | 搜索确认目标后更新 Block 内容 | [API 参考](references/api.md#更新笔记) |\n| `/huadai search` 或「搜一下」 | 搜索 | 关键词检索笔记 | [API 参考](references/api.md#搜索笔记) |\n\n## 自然语言路由\n\n| 用户说法（示例） | 路由 | 执行方式 |\n|------------------|------|----------|\n| 「授权话袋」「连接话袋笔记」「配置话袋」「怎么填 Key」 | Config | 不调用业务 API，引导配置 `HUADAI_API_KEY` |\n| 「新建/上传/保存/写入到笔记」「记一下」 | Upload | `POST /block/upload-block` |\n| 「更新/修改笔记」「补充到这条」 | Update | 先确认 `unique_id`，再 `POST /block/update-block` |\n| 「搜/找/检索/有哪些相关笔记」 | Search | `GET /search` |\n\n## API 路由表\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/search` | 关键词搜索笔记 |\n| GET | `/block/:unique_id` | 获取单条笔记详情 |\n| POST | `/block/upload-block` | 新建笔记 |\n| POST | `/block/update-block` | 更新笔记 |\n\n完整 URL 等于 Base URL + 路径。例如：`https://openapi.ihuadai.cn/open/api/v1/search`。\n\n## 执行规则\n\n### 搜索笔记\n\n- 调用 `GET /search?query=<关键词>&page=1&size=10`。\n- 无结果时明确回复「未找到」，不要编造类似笔记。\n- 从响应中提取关键信息展示给用户：\n  - `unique_id` — 笔记唯一标识（更新/查详情时需要）\n  - `content` — Quill Delta 数组，提取 `insert` 字段拼接为纯文本摘要\n  - `create_time` / `update_time` — Unix 时间戳，可转为可读时间\n  - `type` — 笔记类型\n- 展示结果时优先给标题/摘要/`unique_id`，方便用户选择要更新哪条。\n- 如果结果超过一页（`total > size`），提示用户缩小搜索范围或翻页。\n\n### 获取笔记详情\n\n- 调用 `GET /block/:unique_id` 查看笔记完整内容。\n- 仅在用户明确要求查看某条笔记详情，或需要获取完整内容用于更新时使用。\n\n### 新建笔记\n\n- 为新笔记生成新的 `unique_id`，格式：`b_<unix_time>_<random8>`。\n- 普通文本笔记使用 `type=1`。\n- `content` 直接传 Markdown 字符串。后端会自动转为 Quill Delta，无需手动构建数组。\n- `create_time` 使用当前 Unix 秒。\n- `status=1` 表示正常笔记。\n- `is_collect=0` 表示非收藏笔记（必填，`0`=否 `1`=是）。\n- `is_todo=0` 表示非待办笔记（必填，`0`=否 `1`=是）。\n\n### 更新笔记\n\n- 更新前必须确认目标 `unique_id`。\n- 如果用户没有提供明确 `unique_id`，先搜索，再让用户确认或选择最匹配的一条。\n- `content` 传更新后的完整 Markdown 字符串。\n- `status=1` 表示正常笔记。\n- `is_collect=0` 表示非收藏笔记（必填，`0`=否 `1`=是）。\n- `is_todo=0` 表示非待办笔记（必填，`0`=否 `1`=是）。\n- 不要只发送「追加内容」并假装已合并，除非 API 请求体确实包含最终要保存的内容。\n\n## 脚本调用指引\n\n本 Skill 提供了 `scripts/` 目录下的辅助脚本。在环境中配置了 `HUADAI_API_KEY` 后，可以直接执行：\n\n```bash\n# 搜索笔记\n./scripts/search.sh \"关键词\"\n\n# 新建笔记\n./scripts/upload.sh \"笔记内容（Markdown）\"\n\n# 更新笔记\n./scripts/update.sh <unique_id> \"新内容\"\n```\n\nAgent 可优先选择调用脚本而非手动拼接 curl。脚本已处理参数校验、错误处理和响应格式化。\n\n## 通用错误处理\n\n| code | 处理方式 |\n|------|----------|\n| 200 | 成功。写操作可回复已保存/已更新 |\n| 400001 | API Key 无效，引导用户重新创建并配置 API Key |\n| 400003 | 无权限访问该资源 |\n| 400018 | 笔记不存在，提示重新搜索确认 |\n| 400024 | 需要有效会员，引导用户在话袋开通对应权益 |\n| 500000 | 服务异常，提示稍后重试 |\n\n## 安全规则\n\n- 不输出 API Key。\n- 不保存 API Key 到笔记正文。\n- 不在未调用 API 或 API 未成功时声称操作完成。\n- 不猜测已有笔记 ID、用户身份、隐藏内容。\n- 不泄露搜索结果以外的任何用户数据。\n\nFile v1.0.1:README.md\n\n# 话袋笔记 Skill\n\n话袋笔记 Skill 是话袋面向通用 Agent 的笔记能力扩展，支持通过自然语言新建、更新和搜索个人笔记。它采用 `SKILL.md` + `references/` + `scripts/` 的标准 Skill 结构，可发布到 ClawHub、SkillHub 等 Skill 市场，也可被支持 Skill 目录的 Agent 环境安装使用。\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 新建笔记 | 用一句话快速记录想法、会议结论、灵感和待整理内容 |\n| 搜索笔记 | 用关键词找回之前记录的内容 |\n| 更新笔记 | 基于搜索结果确认 `unique_id` 后，补充或修改已有笔记 |\n\n## 安装\n\n### 让 AI 助手安装（推荐）\n\n在 AI 助手中输入以下指令即可安装：\n\n**直接安装ClawHub地址：**\n```text\n请安装话袋笔记 Skill，地址：https://clawhub.ai/monkeydb/hd-notes-skills\n```\n\n**Claude Code / Cursor / Codex / OpenClaw / 其他通用 Agent：**\n```text\n请安装话袋笔记 Skill，地址：https://github.com/monkeyDB/hd-notes-skills\n```\n\n如果 ClawHub 不可用，也可以直接从 GitHub 安装：\n```text\n请安装话袋笔记 Skill，地址：https://raw.githubusercontent.com/monkeyDB/hd-notes-skills/main/SKILL.md\n```\n\n### 手动安装\n\n将本仓库作为一个 Skill 目录放到你的 Agent 支持的 Skill 目录中。常见形式如下，实际路径以对应 Agent 文档为准：\n\n```bash\ngit clone https://github.com/monkeyDB/hd-notes-skills.git\n```\n\n安装后，确保 Agent 能读取仓库根目录的 `SKILL.md`、`references/api.md` 和 `scripts/` 目录。\n\n## 配置\n\n1. 打开 [话袋开放平台](https://ihuadai.cn/desktop/openai)\n2. 创建 API Key\n3. 在 Agent 运行环境中配置环境变量：\n\n```bash\nexport HUADAI_API_KEY=<你的API Key>\n```\n\n**Claude Code 用户** 也可以在 `~/.bashrc` 或 `~/.zshrc` 中设置：\n\n```bash\necho 'export HUADAI_API_KEY=<你的API Key>' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n调用 OpenAPI 时，Skill 会通过请求头传递：\n\n```http\nAuthorization: <HUADAI_API_KEY>\n```\n\n> ⚠️ 不要在聊天中粘贴、展示或保存 API Key。\n\n## 使用示例\n\n### 记录想法\n\n```text\n记一下：以后可以试试每天早起 30 分钟看书，提高专注力。\n```\n\n### 记录会议结论\n\n```text\n帮我记一下今天的结论：\n1. 本周先完成首页改版的基础功能\n2. 登录问题优先修复，明天前给出方案\n3. 下周一安排前后端联调\n```\n\n### 查找历史笔记\n\n```text\n帮我找一下之前记的「早起看书」相关内容。\n```\n\n### 更新笔记\n\n```text\n把刚才找到的早起看书那条补充一句：先从每周三天开始，不追求每天都做。\n```\n\n## API\n\nBase URL：\n\n```text\nhttps://openapi.ihuadai.cn/open/api/v1\n```\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/search` | 搜索笔记 |\n| GET | `/block/:unique_id` | 获取笔记详情 |\n| POST | `/block/upload-block` | 新建笔记 |\n| POST | `/block/update-block` | 更新笔记 |\n\n请求体、curl 示例和错误码见 [references/api.md](references/api.md)。\n\n## 兼容平台\n\n| 平台 | 状态 | 说明 |\n|------|------|------|\n| Claude Code | ✅ | 支持 SKILL.md 目录格式 |\n| Cursor | ✅ | 支持 Skill 安装 |\n| Codex (OpenAI) | ✅ | 通过 OpenClaw 兼容 |\n| OpenClaw | ✅ | 原生支持，含 metadata.openclaw 配置 |\n| 任意 Skill 目录 Agent | ✅ | 标准 SKILL.md + references/ + scripts/ 格式 |\n\n## 安全边界\n\n- API Key 只用于请求头 `Authorization`。\n- 未配置 API Key 时，Skill 只引导用户到话袋开放平台创建并配置 API Key。\n- 写操作必须以 API 返回 `code=200` 为准。\n- 搜索为空时必须明确说明未找到，禁止编造结果。\n- 更新笔记时，`unique_id` 必须来自搜索结果或用户明确提供。\n\n## 相关链接\n\n- [GitHub地址](https://github.com/monkeyDB/hd-notes-skills)\n- [ClawHub商店地址](https://clawhub.ai/monkeydb/hd-notes-skills)\n- [话袋开放平台](https://ihuadai.cn/desktop/openai)\n- [话袋官网](https://ihuadai.cn)\n\n## License\n\nMIT-0\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7emwh7zk4apdw4p85qfe6xy9859xvm\",\n  \"slug\": \"hd-notes-skills\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783916602704\n}\n\nFile v1.0.1:references/api.md\n\n# API 参考\n\n**Base URL**：`https://openapi.ihuadai.cn/open/api/v1`\n**鉴权**：请求头 `Authorization: <HUADAI_API_KEY>`\n\n所有业务 API 都返回统一 JSON。成功以 `code=200` 为准。\n\n## 搜索笔记\n\n```http\nGET https://openapi.ihuadai.cn/open/api/v1/search?query={关键词}&page=1&size=10\nAuthorization: <HUADAI_API_KEY>\n```\n\ncurl 示例：\n\n```bash\ncurl -sS -G \"https://openapi.ihuadai.cn/open/api/v1/search\" \\\n  --data-urlencode \"query=早起看书\" \\\n  --data-urlencode \"page=1\" \\\n  --data-urlencode \"size=10\" \\\n  -H \"Authorization: $HUADAI_API_KEY\"\n```\n\n### 搜索响应结构\n\n成功时返回 `code=200`，核心数据在 `data` 字段中：\n\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"total\": 5,\n    \"page\": 1,\n    \"size\": 10,\n    \"data\": [\n      {\n        \"unique_id\": \"b_1730000000_a1b2c3d4\",\n        \"type\": 1,\n        \"content\": [{ \"insert\": \"笔记正文内容...\" }],\n        \"create_time\": 1720000000,\n        \"update_time\": 1720086400,\n        \"is_collect\": 0,\n        \"is_todo\": 0,\n        \"status\": 1\n      }\n    ]\n  }\n}\n```\n\n**关键字段说明**：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `total` | int | 匹配总数 |\n| `data[].unique_id` | string | 笔记唯一标识，用于更新和查详情 |\n| `data[].type` | int | 笔记类型：1=文本、2=图片、3=语音、4=视频 |\n| `data[].content` | array | Quill Delta ops 数组，从中提取 `insert` 拼接为文本摘要 |\n| `data[].create_time` | int | Unix 秒时间戳 |\n| `data[].update_time` | int | 最后更新时间（Unix 秒） |\n| `data[].status` | int | 状态：1=正常 |\n\n**提取内容摘要**：`content` 是 Quill Delta 数组，遍历每个 op，取 `insert` 字段拼接即可得到纯文本。\n\n执行要求：\n\n- 无结果时明确回复「未找到」。\n- 更新笔记前，优先通过搜索结果确认目标 `unique_id`。\n- 不要猜测或生成已有笔记的 `unique_id`。\n\n## 获取笔记详情\n\n```http\nGET https://openapi.ihuadai.cn/open/api/v1/block/{unique_id}\nAuthorization: <HUADAI_API_KEY>\n```\n\ncurl 示例：\n\n```bash\ncurl -sS \"https://openapi.ihuadai.cn/open/api/v1/block/b_1730000000_a1b2c3d4\" \\\n  -H \"Authorization: $HUADAI_API_KEY\"\n```\n\n返回单条笔记的完整信息，包括 `content`、`attachment`、`children`（追记/子笔记）等字段。\n\n执行要求：\n\n- 在用户明确要求查看某条笔记详情，或更新前需要确认完整内容时调用。\n- `unique_id` 必须来自搜索结果或用户明确提供。\n\n## 新建笔记\n\n```http\nPOST https://openapi.ihuadai.cn/open/api/v1/block/upload-block\nAuthorization: <HUADAI_API_KEY>\nContent-Type: application/json\n```\n\n推荐请求体。`content` 可以直接传 Markdown 字符串：\n\n```json\n{\n  \"unique_id\": \"b_1730000000_a1b2c3d4\",\n  \"type\": 1,\n  \"content\": \"正文\\n\",\n  \"create_time\": 1717142400,\n  \"status\": 1,\n  \"is_collect\": 0,\n  \"is_todo\": 0\n}\n```\n\n兼容请求体。`content` 也可以传 Quill Delta ops：\n\n```json\n{\n  \"unique_id\": \"b_1730000000_a1b2c3d4\",\n  \"type\": 1,\n  \"content\": [\n    {\n      \"insert\": \"正文\\n\"\n    }\n  ],\n  \"create_time\": 1717142400,\n  \"status\": 1\n}\n```\n\ncurl 示例：\n\n```bash\ncurl -sS -X POST \"https://openapi.ihuadai.cn/open/api/v1/block/upload-block\" \\\n  -H \"Authorization: $HUADAI_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"unique_id\":\"b_1730000000_a1b2c3d4\",\"type\":1,\"content\":\"正文\\n\",\"create_time\":1717142400,\"status\":1,\"is_collect\":0,\"is_todo\":0}'\n```\n\n执行要求：\n\n- `unique_id` 必须是新生成的笔记 ID。\n- 普通文本笔记使用 `type=1`。\n- `create_time` 使用当前 Unix 秒。\n- 只有响应 `code=200` 后，才能回复「已保存」。\n\n## 更新笔记\n\n```http\nPOST https://openapi.ihuadai.cn/open/api/v1/block/update-block\nAuthorization: <HUADAI_API_KEY>\nContent-Type: application/json\n```\n\n推荐请求体。`unique_id` 必须来自搜索结果或用户明确提供，`content` 传更新后的完整 Markdown 正文：\n\n```json\n{\n  \"unique_id\": \"b_xxx\",\n  \"type\": 1,\n  \"content\": \"更新后的完整正文\\n\",\n  \"status\": 1,\n  \"is_collect\": 0,\n  \"is_todo\": 0\n}\n```\n\n兼容请求体：\n\n```json\n{\n  \"unique_id\": \"b_xxx\",\n  \"type\": 1,\n  \"content\": [\n    {\n      \"insert\": \"更新后的完整正文\\n\"\n    }\n  ],\n  \"status\": 1\n}\n```\n\ncurl 示例：\n\n```bash\ncurl -sS -X POST \"https://openapi.ihuadai.cn/open/api/v1/block/update-block\" \\\n  -H \"Authorization: $HUADAI_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"unique_id\":\"b_xxx\",\"type\":1,\"content\":\"更新后的完整正文\\n\",\"status\":1,\"is_collect\":0,\"is_todo\":0}'\n```\n\n执行要求：\n\n- 更新前必须确认目标 `unique_id`。\n- 如果用户只描述「刚才那条」或「相关那条」，先搜索并确认。\n- 请求体应包含更新后的完整正文，避免把增量补充误当成完整内容。\n- 只有响应 `code=200` 后，才能回复「已更新」。\n\n## 错误码\n\n| code | 含义 | 处理方式 |\n|------|------|----------|\n| 200 | 成功 | 写操作可回复已保存/已更新 |\n| 400001 | Key 无效 | 引导用户重新创建并配置 API Key |\n| 400003 | 无权限 | 告知无权限访问该资源 |\n| 400018 | 笔记不存在 | 提示重新搜索确认目标笔记 |\n| 400024 | 需有效会员 | 引导用户在话袋开通对应权益 |\n| 500000 | 系统错误 | 提示稍后重试 |\n\n## 安全要求\n\n- 不在对话中输出 `HUADAI_API_KEY`。\n- 不把 API Key 写入笔记正文。\n- 不在 API 调用失败时声称成功。\n- 不编造搜索结果、笔记 ID、笔记内容。\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\n话袋笔记 Skill helps agents create, update, and search personal notes through the Huadai OpenAPI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[monkeydb](https://clawhub.ai/user/monkeydb)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agent developers use this skill to connect a compatible agent to Huadai Notes so it can save new notes, search existing notes, and update confirmed notes through the Huadai OpenAPI.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Helper scripts may execute unintended local code when handling note identifiers.\n\nMitigation: Review before installing and avoid arbitrary or externally supplied note IDs until upload.sh and update.sh serialize unique_id safely.\n\nRisk: The Huadai API key can be sent to an overridden endpoint if HUADAI_BASE_URL points away from Huadai.\n\nMitigation: Use only a Huadai API key you are comfortable exposing to this skill and do not set HUADAI_BASE_URL to a non-Huadai host.\n\n## Reference(s):\n\n- [API Reference](references/api.md)\n- [ClawHub Skill Page](https://clawhub.ai/monkeydb/skills/hd-notes-skills)\n- [ClawHub Marketplace Page](https://clawhub.ai/monkeydb/hd-notes-skills)\n- [Huadai Open Platform](https://ihuadai.cn/desktop/openai)\n- [Huadai OpenAPI Base URL](https://openapi.ihuadai.cn/open/api/v1)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and plain text guidance with shell commands and API response summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires HUADAI_API_KEY for authenticated Huadai OpenAPI calls.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release metadata; artifact frontmatter and package metadata report 1.1.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v1.0.1:package.json\n\n{\n  \"name\": \"hd-notes-skills\",\n  \"version\": \"1.1.0\",\n  \"description\": \"话袋笔记 Skill：通过话袋 OpenAPI 新建、更新和搜索个人笔记。\",\n  \"license\": \"MIT-0\",\n  \"author\": \"话袋 (Huadai)\",\n  \"homepage\": \"https://github.com/monkeyDB/hd-notes-skills\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/monkeyDB/hd-notes-skills.git\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/monkeyDB/hd-notes-skills/issues\"\n  },\n  \"keywords\": [\n    \"话袋\",\n    \"笔记\",\n    \"huadai\",\n    \"notes\",\n    \"skill\",\n    \"openclaw\",\n    \"clawhub\",\n    \"skillhub\",\n    \"agent\",\n    \"hd-notes-skills\"\n  ],\n  \"clawhub\": {\n    \"acceptLicenseTerms\": true\n  },\n  \"openclaw\": {\n    \"minVersion\": \"0.1.0\",\n    \"baseUrl\": \"https://openapi.ihuadai.cn/open/api/v1\",\n    \"requires\": {\n      \"env\": [\n        \"HUADAI_API_KEY\"\n      ]\n    },\n    \"primaryEnv\": \"HUADAI_API_KEY\"\n  }\n}\n\nArchive v1.0.0: 12 files, 21636 bytes\n\nFiles: _meta.json (134b), package.json (612b), README.md (4731b), references/api-details.md (6157b), references/config.md (2013b), references/oauth.md (8343b), references/search.md (1665b), references/update.md (1312b), references/upload.md (1369b), scripts/oauth_poll.py (7883b), skill-card.md (2754b), SKILL.md (5994b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: 话袋笔记\ndescription: |\n  话袋笔记 - 新建、更新和搜索个人笔记。\n\n  **当以下情况时使用此 Skill**：\n  (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」「收藏」\n  (2) 用户要更新内容到笔记：「更新一下」「更新笔记」\n  (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」\n  (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「怎么填 Key」\nmetadata:\n  openclaw:\n    requires: {}\n    optionalEnv:\n      - HUADAI_BASE_URL\n      - HUADAI_API_KEY\n      - HUADAI_CLIENT_ID\n      - HUADAI_USER_UUID\n    baseUrl: \"https://openapi.ihuadai.cn/open/api/v1\"\n    homepage: \"https://ihuadai.cn\"\n---\n# 话袋笔记 Skill\n\n## Agent 必读约束\n\n- **唯一 Base URL**：`https://openapi.ihuadai.cn/open/api/v1`（禁止使用其他域名或自行拼接根域）\n- **开放 API 文档**：以话袋官方发布为准（此仓库以 `references/` 内文档为最终对接依据）\n- **鉴权与必需请求头**：`HUADAI_API_KEY`**（`Authorization`）及 **`HUADAI_USER_UUID`**（`USER-UUID`，与话袋用户 `unique_id` 一致）\n- **OAuth（设备码）**：按 [OAuth 授权配置](references/oauth.md) 执行；默认使用服务端预注册的固定 `client_id`，一般**只需要**配置 `HUADAI_BASE_URL` 即可走授权。仅在需要覆盖时才配置 `HUADAI_CLIENT_ID`。\n- **调用前检查配置**：若未配置 `HUADAI_API_KEY` / `HUADAI_USER_UUID`（业务请求）或未配置 `HUADAI_BASE_URL`（走 OAuth 时），必须停止调用并引导用户在本地配置；禁止假装成功\n- **数据真实性**：所有笔记内容、列表、详情都必须来自 API 响应；禁止编造笔记、ID、space_id 等\n- **空结果处理**：API 返回为空/未找到时，必须明确告知“未找到”，并给出下一步（换关键词/缩小范围）\n- **写操作确认**：保存/更新等写操作，必须在 API 明确返回成功后再回复“已保存/已更新”\n- **群聊/多人限制（若配置 `HUADAI_USER_UUID`）**：\n  - `HUADAI_USER_UUID` 与话袋 **`unique_id`** 一致，用于在多人聊天中划定「仅该用户」的笔记边界，保证私密性\n  - 当请求者身份无法与 `HUADAI_USER_UUID` 匹配时，必须拒绝访问任何笔记内容与搜索结果\n  - 拒绝时只说明需要由 owner 发起请求，不泄露任何数据\n\n---\n\n## 文档索引（references）\n\n> 匹配指令或 API 后，用 **read 工具**读取下表对应 `references/*.md` 获取完整字段、示例与边界说明。错误码与统一响应见 [话袋笔记 API 详细参考](references/api-details.md)。\n\n## 指令路由表\n\n| 指令 | 角色 | 说明 | 详细文档 |\n|------|------|------|----------|\n| `/huadai config` 或「配置话袋」 | 配置 | 环境变量、`openclaw.json` 注入、请求头约定 | [配置（必须先完成）](references/config.md) |\n| `/huadai oauth` 或「授权/连接」 | 授权 | OAuth 2.0 Device Flow、换取 API Key | [OAuth 授权配置（话袋笔记）](references/oauth.md) |\n| `/huadai upload` 或「记一下/保存」 | 新建 | 新建 Block 笔记（`upload-block`） | [新建笔记（Upload）](references/upload.md) |\n| `/huadai update` 或「更新笔记」 | 更新 | 更新 Block 内容与属性（`update-block`） | [更新笔记（Update）](references/update.md) |\n| `/huadai search` 或「搜一下」 | 搜索 | 全文检索 `GET /search` | [搜索笔记（Search）](references/search.md) |\n\n## 自然语言路由（触发规则）\n\n| 用户说法（示例） | 路由 | 详细文档 |\n|------------------|------|----------|\n| 「新建/上传/保存到笔记」 | Upload | [新建笔记（Upload）](references/upload.md) |\n| 「更新/修改笔记」 | Update | [更新笔记（Update）](references/update.md) |\n| 「搜/找/检索/有哪些相关笔记」 | Search | [搜索笔记（Search）](references/search.md) |\n| 「配置/连接/怎么填 key/报错未配置」 | Config / OAuth | [配置（必须先完成）](references/config.md)、[OAuth 授权配置](references/oauth.md) |\n\n## API 路由表\n\n> 说明：以下为 MVP 参考路径。Base URL 为 `https://openapi.ihuadai.cn/open/api/v1`（与 [配置](references/config.md) 中 `HUADAI_BASE_URL` 一致）。\n\n| 方法 | 路径 | 说明 | 详细文档 |\n|------|------|------|----------|\n| GET | `/open/api/v1/search` | 全文检索 | [搜索笔记（Search）](references/search.md#全文检索) |\n| POST | `/open/api/v1/block/upload-block` | 新建笔记 Block | [新建笔记（Upload）](references/upload.md#新建笔记block) |\n| POST | `/open/api/v1/block/update-block` | 更新笔记内容/属性 | [更新笔记（Update）](references/update.md#更新笔记block) |\n| （OAuth） | `/open/api/v1/oauth/device/code` 等 | 设备码授权（Device Flow） | [OAuth 授权配置](references/oauth.md) |\n\n统一鉴权、响应包体与错误码分段说明见 [api-details.md](references/api-details.md#统一鉴权与请求头)、[错误码表](references/api-details.md#错误码表code)。\n\n## 通用错误处理（统一策略）\n\n- **未配置/缺失 Key**：停止请求，引导用户配置 `HUADAI_API_KEY`\n- **未登录/未授权**：提示需要重新登录/刷新 token（按后端返回的 `code/message` 给出行动建议）\n- **无权限（403）**：告知无权限访问该笔记，建议更换关键词或确认账号\n- **限流（429）**：提示稍后重试，并进行退避（例如等待数秒后再试）\n- **服务异常（5xx/超时）**：提示服务暂不可用，建议稍后重试；不要输出堆栈或内部信息\n\n## 安全规则\n\n- 不在对话中索取、输出或回显 `HUADAI_API_KEY`\n- 不输出任何可能识别用户身份的敏感信息（除非用户明确提供并要求使用）\n- 禁止在未调用 API 时返回“已保存/已删除/已找到”\n- 禁止猜测或生成不存在的笔记 ID\n\nFile v1.0.0:README.md\n\n# 话袋笔记 Skill\n\n---\n\n## ✨ 核心能力（MVP）\n\n| 能力 | 说明 |\n|------|------|\n| **✏️ 新建笔记** | 用一句话快速记录你的想法、会议内容或灵感 |\n| **🔍 更新笔记** | 对已有笔记进行补充或修改，让内容始终保持最新 |\n| **📄 搜索笔记** | 输入关键词，快速找到你记录过的内容 |\n\n---\n💡 使用场景\n✏️ 随手记录（想到就记）\n不需要整理格式，直接说就可以。\n💬 记录一个想法\n\n👤 记一下：以后可以试试每天早起30分钟看书，提高专注力\n🤖 好的，已经帮你记下来了。\n\n\n💬 会议快速记录\n\n👤 帮我记一下今天的结论：\n1）本周先完成首页改版的基础功能\n2）登录问题优先修复，明天前给出方案\n3）下周一安排联调，涉及前后端一起参与\n🤖 已帮你记录好了，后面可以随时查看或补充。\n\n\n🔍 要用时找（随时召回）\n不用翻记录，直接问。\n💬 查找历史笔记\n\n👤 帮我找一下之前记的“早起看书”的想法\n🤖 找到了几条相关内容，已经按时间帮你整理好了。\n\n\n🚀 快速上手\n你只需要记住两件事：\n\n\n📝 想记录 → 直接说“记一下…”\n\n\n🔎 想查找 → 直接说“帮我找…”\n\n\n剩下的交给我来处理。\n\n✅ 当前支持能力（MVP）\n\n- 新建笔记\n- 更新笔记\n- 关键词搜索笔记\n\n\n🌱 小提示\n\n不需要结构化输入，像聊天一样说就行\n\n内容越具体，后面越容易找回来\n\n可以把它当作你的「第二大脑」\n\n---\n\n## 安装\n\n\n### 方式一：通过 ClawHub/SkillHub（腾讯）/SkillHub（中国）  安装（推荐）\n\n```bash\nclawhub install huadai-notes-skills\nSkillHub install huadai-notes-skills\nSkillHub install huadai-notes-skills\n```\n\n### 方式二：让 AI 助手安装\n\n> 帮我安装话袋笔记 Skill，地址是 https://github.com/HuadaiNotes/hd_notes_skills/blob/main/SKILL.md\n\n### 方式三：手动安装\n\n```bash\nmkdir -p ~/.openclaw/workspace/skills/huadai-notes-skill\ncd ~/.openclaw/workspace/skills/huadai-notes-skill\ncurl -sL https://github.com/HuadaiNotes/hd_notes_skills/blob/main/SKILL.md -o SKILL.md\ncurl -sL https://github.com/HuadaiNotes/hd_notes_skills/blob/main/SKILL.md -o package.json\n```\n\n\n## 配置（重要）\n\n### 自动配置（默认）\n\n安装后首次使用时，若检测到缺少配置，AI 会自动触发 OAuth Device Flow（详见 [OAuth 授权配置（话袋笔记）](references/oauth.md)）：\n\n1. 你发起任意笔记相关操作（保存/搜索/打开）\n2. AI 检测到未配置 `HUADAI_API_KEY` / `HUADAI_USER_UUID`\n3. AI 生成授权链接（verification_uri）并提示你完成授权\n4. 授权成功后自动写入 `HUADAI_API_KEY` 与 `HUADAI_USER_UUID`，继续执行你的请求\n\n### 手动配置（可选）\n\n在 `~/.openclaw/openclaw.json` 中注入（示例见 [配置（必须先完成）](references/config.md)、[OAuth 授权配置](references/oauth.md)）：\n\n- `HUADAI_BASE_URL`: `https://openapi.ihuadai.cn/open/api/v1`\n- `HUADAI_API_KEY`: OAuth 换取的 `api_key`\n- `HUADAI_USER_UUID`: OAuth 返回的用户 `unique_id`（对应请求头 `USER-UUID`）\n- `HUADAI_CLIENT_ID`: 可选覆盖；默认使用服务端预注册 `client_id`\n\n此 Skill 需要在运行环境中提供以下环境变量（不要在聊天中粘贴任何密钥）：\n\n- `HUADAI_BASE_URL`（必填）：话袋 OpenAPI 根地址（例如 `https://openapi.ihuadai.cn/open/api/v1`）\n- `HUADAI_CLIENT_ID`（可选覆盖，仅 OAuth）：OAuth Device Flow 的应用标识（申请设备码/换取 API Key；流程见 [OAuth 授权配置](references/oauth.md)）\n- `HUADAI_API_KEY`（必填）：业务 API 调用鉴权（请求头 `Authorization`）\n- `HUADAI_USER_UUID`（强烈建议，群聊/多人场景必配）：用户唯一标识\n\n## Base URL 与接口路径\n\n- Base URL：`https://openapi.ihuadai.cn/open/api/v1`\n- API 路径：以本仓库 **references** 为准（统一 `/open/api/v1/...`）；接口分册：[新建笔记（Upload）](references/upload.md)、[更新笔记（Update）](references/update.md)、[搜索笔记（Search）](references/search.md)、[API 详细参考](references/api-details.md)\n\n## 安全说明\n\n- 不在对话中索取、输出或回显任何 `HUADAI_API_KEY`\n- 所有读写都必须通过 API 获取结果，禁止编造“已保存/已找到”\n- 开启 `HUADAI_USER_UUID` 时，非 user 的请求必须拒绝并提示原因\n\n---\n\n## 📜 相关链接\n\n- [话袋官网](https://ihuadai.cn/)\n- [ClawHub](https://clawhub.ai/----/ihuadai.cn)\n- [SkillHub腾讯](https://skillhub.tencent.com/-----/ihuadai.cn)\n- [SkillHub中国](https://www.skill-cn.com//-----/ihuadai.cn)\n\n---\n\n## License\n\n见 `LICENSE`。\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7emwh7zk4apdw4p85qfe6xy9859xvm\",\n  \"slug\": \"hd-notes-skills\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776842524831\n}\n\nFile v1.0.0:references/api-details.md\n\n## 话袋笔记 API 详细参考\n\n## 目录\n\n1. [统一鉴权与请求头](#统一鉴权与请求头)\n2. [统一响应结构](#统一响应结构)\n3. [错误码表（code）](#错误码表code)\n4. [新建笔记（Block）](#新建笔记block)\n5. [更新笔记（Block）](#更新笔记block)\n6. [搜索笔记（全文检索）](#搜索笔记全文检索)\n\n---\n\n## 统一鉴权与请求头\n\n- **`USER-UUID`**：与话袋用户 **`unique_id`** 一致，用于对用户做唯一标识与数据归属；在 Skill 等多端场景中可配合配置用于多人聊天下的身份边界与私密性。\n- **`Authorization`（API Key）**：用于调用方**身份校验与鉴权登录**，证明请求来自已授权用户。\n\n- **必填 Headers（所有受保护接口）**\n  - `USER-UUID: <unique_id>`：用户唯一标识\n  - `Authorization: <api_key>`：API Key（鉴权登录）\n  - `X-Request-Id: <uuid>`：请求追踪（建议；写操作强烈建议）\n  - `Content-Type: application/json`：POST/PUT 一般需要\n\n> 对外 OpenAPI 统一使用 `/open/api/v1/...` \n\n---\n\n## 统一响应结构\n\n### 成功\n\n```json\n{\n  \"code\": 200,\n  \"message\": \"请求成功\",\n  \"data\": {}\n}\n```\n\n### 失败\n\n失败一般为 HTTP 400/403/500，Body 仍保持统一结构：\n\n```json\n{\n  \"code\": 400000,\n  \"message\": \"客户端请求错误\",\n  \"data\": {}\n}\n```\n\n其中 `data` 可能不存在或为空对象，视具体接口而定。\n\n---\n\n## 错误码表（code）\n\n话袋错误码采用「分段码」：\n\n- `200`：成功\n- `400000+`：客户端/权限/资源类错误\n- `500000+`：服务端错误\n- `1`：通用失败（少数场景）\n\n下面为 **与笔记/搜索强相关** 的常用错误码（完整列表请以服务端 `package/respond` 为准）：\n\n| code | 含义 | 典型场景 |\n|------|------|----------|\n| 200 | 请求成功 | 成功返回 |\n| 400000 | 客户端请求错误 | 参数校验失败、业务校验失败等 |\n| 400001 | 未授权/未登录 | `token` 缺失或无效（常见 message：“请先登录/用户未登录”） |\n| 400003 | 无权限 | 无访问权限、禁止访问等（通常会返回 HTTP 403） |\n| 400018 | 笔记未找到 | 资源不存在（如 block 不存在） |\n| 500000 | 系统错误 | 依赖异常、内部错误 |\n\n> 说明：HTTP 状态码与 `code` 并非一一对应（例如未登录在部分逻辑里会走 HTTP 400 + `400001` 类 code）。\n\n---\n\n## 新建笔记（Block）\n\n### 接口\n\n- **方法/路径**：`POST /open/api/v1/block/upload-block`\n\n### 请求体（核心字段）\n\n请求体为 `Blocks`（字段较多，以下为与“新建笔记”强相关的最小子集；\n\n| 字段 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `unique_id` | string | 是 | 笔记唯一ID（客户端生成或由上游分配） |\n| `content` | array | 否 |  Markdown 格式正文|\n| `attr` | object | 否 | 扩展属性 |\n| `create_time` | uint64 | 是 | 创建时间（秒级时间戳） |\n| `parent_id` | string | 否 | 父笔记 unique_id（子笔记/追记） |\n| `folder_id` | uint32 | 否 | 文件夹ID |\n| `is_collect` | int | 否 | 是否收藏（0/1） |\n| `is_todo` | int | 否 | 是否待办（0/1） |\n| `status` | int | 否 | 状态（正常/回收站等） |\n| `attachment` | array | 否 | 附件列表（上传后的 file_id/path 等） |\n| `block_tags` | array | 否 | 标签变更列表（含 action） |\n| `quotes` | array | 否 | 引用列表 |\n\n### 响应\n\n成功返回 `code=200`，`data` 通常为一个轻量对象（用于首条创建时的画像提示等，具体以服务端返回为准）。\n\n---\n\n## 更新笔记（Block）\n\n> 第一版仅保留一个“更新”入口,用 `update-block`。\n\n### 接口（推荐：更新内容/属性）\n\n- **方法/路径**：`POST /open/api/v1/block/update-block`\n\n### 请求体（核心字段）\n\n| 字段 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `unique_id` | string | 是 | 笔记唯一ID |\n| `type` | int | 是 | 笔记类型（枚举） |\n| `content` | array | 否 | 传 **JSON 字符串** 表示正文 **Markdown** |\n| `attr` | object | 否 | 属性（不传则不改） |\n| `block_tags` | array | 否 | 标签变更列表（含 action） |\n| `quotes` | array | 否 | 引用列表 |\n| `skin` | object | 否 | 皮肤 |\n\n## 搜索笔记（全文检索）\n\n### 接口\n\n- **方法/路径**：`GET /open/api/v1/search`\n\n### Query 参数（常用）\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `query` | string | 否 | 搜索关键词（可为空） |\n| `page` | int | 否 | 页码，默认 1 |\n| `size` | int | 否 | 每页数量，默认 10，最大 100 |\n| `search_type` | string | 否 | `keyword` / `script` / `custom`（默认 `custom`） |\n| `sort_by` | string | 否 | `_score` / `create_time` / `update_time` |\n| `sort_order` | string | 否 | `asc` / `desc` |\n| `enable_highlight` | bool | 否 | 是否高亮 |\n\n### 响应（概览）\n\n`data` 为分页对象，包含 `total/page/size/total_pages` 以及 `data[]` 列表；列表项通常包含 `unique_id` 。\n\n\n\n## 使用示例（curl）\n\n```bash\n# 1. 新建笔记\ncurl -sS -X POST 'https://openapi.ihuadai.cn/open/api/v1/block/upload-block' \\\n  -H 'USER-UUID: {user_uuid}' \\    \n  -H 'Authorization: {api_key}' \\\n  -H 'X-Request-Id: {uuid}' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"unique_id\": \"unique_id\", #笔记的unique_id，标识笔记\n    \"content\": [\n      { \"insert\": \"传 **JSON 字符串** 表示正文 **Markdown**\" } \n    ],\n    \"is_collect\": 0,\n    \"is_todo\": 0,\n    \"status\": 1,\n    \"create_time\": 1713148800\n  }'\n\n# 2. 更新笔记（内容/属性）\ncurl -sS -X POST 'https://openapi.ihuadai.cn/open/api/v1/block/update-block' \\\n  -H 'USER-UUID: {user_uuid}' \\  \n  -H 'Authorization: {api_key}' \\\n  -H 'X-Request-Id: {uuid}' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"unique_id\": \"\",\n    \"content\": [\n      { \"insert\": \"传 **JSON 字符串** 表示正文 **Markdown**\" }\n    ],\n    \"number_of_words\": 0\n  }'\n\n# 3. 搜索笔记 \ncurl -sS -X GET 'https://openapi.ihuadai.cn/open/api/v1/search?query=hello&page=1&size=10' \\\n  -H 'USER-UUID: {user_uuid}' \\\n  -H 'Authorization: {api_key}'\n```\n\nFile v1.0.0:references/config.md\n\n# 配置（必须先完成）\n\n本文档以 [话袋笔记 API 详细参考](api-details.md) 为准：话袋对外 OpenAPI 统一使用 **`/open/api/v1/...`** 前缀，并通过 **`USER-UUID + API Key`** 做调用方鉴权。\n\n## 你需要准备什么\n\n### 1) 必需请求头（所有 OpenAPI 接口）\n\n- `USER-UUID: <user_uuid>`：用户唯一标识（与话袋用户 **`unique_id`** 一致；必填，用于归属与多人场景下的身份边界）\n- `Authorization: <api_key>`：API Key（必填，用于身份校验与对外接口鉴权登录）\n\n建议同时携带：\n\n- `X-Request-Id: <uuid>`：请求追踪/审计（强烈建议；写操作建议每次唯一）\n- `Content-Type: application/json`：仅在 POST 且有 JSON body 时需要\n\n> 说明：当前 Skill 采用对外 `Authorization: <api_key>` 形式.\n\n### 2) 建议通过环境变量注入（推荐）\n\n- `HUADAI_USER_UUID`（必填）：对应请求头 `USER-UUID`，取值与话袋用户 **`unique_id`** 一致\n- `HUADAI_API_KEY`（必填）：对应请求头 `Authorization`，用于鉴权登录\n- `HUADAI_BASE_URL`（必填）：话袋 OpenAPI 根地址（例如 `https://openapi.ihuadai.cn/open/api/v1`\n- `HUADAI_CLIENT_ID`（可选覆盖，仅 OAuth）：OAuth Device Flow 的应用标识（用于申请设备码与轮询换取 `HUADAI_API_KEY`；详见 [OAuth 授权配置（话袋笔记）](oauth.md)）\n\n## 配置原则（必须遵守）\n\n- 不要在聊天里回显 `USER-UUID`\n- 不要在聊天里回显 `Authorization` / `api_key`\n- 缺少 `USER-UUID` 或 `HUADAI_API_KEY` 时，Skill 必须拒绝执行任何读写请求，并引导用户完成配置\n- 一切“已保存/已删除/已找到”的结论必须来自 API 响应（以 `code=200` 为准）\n\n```json\n{\n  \"skills\": {\n    \"entries\": {\n      \"huadai-notes-skill\": {\n        \"env\": {\n          \"HUADAI_USER_UUID\": \"uu_****\",\n          \"HUADAI_API_KEY\": \"hk_live_****\",\n          \"HUADAI_BASE_URL\": \"https://openapi.ihuadai.cn/open/api/v1\"\n        }\n      }\n    }\n  }\n}\n```\n\nFile v1.0.0:references/oauth.md\n\n# OAuth 授权配置（话袋笔记）\n\n## 概述\n\n使用 **OAuth 2.0 Device Authorization Grant** 让用户在浏览器中完成授权，换取 **API Key**，再写入本地/运行环境配置。适用于「配置话袋笔记」「连接话袋」等场景；首次调用开放接口前若缺少凭证，也应引导用户走本流程。\n\n话袋开放接口的调用侧模型（详见 [配置（必须先完成）](config.md)、[话袋笔记 API 详细参考](api-details.md)）为：\n\n- **`USER-UUID` 请求头**：与话袋用户 **`unique_id`** 一致，用于**唯一标识用户**与数据归属；配置为环境变量 **`HUADAI_USER_UUID`**。在多人聊天场景中，用于划定「仅该用户」可访问的笔记边界，保证**私密性**。\n- **`Authorization` 请求头**：值为 **API Key**，用于**身份校验与鉴权登录**（证明调用方为已授权用户），配置为 **`HUADAI_API_KEY`**。\n\n> 说明：OAuth 步骤里的「授权轮询码」仅用于向 `/oauth/token` **兑换**上述凭证；它不是“设备号/设备绑定标识”。话袋笔记 Skill **不做设备绑定**、也不使用 `Device-Id` 之类的请求头。\n\n---\n\n## 自动触发条件\n\n每次调用 API 前，先检查是否已具备调用所需配置（至少 **`HUADAI_API_KEY`**，以及受保护接口要求的 **`HUADAI_USER_UUID`**，见 [配置（必须先完成）](config.md)）。\n\n若缺失，**应发起 OAuth 授权流程**（无需用户先说「配置」），说明需要先完成授权再使用；授权完成并写入配置后，再继续执行用户原本请求。\n\n---\n\n## 手动配置（可选）\n\n1. 前往 [话袋开放平台](https://ihuadai.cn/openapi) 创建应用\n2. 获取 **`api_key`** 与 **`unique_id`**（用户唯一标识）。\n3. 在 `~/.openclaw/openclaw.json`（或当前环境的 Skill 配置）中注入环境变量，**不要在聊天中回显密钥**：\n\n```json\n{\n  \"skills\": {\n    \"entries\": {\n      \"huadai-notes-skill\": {\n        \"env\": {\n          \"HUADAI_BASE_URL\": \"https://openapi.ihuadai.cn/open/api/v1\",\n          \"HUADAI_API_KEY\": \"hk_live_你的key\",\n          \"HUADAI_USER_UUID\": \"用户标识\"\n        }\n      }\n    }\n  }\n}\n```\n\n---\n\n## Device Flow 完整流程\n\n以下路径均相对于 **`HUADAI_BASE_URL`**（已包含 `/open/api/v1` 前缀），与 [话袋笔记 API 详细参考](api-details.md) 一致。\n\n### 步骤 1：申请授权码\n\n```\nPOST https://openapi.ihuadai.cn/open/api/v1/oauth/device/code\nContent-Type: application/json\n```\n\n请求体（与 `scripts/oauth_poll.py` 一致）：\n\n- **默认（推荐）**：使用预注册应用，请求体为 **空 JSON 对象**：\n\n```json\n{}\n```\n\n- **覆盖 `client_id`（企业自建等）**：在环境变量中设置 `HUADAI_CLIENT_ID` 后，请求体为：\n\n```json\n{\n  \"client_id\": \"<你的 HUADAI_CLIENT_ID>\"\n}\n```\n\n> 说明：默认情况下话袋服务端为 OpenClaw 预注册固定 `client_id`，**无需**在请求里传 `client_id`，也**无需**配置 `HUADAI_CLIENT_ID`。仅在需要覆盖时配置环境变量并随请求发送。\n\n\n**统一结构示例**：\n\n```json\n{\n  \"code\": 200,\n  \"message\": \"请求成功\",\n  \"data\": {\n    \"code\": \"abc123...\",\n    \"verification_uri\": \"https://openapi.ihuadai.cn/api/v1/oauth/authorize?code=abc123...\",\n    \"user_code\": \"ABCD-1234\",\n    \"expires_in\": 600,\n    \"interval\": 5\n  }\n}\n```\n\n| 字段 | 说明 |\n|------|------|\n| `code`（在 `data` 内） | 授权轮询码，步骤 3 轮询 `/oauth/token` 时使用 |\n| `verification_uri` | 授权链接，**发给用户点击** |\n| `user_code` | 确认码，**必须展示给用户核对** |\n| `expires_in` | 授权码有效期（秒），常见 600 |\n| `interval` | 建议轮询间隔（秒），常见 5 |\n\n### 步骤 2：展示授权链接\n\n将 `verification_uri` 与 `user_code` 发给用户，例如：\n\n> 请点击链接完成授权：{verification_uri}  \n> **请核对确认码**：`{user_code}`（须与授权页一致后再授权）\n\n**安全**：`user_code` 用于降低钓鱼风险；若页面所示与 Agent 提供的不一致，应拒绝授权。\n\n**发送后立即启动后台轮询**（步骤 3）。\n\n### 步骤 3：轮询等待授权\n\n在用户打开链接操作的同时，**后台轮询** token 端点（不必等用户回复）。\n\n```\nPOST {HUADAI_BASE_URL}/oauth/token\nContent-Type: application/json\n```\n\n其中 `{HUADAI_BASE_URL}` 须与步骤 1 一致（例如 `https://openapi.ihuadai.cn/open/api/v1`），完整示例：\n\n```\nPOST https://openapi.ihuadai.cn/open/api/v1/oauth/token\nContent-Type: application/json\n```\n\n请求体（`grant_type` 与 `code` 必填；`client_id` 仅在与步骤 1 一致地使用了 `HUADAI_CLIENT_ID` 时需要带上）：\n\n```json\n{\n  \"grant_type\": \"device_code\",\n  \"code\": \"{data.code}\"\n}\n```\n\n若已设置 `HUADAI_CLIENT_ID`，则请求体需额外包含 `\"client_id\": \"<与步骤 1 相同的值>\"`。\n\n**轮询策略**：\n\n- **间隔**：每 5 秒一次（或与步骤 1 返回的 `interval` 一致）\n- **超时**：最多约 10 分钟（与授权码有效期对齐）\n- **并行**：轮询在后台执行，不阻塞其他交互\n\n**推荐使用本 Skill 自带脚本**（仓库内路径：`scripts/oauth_poll.py`）：\n\n```bash\nexport HUADAI_BASE_URL=\"https://openapi.ihuadai.cn/open/api/v1\"\n# 可选：export HUADAI_CLIENT_ID=\"你的 client_id\"\nresult=$(python scripts/oauth_poll.py \"{data.code}\")\napi_key=$(echo \"$result\" | jq -r '.api_key')\nuser_uuid=$(echo \"$result\" | jq -r '.unique_id // .user_uuid // empty')\n```\n\n脚本成功时在 **stdout** 打印 `data` 的 JSON；错误信息在 **stderr**，退出码见脚本头部注释（如用户拒绝、过期、超时等）。\n\n**OpenClaw 场景示例**（按需调整路径与 session）：\n\n```yaml\n# 后台执行轮询\nexec: python scripts/oauth_poll.py \"{code}\"\n  background: true\n  env:\n    HUADAI_BASE_URL: \"https://openapi.ihuadai.cn/open/api/v1\"\n    # 可选：HUADAI_CLIENT_ID: \"你的 client_id\"\n\nprocess: poll\n  sessionId: {sessionId}\n  timeout: 600000\n```\n\n**轮询过程状态**（`data.msg` 或等价字段，以服务端为准）：\n\n| 情形 | 说明 | 处理 |\n|------|------|------|\n| `authorization_pending` | 用户尚未完成操作 | 继续轮询 |\n| `rejected` | 用户拒绝授权 | 停止轮询并提示 |\n| `expired_token` | 授权码过期 | 停止轮询，从步骤 1 重试 |\n| `already_consumed` | 授权码已使用 | 停止轮询；可能已在其他终端完成 |\n| `data` 中含 `api_key` | 授权成功 | 进入步骤 4 |\n\n**授权成功**时，`data` 中至少包含 **`api_key`**；若返回 **`unique_id`** 或 **`user_uuid`**，应与请求头 **`USER-UUID`** 一致，并写入 **`HUADAI_USER_UUID`**。\n\n成功响应示例（统一结构）：\n\n```json\n{\n  \"code\": 200,\n  \"message\": \"请求成功\",\n  \"data\": {\n    \"client_id\": \"cli_xxx\",\n    \"api_key\": \"hk_live_xxx\",\n    \"unique_id\": \"uu_xxx\",\n    \"key_id\": \"可选\",\n    \"expires_at\": 1742000000\n  }\n}\n```\n\n| 字段 | 说明 |\n|------|------|\n| `api_key` | 写入 **`HUADAI_API_KEY`**，用于 **`Authorization`** 鉴权登录 |\n| `unique_id` / `user_uuid`（若返回） | 写入 **`HUADAI_USER_UUID`**，对应 **`USER-UUID`**，与话袋用户唯一标识一致 |\n| `client_id`（若返回） | 可选写入 **`HUADAI_CLIENT_ID`**，便于下次自建应用覆盖时与本次授权一致；使用预注册应用时通常不必保存 |\n| `expires_at` | 若存在，为 API Key 等相关过期时间（Unix 秒），可在提示文案中使用 |\n\n### 步骤 4：写入配置并校验\n\n将 **`HUADAI_API_KEY`**、**`HUADAI_USER_UUID`**（与 **`unique_id`** 一致）、**`HUADAI_BASE_URL`** 写入运行环境或 `openclaw.json`（示例见上文）。**`HUADAI_CLIENT_ID`** 仅在需要固定为某自建应用、或希望与响应中的 `client_id` 对齐时再写入。\n\n告知用户时可说明：\n\n- 已可使用话袋笔记 Skill 的保存、搜索等能力；\n- **不要在对话中粘贴或展示完整 Key 与 USER-UUID**；\n- 多人场景下仅绑定配置中的 **`HUADAI_USER_UUID`** 对应用户，避免他人访问同一笔记数据。\n\n---\n\n## 相关文档\n\n- [配置（必须先完成）](config.md)（请求头与环境变量）\n- [话袋笔记 API 详细参考](api-details.md)（HTTP 路径与统一响应）\n- 轮询脚本：仓库内 [`scripts/oauth_poll.py`](../scripts/oauth_poll.py)\n\nFile v1.0.0:references/search.md\n\n# 搜索笔记（Search）\n\n## 何时使用\n\n- 用户要“搜一下/找一下/有哪些相关笔记”\n- 用户记不清笔记标题或 ID，希望按语义描述找相关内容\n\n## 接口（本页覆盖）\n\n- `GET /open/api/v1/search`\n\n## 通用请求头（必须）\n\n见 [配置（必须先完成）](config.md#你需要准备什么)：\n\n- `USER-UUID: <user_unique_id>`\n- `Authorization: <api_key>`\n\n---\n\n## 全文检索\n\n```\nGET {BASE_URL}/search?query=...&page=1&size=10\n```\n\nQuery 参数（常用）：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| `query` | string | 搜索关键词（可为空） |\n| `page` | int | 页码，默认 1 |\n| `size` | int | 每页数量，默认 10，最大 100 |\n| `search_type` | string | `keyword` / `script` / `custom`（默认 `custom`） |\n| `sort_by` | string | `_score` / `create_time` / `update_time` |\n| `sort_order` | string | `asc` / `desc` |\n| `enable_highlight` | bool | 是否高亮 |\n\n返回结构（概览）：\n\n```json\n{\n  \"code\": 200,\n  \"message\": \"请求成功\",\n  \"data\": {\n    \"total\": 0,\n    \"page\": 1,\n    \"size\": 10,\n    \"total_pages\": 0,\n    \"data\": []\n  }\n}\n```\n\n---\n\n## 结果呈现建议（对用户）\n\n- 默认展示前 5 条\n- 每条至少包含：\n  - `title`\n  - `created_at`\n  - `content` 片段\n  - `note_id`（当 `note_type=NOTE` 时才可用于后续调详情）\n\n## 空结果\n\n- 必须明确告知“未找到”\n- 给出下一步：换关键词、缩短 query、或增加限定词\n\n## 常见错误\n\n见 [话袋笔记 API 详细参考 · 错误码表](api-details.md#错误码表code)：\n\n- `400000`：参数/业务校验失败\n- `400003`：无权限\n- `500000`：系统错误\n\nFile v1.0.0:references/update.md\n\n# 更新笔记（Update）\n\n## 何时使用\n\n- 用户需要对已有笔记进行更新（正文/属性等）\n\n## 接口（本页覆盖）\n\n本页以话袋后端原生接口为准：统一使用 `/v1` 前缀。\n\n- `POST /open/api/v1/block/update-block`：更新 Block 笔记（内容/属性）\n\n## 通用请求头（必须）\n\n见 [配置（必须先完成）](config.md#你需要准备什么)：\n\n- `USER-UUID: <user_unique_id>`\n- `Authorization: <api_key>`\n- `Content-Type: application/json`（仅 POST 且 body 为 JSON 时需要）\n\n---\n\n## 更新笔记（Block）\n\n```\nPOST {BASE_URL}/block/update-block\nContent-Type: application/json\n```\n\n请求体（字段详解见 [话袋笔记 API 详细参考 · 更新笔记（Block）](api-details.md#更新笔记block)）：\n\n```json\n{\n  \"unique_id\": \"b_xxx\",\n  \"type\": 1,\n  \"content\": [],\n  \"attr\": {}\n}\n```\n\n返回说明：\n- 同步完成：返回 `code=200`\n\n---\n\n## 成功判定（必须）\n\n- 必须以 API 返回 `code=200` 为准；未拿到明确成功响应前，禁止回复“已更新”\n\n## 常见错误\n\n见 [话袋笔记 API 详细参考 · 错误码表](api-details.md#错误码表code)：\n\n- `400000`：参数/业务校验失败\n- `400003`：无权限\n- `400018`：笔记不存在（部分场景会返回业务 message）\n- `500000`：系统错误\n\nFile v1.0.0:references/upload.md\n\n# 新建笔记（Upload）\n\n## 何时使用\n\n- 用户想要新建一条笔记\n- 用户发来一段内容/链接/图片，希望“记下来/存到笔记”\n\n## 接口（本页覆盖）\n\n本页以话袋后端原生接口为准：统一使用 `/v1` 前缀。\n\n- `POST /open/api/v1/block/upload-block`：新建 Block 笔记\n\n## 通用请求头（必须）\n\n见 [配置（必须先完成）](config.md#你需要准备什么)：\n\n- `USER-UUID: <user_unique_id>`\n- `Authorization: <api_key>`\n- `Content-Type: application/json`（仅 POST 且 body 为 JSON 时需要）\n\n---\n\n## 新建笔记（Block）\n\n```\nPOST {BASE_URL}/block/upload-block\nContent-Type: application/json\n```\n\n请求体（字段详解见 [话袋笔记 API 详细参考 · 新建笔记（Block）](api-details.md#新建笔记block)）：\n\n```json\n{\n  \"unique_id\": \"b_xxx\",\n  \"type\": 1,\n  \"content\": [],\n  \"attr\": {},\n  \"create_time\": 1741190400\n}\n```\n\n返回说明：\n- 同步完成：返回 `code=200`\n\n---\n\n## 成功判定（必须）\n\n- 必须以 API 返回 `code=200` 为准；未拿到明确成功响应前，禁止回复“已保存”\n\n## 常见错误\n\n见 [话袋笔记 API 详细参考 · 错误码表](api-details.md#错误码表code)：\n\n- `400000`：参数/业务校验失败\n- `400003`：无权限\n- `400018`：笔记不存在（部分场景会返回业务 message）\n- `500000`：系统错误\n\nFile v1.0.0:skill-card.md\n\n## Description: <br>\n话袋笔记 helps an agent create, update, and search a user's personal notes through the Huadai notes API. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[monkeydb](https://clawhub.ai/user/monkeydb) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and their agents use this skill to save new personal notes, update existing notes, and search prior notes by natural-language requests. It also guides OAuth and local configuration needed before note operations are performed. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill handles OAuth-derived API credentials and a user UUID for private notes. <br>\nMitigation: Keep HUADAI_API_KEY, HUADAI_USER_UUID, OpenClaw configuration, and session logs private; never paste or echo credentials in chat. <br>\nRisk: The skill can read and write personal notes through openapi.ihuadai.cn. <br>\nMitigation: Install only if you trust Huadai with notes saved or searched through this integration, and use explicit save, update, or search commands when tighter control is needed. <br>\nRisk: In shared or group contexts, a mismatched requester could attempt to access another user's notes. <br>\nMitigation: Use HUADAI_USER_UUID as the access boundary and refuse note access when the requester cannot be matched to the configured owner. <br>\n\n\n## Reference(s): <br>\n- [话袋笔记 API 详细参考](references/api-details.md) <br>\n- [配置（必须先完成）](references/config.md) <br>\n- [OAuth 授权配置（话袋笔记）](references/oauth.md) <br>\n- [新建笔记（Upload）](references/upload.md) <br>\n- [更新笔记（Update）](references/update.md) <br>\n- [搜索笔记（Search）](references/search.md) <br>\n- [话袋官网](https://ihuadai.cn) <br>\n- [话袋 OpenAPI Base URL](https://openapi.ihuadai.cn/open/api/v1) <br>\n- [ClawHub skill page](https://clawhub.ai/monkeydb/hd-notes-skills) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, API Calls, Shell commands, Configuration guidance] <br>\n**Output Format:** [Markdown text with JSON examples, shell commands, and API request guidance] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses OAuth-derived credentials and Huadai API responses to report note save, update, and search results.] <br>\n\n## Skill Version(s): <br>\n1.0.0 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nFile v1.0.0:package.json\n\n{\n  \"name\": \"huadai-notes\",\n  \"version\": \"0.1.0\",\n  \"description\": \"话袋笔记 Skill — 通过 AI 新建、更新和搜索个人笔记。\",\n  \"license\": \"MIT-0\",\n  \"author\": \"话袋 (Huadai)\",\n  \"homepage\": \"https://ihuadai.cn\",\n  \"keywords\": [\"话袋\", \"笔记\", \"huadai\", \"notes\", \"openclaw\", \"skill\"],\n  \"clawhub\": {\n    \"acceptLicenseTerms\": true\n  },\n  \"openclaw\": {\n    \"minVersion\": \"0.1.0\",\n    \"baseUrl\": \"https://openapi.ihuadai.cn/open/api/v1\",\n    \"requires\": {},\n    \"optionalEnv\": [\n      \"HUADAI_BASE_URL\",\n      \"HUADAI_CLIENT_ID\",\n      \"HUADAI_API_KEY\",\n      \"HUADAI_USER_UUID\"\n    ]\n  }\n}","readmeExcerpt":"Skill: 话袋笔记 Skill Owner: monkeydb Summary: 话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。 当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-07-13T04:23:22.704Z | user **v1.1.0 update summary:** Skill name, documentation, and structure h","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# 搜索笔记\n./scripts/search.sh \"关键词\"\n\n# 新建笔记\n./scripts/upload.sh \"笔记内容（Markdown）\"\n\n# 更新笔记\n./scripts/update.sh <unique_id> \"新内容\""},{"language":"text","snippet":"请安装话袋笔记 Skill，地址：https://clawhub.ai/monkeydb/hd-notes-skills"},{"language":"text","snippet":"请安装话袋笔记 Skill，地址：https://github.com/monkeyDB/hd-notes-skills"},{"language":"text","snippet":"请安装话袋笔记 Skill，地址：https://raw.githubusercontent.com/monkeyDB/hd-notes-skills/main/SKILL.md"},{"language":"bash","snippet":"git clone https://github.com/monkeyDB/hd-notes-skills.git"},{"language":"bash","snippet":"export HUADAI_API_KEY=<你的API Key>"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: hd-notes-skills\ndescription: |\n  话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。\n\n  当以下情况时使用此 Skill：\n  (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」\n  (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」\n  (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」\n  (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」\n  (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」\nversion: 1.1.0\nhomepage: https://clawhub.ai/monkeydb/hd-notes-skills\nuser-invocable: true\nmetadata:\n  openclaw:\n    emoji: \"📝\"\n    primaryEnv: HUADAI_API_KEY\n    requires:\n      env:\n        - HUADAI_API_KEY\n    envVars:\n      - name: HUADAI_API_KEY\n        required: true\n        description: 话袋开放平台 API Key（请求头 Authorization）\n    baseUrl: \"https://openapi.ihuadai.cn/open/api/v1\"\n    homepage: \"https://clawhub.ai/monkeydb/hd-notes-skills\"\n    repository: \"https://github.com/monkeyDB/hd-notes-skills\"\n---\n\n# 话袋笔记 Skill\n\n## Agent 必读约束\n\n- **唯一 Base URL**：`https://openapi.ihuadai.cn/open/api/v1`。禁止使用其他域名，禁止重复拼接 `/open/api/v1`。\n- **鉴权方式**：业务 API 仅使用请求头 `Authorization: <HUADAI_API_KEY>`。\n- **API Key 来源**：用户需先在 [话袋开放平台](https://ihuadai.cn/desktop/openai) 创建 API Key。如果用户未配置，引导用户创建并配置 `HUADAI_API_KEY`。\n- **数据真实性**：所有笔记内容、搜索结果、笔记 ID 都必须来自 API 响应。禁止编造「已保存」「已找到」「已更新」。\n- **写操作确认**：只有 API 返回 `code=200` 后，才能回复用户已保存或已更新。\n- **更新笔记约束**：`unique_id` 必须来自搜索结果或用户明确提供，禁止猜测或生成已有笔记 ID。\n- **密钥安全**：不要在对话中要求用户粘贴 API Key，不要回显、记录、总结或展示 `HUADAI_API_KEY`。\n\n## 快速开始：配置 API Key\n\n如果还没有配置 `HUADAI_API_KEY`，引导用户：\n\n- 打开 https://ihuadai.cn/desktop/openai 创建 API Key\n- 设置环境变量：`export HUADAI_API_KEY=<你的Key>`\n\n## 文档索引\n\n| 文档 | 内容 | 何时读取 |\n|------|------|----------|\n| [API 参考](references/api.md) | 完整请求体、curl 示例、响应判断、错误码 | 需要构造 API 调用或处理错误时 |\n\n## 指令路由表\n\n| 指令 | 角色 | 说明 | 详细文档 |\n|------|------|------|----------|\n| `/huadai config` 或「配置话袋」 | 配置 | 引导用户到开放平台创建并配置 API Key | [API 参考](references/api.md) |\n| `/huadai upload` 或「记一下/保存」 | 新建 | 新建 Block 笔记 | [API 参考](references/api.md#新建笔记) |\n| `/huadai update` 或「更新笔记」 | 更新 | 搜索确认目标后更新 Block 内容 | [API 参考](references/api.md#更新笔记) |\n| `/huadai search` 或「搜一下」 | 搜索 | 关键词检索笔记 | [API 参考](references/api.md#搜索笔记) |\n\n## 自然语言路由\n\n| 用户说法（示例） | 路由 | 执行方式 |\n|------------------|------|----------|\n| 「授权话袋」「连接话袋笔记」「配置话袋」「怎么填 Key」 | Config | 不调用业务 API，引导配置 `HUADAI_API_KEY` |\n| 「新建/上传/保存/写入到笔记」「记一下」 | Upload | `POST /block/upload-block` |\n| 「更新/修改笔记」「补充到这条」 | Update | 先确认 `unique_id`，再 `POST /block/update-block` |\n| 「搜/找/检索/有哪些相关笔记」 | Search | `GET /search` |\n\n## API 路由表\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/search` | 关键词搜索笔记 |\n| GET | `/block/:unique_id` | 获取单条笔记详情 |\n| POST | `/block/upload-block` | 新建笔记 |\n| POST | `/block/update-block` | 更新笔记 |\n\n完整 URL 等于 Base URL + 路径。例如：`https://openapi.ihuadai.cn/open/api/v1/search`。\n\n## 执行规则\n\n### 搜索笔记\n\n- 调用 `GET /search?query=<关键词>&page=1&size=10`。\n- 无结果时明确回复「未找到」，不要编造类似笔记。\n- 从响应中提取关键信息展示给用户：\n  - `unique_id` — 笔记唯一标识（更新/查详情时需要）\n  - `content` — Quill Delta 数组，提取 `insert` 字段拼接为纯文本摘要\n  - `create_time` / `update_time` — Unix 时间戳，可转为可读时间\n  - `type` — 笔记类型\n- 展示结果时优先给标题/摘要/`unique_id`，方便用户选择要更新哪条。\n- 如果结果超过一页（`total > size`），提示用户缩小搜索范围或翻页。\n\n### 获取笔记"},{"path":"README.md","content":"# 话袋笔记 Skill\n\n话袋笔记 Skill 是话袋面向通用 Agent 的笔记能力扩展，支持通过自然语言新建、更新和搜索个人笔记。它采用 `SKILL.md` + `references/` + `scripts/` 的标准 Skill 结构，可发布到 ClawHub、SkillHub 等 Skill 市场，也可被支持 Skill 目录的 Agent 环境安装使用。\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| 新建笔记 | 用一句话快速记录想法、会议结论、灵感和待整理内容 |\n| 搜索笔记 | 用关键词找回之前记录的内容 |\n| 更新笔记 | 基于搜索结果确认 `unique_id` 后，补充或修改已有笔记 |\n\n## 安装\n\n### 让 AI 助手安装（推荐）\n\n在 AI 助手中输入以下指令即可安装：\n\n**直接安装ClawHub地址：**\n```text\n请安装话袋笔记 Skill，地址：https://clawhub.ai/monkeydb/hd-notes-skills\n```\n\n**Claude Code / Cursor / Codex / OpenClaw / 其他通用 Agent：**\n```text\n请安装话袋笔记 Skill，地址：https://github.com/monkeyDB/hd-notes-skills\n```\n\n如果 ClawHub 不可用，也可以直接从 GitHub 安装：\n```text\n请安装话袋笔记 Skill，地址：https://raw.githubusercontent.com/monkeyDB/hd-notes-skills/main/SKILL.md\n```\n\n### 手动安装\n\n将本仓库作为一个 Skill 目录放到你的 Agent 支持的 Skill 目录中。常见形式如下，实际路径以对应 Agent 文档为准：\n\n```bash\ngit clone https://github.com/monkeyDB/hd-notes-skills.git\n```\n\n安装后，确保 Agent 能读取仓库根目录的 `SKILL.md`、`references/api.md` 和 `scripts/` 目录。\n\n## 配置\n\n1. 打开 [话袋开放平台](https://ihuadai.cn/desktop/openai)\n2. 创建 API Key\n3. 在 Agent 运行环境中配置环境变量：\n\n```bash\nexport HUADAI_API_KEY=<你的API Key>\n```\n\n**Claude Code 用户** 也可以在 `~/.bashrc` 或 `~/.zshrc` 中设置：\n\n```bash\necho 'export HUADAI_API_KEY=<你的API Key>' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n调用 OpenAPI 时，Skill 会通过请求头传递：\n\n```http\nAuthorization: <HUADAI_API_KEY>\n```\n\n> ⚠️ 不要在聊天中粘贴、展示或保存 API Key。\n\n## 使用示例\n\n### 记录想法\n\n```text\n记一下：以后可以试试每天早起 30 分钟看书，提高专注力。\n```\n\n### 记录会议结论\n\n```text\n帮我记一下今天的结论：\n1. 本周先完成首页改版的基础功能\n2. 登录问题优先修复，明天前给出方案\n3. 下周一安排前后端联调\n```\n\n### 查找历史笔记\n\n```text\n帮我找一下之前记的「早起看书」相关内容。\n```\n\n### 更新笔记\n\n```text\n把刚才找到的早起看书那条补充一句：先从每周三天开始，不追求每天都做。\n```\n\n## API\n\nBase URL：\n\n```text\nhttps://openapi.ihuadai.cn/open/api/v1\n```\n\n| 方法 | 路径 | 说明 |\n|------|------|------|\n| GET | `/search` | 搜索笔记 |\n| GET | `/block/:unique_id` | 获取笔记详情 |\n| POST | `/block/upload-block` | 新建笔记 |\n| POST | `/block/update-block` | 更新笔记 |\n\n请求体、curl 示例和错误码见 [references/api.md](references/api.md)。\n\n## 兼容平台\n\n| 平台 | 状态 | 说明 |\n|------|------|------|\n| Claude Code | ✅ | 支持 SKILL.md 目录格式 |\n| Cursor | ✅ | 支持 Skill 安装 |\n| Codex (OpenAI) | ✅ | 通过 OpenClaw 兼容 |\n| OpenClaw | ✅ | 原生支持，含 metadata.openclaw 配置 |\n| 任意 Skill 目录 Agent | ✅ | 标准 SKILL.md + references/ + scripts/ 格式 |\n\n## 安全边界\n\n- API Key 只用于请求头 `Authorization`。\n- 未配置 API Key 时，Skill 只引导用户到话袋开放平台创建并配置 API Key。\n- 写操作必须以 API 返回 `code=200` 为准。\n- 搜索为空时必须明确说明未找到，禁止编造结果。\n- 更新笔记时，`unique_id` 必须来自搜索结果或用户明确提供。\n\n## 相关链接\n\n- [GitHub地址](https://github.com/monkeyDB/hd-notes-skills)\n- [ClawHub商店地址](https://clawhub.ai/monkeydb/hd-notes-skills)\n- [话袋开放平台](https://ihuadai.cn/desktop/openai)\n- [话袋官网](https://ihuadai.cn)\n\n## License\n\nMIT-0"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7emwh7zk4apdw4p85qfe6xy9859xvm\",\n  \"slug\": \"hd-notes-skills\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783916602704\n}"},{"path":"references/api.md","content":"# API 参考\n\n**Base URL**：`https://openapi.ihuadai.cn/open/api/v1`\n**鉴权**：请求头 `Authorization: <HUADAI_API_KEY>`\n\n所有业务 API 都返回统一 JSON。成功以 `code=200` 为准。\n\n## 搜索笔记\n\n```http\nGET https://openapi.ihuadai.cn/open/api/v1/search?query={关键词}&page=1&size=10\nAuthorization: <HUADAI_API_KEY>\n```\n\ncurl 示例：\n\n```bash\ncurl -sS -G \"https://openapi.ihuadai.cn/open/api/v1/search\" \\\n  --data-urlencode \"query=早起看书\" \\\n  --data-urlencode \"page=1\" \\\n  --data-urlencode \"size=10\" \\\n  -H \"Authorization: $HUADAI_API_KEY\"\n```\n\n### 搜索响应结构\n\n成功时返回 `code=200`，核心数据在 `data` 字段中：\n\n```json\n{\n  \"code\": 200,\n  \"data\": {\n    \"total\": 5,\n    \"page\": 1,\n    \"size\": 10,\n    \"data\": [\n      {\n        \"unique_id\": \"b_1730000000_a1b2c3d4\",\n        \"type\": 1,\n        \"content\": [{ \"insert\": \"笔记正文内容...\" }],\n        \"create_time\": 1720000000,\n        \"update_time\": 1720086400,\n        \"is_collect\": 0,\n        \"is_todo\": 0,\n        \"status\": 1\n      }\n    ]\n  }\n}\n```\n\n**关键字段说明**：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `total` | int | 匹配总数 |\n| `data[].unique_id` | string | 笔记唯一标识，用于更新和查详情 |\n| `data[].type` | int | 笔记类型：1=文本、2=图片、3=语音、4=视频 |\n| `data[].content` | array | Quill Delta ops 数组，从中提取 `insert` 拼接为文本摘要 |\n| `data[].create_time` | int | Unix 秒时间戳 |\n| `data[].update_time` | int | 最后更新时间（Unix 秒） |\n| `data[].status` | int | 状态：1=正常 |\n\n**提取内容摘要**：`content` 是 Quill Delta 数组，遍历每个 op，取 `insert` 字段拼接即可得到纯文本。\n\n执行要求：\n\n- 无结果时明确回复「未找到」。\n- 更新笔记前，优先通过搜索结果确认目标 `unique_id`。\n- 不要猜测或生成已有笔记的 `unique_id`。\n\n## 获取笔记详情\n\n```http\nGET https://openapi.ihuadai.cn/open/api/v1/block/{unique_id}\nAuthorization: <HUADAI_API_KEY>\n```\n\ncurl 示例：\n\n```bash\ncurl -sS \"https://openapi.ihuadai.cn/open/api/v1/block/b_1730000000_a1b2c3d4\" \\\n  -H \"Authorization: $HUADAI_API_KEY\"\n```\n\n返回单条笔记的完整信息，包括 `content`、`attachment`、`children`（追记/子笔记）等字段。\n\n执行要求：\n\n- 在用户明确要求查看某条笔记详情，或更新前需要确认完整内容时调用。\n- `unique_id` 必须来自搜索结果或用户明确提供。\n\n## 新建笔记\n\n```http\nPOST https://openapi.ihuadai.cn/open/api/v1/block/upload-block\nAuthorization: <HUADAI_API_KEY>\nContent-Type: application/json\n```\n\n推荐请求体。`content` 可以直接传 Markdown 字符串：\n\n```json\n{\n  \"unique_id\": \"b_1730000000_a1b2c3d4\",\n  \"type\": 1,\n  \"content\": \"正文\\n\",\n  \"create_time\": 1717142400,\n  \"status\": 1,\n  \"is_collect\": 0,\n  \"is_todo\": 0\n}\n```\n\n兼容请求体。`content` 也可以传 Quill Delta ops：\n\n```json\n{\n  \"unique_id\": \"b_1730000000_a1b2c3d4\",\n  \"type\": 1,\n  \"content\": [\n    {\n      \"insert\": \"正文\\n\"\n    }\n  ],\n  \"create_time\": 1717142400,\n  \"status\": 1\n}\n```\n\ncurl 示例：\n\n```bash\ncurl -sS -X POST \"https://openapi.ihuadai.cn/open/api/v1/block/upload-block\" \\\n  -H \"Authorization: $HUADAI_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"unique_id\":\"b_1730000000_a1b2c3d4\",\"type\":1,\"content\":\"正文\\n\",\"create_time\":1717142400,\"status\":1,\"is_collect\":0,\"is_todo\":0}'\n```\n\n执行要求：\n\n- `unique_id` 必须是新生成的笔记 ID。\n- 普通文本笔记使用 `type=1`。\n- `create_time` 使用当前 Unix 秒。\n- 只有响应 `code=200` 后，才能回复「已保存」。\n\n## 更新笔记\n\n```http\nPOST https://openapi.ihuadai.cn/open/api/v1/block/update-block\nAuthorization: <HUADAI_API_KEY>\nContent-Type: application/json\n```\n"},{"path":"skill-card.md","content":"## Description:\n\n话袋笔记 Skill helps agents create, update, and search personal notes through the Huadai OpenAPI.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[monkeydb](https://clawhub.ai/user/monkeydb)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agent developers use this skill to connect a compatible agent to Huadai Notes so it can save new notes, search existing notes, and update confirmed notes through the Huadai OpenAPI.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Helper scripts may execute unintended local code when handling note identifiers.\n\nMitigation: Review before installing and avoid arbitrary or externally supplied note IDs until upload.sh and update.sh serialize unique_id safely.\n\nRisk: The Huadai API key can be sent to an overridden endpoint if HUADAI_BASE_URL points away from Huadai.\n\nMitigation: Use only a Huadai API key you are comfortable exposing to this skill and do not set HUADAI_BASE_URL to a non-Huadai host.\n\n## Reference(s):\n\n- [API Reference](references/api.md)\n- [ClawHub Skill Page](https://clawhub.ai/monkeydb/skills/hd-notes-skills)\n- [ClawHub Marketplace Page](https://clawhub.ai/monkeydb/hd-notes-skills)\n- [Huadai Open Platform](https://ihuadai.cn/desktop/openai)\n- [Huadai OpenAPI Base URL](https://openapi.ihuadai.cn/open/api/v1)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and plain text guidance with shell commands and API response summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires HUADAI_API_KEY for authenticated Huadai OpenAPI calls.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release metadata; artifact frontmatter and package metadata report 1.1.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。 当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Skill: 话袋笔记 Skill Owner: monkeydb Summary: 话袋笔记 - 通过话袋 OpenAPI 新建、更新和搜索个人笔记。 当以下情况时使用此 Skill： (1) 用户要保存内容到笔记：「记一下」「存到笔记」「保存」 (1.5) 用户要收藏某条笔记：「收藏这条」「收藏一下」 (2) 用户要更新内容到笔记：「更新一下」「更新笔记」「补充到这条」 (3) 用户要搜索或查看笔记：「搜一下」「找找笔记」「打开某条笔记」「笔记详情」 (4) 用户要配置话袋笔记：「配置话袋」「连接话袋笔记」「授权话袋」「怎么填 Key」 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-07-13T04:23:22.704Z | user **v1.1.0 update summary:** Skill name, documentation, and structure h","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1075,"uniquenessScore":45,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:08:56.854Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:08:56.854Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T20:56:25.966Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}