core/editor/vscode/README.md

Dever for VS Code

为 .dever 提供高亮、悬浮说明、源码跳转和调用流程。

安装

从 发布页 下载 dever-language-0.0.1.vsix，在 VS Code 执行 Extensions: Install from VSIX。

插件默认调用 PATH 中的 dever，需要带 inspect 的编译器。可用 dever.command 设置命令及固定参数，值为数组；远程执行时，编译器须能读取相同的源码路径。未信任的工作区不会执行编译器。

使用

操作	功能
悬浮函数	显示签名、主题说明和调用摘要
F12	跳转定义
Shift+F12	查看引用
显示调用层次结构	查看调用方和被调用方
Dever: Preview Documentation	打开主题说明
Dever: Show Calls	查看每处调用及源码位置
Dever: Open Domain Links	阅读领域调用图

源码与说明保存后刷新索引。未保存修改或源码检查错误会暂停相关导航并提示原因。查询不运行应用，也不调用 AI。

调用图内置 Mermaid，可离线阅读和点击节点跳转。修改代码后生成流程：

dever inspect . --links
dever inspect . --links --check

图保留分句、参数求值顺序、短路、集合处理、任务、事务和 Port/Adapter 选择。它展示可能执行的路径；部署配置决定实际 Adapter。

当前支持函数、API/CMD、REST、认证、Job、回调、SQL 和 Port/Adapter 导航，尚不提供通用类型和字段引用导航。源码与说明的组织见 说明写法。

开发插件

在本目录执行：

npm ci
npm run build
DEVER_TEST_BIN=/path/to/dever npm run test:navigation
npm test -- --markdown-grammar /path/to/markdown.tmLanguage.json
npm run package

流程图浏览器测试使用 npm run test:flows，需设置 DEVER_TEST_BIN 和 DEVER_BROWSER_TOOLS，后者指向已有 playwright-core、Chromium 的 node_modules；系统库路径按测试环境设置。

构建会把 Markdown 解析器和 Mermaid 放入 VSIX，用户无需另装 npm 或渲染库。开发阶段版本统一为 0.0.1。