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。