编辑器插件合集 vecnode/vn-code

vn-code

智能体与人的 ADE ⌨️ 打包了插件、技能和接口

vncode: the plugin pack, a Node application - the vncode README header

跨平台 Node ADE，内置核心 DSH，面向专业工程与设计：每个插件都是 Node.js（纯 JavaScript 打包，零 npm 依赖），Rust 只负责那个小巧的前门安装器二进制，由它组装 harness home 并启动 launcher。launcher 可在 Windows、macOS 和 Linux 上运行。

运行

| | Windows | macOS / Linux |
| 应用 | scripts\run-desktop.bat | ./scripts/run-desktop.sh |
| 仅浏览器标签页 | scripts\run-web.bat | ./scripts/run-web.sh |

run-web 启动固定版本的 harness，并在 Chrome 中打开它打印的 URL；打不开就回退到你的默认浏览器。run-desktop 在没有 vncode 时先构建它，然后运行：如果当前使用的 home 缺少插件包，就安装插件包；如果没有 DeepSeek 密钥，就询问密钥；随后在前台运行同一个 run-web。

vncode 是个小巧的 Rust 二进制，每个操作系统约 0.5 MB，没有窗口，也不内嵌浏览器：界面就是同一个 Web 应用，跑在你已经在用的浏览器里。它的动词有 start（默认）、install、uninstall、status 和 key；-Help 列出所有参数，app/README.md 用一页讲清整个应用。

cd app
cargo build --release --locked # -> app/target/release/vncode (~0.5 MB)
./target/release/vncode status # the pin, the home, the pack, the key, the launcher
./target/release/vncode # install if needed, key if needed, then run-web
./target/release/vncode key # write DEEPSEEK_API_KEY into <home>/.env
./target/release/vncode -Help # every verb and flag

vncode 自己从不运行 node：它启动 scripts/run-web.，由后者来运行。它做的任何事都不需要窗口、端口或自己的浏览器。
只有 URL 指向回环地址时才会打开，启动 token 也从不写入文件——这两条规则都写在 SECURITY.md 里。

插件

每个包自己的 README 就是参考：它做什么、为什么这样构建、会触碰什么。确切版本见 .dsh-version.json。

