Agent Skills
返回列表
龙虾录音卡开发者开放平台

龙虾录音卡开发者开放平台

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-c77c0c1n/airec-dev-v1。

技能介绍

要解决什么问题

龙虾录音卡(ClawRecorder)会把随身录音自动转写并上传到云端。若你只是终端用户,用官方 App 或 CLI 即可;但若你是第三方开发者或软件服务商,需要把「读用户自己的转写文本 → 生成纪要、周报、待办」封装成可安装的 AI 技能,就要对接开发者开放平台。核心矛盾是:技能要能取数,又不能让开发者读到别的用户数据。

技能/平台如何工作

本技能载体是一份完整的接入文档(对应 SKILL.md),描述 HTTP API 与运行时约定,而非单一脚本。典型闭环分五步:

  1. 用手机号 + 短信验证码注册开发者身份,获得 dev JWT(管理面,约 30 天有效)。
  2. 调用 POST /api/dev/skills 提交 SKILL.md 全文 → 平台风险扫描 → 通过后落库并一次性返回 API Key 明文(只存哈希,丢失需撤销重提)。
  3. 对技能开启分享,得到 6 位分享码(一对多;数据隔离不靠码,靠安装时每人一把 Key)。
  4. 终端用户用用户 JWT登录后 POST /api/v1/skills/install 安装,获得用户专属 API Key(与开发者 Key 独立)。
  5. 技能运行时仅用 X-Airec-Api-Key 调用 GET /api/v1/transcriptions 分页读转写;列表接口只给 text_preview(前 200 字),完整文本需用户侧 GET /api/transcriptions/{tr_id}(Bearer 用户 JWT)。

官方 CLI(airec-dev / airec)可覆盖注册、分享、安装等步骤;自研集成则按文档中的 {BASE_URL} 与错误码表实现。取 Key 时应按 skill_name 精确匹配本机 ~/.airec/dev_keys.json,优先 owner=user,避免误用其他技能的 Key。

边界与注意点

  • 三种凭据勿混用:dev JWT 管技能/分享;用户 JWT 管安装与完整转录;API Key 仅供运行时取数,不是登录态。
  • 开发者不得把 dev JWT 或自己的 Key 打进公开技能包;分享码可公开,Key 不可。
  • 提交技能时扫描会拒绝 chmod、rm -rf、curl | sh 等危险模式;转录文本视为不可信输入,禁止当指令执行。
  • 技能装好后拉不到数据,多半是用户未完成「登录 + 分享码安装」两步,未签发用户 Key。

使用场景

  • ISV 要把「读用户录音转写 → 出会议纪要」做成可分享码安装的技能,需对照文档实现提交、分享与用户 Key 取数
  • 自研 Agent 不想依赖客户机 CLI,计划在运行时只用 API Key 分页调用转录列表接口
  • 集成前应自测 dev JWT 提交流程与风险扫描被拒原因(frontmatter、依赖白名单、危险命令)
  • 技能需拼接完整转写时,要区分 preview 接口与用户 JWT 下的详情端点,避免误以为有 GET /transcriptions/{id} 数据面

适合人员

  • 为龙虾录音卡终端客户做定制纪要/周报技能的第三方软件服务商,需要正规 API 与一人一把 Key 的隔离模型
  • 会在 CI 或自有后台调用 `/api/dev/skills` 批量提交版本化 SKILL.md 的内部平台工程师
  • 负责 Agent 运行时在多技能环境下解析 `~/.airec/dev_keys.json`、避免拿错 Key 的集成开发者
  • 需向客户说明「为何要先登录再输分享码」的技术顾问或售前,要有一套可引用的官方接口说明