话袋笔记助手

要解决的问题

Agent 在笔记类任务中常见两类问题：一是把用户意图直接当成 API 状态，提前声称「已保存」或「已更新」；二是在没有 unique_id、搜索结果或笔记详情的情况下拼接内容，导致更新错目标或编造摘要。这个技能围绕话袋笔记的开放接口，把搜索、查看、新建、更新和错误处理拆成可验证的步骤，适合在对话中维护外部笔记库。

工作方式

• 配置与鉴权：用户提到「配置话袋」或「怎么填 Key」时，先引导创建并配置 HUADAI_API_KEY，不立即调用业务 API；密钥不应在对话中回显。
• 搜索与选择：通过 GET /search 按关键词检索，从响应中提取 unique_id、文本摘要、时间和类型；无结果时明确回复「未找到」，不补写类似笔记。
• 详情与更新：需要完整内容时调用 GET /block/:unique_id；更新前必须确认目标 unique_id，再把完整 Markdown 写入 POST /block/update-block。
• 写操作确认：新建使用 POST /block/upload-block，只有接口返回 code=200 后才能告知用户保存成功；错误码如 400001、400018 分别提示重新配置密钥或重新搜索笔记。

注意点

该技能依赖话袋开放平台的 API Key 与对应权益，不保存密钥到笔记正文，也不处理会员开通、权限撤销等账号侧操作。使用重点是让 Agent 以 API 响应为准，而不是依赖自然语言推断笔记是否已存在、已更新或已找到。