| 包 | 新增内容 |
| dsh-vn-master | 无浏览器的 master，最后安装——整包补丁和行重述的落点就在这里（它在 web 配置档上启用 Browser 标签页，并移除反馈界面） |
| dsh-rightbar | 包自带的右侧栏：标签条、停靠面板和 sidebarRight 注册表（随包发布的侧栏的分支） |
| dsh-rightbar-files | 基于该侧栏的 Files 标签页类型 |
| dsh-editor | 文本和代码标签页（内置 CodeMirror 6），带 Markdown 预览和 Save/Create |
| dsh-gittree | 只读的 History 标签页：把工作区的提交画成图轨（泳道、合并、PR 标记），以及每个提交改动的文件 |
| dsh-image | 图片查看器：适配、缩放、平移，并读取指针下的源像素 |
| dsh-audio | 波形界面：WAV/AIFF/FLAC，每个声道一条轨道，dBFS，选区与播放 |
| dsh-media | 智能体能操作的媒体：media_probe / media_run / media_frames，跑在锁定版本、经 SHA-256 校验的 ffmpeg 副本上，外加视频标签页串流用的路由 |
| dsh-supercollider | 智能体能演奏的 SuperCollider：十个 sc_ 工具跑在一个长期存活的 sclang 会话上（热往返约 31 ms，智能体定义的东西下次调用还在），手写的 OSC 客户端连到 scsynth，已安装的 .schelp 参考为 sc_help 建好索引，.scd 文件工作流，还有五个技能教这门语言、SynthDef 和 live coding——其中每个代码示例都经过检查编译。零 npm 依赖，不打包任何东西——它找机器自带的 SuperCollider——自己的界面是一个小控制台标签页，.scd 文件在编辑器里打开 |
| dsh-video | 播放器标签页：串流并拖动任意视频容器，带 ffprobe 信息面板、章节跳转，浏览器解不了码时一键 remux |
| dsh-diagrams | Mermaid、TikZ 和 Diagram Design 套件，既是标签页也是七个智能体工具——套件的 204 个示例和 44 种有文档的类型锁定在某个提交上内置，可在索引页浏览，一次调用即可插入，每次写入（包括自包含的 HTML 文档）都先校验再存储 |
| dsh-frontend-craft | 前端设计工艺：Impeccable 的 Apache-2.0 语料，按固定 commit 内置——24 条命令、41 份参考、工艺底线、四种访客模式和原生平台参考——外加它的 61 条规则检测器，在包内编译为 WebAssembly，所以不需要 npx impeccable，不下载引擎，也不联网。五个 fe_ 工具（fe_context、fe_detect、fe_direction、fe_artifact，以及 fe_render——它用本机自带的 headless Chrome/Edge 渲染工作区里的 HTML 文件或回环 dev-server URL，并测量对比度、点按目标、溢出、行宽、字号、标题层级和缺失的 alt），一副 18 个世界的本地方向牌组，让每次掷出的方向都带着一个智能体没写过的挑战者，还有一个 Frontend 标签页，展示发现项、产物、方向轮次和渲染出的画面。检测器的发现项在自带 fixtures 上与上游命令行 186/186 一致 |
| dsh-shaders | 真正能编译的 GLSL：七个 shader_ 工具驱动本机已有的浏览器——只传 argv、一次性配置档、每个名字都解析为 NOTFOUND——每个答案都标明它实际到达的层级（v1-static → v2-compiled → v3-drawn → v4-measured），每条诊断都映射回你的行号，活跃 uniform 从链接后的程序里读出。五种方言分开处理，因为它们不能互换，而且桌面 GLSL 直接拒绝，不伪造（ANGLE 编译不了）。shader_target 输出独立网页、.frag+.vert 一对、ISF（Resolume 能读）、FreeFrameGL C++ 脚手架——从不构建，FFGL 是 C++ ABI——或者 Shadertoy 名字。语料是 3.1 MB 固定 MIT 着色器：106 个 Radiant 页面，提取出 79 份片段源码，20 个可复用 GLSL 模块、11 个模板、11 件成品和 14 份书面参考，来自 shader-skills，外加一份 48 条链接的精选索引；每个字节都能离线重新推导（vendor//build.mjs --check）。Shaders 标签页画出实时 WebGL 预览，每个 @param 配一个滑块，五个技能教这门语言和排查顺序，检查会编译两个语料里的每个片段，并绘制每件成品 |
| dsh-pdf | 把 PDF 当作智能体能读、能扫描的界面，外加一个带缩略图和书签的阅读器标签页 |
| dsh-ocr | 智能体能读图片：一个 ocr 工具，走 PATH 里的 tesseract，或者在 Windows 上——什么都不用装——走 Windows 自带的 OCR 引擎，它自己就能把 PDF 页面栅格化。会说明引擎、语言和页数，遇到本机没有数据的语言会拒绝，并列出它能读的语言，还会说明每个答案都是转写 |
| dsh-wsl | 本包中 POSIX 的那一半，可在 Windows 上测试：wsl_status（解码启动器输出的 UTF-16 表格，标出默认发行版，并用 probe 检查某个发行版能否真正执行检查）、wsl_run（在某个发行版里运行一个 argv 数组——不是 shell 字符串——带截止时间、进程树终止、每路输出 1 MB 上限，答案里带退出码）和 wsl_path（C:\… ⇄ /mnt/c/…）。它存在的意义，是让 run-web.sh、install.sh 和各项检查的 sh 分支能在写这些脚本的机器上跑起来；在 Docker 机器上，启动器的默认发行版是 docker-desktop-data，所以工具会写明自己用的是哪个发行版 |
| dsh-docker | 把 Docker（或 Podman）当作一层操作面：九个 docker_ 工具，走机器自带的命令行——状态、容器、镜像、inspect、日志、pull、run、生命周期，外加一个 docker_start，负责拉起 Docker Desktop（或 podman machine）并等它的 daemon 就绪——还有一个 Docker 标签页，列出容器和镜像，支持启动/停止/删除、pull 和 run。只走 argv，不走 shell；每次删除都要重复目标名确认；exec、system prune、--privileged 一律不提供写法。在 Windows 11 上，Docker Desktop 关着才是常态：答案会直说，并给出按钮 |
| dsh-ollama | 把 Ollama 当作可度量的操作面：五个 ollama_ 工具，走机器自带的 daemon——状态（磁盘上的模型、当前已加载的模型，以及没人应答时用 ollama serve 起一个）、一次有边界的推理（带 Ollama 报告的 token 数和纳秒级耗时，本包此前没有任何东西读过这些）、少于 3 次就拒绝的基准测试（报告带离散度的中位数，冷启动与热启动在首个 token* 处标明，因为冷加载从不降低 tok/s）、A/B 与 num_ctx 扫描、模型（pull/delete 要重复 tag 确认）、带余弦相似度的嵌入——外加三个技能（REST API、指标算术、Python 客户端），其示例会被一项检查解析；还有一道回环围栏，在任何请求发出前就拒绝另一台机器上的 daemon。daemon 没起来也是一个答案，不是失败 |
| dsh-proto-lab | 一个原型实验室，由智能体填充：五个 lab_ 工具把一次运行写入工作区自己的 <workspace>/lab/<runtime>/<slug>/ —— p5.js 草图浏览器能打开，openFrameworks 项目是三个真实 C++ 文件（src/main.cpp、src/ofApp.h、src/ofApp.cpp），用你自己的 projectGenerator 和 make 构建。运行时注册表让第三种语言只需一个模块加一行（Rust 版 Processing、Cinder），每个技能旁边都放着一个提交进仓库的示例库，由检查驱动，验证是一条明确的阶梯 —— 结构、解析、编译、渲染、测量 —— 答案永远会指出实际到达的层级。实验室本身被 gitignore：发布包只带生成器和示例，从不带运行产物 |
| dsh-research | 研究是一个你留存的文件夹：你的指令和每个关卡的回答都用你自己的话记录，九个 rs_ 工具操作一份只追加的论断与来源台账 —— 除非你确认了问题，否则 rs_write 会拒绝，论断的引文会对照来源核查。数字就是数据（p = .000 会被拒绝），方法记录的筛选计数不能增加，披露记录必须完整 —— 作者、伦理、资助、利益冲突、数据、AI 使用 —— 之后投稿文件夹才会把它印在标题页旁边，绝不放进审稿人看到的手稿。rs_verify action=calibrate 测量读者，标签页在真实浏览器里渲染并测量。八个技能，一个可编辑的标签页，没有 socket，没有子进程，没有任何 vendored 依赖 |
| dsh-browser | 浏览器标签页，取代随包发布的 iframe 版本：页面在主机上、在一个一次性引擎里渲染，出口网关只放行 https（截图、脚本执行后的文本、测量出的样式），供标签页和 browser_render / browser_query / browser_text 使用 —— 已构建并随包发布，但处于关闭状态：主层禁用了这一行，所以配置档不加载标签页、不加载路由、不加载工具，也不加载客户端 bundle |
| dsh-skills | 技能浏览器：缩放控件左侧的头部按钮会打开本次对话加载的每个技能，带 markdown 和行内编辑 |
| dsh-cmdbar | 命令栏：智能体自己的命令放在底部停靠区（对话日志的只读转录 —— 终端已在 alpha.12 中移除；面板跟随屏幕上当前的对话） |
| dsh-themes | 头部控件（主题，含 Nord/Monokai/Hacker/Cyber、截图、页面缩放）、Markdown 纸张、VN 品牌，以及隐藏随包发布的账户菜单 Feedback 行 |
| dsh-ui-state | 包自己的 UI 状态（缩放、主题、停靠区、列宽）在主机侧记住 |
| dsh-modal | 共享对话框界面（modals），包内各控件都用它 |
| dsh-open-in-app | Open In… 打过补丁，直接打开系统文件浏览器 |

