vn-code：跨平台 Node.js

24次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 vn-code

30 秒速读：想给 AI Agent 一个能写代码、看 Git 历史、处理音视频的工作台，又希望人随时能接管——IDE 太重，纯终端又不够直观。本篇讲的是 vn-code：一个基于 DSH 的跨平台 Node.js Agent-Human ADE，它以浏览器为统一界面，把文件、代码编辑（CodeMirror 6）、只读 Git 历史、图像、音频、媒体处理、SuperCollider 音频能力都做成可安装插件（纯 JavaScript bundle，不依赖 npm 包），Windows、macOS、Linux 都有启动脚本。关键词：vn-code。

软件信息一览

项目	说明
项目名称	vn-code
项目定位	基于 DSH harness 的跨平台 Node.js Agent-Human ADE（Agent 与人协同的开发环境）
技术栈	Node.js 应用 + DSH harness；Rust 负责组装 harness 目录并提供轻量启动器
界面	浏览器（启动器不内置浏览器窗口，桌面模式也走本机浏览器访问 Web 应用）
插件体系	纯 JavaScript bundle，不依赖 npm 包；覆盖文件、代码编辑、Markdown 预览、只读 Git 历史、图像、音频、媒体、SuperCollider
代码编辑	vendored CodeMirror 6，文本/代码标签、Markdown 预览、保存与创建操作
媒体处理	固定版本 ffmpeg，经 SHA-256 校验；提供探测、处理与视频帧接口
音频能力	SuperCollider 插件经长期运行的 sclang 会话向 Agent 暴露音频操作工具
Git 历史	只读图形界面：提交、合并、PR 标记、受影响文件（只能看，不能写）
平台	Windows（.bat）、macOS / Linux（.sh）
前提	Node.js 运行环境、DeepSeek 密钥
许可证	以仓库 LICENSE 文件为准（使用前请先确认）

版本选择：先跑 run-web 验证界面和插件，再决定装不装桌面启动器

结论先行：run-web 是验证”浏览器界面 + 插件能不能用”的最短路径——它启动固定版本的 harness 并打开本地 URL，一步到位。run-desktop 会构建 vncode 启动器、按需安装插件包并索要 DeepSeek 密钥，步骤多、变量多，留到第二步。

取用方式	适合谁	风险点
run-web	第一次上手、只想看界面和插件长什么样的人	只是验证，很多能力要到桌面模式才完整
run-desktop	界面看顺眼了、准备正式用起来的人	要构建启动器、装插件包、配 DeepSeek 密钥，一步错步步错
锁定 .dsh-version.json 的版本	已经跑顺、要长期用的工作台	harness 和 ffmpeg 都是固定版本，脱离版本文件单独升级会破坏校验

推荐路线：run-web 跑通 → 逐个试你的目标插件（先读各插件自己的 README）→ 再跑 run-desktop → 长期用就锁定 .dsh-version.json 的版本，别手贱单独升级组件。版本策略以仓库实际发布说明为准。

上手只盯 4 个卡点

Node.js 先装对版本。整个应用跑在 Node 上，版本对不上后面全是玄学报错。先按 README 确认版本要求，装完跑个 node -v 对一下，别跳过这一步。
DeepSeek 密钥是硬门槛。run-desktop 会请求 DeepSeek 密钥，没有它 Agent 能力起不来。先把密钥准备好，国内网络环境下先实测访问通不通，不通后面全白搭。
启动脚本先给执行权限。macOS / Linux 的 .sh 脚本要先 chmod +x，Windows 用 .bat。权限没给，脚本点都点不动——这是最常见又最没技术含量的卡点。
别脱离 .dsh-version.json 升级。harness 和 ffmpeg 都是固定版本 + SHA-256 校验的，单独升级某个组件大概率破坏校验。先读懂版本文件，再决定动不动。

落地前必做的 4 项配置

DeepSeek 密钥与访问方式。入口：run-desktop 的密钥配置流程。体感差别：这是 Agent 能力的总开关——密钥配通之前，工作台只是个能看不能干的浏览器页面；配通之后，Agent 才能真正上手干活。
插件按需安装。入口：插件包安装流程（各插件 README）。体感差别：插件覆盖文件、代码、Git 历史、图像、音频、媒体、SuperCollider，不是一次全装——先装你要用的那几个，每个插件的行为以它自己的 README 为准，别按名字猜功能。
媒体 ffmpeg 校验确认。入口：固定 ffmpeg 副本的 SHA-256 校验。体感差别：媒体探测、处理、视频帧接口都依赖这个固定副本，校验不过就别往下走了，换源重下比排错快得多。
Git 历史只读范围心里有数。入口：Git 历史插件（只读图形界面：提交、合并、PR 标记、受影响文件）。体感差别：它只能看不能写——别指望在这里提交、建分支、合并，写操作回你的终端或 IDE，别在工作台里干等。

先看 4 条注意事项，再决定用不用

Git 历史是只读的。仓库明确它是只读界面，不能据此推断它有提交、分支、合并写入能力。把它当”可视化 git log”，别当”可视化 git”。
启动器不内置浏览器。桌面模式最终还是通过本机浏览器访问 Web 应用。想要原生桌面窗口、完整 IDE 发行版感觉的人会失望，先确认你能接受”浏览器即界面”。
插件行为以各插件 README 为准。总 README 只列了部分插件和能力，其他插件的文件访问范围、行为边界要逐个看。别按插件名字脑补功能，读文档比试错便宜。
公开信息有限，别只看热度下结论。不同操作系统上的脚本兼容性、权限要求、长期维护状态，都要结合源码判断。仓库热度不等于生产可用，评估时逐项核对前提条件。

适合谁用：想研究 DSH + 插件 + Agent 组合的人

适合：希望在浏览器界面里管理代码、文件、媒体和工程工作流，并想把 DSH、插件与 Agent 技能组合起来的开发者和设计工程人员；能接受脚本化部署、愿意逐个读插件 README 的人。

不适合：要原生桌面窗口、完整 IDE 发行版、或明确企业支持的人——它给不了这些，先验证再决定，别装完才发现气质不合。

横向看一眼：VS Code + Agent 插件是”编辑器里加 Agent”；vn-code 是”浏览器工作台里，Agent 和人共用一套插件”；纯终端 Agent 则完全没有可视化界面。三条路线解决的是不同的协作姿势，选的是姿势，不是优劣。

一句话总结：vn-code 最值钱的不是”又一个编辑器”，而是把 DSH harness、插件、浏览器界面拼成了一套”Agent 和人能同时上手”的工作台——插件无 npm 依赖、媒体走固定校验的 ffmpeg、Git 历史只读可视化，每一块的边界都写得很清楚。接受它的实验气质，它就是研究 Agent-Human 协作的一个好起点。