# Dever for VS Code

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

## 安装

从 [发布页](https://git.dever.cc/dever/core/releases/tag/v0.0.1) 下载 `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，可离线阅读和点击节点跳转。修改代码后生成流程：

```sh
dever inspect . --links
dever inspect . --links --check
```

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

当前支持函数、API/CMD、REST、认证、Job、回调、SQL 和 Port/Adapter 导航，尚不提供通用类型和字段引用导航。源码与说明的组织见 [说明写法](https://git.dever.cc/dever/core/src/branch/main/DOCUMENTATION.md)。

## 开发插件

在本目录执行：

```sh
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`。