1. 基础使用教程
速创 API
  • 文档说明
  • 基础使用教程
    • 新手必看!速创API 中转站
    • (推荐)电脑版Cherry Studio对接速创API实现简单对话教程
    • 安卓版Cherry Studio · 接入速创API教程
    • (进阶)电脑版Cherry Studio实现画图
    • (进阶)电脑版Cherry Studio实现agent操控电脑文件
    • 实操案例——写论文
  • 模型(Models)
    • 列出模型
      • 原生OpenAI格式
      • 原生Gemini格式
  • 聊天(Chat)
    • 原生OpenAI格式
      • ChatCompletions格式
      • Responses格式
    • 原生Gemini格式
      • Gemini文本聊天
      • Gemini媒体识别
    • 原生Claude格式
      POST
  • 图像(Images)
    • 原生OpenAI格式
      • 生成图像
      • 编辑图像
    • 通义千问格式
      • 生成图像
      • 编辑图像
    • Nano Banana
      • Gemini原生格式
      • OpenAI聊天格式
  • 视频(Videos)
    • Sora格式
      • 创建视频
      • 获取视频任务状态
      • 获取视频内容
    • 可灵格式
      • Kling 文生视频
      • 获取 Kling 文生视频任务状态
      • Kling 图生视频
      • 获取 Kling 图生视频任务状态
    • 即梦格式
      • 即梦视频生成
    • 创建视频生成任务
      POST
    • 获取视频生成任务状态
      GET
  • 嵌入(Embeddings)
    • 原生OpenAI格式
      POST
    • 原生Gemini格式
      POST
  • 补全(Completions)
    • 原生OpenAI格式
      POST
  • 音频(Audio)
    • 原生OpenAI格式
      • 音频转录
      • 音频翻译
      • 文本转语音
    • 原生Gemini格式
  • 实时语音(Realtime)
    • 原生OpenAI格式
  • 重排序(Rerank)
    • 文档重排序
  • 审查(Moderations)
    • 原生OpenAI格式
  • 未实现(Unimplemented)
    • 微调(Fine-tuning)
      • 列出微调任务 (未实现)
      • 创建微调任务 (未实现)
      • 获取微调任务详情 (未实现)
      • 取消微调任务 (未实现)
      • 获取微调任务事件 (未实现)
    • 文件(Files)
      • 列出文件 (未实现)
      • 上传文件 (未实现)
      • 获取文件信息 (未实现)
      • 删除文件 (未实现)
      • 获取文件内容 (未实现)
  • 数据模型
    • Schemas
      • User
      • Log
      • Model
      • Token
      • Usage
      • PageInfo
      • Channel
      • Redemption
      • ApiResponse
      • ModelsResponse
      • ErrorResponse
      • Message
      • MessageContent
      • Tool
      • ToolCall
      • GeminiModelsResponse
      • ChatCompletionResponse
      • ChatCompletionRequest
      • ChatCompletionStreamResponse
      • CompletionRequest
      • CompletionResponse
      • ResponseFormat
      • ResponsesRequest
      • ResponsesResponse
      • ResponsesStreamResponse
      • ClaudeRequest
      • ClaudeMessage
      • ClaudeResponse
      • EmbeddingRequest
      • EmbeddingResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • ImageResponse
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • AudioTranscriptionResponse
      • SpeechRequest
      • RerankRequest
      • RerankResponse
      • VideoRequest
      • ModerationRequest
      • VideoResponse
      • ModerationResponse
      • VideoTaskResponse
      • GeminiRequest
      • VideoTaskMetadata
      • VideoTaskError
      • GeminiResponse
      • OpenAIVideo
      • OpenAIVideoError
  1. 基础使用教程

实操案例——写论文

十分钟速通!Cherry Studio + 速创API:Agent 模式辅助论文写作实操教程#

重要提醒:AI 只能作为学习、检索、整理、润色和辅助分析工具,不能代替你完成学术判断和原创写作。论文写作必须遵守学校、期刊或课程要求,正确引用参考文献,避免抄袭、编造数据、伪造引用等学术不端行为。AI 输出内容可能存在错误,请务必人工核对原文、数据、公式和引用格式。
本文以“让 AI 读取本地参考文献并辅助写论文总结”为案例,演示如何从注册速创API、安装 Cherry Studio 和 Git 开始,配置 Agent Anthropic 格式的一键导入,并让 AI 读取电脑文件完成论文辅助任务。

