龙虾录音卡开发者开放平台
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-c77c0c1n/airec-dev-v1。
技能介绍
要解决什么问题
龙虾录音卡(ClawRecorder)会把随身录音自动转写并上传到云端。若你只是终端用户,用官方 App 或 CLI 即可;但若你是第三方开发者或软件服务商,需要把「读用户自己的转写文本 → 生成纪要、周报、待办」封装成可安装的 AI 技能,就要对接开发者开放平台。核心矛盾是:技能要能取数,又不能让开发者读到别的用户数据。
技能/平台如何工作
本技能载体是一份完整的接入文档(对应 SKILL.md),描述 HTTP API 与运行时约定,而非单一脚本。典型闭环分五步:
- 用手机号 + 短信验证码注册开发者身份,获得
dev JWT(管理面,约 30 天有效)。 - 调用
POST /api/dev/skills提交 SKILL.md 全文 → 平台风险扫描 → 通过后落库并一次性返回 API Key 明文(只存哈希,丢失需撤销重提)。 - 对技能开启分享,得到 6 位分享码(一对多;数据隔离不靠码,靠安装时每人一把 Key)。
- 终端用户用用户 JWT登录后
POST /api/v1/skills/install安装,获得用户专属 API Key(与开发者 Key 独立)。 - 技能运行时仅用
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 的集成开发者
- 需向客户说明「为何要先登录再输分享码」的技术顾问或售前,要有一套可引用的官方接口说明