这个包以前自带 Files 面板（dsh-files，更早叫 dsh-focus）；后来 harness 长出了真正的右侧边栏，它就被撤下了。安装器会清理掉旧名字，升级时不会重复挂载。

包内附带的第三方内容

有些 bundle 里带着别人的作品。运行时不会去拉取任何东西 —— 配置档以实时链接的方式安装 bundle，所以插件在应用两端都要用的引擎必须落在磁盘上 —— 每棵附带进来的目录树都把自己的上游 LICENSE 放在字节旁边。

| 内容 | 所在 bundle | 如何保证一致 |
| Mermaid 11.17.2（lib/vendor/mermaid.min.js） | dsh-diagrams | node packages/dsh-diagrams/vendor/build.mjs --check 重新计算记录的 sha256 |
| Diagram Design —— 204 个实例、44 种有文档的视觉类型、62 份参考文档，MIT，cathrynlavery/diagram-design | dsh-diagrams | node packages/dsh-diagrams/vendor/design/build.mjs --check 离线对照固定 commit，重新计算整棵 277 文件目录树的哈希 |
| pdf.js 6.3.289（lib/vendor/pdf.min.mjs + worker、cmaps、fonts、wasm） | dsh-pdf | node packages/dsh-pdf/vendor/build.mjs --check，逐文件哈希，外加每棵树的摘要 |
| Impeccable 4.6.0（@2f46b7a，Apache-2.0）—— 24 条命令的技能语料和 41 份参考、61 条规则的注册表，以及用同一份 crates/core + crates/foundation 构建出的检测器，产物为 detect_bg.wasm（4,558,054 字节）+ 它的 CommonJS 胶水层 | dsh-frontend-craft | node packages/dsh-frontend-craft/vendor/impeccable/build.mjs --check 离线对照固定 commit，重新计算每个附带文件的哈希；引擎在这里从该 pin 构建（build-engine.mjs，冷启动 54 s），Apache LICENSE 和 NOTICE.md 放在旁边，VERSION.json 记录四处文本变换以及每一个字节 |
| Radiant —— 106 个 shader 页面、79 份提取出的 fragment 源码，MIT，pbakaus/radiant | dsh-shaders | node packages/dsh-shaders/vendor/radiant/build.mjs --check 离线从已提交的页面重新推导目录；页面逐字节一致，两个无法静态提取的页面会点名并说明原因 |
| shader-skills —— 20 个 GLSL 模块、11 个模板、11 个画廊作品、14 份参考，MIT，gokayfem/shader-skills | dsh-shaders | node packages/dsh-shaders/vendor/shader-skills/build.mjs --check 离线重新推导依赖闭包，目录里记录每个模板由哪个画廊作品证明 |
| awesome-glsl — 48 条链接的精选索引（不含着色器代码），MIT 协议，vanrez-nez/awesome-glsl | dsh-shaders | node packages/dsh-shaders/vendor/glsl-links/build.mjs --check 用来验证 links.json 仍与随包附带的 markdown 一致 |
| p5.js 1.11.13（lib/vendor/p5.min.js，LGPL-2.1） | dsh-proto-lab | node packages/dsh-proto-lab/vendor/build.mjs --check 离线重新计算已记录字节的哈希。特意选 1.x：这是最后一个自带经典脚本浏览器构建的版本线，而从文件系统直接打开的运行时正需要它 |
| CodeMirror 6（lib/vendor/cm6.min.js）以及分叉后随包发布的客户端 bundle | dsh-editor、dsh-rightbar、dsh-open-in-app | bundle 自带的版本标记和分叉树的哈希，两者都由 scripts/checks/ 断言 |

