前言¶

写笔记的链路通常要自己拼一套后端：建表、写接口、做鉴权、再写搜索。真到了”随手记一句话”的场景，这一步并不划算——你需要的只是把内容丢进去，之后能按关键词找回来。

话袋笔记 Skill 把这件事压缩成一个 Skill：通过话袋开放平台的 OpenAPI，让 Agent 直接完成新建笔记、更新笔记、关键词搜索笔记三件事。下面介绍它的定位、能力和启用方式。

这是什么¶

话袋笔记 Skill（hd_notes_skills）是一个基于通用 SKILL.md 格式的 Agent Skill，提供话袋笔记的写入与检索能力。

• 出品方：社区（community），发布者 user_5808e1d9
• 坐标：@user_5808e1d9/hd-notes-skills
• 当前版本：1.0.2
• 分类：knowledge-management
• 标签：requires_api_key=true
• 评分：100000；下载：495；安装：2

解决什么问题：把”记一笔”和”找出来”这两步交给 Agent，开发者不用为笔记功能单独搭服务。Skill 本身不存数据，读写都落在话袋开放平台上。

核心功能¶

下面介绍已核实的三项能力，均通过话袋 OpenAPI 提供。

1、新建笔记：把一段自然语言内容记成一篇笔记。
2、更新笔记：对已有笔记做修改。
3、关键词搜索笔记：按关键词把笔记检索召回。

能力边界也要说清楚：资料中未列出分页、排序、标签、附件等扩展能力，因此本文不描述。

安装与启用¶

该 Skill 托管在 SkillHub 上，官方页面：

https://www.skillhub.cn/skills/user_5808e1d9/hd-notes-skills

安装入口即上面的页面，坐标为 @user_5808e1d9/hd-notes-skills，按页面提示添加即可。

认证方式在简介中已明确：使用话袋开放平台 API Key，通过请求头 Authorization 传递。因此启用前需要先在话袋开放平台申请 API Key。请求侧的配置形态如下（凭据请用真实 Key 替换）：

Authorization: Bearer <话袋开放平台 API Key>

需要说明的是，资料中没有给出针对 Cursor、Codex CLI、Claude Code 的差异化安装命令或字段名，本文不做区分描述。有需要时以官方页面为准。

典型用法¶

由于 Skill 把读写委托给话袋 OpenAPI，实际调用时 Agent 侧只负责组织意图，底层仍是带鉴权的 HTTP 请求。一个可用的请求示例如下，作用是确认鉴权头正确，从而验证 Key 是否生效：

curl -s -H "Authorization: Bearer <话袋开放平台 API Key>" \
  -H "Content-Type: application/json" \
  -X GET "https://api.example.com/openapi/notes?q=<关键词>"

上面示例中的域名与路径仅为结构演示，真实的接口地址、路径与参数以话袋开放平台文档为准，本文不做断言。

从 Skill 侧看，日常用法对应三类自然语言指令：

1、”把这句话记下来” → 新建笔记
2、”刚才那条改成……” → 更新笔记
3、”我上周记的那条关于……的笔记找出来” → 关键词搜索

适用场景与注意¶

适合的场景：Agent 需要自带笔记能力、又不想自建笔记服务的个人项目与原型；已经使用话袋开放平台、希望复用现有笔记数据的场景。

需要注意的点：

1、必须配置话袋开放平台 API Key，否则所有读写请求都无法通过鉴权。
2、笔记数据存放在话袋侧，Skill 只是调用方，换平台意味着数据要迁移。
3、版本 1.0.2 属于早期版本，当前安装量为 2，生产环境接入前建议先在测试环境验证一遍。
4、安装命令与具体配置字段未能从官方资料核实，接入前请核对官方页面。

结尾¶

话袋笔记 Skill 的价值在于把笔记的写入与检索收敛成一个 Skill，开发者不必为此单独搭建服务，Agent 侧只需配置好话袋开放平台 API Key 即可。

官方地址：https://api.skillhub.cn/user_5808e1d9/hd-notes-skills