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

vn-harness

语言：JavaScript
许可证：MIT
DeepSeek Harness 0.1.5-rc.1

DeepSeek Harness 的个人插件包。

所有内容都以标准的 dsh bundles 形式发布。插件是
纯 JavaScript，启动器可在 Windows、macOS 和 Linux 上运行 ——
Windows 那一半是 PowerShell，macOS/Linux 那一半是纯 POSIX shell。

插件（全部为 alpha）

每个包自己的 README 是其功能、为何如此构建以及它触及了什么的参考；
下表是总览。

| 包 | 功能 | 状态 |
|---|---|---|
| dsh-vn-master | README.md | alpha 0.1.0-alpha.1 |
| dsh-rightbar | README.md | alpha 0.1.0-alpha.2 |
| dsh-rightbar-files | README.md | alpha 0.1.0-alpha.1 |
| dsh-editor | README.md | alpha 0.1.0-alpha.9 |
| dsh-gittree | README.md | alpha 0.1.0-alpha.4 |
| dsh-terminal | README.md | alpha 0.1.0-alpha.3 |
| dsh-themes | README.md | alpha 0.1.0-alpha.10 |
| dsh-modal | README.md | alpha 0.1.0-alpha.1 |
| dsh-open-in-app | README.md | alpha 0.1.0-alpha.1 |

该包过去自带一个 Files 面板（dsh-files，更早叫 dsh-focus），
带有私有 dock 和 header 胶囊；当 harness 长出真正的右侧边栏后，
它就被弃用了。现在该包更进一步，通过 fork 它来拥有这个栏本身 ——
参见 packages/dsh-rightbar/README.md 和
scripts/sync-vendored.ps1 重新同步路径。同样的 fork-and-disable 方案
拥有 Open In… 的文件管理器那一半（dsh-open-in-app）。

该包的 master 是它自己的一个 bundle，dsh-vn-master，并且它
故意是空白的：bundle 层加上一行 no-op，没有浏览器那一半、
没有 service、也没有 inject 边。因此右侧栏只保留栏的职责，
而 master —— 最后安装 —— 是放置包级补丁的地方。

安装（Windows、macOS、Linux）

两个启动器，一种行为。Windows 运行 PowerShell 安装程序
（install.bat → scripts/install-all.ps1；Windows PowerShell 5.1 或 7）。
macOS 和 Linux 运行 POSIX shell 安装程序（install.sh →
scripts/install-all.sh），并且只需要带 npm/npx 的 Node.js —— 不需要 PowerShell。
:: Windows - 双击 install.bat，或：
install.bat                  :: web 配置文件（唯一目标）
install.bat -Force           :: 即使版本匹配也重新添加 bundle

macOS / Linux
./install.sh                 # web 配置文件（唯一目标）
./install.sh -Force          # 显式指定；此启动器无论如何都会强制重新添加

或者直接驱动平台脚本：

:: Windows
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/install-all.ps1 -Force

macOS / Linux
sh scripts/install-all.sh -Force

两部分执行相同的工作（幂等——可安全重复运行）：

1. 从 .dsh-version.json 固定 dsh 版本，并通过
npx @deepseek-ai/dsh@ 运行所有内容，
2. 当系统 pnpm 对该配置文件来说足够新时复用它，否则在 ./tools 下引导一个
私有副本（无需管理员权限，不涉及全局），
3. 解析 web 配置文件（$DSH_HOME/profiles/web，$DSH_HOME = 环境变量或
~/.dsh），
4. 清除已弃用的 bundle 名称（dsh-focus、dsh-files——该包自带的
Files 面板，现由 harness 自身提供），这样升级时不会
重复挂载，
5. 对 packages/ 下的每个包运行 dsh plugin --profile web add
（跳过已处于仓库版本的 bundle，除非使用 -Force），
6. 打印后续步骤。两部分都不会触碰 API 密钥——请在
Settings → Models 中添加你的密钥。

使用 uninstall.bat（Windows）或 ./uninstall.sh（macOS/Linux）卸载；
两者都有相同的 -Plugin / -DshHome / -ProfileName 开关。移除一个
bundle 也会移除其补丁层。

说明

- 插件处于 alpha 阶段，并且是针对 .dsh-version.json 中固定的 harness 版本
（0.1.5-rc.1）构建的。dsh-rightbar / dsh-rightbar-files /
dsh-open-in-app 是该版本客户端 bundle 的 fork；在提升固定版本后，
运行 scripts/sync-vendored.ps1 来推进这些 fork（参见
packages/dsh-rightbar/README.md）。dsh-open-in-app 是唯一一个
并非逐字节一致的 fork：其文档化的补丁位于 sync-vendored.ps1 中。
sync-vendored.ps1 是 维护者工具，也是本仓库中唯一一个在 macOS/Linux 上
需要 PowerShell 7（pwsh）的脚本——安装器从不需要。
- 语言：UI 部分有意采用 纯 JavaScript，没有构建
步骤——核心客户端包提供手写的模块表 bundle，编辑→重启循环保持即时。
有三个文件是 生成的，绝不手动编辑：dsh-editor 内置的 CodeMirror 6
产物（lib/vendor/cm6.min.js）以及三个 fork 的 bundle
（dsh-rightbar/lib/client.js、dsh-rightbar-files/lib/client.js、
dsh-open-in-app/lib/client.js）。
- 迭代修改：直接运行 install.bat / ./install.sh 会 重新同步
本仓库中版本发生变化的每个 bundle——修改 package.json +
.dsh-version.json，然后再次运行启动器；-Force 无论如何都会重新添加
（当包集合发生变化时需要一次，例如新增一个 bundle）。循环还有一条额外规则
看 已应用：Web 配置文件会将每个 bundle 作为实时链接安装
到此仓库中，因此代码编辑在那里已经算是“已安装”——你只需要
重启 npx @deepseek-ai/dsh web 并强制刷新浏览器
（Ctrl+F5）。客户端 bundle 在应用启动时只读取一次。
- 手动路径和故障排除请参见 docs/INSTALL.md。

安全与许可

- MIT——参见 LICENSE。插件由 vecnode 编写。
- 安全策略（支持线、私密报告、加固预期）：
SECURITY.md。此包从不接触 API 密钥，也从不修补
DeepSeek 核心文件：它添加自己的行，并（对于右侧栏）禁用
随附的行，然后提供自己复制的 bundle。

仓库布局

AGENTS.md              面向在此仓库中工作的编码代理的快速入门简介
ARCHITECTURE.md        深入探讨：插件模型、右侧栏分支、编辑器标签页、安装程序
LICENSE                MIT 许可证（vecnode）
SECURITY.md            安全策略：支持线、私密报告、加固
.gitattributes         保持 .sh 启动器为 LF（CRLF shebang 会破坏它们）
packages/dsh-vn-master/  唯一没有客户端部分的 bundle——空白主层
packages//     一个独立的 dsh bundle（package.json + cordis.patch.yml + lib/）
lib/index.js         Node 部分（可能是一个空操作行，以便客户端 bundle 随附）
lib/client.js        浏览器部分（模块表 bundle；手写或生成的 fork）
scripts/               install-all.ps1 / uninstall-all.ps1（Windows PowerShell）以及
install-all.sh / uninstall-all.sh（适用于 macOS/Linux 的 POSIX sh），
外加 sync-vendored.ps1（维护者 fork 重新同步）以及
.bat / .sh 控制台孪生脚本
checks/              针对 JS 部分的独立验证（参见其 README）
.dsh-version.json      固定的 harness 线 + 每个包的版本
install.bat / .sh      双击安装程序  |  uninstall.bat / .sh  卸载程序