使用前必看:AI 不是所有软件都能操控#

Agent 能读取和编辑文件,也能执行命令,但不是所有软件都能被 AI 操控。
简单理解:
支持命令行、脚本、API 的软件,AI 更容易操控;
只能靠鼠标点击界面的软件,AI 通常不能稳定操控;
MATLAB 支持命令行运行脚本,实测可以配合 Agent 使用;
如果不确定某个专业软件能不能用,可以先问 AI:“这个软件是否支持命令行调用、脚本运行或 API 自动化?”
示例:
请帮我确认 XXX 软件是否支持命令行调用、脚本运行或 API 自动化。如果支持,请告诉我 Windows 下的基本调用方式。

一、准备工作#

你需要准备:
1.
一个速创API账号;
2.
Cherry Studio 电脑版;
3.
Git;
4.
本地论文资料,例如 PDF、Word、Markdown、TXT、BibTeX、Excel 数据等;
5.
一个明确的论文任务,例如“总结参考文献”“整理研究现状”“生成论文大纲”“润色某一节内容”。
本教程只写电脑端。Agent 需要读取本地文件、执行命令和调用工具,请使用电脑完成。
百度网盘:通过网盘分享的文件:cherrystudio
链接: https://pan.baidu.com/s/1-_OVaNpJV2E_mMIrb5-r7Q?pwd=nwyq 提取码: nwyq
--来自百度网盘超级会员v5的分享

二、注册速创API中转站#

1.
打开浏览器访问速创API中转站:
https://api.suchuang.vip
2.
使用邮箱注册账号并登录。
注册登录示意图
3.
登录后点击“控制台”,进入个人控制面板。
4.
进入“钱包管理”查看余额。
注意:注册就送1⚡,每天签到也获得额度。如果余额不足,模型调用可能会失败。

三、创建 API Key / 令牌#

1.
在速创API控制台中找到“API 密钥”。
2.
点击“创建API密钥”。
添加令牌
3.
填写令牌名称,例如:
Cherry Studio Agent 论文写作
4.
根据需要选择分组或模型服务,然后保存。
填写令牌信息
5.
创建成功后,在令牌列表中可以看到对应记录。
安全提醒:API Key 相当于账号调用凭证,不要发给陌生人,不要上传到公开仓库,也不要截图公开发布。

四、下载安装 Cherry Studio 电脑版#

Cherry Studio 电脑版可以从官方 GitHub (需要自行解决网络问题)下载:
https://github.com/CherryHQ/cherry-studio/releases
下载与你电脑系统对应的安装包,例如 Windows 版本,安装完成后打开 Cherry Studio。
百度网盘:通过网盘分享的文件:cherrystudio
链接: https://pan.baidu.com/s/1-_OVaNpJV2E_mMIrb5-r7Q?pwd=nwyq 提取码: nwyq
--来自百度网盘超级会员v5的分享

五、下载安装 Git#

Agent 操控电脑文件时,经常需要使用命令行工具。建议先安装 Git,因为 Git 会附带常用的命令行环境。
Git 下载地址:
官方(需要自行解决网络问题):https://git-scm.cn/install/
百度网盘:通过网盘分享的文件:cherrystudio
链接: https://pan.baidu.com/s/1-_OVaNpJV2E_mMIrb5-r7Q?pwd=nwyq 提取码: nwyq
--来自百度网盘超级会员v5的分享
安装时一般保持默认选项即可。安装完成后,可以在终端中输入下面命令检查是否安装成功:
如果能显示版本号,说明安装成功。

六、一键导入 Agent Anthropic 格式#

速创API提供的一键导入不止一种。这里不要选择普通聊天导入,而是选择用于 Agent 的 Anthropic 格式导入。
操作步骤:
1.
打开速创API控制台;
2.
进入“令牌管理”或“API 密钥”;
3.
找到刚刚创建的令牌;
4.
点击令牌后面的“聊天”下拉按钮;
5.
选择 Agent / Anthropic 格式的一键导入;
6.
根据提示打开 Cherry Studio 并完成导入。
参考示意图:
Agent 导入入口 2
重点:智能体模式只支持 Anthropic 供应商。不要只把 New API 供应商的模型端点改成 Anthropic,这样不能在智能体模式中正常使用。需要供应商类型本身就是 Anthropic。

