实操案例：OpenCode 桌面版辅助论文写作

转载请注明出处

重要提醒：AI 只能作为学习、检索、整理、润色和辅助分析工具，不能代替你完成学术判断和原创写作。论文写作必须遵守学校、期刊或课程要求，正确引用参考文献，避免抄袭、编造数据、伪造引用等学术不端行为。AI 输出内容可能存在错误，请务必人工核对原文、数据、公式和引用格式。

⚠️ 使用前必看：AI 不是所有软件都能操控

Agent 能读取和编辑文件，也能执行命令，但不是所有软件都能被 AI 操控。

简单理解：

支持命令行、脚本、API 的软件，AI 更容易操控；

只能靠鼠标点击界面的软件，AI 通常不能稳定操控；

MATLAB 支持命令行运行脚本，实测可以配合 Agent 使用；

如果不确定某个专业软件能不能用，可以先问 AI："这个软件是否支持命令行调用、脚本运行或 API 自动化？"

示例：

请帮我确认 XXX 软件是否支持命令行调用、脚本运行或 API 自动化。如果支持，请告诉我 Windows 下的基本调用方式。

一、准备工作

你需要准备：

一个速创API账号（获取 API Key）

OpenCode 桌面版

Git（命令行工具）

本地论文资料（PDF、Word、Markdown、Excel 数据等）

一个明确的论文任务（如"总结参考文献""生成论文大纲""润色某章节"）

二、注册速创API中转站

打开浏览器访问速创API中转站：

https://api.suchuang.vip

使用邮箱注册账号并登录。

登录后点击"控制台"，进入个人控制面板。

进入"钱包管理"查看余额。

注意：注册就送1额度，每天签到也获得余额。如果余额不足，模型调用可能会失败。

三、创建 API Key

在速创API控制台中找到"API 密钥"。

点击"创建API密钥"。

填写令牌名称，例如：

OpenCode 论文写作

选择分组，点击保存。

创建成功后复制你的 API Key。

⚠️ 安全提醒：API Key 相当于账号调用凭证，不要发给陌生人，不要上传到公开仓库，也不要截图公开发布。

详细配置方法可参考速创API配置文档：

👉 https://apidoc.suchuang.vip/8466135m0

四、下载安装 OpenCode 桌面版

百度网盘：通过网盘分享的文件：opencode
链接: https://pan.baidu.com/s/1jI1CIToxj_RKOsx18-97zA 提取码: 8i6y
--来自百度网盘超级会员v5的分享
官方：https://opencode.ai/zh/download 注意下载桌面版

安装 Git（推荐）

Agent 操控电脑文件时经常需要使用命令行工具。建议先安装 Git。

百度网盘：通过网盘分享的文件：opencode
链接: https://pan.baidu.com/s/1jI1CIToxj_RKOsx18-97zA 提取码: 8i6y
--来自百度网盘超级会员v5的分享
官方：https://git-scm.cn/install/
安装完成后，在终端中输入：

能显示版本号即为安装成功。

五、让内置 AI 帮你配置 OpenCode

5.1 最简单的方法：直接让 AI 配

打开 OpenCode 桌面版，新建一个对话，直接对内置的免费模型说：

帮我在 opencode 配置文件 ~/.config/opencode/opencode.jsonc 中添加新的 provider。配置要求如下：

供应商信息：

供应商 ID：suchuang
显示名称：速创API
API 地址：https://api.suchuang.vip/v1
API Key：sk-xxx
SDK 包：@ai-sdk/openai-compatible
模型列表（请先搜索每个模型在 OpenAI / xAI 官方文档中的规格）：

模型一：ID xxx (例如gpt-5.5，具体参考速创API-模型广场的名称)

搜索它的 context window、max output tokens、是否支持 reasoning（支持哪些 level：none/low/medium/high）、是否支持 vision（图片输入）
主力模型，走 Responses API（provider.npm: "@ai-sdk/openai"）

模型二：ID xxx(例如gpt-5.4-nano，具体参考速创API-模型广场的名称)

同样搜索以上规格
每个模型必须包含的字段： name、limit.context、limit.output、reasoning（布尔）、modalities.input+modalities.output、options.reasoningEffort、options.reasoningSummary，以及需要时加 provider.npm。tool_call 和 attachment 不是有效字段，不要加。

配置完成后，请告诉我需要重启 OpenCode 才能生效。

AI 会自动帮你修改配置文件，添加供应商和模型。

💡 小提示：不只是配模型，任何使用中遇到的问题（环境配置、无法读取 PDF/Word、命令行报错等）都可以直接问 AI。比如：
我打开 PDF 文件时报错，说缺少依赖，帮我看看怎么解决。
AI 会自动诊断环境问题并帮你修复。

