Initial Dever 0.0.1

editor/vscode/README.md

@@ -0,0 +1,50 @@
+# 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`。