CytStudio 帮助文档

欢迎使用 CytStudio！CytStudio 是面向嵌入式开发者的 IDE，集成内置 AI 编程智能体、J-Link 硬件调试、CMSIS-Pack / FLM 烧录、Clang 静态分析与项目迁移。本文将帮助你快速上手。

安装说明

系统要求

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

下载与安装

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

AI 智能体：CytStudio 集成了开源的 DeepSeek Harness，随安装包内置，无需额外配置即可使用。在线可连接 DeepSeek / Pi 等云端模型；如需完全离线运行，请接入你自己的本地 AI 模型（见下文「AI 编程智能体」章节）。

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

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

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

目前已验证以下版本：

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

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

目前已验证以下版本：

如需 GDB 调试服务，请一并安装对应的 Arm GNU 工具链配套版本。

快速开始

创建新项目

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

导入现有项目

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

导入步骤：

1. 点击 文件 → Project Wizard
2. 选择对应的项目文件
3. 自动提取源文件、包含路径、宏定义、芯片型号、CPU/FPU、链接脚本等配置
4. 检查并确认导入设置后点击 下一步，按向导完成工程导入
5. IAR / Keil 等特有的语法差异，可交给内置 AI 智能体协助修复

主要功能

AI 编程智能体（DeepSeek Harness）

CytStudio 集成了开源的 DeepSeek Harness 作为唯一的 AI 编程智能体，能读取、编写、构建并调试代码，并把 28+ 项 IDE 能力注入对话。

• 在线模型：连接 DeepSeek、Pi 等云端模型，或任意 OpenAI 兼容接口
• 离线模型：接入你自己的本地 AI 模型（如通过 llama.cpp / Ollama 暴露的 OpenAI 兼容端点）即可完全离线运行，无需公网

它支持的能力：

• 代码生成 / 改写：描述需求，直接读、写、改文件
• 构建与调试驱动：在对话里触发编译、J-Link 调试（28+ IDE 工具桥接）
• 代码解释与审查：选中代码解释功能、整体审查、定位 Bug
• 子智能体与工作流：为复杂任务拆分角色（含 Claude Code / Codex）
• 丰富的工具与资源：文件、Shell、网页搜索、终端、目标/待办、Excel、PDF、MCP 客户端
• 技能系统：用户自定义技能热重载；插件市场（dshmarket）可浏览安装智能体插件
• 权限与沙箱：信任梯度权限预设（Plan → Default → AcceptEdits → Bypass），高风险操作可触发用户确认；沙箱化执行 bash / PowerShell / 文件系统
• 会话管理：可搜索会话、自动标题、检查点与日志导出

模型选择：默认使用内置的 DeepSeek Harness 配置，在线即可连接 DeepSeek / Pi；若需本地离线推理，请在 AI 设置 中把模型端点指向你自己的本地模型服务。构建失败、断点触发等 IDE 事件会作为上下文自动注入，唤醒智能体诊断。

代码编辑器

• Clang 语义引擎：上下文感知的代码补全、实时诊断、语义高亮、跳转到定义
• 分屏编辑：水平 / 垂直分屏，支持跨组拖拽标签页
• 符号导航：大纲视图、跳转历史、搜索定位、缩略图
• 多编码支持：自动识别 GBK / UTF-8，一键转码，杜绝中文乱码
• 多格式查看：内置 Markdown、PDF、图片快速查看器

编译与构建

• GCC / Clang 双编译器：根据项目配置自动选择
• 增量编译：仅重编译变更的源文件，大幅加快构建速度
• 构建消息：结构化输出（错误 / 警告 / 备注），双击跳转到对应代码位置
• CMSIS-Pack RTE 集成：勾选的 Pack 组件自动把源码、宏、头文件路径并入每次构建

CMSIS-Pack 与 FLM 片内烧录

• CMSIS-Pack 管理器：浏览、安装、移除 Packs，设备支持自动接入构建
• 组件选择：从组件树中选择（如 CMSIS-DSP），源码 / 宏 / 包含路径自动并入
• 只读组件树：Keil 风格展示，带灰色锁定徽标，双击打开只读源码
• FLM 算法引擎：解析 Keil 风格 .flm 算法（基础地址、大小、扇区几何），在 RAM 内执行片内擦除与编程
• 算法自动选择：优先 J-Link 内建、其次安装的 Pack FLM，找不到也能可靠回退
• 烧录进度 UI：擦除、编程、校验各阶段可视化进度

硬件调试（J-Link）

1. 连接 J-Link 调试器到目标板
2. 在 CytStudio 中配置调试器类型和目标芯片
3. 点击 调试 → Debug 进入调试会话

支持的功能：

• 断点设置（逻辑断点 / Flash 硬件断点 / 数据观察点）
• 单步执行（逐行进入、逐行跳过、逐指令）
• 寄存器视图（CPU + 外设寄存器）
• 内存视图（十六进制转储，可配置列宽）
• 变量监视与 C 表达式求值（DWARF 树泛化展开）
• 反汇编视图（源码 / 汇编混合）
• Call Stack 调用栈回溯（帧精确）
• 断点管理器
• FreeRTOS 任务监控（任务、栈使用、运行时统计、CPU 负载、状态时间线）
• Attach 附加调试（无需复位）
• Download / Erase 单独下载与擦除功能
• 高速采样（微秒级多点采样，实时波形显示）

数据可视化

1. 在调试会话中，打开 视图 → Oscillograph 面板
2. 从变量表中选择要绘制的变量
3. 波形实时滚动显示，支持：
   • 多通道叠加，每通道独立配置名称 / 颜色 / 缩放 / 偏移
   • 缩放与平移、跟随模式
   • A/B 双光标测量、触发电平、十字准线读数
   • CSV / 图像导出

静态代码分析

• 分析类型：控制流图 (CFG)、调用图、交叉引用、圈复杂度、Halstead 度量、嵌套深度、包含图、重复代码、继承分析、递归检测
• 可视化：交互式图（缩放 / 平移 / 节点选择）
• 导出：PNG / SVG 高清图像、HTML 完整报告、CSV 结构化数据

工程与 Git

• Git 集成：工作树状态、diff、日志图谱、分支管理、内置 Git 终端
• 多标签终端：PowerShell / Git Bash / CMD，VSCode 风格，主题适配
• 主题系统：暗 / 高对比暗 / 亮 三套主题，可自定义强调色
• 多语言切换：中文 / English 一键切换（设置 → 语言，重启生效）

快捷键

常见问题

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

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

Q: J-Link 连接失败？

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

Q: 内置 AI 智能体如何打开？

智能体面板默认随 IDE 打开，无需额外配置即可使用。若找不到，可在菜单或侧栏中找到智能体入口。

Q: 如何切换模型 / 使用本地模型离线运行？

在 AI 设置 中配置模型端点：

• 在线：填入 DeepSeek / Pi，或任意 OpenAI 兼容接口的地址与密钥即可
• 离线：将端点指向你自己的本地模型服务（如通过 llama.cpp / Ollama 暴露的 OpenAI 兼容接口），即可完全离线运行，无需公网

Q: 智能体提示“需要权限确认”？

内置智能体使用信任梯度权限预设（Plan → Default → AcceptEdits → Bypass）。高风险操作（写文件、执行 Shell、访问网络）会触发用户确认对话框，你可选择允许或拒绝；部分预设下也会启用沙箱化执行。

Q: 如何检查更新？

点击 帮助 → 检查更新，或在启动时由应用自动检查。更新对话框会展示发布说明，并支持“强制更新 / 跳过此版本”。

获取帮助

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

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