5.2 其他常用指令

配完之后，这些操作也可以直接跟 AI 说：

你想做的事	对 AI 说的话

改模型参数	"帮我改 gpt-5.5 的思考强度为 high"
禁用某个供应商	"帮我把 suchuang 禁用了"
查看当前配置	"帮我读一下现在的配置文件"
配 Key	"帮我把 Key 加到配置文件里，key 是 sk-xxx"

5.3 推荐开启的设置

配好模型后，在 OpenCode 设置中打开以下选项防止折叠之后误认为ai卡住了：

设置项	建议
在时间线中显示模型推理摘要	✅ 打开
默认在时间线中展开 shell 工具部分	✅ 打开
默认在时间线中展开 edit、write 和 patch 工具部分	✅ 打开
当智能体正在工作时，在会话顶部显示动画进度条	✅ 打开

5.4 权限设置建议

在设置中，建议不要开启自动接受权限：

读文件：自动允许

写文件/执行命令：需要你批准

这样 AI 不会偷偷改你的文件——每次修改前都会问你。

六、实操：让 AI 读取参考文献并写论文

6.1 准备论文资料

假设你的电脑中有一个文件夹：

D:\论文资料\参考文献

里面有以下文件：

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

6.2 复制文件或文件夹路径

在 Windows 中右键文件或文件夹 → 选择"复制文件地址"或"复制路径"。

注意：一定要把完整路径发给 AI。只说"读取我的参考文献"是不够的，因为 AI 不知道你的文件在哪。

6.3 给 AI 一个明确的任务

请读取以下文件夹中的参考文献，帮我完成三件事：

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

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

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

6.4 让 AI 输出论文格式

你可以继续追问：

请把上面的总结整理成 Markdown 表格，列包括：
作者、年份、研究对象、方法、结论、局限、可借鉴之处。

也可以让 AI 帮你生成论文大纲：

基于这些参考文献，请帮我设计一个论文大纲，
题目暂定为《基于 XXX 的 YYY 研究》。
要求包括摘要、引言、文献综述、研究方法、结果分析、结论与展望。

还可以让 AI 辅助润色：

请在不改变原意、不新增虚假引用的前提下，
润色下面这段文字，使其更符合学术论文表达。

【粘贴你的原文】

七、完整论文工作流

下面是一个比较稳妥的 AI 辅助论文写作流程：

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

八、常用提示词模板

模板 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 说找不到文件？

请确认：

路径是否完整（推荐复制文件资源管理器中的完整路径）

文件是否真实存在

是否允许 Agent 读取本地文件

路径中是否有中文空格等特殊符号

2. 为什么 AI 不能操控某个软件？

该软件可能不支持命令行或脚本调用。AI 更擅长操作文件、命令行工具和可脚本化的软件。

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

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

4. AI 会不会编造参考文献？

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

5. MATLAB 怎么配合 AI 使用？

AI 可以帮你写 MATLAB 脚本、修复代码报错、解释运行结果。你只需要把脚本路径或报错信息发给 AI，AI 就能直接操作。确保 OpenCode 有权限访问 MATLAB 的可执行文件。

6. 对话太长怎么办？

及时新开对话（不是新建智能体），以降低 token 消耗。

十、总结

使用 OpenCode 桌面版 + 速创API，可以让 AI 读取本地资料、整理文献、辅助写作，并在权限允许的情况下运行 MATLAB 等命令行软件。

但请记住：

AI 是参考工具，不是论文代写工具

文件路径要完整复制给 AI

参考文献必须人工核对

专业软件必须支持命令行或脚本调用，AI 才可能稳定操控

MATLAB 支持命令行调用，适合作为 Agent 辅助科研计算的工具之一

实操案例：OpenCode 桌面版辅助论文写作

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

一、准备工作#

二、注册速创API中转站#

三、创建 API Key#

四、下载安装 OpenCode 桌面版#

安装 Git（推荐）#

五、让内置 AI 帮你配置 OpenCode#

5.1 最简单的方法：直接让 AI 配#

5.2 其他常用指令#

5.3 推荐开启的设置#

5.4 权限设置建议#

六、实操：让 AI 读取参考文献并写论文#

6.1 准备论文资料#

6.2 复制文件或文件夹路径#

6.3 给 AI 一个明确的任务#

6.4 让 AI 输出论文格式#

七、完整论文工作流#

八、常用提示词模板#

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

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

模板 3：检查论文段落#

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

九、常见问题#

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

2. 为什么 AI 不能操控某个软件？#

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

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

5. MATLAB 怎么配合 AI 使用？#

6. 对话太长怎么办？#

十、总结#