🚀 DeepSeek AI Studio for MATLAB

📖 简介 (Introduction)

DeepSeek AI Studio for MATLAB 是一款深度集成到 MATLAB 环境中的智能编程插件。它利用最先进的 DeepSeek-V3（极速对话）和 DeepSeek-R1（深度推理）大模型，彻底改变您的科研与开发工作流。

不再需要频繁切换浏览器查文档或搜索代码，DeepSeek Copilot 直接在 MATLAB 中为您提供代码生成、自动纠错、算法推演和官方文档级知识查询服务。

✨ 核心功能 (Key Features)

1. 🧠 双模型驱动 (Dual-Model Engine)

标准模式 (DeepSeek-V3)：毫秒级响应，适用于快速生成绘图代码、数据处理脚本和简单函数。
深度思考模式 (DeepSeek-R1)：勾选深度思考 (R1) 即可启用。适用于复杂的数学建模、算法推导及逻辑严密的代码设计。AI 会在终端展示详细的 思维链 (Chain of Thought)，让您看到 AI 是如何思考的。

2. ⚡ 智能代码生成与执行 (Code Gen & Run)

自然语言交互：只需输入 "读取 data.csv 并绘制热力图"，即可一键生成完整、可运行的 MATLAB 代码。
一键运行：生成的代码自动注入编辑器，点击 [▶ 运行] 即可直接在 MATLAB 工作区执行，结果立即可见。

3. 🔧 自动诊疗修复 (Auto-Fix & Diagnosis)

遇到报错？别担心！

智能捕获：自动捕获 MATLAB 命令行报错信息。
一键修复：点击 [🔧 修复]，AI 会分析错误原因，并直接修改代码。
代码审查：在无报错情况下，AI 会对当前代码进行 Code Review，提供性能优化建议。

4. 📚 智能知识库 (Smart Knowledge Base)

官方文档风格：内置 [🔍 知识查询] 功能，模拟 MathWorks 官方文档排版，支持富文本渲染。
深度推演：查询请求强制使用 R1 模型 进行深度推理，确保回答的准确性和深度。
一键直达：回答中引用的函数（如 fft, plot）会自动生成超链接，点击即可调用系统浏览器跳转至 MathWorks 官网对应页面。

5. 🎁 灵感彩蛋 (Inspiration Easter Eggs)

缺乏灵感？点击 [🎁 彩蛋] 按钮。
内置 100+ 高质量提示词库，涵盖混沌数学、物理仿真、图像处理、游戏开发等领域。
随机生成如“绘制动态洛伦兹吸引子”、“模拟双摆混沌”等有趣案例，一键生成酷炫代码。

6. 🛡️ 安全与持久化 (Security & Persistence)

API Key 安全存储：使用 MATLAB 标准 setpref 机制存储密钥，无需修改源码文件，安全且永久有效。
沙箱保护：自动屏蔽 clear, clc, close all 等可能导致用户数据丢失的危险命令。

📥 安装与使用 (Installation)

环境要求

MATLAB R2021a 或更高版本（推荐 R2023b 以获得最佳 UI 体验）。
有效的 DeepSeek API Key（需在 DeepSeek 开放平台申请）。

安装步骤

方法一：直接运行源码（推荐开发调试）

下载本项目中的 DeepSeekCopilot.m 文件。
将文件放置在 MATLAB 的当前工作目录或路径中。
在 MATLAB 命令行输入：
app = DeepSeekCopilot();

方法二：安装 APP 包（推荐日常使用）

下载 DeepSeekCopilot.mlappinstall（如有提供）。
双击文件安装到 MATLAB Apps 栏。
点击图标即可启动。

首次配置

启动软件后，点击右上角的 [⚙ 设置] 按钮。
在弹出的对话框中粘贴您的 DeepSeek API Key（以 sk- 开头）。
点击确定，Key 将自动保存，下次启动无需再次输入。

🎨 界面概览 (Screenshots)

💡 使用技巧 (Tips)

Prompt Engineering：描述越具体，代码越准确。
- ❌ “画个图”
- ✅ “画一个三维曲面图，X和Y范围是-5到5，Z是sin(sqrt(x^2+y^2))，使用 jet 颜色映射，并添加颜色栏。”
利用 R1 模型：对于“如何实现卡尔曼滤波”或“推导二体问题轨道”这类复杂问题，务必勾选 深度思考 (R1)，虽然生成速度稍慢，但逻辑质量极高。
多轮迭代：生成的代码如果不完美，可以在输入框继续输入修改意见（如“把线条改成红色虚线”），然后再次点击生成。

❓ 常见问题 (FAQ)

Q: 为什么点击“知识查询”里的链接没有反应？
A: 请确保您使用的是最新版 (V0.4.1+)。新版本已支持调用系统默认浏览器打开链接。如果仍无法打开，请检查 MATLAB 的 web 函数权限设置。
Q: 深度思考模式 (R1) 为什么反应比较慢？
A: DeepSeek-R1 是推理模型，它在输出最终答案前会进行大量的思维链推导（Chain of Thought）。这通常需要 10-60 秒的时间，请耐心等待终端中的思考过程输出。
Q: 这里的代码会上传到服务器吗？
A: 您的代码和提示词仅会发送给 DeepSeek 官方 API 用于生成结果。本软件完全开源，没有任何第三方数据收集行为。

🤝 贡献与支持 (Contribution)

欢迎提交 Issue 或 Pull Request！如果您觉得这个工具好用，请给本项目点一个 ⭐ Star！

Author: 林南橘
Feedback: 请在 GitHub Issues 中反馈 Bug 或建议。

Designed with ❤️ for the MATLAB Community

DeepSeekMatlabCopilot

Install / Use

README