如何为自定义ISA汇编指令添加IDE鼠标悬停说明？

• 核心逻辑：VSCode的鼠标悬停提示功能，本质是由对应语言的**语法扩展（Language Server/Extension）**实现的。Doxygen是静态文档生成工具，无法直接提供IDE实时提示，但你采用的Doxygen风格注释可以被扩展识别并复用。

• 具体实现步骤：

  1. 统一注释规范：继续使用你给出的Doxygen风格伪C注释（或调整为适配汇编的格式），完整记录每条指令的功能、语法、参数说明。示例（已汉化）：

     /**@{*/
     /**
      * @brief   AND - 按位逻辑与
      * 汇编语法     AND ar, as, at
      * @param ar - 结果寄存器
      * @param as - 源寄存器1
      * @param at - 源寄存器2
      * AND指令计算地址寄存器as和at的按位逻辑与，结果写入地址寄存器ar。
      */
     and(ar, as, at);
     

  2. 适配VSCode扩展：
     • 若已有自定义ISA的VSCode扩展，需修改扩展的语言服务模块，添加注释解析逻辑，让它识别Doxygen风格注释，并在悬停时提取内容展示。
     • 若无现成扩展，可开发轻量扩展：借助VSCode的HoverProvider API，编写匹配规则关联汇编指令与对应注释，悬停时返回解析后的提示文本。
  3. 关联注释与指令：确保注释和对应指令有明确的映射关系（比如注释紧跟指令定义，或通过命名规则绑定），保证扩展能精准匹配。

• 各工具的角色：

  • VSCode：仅提供悬停提示的UI展示框架，不负责注释解析，依赖扩展实现核心功能。
  • Doxygen：主要用于生成离线静态文档，不能直接提供实时悬停，但你写的Doxygen风格注释可以被扩展复用，无需额外调整格式。

内容的提问来源于stack exchange，提问作者peter_esp