TicNote Cursor 插件（ticnote-cursor-plugin）

将官方 TicNote API Skill 打包为 Cursor Plugin，让 Agent 可以安全地完成：AppKey/Token 引导、知识库项目与文件列表、上传、转写、总结、翻译、分享、播客、Deep Research、用户设置与知识库管理。

English: Cursor plugin packaging the official TicNote knowledge-base / recording API skill for agents (token, upload, transcribe, summary, deep research).

安装

本地安装（当前）

将本目录 ticnote-plugin/ 复制或克隆到本机
在 Cursor 中按本地 Plugin 方式加载该文件夹（Marketplace 上架后可一键安装）
打开 Plugins → Configure，填写变量 TICNOTE_APPKEY
API Key 获取：https://ticnote.com （国内：https://www.ticnote.cn → 账户设置 → API 密钥）

AppKey 前缀一般为 tncn_sk_ / tnovs_sk_（及对应 *_sit_sk_ 测试前缀）。切勿把密钥提交到 Git。

能力

获取 AppKey 指引并换取 Bearer Token
列出知识库项目 / 项目下文件
上传文件到知识库（COS 三步流程封装在脚本中）
文件详情与转写状态轮询
提交转写、重新总结、非音频文件总结
翻译、分享、播客生成
Deep Research
用户设置读写
知识库文件管理（删除 / 重命名 / 复制 / 移动）

斜杠命令

命令	说明
`/ticnote-setup`	引导获取 AppKey 并换取 Token
`/ticnote-list-projects`	列出知识库项目（序号/名称/文件数）
`/ticnote-upload`	上传文件（先确认目录与是否总结）
`/ticnote-file-detail`	查看文件详情或轮询转写

Agent 如何运行脚本

技能根目录为插件内的 skills/ticnote-api/。请将该目录作为 cwd，然后执行：

python scripts/get_token.py --appkey "<APPKEY>"
python scripts/list_projects.py --token "<TOKEN>" --appkey "<APPKEY>"
python scripts/upload_file.py --token "<TOKEN>" --appkey "<APPKEY>" --file "/path/to/file" --parent-id "<PROJECT_ID>"
# …其余脚本见 skills/ticnote-api/SKILL.md

也可使用 skill 目录的绝对路径调用 python /…/skills/ticnote-api/scripts/….py。完整接口说明见 skills/ticnote-api/SKILL.md。

优先使用插件变量 TICNOTE_APPKEY；缺失时请求用户提供，并附上 references/get-apikey.md 指引。

Skill 来源说明

本插件基于官方 TicNote API Skill 压缩包：

https://voice-recorder-cdn.ticnote.com/ticnote-web-prd/2026-03/ticnote-api.zip

在插件场景下调整了脚本路径说明，并增加插件变量 / 安全规则；API 文档与 Python 脚本内容保持官方原样。

安全

见 rules/ticnote-security.mdc：禁止提交 AppKey/Token；仅使用 Configure / 用户提供的密钥；聊天中尽量打码。

安装

本地安装（当前）

能力

斜杠命令

Agent 如何运行脚本

Skill 来源说明

安全

License