Files
IC-Coder-Plugin/media/USER_MANUAL.md
Roe-xin a25d68f527 feat: 添加用户手册只读预览功能
- 新增 UserManualPanel 组件实现只读预览
   - 支持 Markdown 完整渲染(表格、代码块、图片、分隔线)
   - 优化排版和字体大小
   - 用户无法编辑手册内容
2026-03-10 17:01:16 +08:00

7.8 KiB
Raw Blame History

IC Coder 插件端用户手册

欢迎宁德时代新能源科技股份有限公司的各位专家使用 IC Coder 企业版!

本手册旨在为贵公司提供插件的安装、配置及使用指导,帮助您快速上手并充分发挥工具的功能。

在使用过程中,如遇任何功能异常、性能问题或操作疑问,欢迎随时联系我们,我们将在第一时间为您提供支持。

若贵司有特定的业务场景或个性化功能需求,也可直接与我们沟通,我们会为贵司进行定制化开发。

功能 说明
自研微调模型 IC Coder 自研顶尖 Max 微调模型,专为 FPGA 开发
高质量 Verilog 代码生成 根据自然语言描述生成符合规范的 Verilog 代码
自动语法检查 自动检测代码语法错误并自动修复
自动仿真 内置编译器,自动编译和仿真
波形检查工具 内置 VCD 波形查看器,自动波形解析
自主检查迭代 AI 自动检查代码问题并迭代优化
Diff 功能 快速比较代码差异,追踪 AI 修改,可一键确认和撤销修改
Code Action 快捷操作 Ctrl+L 快捷键或右键菜单快速添加代码到对话
支持上下文连续对话 多轮对话AI 记住之前的交互内容
会话历史管理 自动保存对话记录,随时恢复历史会话

IC Coder 快速入门指南

系统要求

  • Visual Studio Code: 版本 >= 1.60.0

各位专家也可以通过这个链接下载VSCode 下载链接


安装步骤

步骤 1通过 VSIX 文件安装(推荐)

  1. 获取安装包

    • 确保您已经获得 iccoder-Trial-1.0.vsix 文件
  2. 打开 VS Code

    • 启动 Visual Studio Code
  3. 安装插件

    有以下三种安装方式:

    方式 A通过命令面板

    • Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS) 打开命令面板
    • 输入 Extensions: Install from VSIX...
    • 选择 iccoder-Trial-1.0.vsix 文件
    • 等待安装完成

    安装方式1.png

    方式 B通过扩展视图

    • 点击左侧活动栏的扩展图标(或按 Ctrl+Shift+X
    • 点击扩展视图右上角的 ... (更多操作)
    • 选择 从 VSIX 安装...
    • 选择 iccoder-Trial-1.0.vsix 文件

    安装方式2.png

    方式 C通过命令行

    code --install-extension iccoder-Trial-1.0.vsix
    
  4. 重启 VS Code

    • 安装完成后,建议重启 VS Code 以确保插件正常加载

步骤 2打开 IC Coder 界面

登录后会自动打开,手动打开也有以下几种方式:

方式 1通过侧边栏

  • 点击左侧活动栏的 IC Coder 图标
  • 侧边栏会显示 IC Coder 聊天界面

侧边栏打开.png

方式 2通过命令面板

  • Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (macOS)
  • 输入以下命令之一:
    • IC Coder: 打开聊天 - 打开聊天界面
    • 打开 IC Coder 助手 - 打开助手面板

命令面板打开.png


步骤 3开始使用

插件已预配置好后端服务,安装后即可直接使用,无需手动配置。

聊天界面.png

故障排除

问题 :插件无法安装

症状:安装 VSIX 文件时报错

解决方案:

  • 确认 VS Code 版本 >= 1.60.0

  • 检查 VSIX 文件是否完整(未损坏)

  • 尝试以管理员权限运行 VS Code

  • 清除 VS Code 缓存后重试

完整使用流程示例

下面通过一个完整的案例,展示如何使用 IC Coder 从需求到代码生成的全过程。

步骤 1输入设计需求

在对话框中输入设计需求,例如:

我需要设计一个 8 位加法器,要求有进位输入和进位输出

点击发送按钮。

输入需求.png

步骤 2AI 询问补充信息

AI 会根据需求,询问一些关键的设计细节。例如:

  • 是否需要溢出检测?
  • 时钟频率要求是多少?
  • 是否需要流水线设计?

您只需要根据实际需求选择相应的选项或者直接输入需求即可AI 会根据您的选择生成最合适的设计方案。

步骤 3确认 AI 生成的任务列表

AI 会根据您的需求和补充信息生成一个详细的任务列表Todo List

确认任务.png

仔细查看任务列表,确认无误后点击确认按钮AI 将开始执行。

步骤 4观察 AI 执行过程

AI 开始工作后,您可以在对话框中实时看到所有执行步骤:

观察执行过程.png

每个步骤完成后,任务列表中对应的项目会被标记为完成状态。

步骤 5仿真运行与结果查看

当 AI 完成代码生成后,会自动运行仿真验证:

仿真运行结果.png

步骤 6查看生成的文件

所有生成的文件会自动保存到您的工作目录中:

project/
├── src/
│   └── tb_adder_8bit.v       # RTL 设计文件
├── sim/
│   └── tb_adder_8bit         # 测试平台文件
└── tb_adder_8bit.vcd         # 波形文件

您可以在 VS Code 的文件资源管理器中直接打开这些文件进行查看或修改。

步骤8继续对话

如果您对给出的结果不太满意您可以告诉IC Coder您想具体修改的地方或者文件

使用流程总结

整个使用流程可以概括为:

  • 输入需求 → 在对话框中描述您的设计需求
  • 回答问题 → 根据 AI 的询问选择合适的选项
  • 确认任务 → 查看并确认 AI 生成的任务列表
  • 观察执行 → 实时查看 AI 的所有执行步骤
  • 查看结果 → 仿真成功后查看生成的文件

使用提示

如何描述需求更准确?

  • 明确功能:清楚说明模块要实现什么功能
  • 指定参数:说明位宽、时钟频率等关键参数
  • 特殊要求:如果有特殊的时序要求或接口规范,请明确说明

示例:

好的描述:设计一个 16 位的 FIFO深度为 256支持异步读写
不够清晰:帮我写一个 FIFO

常见问题

Q: 仿真失败了怎么办? A: AI 会根据错误自动修复代码并重新仿真。

Q: 可以修改生成的代码吗? A: 可以,可以直接编辑文件,然后告诉 AI 重新运行仿真。

Q: 可以导入已有的代码吗? A: 可以,在工作区中打开对应的代码文件夹,然后直接在对话中告诉 AI 您要修改或优化哪个文件AI 会读取并进行修改。

Q: 如何查看 AI 的思考过程? A: 在执行过程中AI 会实时显示每一步的操作和决策依据。

Q: 如何保存对话历史? A: 对话历史会自动保存在本地,可以点击历史对话查看历史会话记录。


卸载插件

如需卸载插件:

  1. 打开扩展视图
  2. 找到 "IC Coder" 插件
  3. 点击卸载按钮
  4. 重启 VS Code

注意事项

  1. 需提前打开一个文件夹作为工作区,否则会准确的为您服务

    打开文件夹.png

  2. 开箱即用

    • 插件已预配置后端服务,无需手动设置
    • 安装后即可直接使用所有功能

祝您使用愉快!如有问题欢迎反馈。