七、在 Cherry Studio 中添加模型#

先调整导航栏位置,选择左侧,具体看个人习惯,本教程以左侧为例
进入设置--显示设置--导航栏位置
QQ_1778086058263.png
完成 Agent Anthropic 格式导入后,还需要在 Cherry Studio 中确认模型已经添加成功。如果没有自动添加到模型列表,可以按下面方法手动添加。
1.
打开 Cherry Studio,进入“设置”。
2.
选择“模型服务”,找到刚刚导入或添加的速创API Anthropic 供应商。
3.
确认供应商已经启用,并且 API 地址、API Key 已经填写正确。
4.
点击“获取模型列表”。
5.
搜索你想使用的模型,点击右侧加号添加到模型列表。
6.
如果没有获取到想要的模型,但速创API“模型广场”中确实存在该模型,可以手动添加。
7.
手动添加时,模型 ID 必须和速创API模型广场中的模型 ID 保持一致。
QQ_1778500548337.png
8.
回到聊天或智能体界面,点击模型选择框,切换到刚刚添加的模型。
9.
如果需要调整上下文、温度等参数,可以进入默认助手或对应模型设置中修改。

八、配置 Cherry Studio 智能体权限#

完成 Agent Anthropic 导入并添加模型后,进入 Cherry Studio 的智能体界面。
1.点击智能体界面,(推荐使用左侧的导航栏,顶部导航栏需要先点击加号再点击智能体),新建智能体,填写相关信息
QQ_1778500432653.png
QQ_1778500526283.png
2.点击三个点,调整设置,例如ai可以操作的文件目录,ai权限
QQ_1778500487060.png
QQ_1778087448445.png
权限推荐使用自动编辑模式,防止ai误操作文件
QQ_1778087470890.png
3.完成配置之后,便可以使用了,比如,帮我读取xxxx路径下的xxx文件,生成一个总结
小技巧:提示词中,需要明确告诉ai你的文件在哪,同时如果ai提示环境不对,找不到文件,或者无法解析文件,你都可以让ai自行配置环境,自行解决问题
注意对话长度,及时新开对话(不是新建智能体)以降低token消耗
QQ_1778087801773.png

九、实操案例:让 AI 读取参考文献并写论文总结#

假设你的电脑中有一个文件夹:
D:\论文资料\参考文献
里面有这些文件:
D:\论文资料\参考文献\文献1.pdf
D:\论文资料\参考文献\文献2.pdf
D:\论文资料\参考文献\文献3.pdf
D:\论文资料\参考文献\参考文献.bib
你想让 AI 帮你读取这些参考文献,并写一段研究现状总结。

1. 复制文件或文件夹地址#

在 Windows 电脑中,可以这样复制路径:
1.
找到你的文件或文件夹;
2.
对着文件或文件夹右键;
3.
选择“复制文件地址”或“复制路径”;
4.
把复制到的完整路径发给 AI。
注意:一定要把完整文件地址或文件夹地址发给 AI。只说“读取我的参考文献”是不够的,因为 AI 不知道你的文件放在哪里。
推荐直接发送完整路径,例如:
请读取下面文件夹中的参考文献,并总结每篇文献的研究问题、方法、结论和不足:

D:\论文资料\参考文献
如果你只想让 AI 读取某几个文件,可以这样发:
请读取下面这些论文文件,并帮我整理一份文献综述表格:

D:\论文资料\参考文献\文献1.pdf
D:\论文资料\参考文献\文献2.pdf
D:\论文资料\参考文献\文献3.pdf

2. 给 AI 一个明确任务#

不要只发文件路径,最好同时说明你要它做什么。
示例提示词:
请读取以下参考文献文件,帮我完成三件事:

1. 分别总结每篇文献的研究主题、研究方法、主要结论和局限;
2. 对比这些文献之间的共同点和差异;
3. 写一段 800 字左右的“国内外研究现状”初稿。

要求:
- 不要编造文献中没有的信息;
- 如果文件中找不到某项信息,请标注“原文未明确说明”;
- 输出内容只作为论文写作参考,我会自行修改和核对。

文件地址:
D:\论文资料\参考文献

3. 让 AI 输出更适合论文写作的结构#

