thanhdz235123-commits/nyx-dsh-plugins

面向 DeepSeek Harness 的 Nyx 插件

一个仓库里包含两个面向 DeepSeek Harness 的插件，
两者都按照 harness 自身插件的构建方式来构建——
宿主部分放在 lib/index.js，客户端部分放在 lib/client.js，契约写在 package.json 中
（main、exports["./client"]、dsh.client、
dsh.bundle.patch）。

| 包 | 作用 |
|---|---|
| nyx-file-panel | 文件链接会打开右侧面板——预览、更改、审查、文件、编辑——而不是操作系统的默认应用。仅限精确路径：链接打开它所指向的内容，否则就说明无法打开。 |
| nyx-message-edit | 就地编辑用户消息：界面会替换该消息，其后的所有内容都会被截断，并从该确切位置重新生成一轮。框架中带有模型选择器，每次尝试都会被追踪。 |

安装

每个包都会把自己安装到 DSH 配置文件中：它把自身的两部分复制到
配置文件的 node_modules 中，并写入激活它们的配置文件补丁。

从克隆仓库安装——这是唯一一条无需在任何地方发布任何内容的路径，
也是经过端到端验证的路径：

git clone https://github.com/thanhdz235123-commits/nyx-dsh-plugins
cd nyx-dsh-plugins
npm run install:plugins          # both plugins; or run one package's bin yourself:
node packages/nyx-file-panel/bin/nyx-file-panel.mjs install
node packages/nyx-message-edit/bin/nyx-message-edit.mjs install

从 npm 安装——无需克隆，无需构建：

npx nyx-file-panel install
npx nyx-message-edit install

npx 只读取 npm 注册表（它从不查看 GitHub），因此这条路径需要
这些包已被发布——而 publish 工作流会一直保持这一点。安装
不需要账号：只有发布才需要。

两个安装器都理解的标志：--force 用于覆盖现有安装，
--home  用于 harness 主目录不是默认值的情况，--dep 用于作为
配置文件依赖项安装而不是复制。uninstall 会将其移除。

宿主部分在启动时加载：安装后，重启 DSH Desktop。客户端
部分会随窗口重新加载（⌘R / Ctrl-R）而被加载。

隐私

两个插件都是本地软件：自身不进行网络调用，没有遥测，
除非你主动要求，否则不会将任何关于你的信息写入磁盘。

有两件事确实会接触磁盘，这是有意为之：

- nyx-file-panel 会在
/nyx-file-panel-index/ 下缓存每个会话的差异索引，这正是让重新打开文件
变得瞬间完成的原因。删除该文件夹即可清除它。
- 诊断信息是选择性启用的：设置 NYX_FILE_PANEL_DIAG=1 或
NYX_MESSAGE_EDIT_DIAG=1 后，插件会向
harness 主目录追加一份本地 JSONL 记录。消息文本永远不会被写入——只记录长度和 id。

tools/leak-scan.mjs 会扫描每个被跟踪的文件，查找凭据、主目录路径、
个人地址和机器名称。它会在 npm run check 和
发布工作流中运行，因此这类内容都无法通过此
仓库进入注册表。

布局

packages/nyx-file-panel/     lib/index.js  lib/client.js  lib/types/**  bin/  docs/
packages/nyx-message-edit/   lib/index.js  lib/client.js  lib/types/**  bin/  tools/

两个包相互独立：可以只安装其中一个、另一个，或两个都安装。

发布（维护者）

.github/workflows/publish.yml 会发布注册表中尚无对应版本的那个包，然后在之后的每次运行中跳过它——因此两个包独立进行版本管理，且任务失败后可以安全地重新运行。

git tag v0.6.4 && git push origin v0.6.4     # 推送标签
gh workflow run publish                       # 或手动：Actions → publish → Run workflow

它需要一个仓库密钥 NPM_TOKEN：一个 npm Automation 令牌（或启用了绕过 2FA 的细粒度令牌）。当账户开启双重验证时，npm 会以 OTP 验证挑战拒绝 npm publish，而自动化令牌是官方支持的绕过方式——参见 npm 的
令牌文档。

许可证

MIT