录音笔记管理助手

技能文档

---
name: luyin-biji-guanli
description: "录音笔记管理助手，支持查询录音列表、获取转写文本和AI智能总结。通过API接口管理录音文件，支持关键词搜索和说话人识别。"
title: "录音笔记管理助手"
category: "办公效率"
---

# 录音笔记管理助手

管理录音笔记：查询列表、获取转写文本和AI总结。通过API接口运行相关命令。

## 认证流程

使用两步认证：先用API Key换取Token，再用Token调用业务接口。

### 获取 Token

```bash
curl -s -X POST "https://api.aidenote.cn/api/userapikeyMstr/getToken/$API_KEY" \
  -H "Content-Type: application/json"
```

成功返回：
```json
{
  "code": 200,
  "result": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "userId": "13000000001xx"
  }
}
```

提取 `result.token`，后续所有请求携带 Header：`Authorization: Bearer <token>`

Token有效期约7天。返回401或认证失败时重新获取。

## 操作

### 获取录音笔记列表

```bash
curl -s -X POST "https://api.aidenote.cn/api/audiofileMstr/audiofileseleUserAllList" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "order": "descending",
    "orderField": "createTime",
    "page": 1,
    "pageSize": 10
  }'
```

可选：请求体加 `"keyword": "搜索词"` 进行关键词搜索。

返回字段说明：
- `result.items`：笔记数组
- `result.total`：总条数
- 每条笔记关键字段：
  - `audiofileFileid`：文件ID（字符串），用于获取转写详情
  - `audiofileTitle`：标题
  - `audiofileFileName`：文件名
  - `createTime`：创建时间
  - `audiofileTimeLength`：时长（毫秒）
  - `audiofileTranscription`：转写状态（0=未开始, 1=进行中, 2=已完成）
  - `audiofileSummaryStatus`：总结状态（0=未开始, 1=进行中, 2=已完成）
  - `audiofileText`：转写文本
  - `audiofileSummary`：AI总结文本
  - `audiofileTag`：标签

### 获取录音转写详情

用列表中的 `audiofileFileid` 获取完整转写：

```bash
curl -s -X POST "https://api.aidenote.cn/api/audiofileMstr/audiofileToText" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "audiototextFileid": "<audiofileFileid>",
    "audiototextLanguage": "zh"
  }'
```

参数：
- `audiototextFileid`：必填，从列表的 `audiofileFileid` 获取
- `audiototextLanguage`：语言，默认 `"zh"`

返回的转写分段包含：
- `audiototextContent`：该段文本
- `audiototextParaNum`：段落号
- `audiototextStartSecond` / `audiototextEndSecond`：时间范围（秒）
- `audiototextRoleName`：说话人

## 输出格式

列表展示：
```
录音笔记（共 N 条）

1. [标题]
   时间：[createTime]  时长：[X分X秒]
   转写：[已完成 / 未开始]  总结：[已完成 / 未开始]
```

转写详情：按段落顺序拼接文本内容，标注说话人。

## 错误处理

- Token获取失败（code != 200）：提示检查API Key
- 业务接口返回401：Token过期，重新获取
- 网络失败：提示检查网络
- 列表为空：告知暂无录音笔记

## 配置

用户需配置API Key环境变量。获取方式：访问相关平台 -> 登录 -> 我的 -> API Key -> 生成访问密钥。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。