随包附带的代码树在 SOURCE.json/VERSION.json 里写明锁定的版本；只要副本与上游有任何差异，就在 NOTICE.md 里说明：Diagram Design 套件的换行符统一规范为 LF，这样 Windows 上的检出不会报出虚假的漂移，而这是对它唯一的改动。升级锁定版本要慎重——--update-pin、重新构建、审查 diff、运行该包自己的检查。

安全与许可

- AGPL-3.0-only —— 见 LICENSE。版权所有 (C) 2026 vecnode。
这个包是 copyleft 的：你可以运行、研究、修改和分享它，但你分发或通过网络提供的版本必须以同一许可附带源码。这是有意为之——vn-code 不该变成别人工作台上的闭源产品。可按需申请商业例外；关于让这件事成为可能的 CLA，见 CONTRIBUTING.md；关于保留自己许可（Apache-2.0、MIT、LGPL-2.1）且不被本许可重新授权的随包代码树，见 THIRD-PARTY-NOTICES.md。
- SECURITY.md：威胁模型、启动 token、这个包有意运行的代码（其中包括 dsh-supercollider 的解释器及其 eval 路由）、这个包刻意不做的事，以及 check-no-secrets.mjs 如何防止凭据进入提交。按其中所述私下报告漏洞。
- ARCHITECTURE.md 是深入解析；docs/ 收录安装、分发、兼容性和各宿主机的说明。