CytStudio 帮助文档

欢迎使用 CytStudio！本文档将帮助你快速上手。

安装说明

系统要求

• 操作系统：Windows 10 / 11 (64-bit)
• 内存：建议 4 GB 及以上
• 硬盘空间：至少 3G 可用空间

下载与安装

1. 前往 GitHub Releases 页面
2. 下载最新的 Windows 安装包（.exe 文件）
3. 双击运行安装程序，按照向导完成安装
4. 安装完成后，开始菜单栏会出现 CytStudio启动程序

安装 J-Link（调试功能必需）

如需使用下载、调试、寄存器查看、Watch、Memory 等功能，请提前安装 J-Link 软件包。

• 下载地址：SEGGER - J-Link / J-Trace Downloads

目前已验证以下版本：

安装 GCC 工具链（编译功能必需）

如果您熟悉 Clang，则无需安装 GCC — CytStudio 已内置 Clang 编译器。

目前已验证以下版本：

快速开始

创建新项目

1. 打开 CytStudio，点击 工程 → New Project
2. 选择项目所在文件夹根目录，点击 保存，项目将在左侧文件树中显示
3. 点击 工程 → Options 配置芯片类型、构建、工具链、调试等
4. 文件树右键属性里，可以对文件进行Git、增删、重命名等操作

导入现有项目

CytStudio 支持导入以下格式的项目：

• STM32CubeMX (.ioc)
• IAR EWARM (.ewp)
• Keil MDK (.uvprojx)

导入步骤：

1. 点击 文件 → Project Wizard
2. 选择对应的项目文件
3. 自动提取源文件、包含路径、宏定义等配置
4. 检查并确认导入设置后点击 下一步，根据向导完成工程导入
5. IAR/Keil等特有的语法，使用CytMind修复

主要功能

AI 编程助手 (CytMind)

CytMind 是你的嵌入式开发 AI 伙伴，支持：

• 代码生成：自然语言描述需求，自动生成代码
• 代码解释：选中代码，让 AI 解释其功能
• Bug 修复：描述问题，AI 自动诊断并提供修复方案
• 代码审查：对整个文件或模块进行审查

使用前请先在设置中配置 AI 模型（支持 OpenAI 兼容接口和 Anthropic Claude）。

代码编辑器

• Clang 语义引擎：上下文感知的代码补全、实时诊断、语义高亮
• 分屏编辑：水平/垂直分屏，支持跨组拖拽标签页
• 符号导航：大纲视图、跳转历史、搜索定位
• 多编码支持：自动识别 GBK / UTF-8，一键转码

编译与构建

• GCC / Clang 双编译器：根据项目配置自动选择
• 增量编译：仅重编译变更的源文件，大幅加快构建速度
• 构建消息：结构化输出，双击跳转到对应代码位置

硬件调试 (J-Link)

1. 连接 J-Link 调试器到目标板
2. 在 CytStudio 中配置调试器类型和目标芯片
3. 点击 调试 → Debug 进入调试会话
4. 支持的功能：
   • 断点设置（逻辑断点 / Flash 硬件断点）
   • 单步执行（逐行 / 逐指令）
   • 寄存器视图
   • 内存视图
   • 变量监视与表达式求值
   • 反汇编视图
   • Callback调用栈视图
   • 断点管理器
   • FreeRTOS 任务监控
   • Attach 附加调试
   • Download / Erase 单独下载和擦除功能

数据可视化

1. 在调试会话中，打开 视图 → Oscillograph 面板
2. 从变量表中选择要绘制的变量
3. 波形实时滚动显示，支持：
   • 多通道叠加
   • 缩放与平移
   • 光标测量
   • CSV / 图像导出

快捷键

常见问题

Q: 编译报错"找不到工具链"？

请检查设置中的工具链路径是否正确，确保 GCC 或 Clang 已正确安装。

Q: J-Link 连接失败？

1. 检查 J-Link 驱动是否已安装
2. 确认目标板已上电
3. 检查连接线是否正常
4. 在设备管理器中确认 J-Link 被正确识别

Q: AI 助手无法使用？

1. 确认网络连接正常
2. 检查 API Key 是否已正确配置
3. 确认 API 端点地址是否正确

获取帮助

• GitHub：github.com/cytstudiooo/cytstudio
• 邮箱：cyte_studio@foxmail.com

文档持续更新中，如有疑问欢迎通过反馈中心提交！