你可以继续追问:
请把上面的总结整理成 Markdown 表格,列包括:作者、年份、研究对象、方法、结论、局限、可借鉴之处。
也可以让 AI 帮你生成论文大纲:
基于这些参考文献,请帮我设计一个论文大纲,题目暂定为《XXX研究》。要求包括摘要、引言、文献综述、研究方法、结果分析、结论与展望。
还可以让 AI 辅助润色,但不要让它替你编造:
请在不改变原意、不新增虚假引用的前提下,润色下面这段文字,使其更符合学术论文表达。

【粘贴你的原文】

十、推荐论文写作工作流#

下面是一个比较稳妥的工作流:
1.
你自己确定论文题目、研究问题和基本思路;
2.
把参考文献文件夹路径发给 AI;
3.
让 AI 逐篇总结文献,不要直接生成整篇论文;
4.
让 AI 整理文献综述表格;
5.
你人工核对每条总结是否符合原文;
6.
让 AI 根据你确认过的信息生成论文大纲;
7.
你自己写初稿,或让 AI 辅助润色局部段落;
8.
对所有引用、数据、公式、图表逐项核查;
9.
使用学校或期刊要求的格式整理参考文献;
10.
最终内容由你自己负责。

十一、常用提示词模板#

模板 1:读取参考文献并总结#

请读取下面文件夹中的参考文献,逐篇总结:研究主题、研究方法、数据来源、主要结论、局限性。

要求:
1. 不要编造原文没有的信息;
2. 找不到的信息请写“原文未明确说明”;
3. 输出 Markdown 表格;
4. 最后总结这些文献对我的论文选题有什么启发。

文件夹地址:
【粘贴你的文件夹路径】

模板 2:写文献综述初稿#

请基于刚才已经总结并核对过的参考文献,帮我写一段文献综述初稿。

要求:
1. 逻辑按照“研究背景—已有研究—不足—本文切入点”展开;
2. 不要添加不存在的作者和年份;
3. 引用位置用“作者(年份)”或“[编号]”占位;
4. 语言正式、客观、适合学术论文;
5. 字数约 800 字。

模板 3:检查论文段落#

请检查下面这段论文文字:

【粘贴段落】

请从以下方面给出修改建议:
1. 逻辑是否连贯;
2. 表达是否学术;
3. 是否有可能需要补充引用的地方;
4. 是否存在夸大或不严谨表述。

请先给修改建议,再给润色后的版本。

模板 4:配合 MATLAB 分析数据#

请读取下面文件夹中的 MATLAB 代码,判断主程序入口,并尝试运行。

要求:
1. 如果报错,请解释报错原因;
2. 在不改变核心算法的前提下修复代码;
3. 运行成功后说明输出结果在哪里;
4. 不要删除原始数据文件。

项目路径:
【粘贴 MATLAB 项目文件夹路径】

十二、常见问题#

1. 为什么 AI 说找不到文件?#

通常是因为你没有提供完整路径,或者 Cherry Studio / Agent 没有对应文件访问权限。
请确认:
路径是否完整;
文件是否真实存在;
路径中是否有特殊符号;
是否把文件夹路径和文件路径复制错了;
是否允许 Agent 读取本地文件。

2. 为什么 AI 不能直接操作某个软件?#

可能是该软件不支持命令行、脚本或 API 自动化。AI 更擅长操作文件、命令行工具和可脚本化软件。

3. AI 写的论文内容可以直接交吗?#

不建议,也不应该。AI 内容只能作为参考。你需要自己核对、修改、补充引用,并遵守学术诚信要求。

4. AI 会不会编造参考文献?#

有可能。因此提示词中要明确要求“不要编造”“找不到就说明找不到”。最终仍然需要你人工核对原始文献。

十三、总结#

使用速创API + Cherry Studio + Agent Anthropic 模式,可以让 AI 读取本地资料、整理文献、辅助写作,并在权限允许的情况下运行部分命令行软件。
但请记住:
AI 是参考工具,不是论文代写工具;
文件路径要完整复制给 AI;
参考文献必须人工核对;
专业软件必须支持命令行、脚本或 API,AI 才可能稳定操控;
MATLAB 支持命令行调用,适合作为 Agent 辅助科研计算的工具之一。
修改于 2026-06-04 09:38:04
上一页
(进阶)电脑版Cherry Studio实现agent操控电脑文件
下一页
原生OpenAI格式
Built with