dsh-enter-using

dsh-enter-using

DSH Web 界面插件：命令授权（审批）支持键盘回车 + 数字键，手感类似 Codex。

默认的 DSH 审批面板只认「回车允许 / Esc 拒绝」。装上这个插件后，面板变成带编号选项的键盘面板，不用鼠标也能授权。

按键

按键	作用
1	允许一次
2	拒绝
Enter	确认当前高亮项（默认第 1 项＝允许一次）
Esc	拒绝
↑ ↓ ← →	切换高亮项（循环）
鼠标悬停 / 点击	同样可用

面板选项顺序固定为 1 允许一次、2 拒绝，与 Codex 一致：默认回车＝放行，误按回车也不会拒绝。

实现方式

• 以 priority: 0.5 注册到会话编辑器的链式槽位 conversation.composer，比官方审批面板（priority: 1）更早被匹配，从而接管审批渲染。
• select 只匹配 kind === "approval" 且可作答的待处理交互；其它待处理交互（例如计划评审）仍返回 null，继续由官方面板处理，互不干扰。
• 键盘监听注册在 document 的捕获阶段，命中后 preventDefault() + stopPropagation()。下列情况一律让行：
  • 事件已被处理（defaultPrevented）、输入框/文本域/contenteditable 内、页面上存在 [role="dialog"] / [aria-modal="true"] 弹窗；
  • 带 Ctrl / Meta / Alt 修饰、输入法组合态（isComposing / keyCode 229）、系统按键重复（repeat）。
• 不调用 ctx.shortcuts.registerFixed：官方审批面板已占用 Enter / Escape 两个固定快捷键，键位处理放在插件组件内部，避免重复注册冲突。
• 每次审批只作答一次：作答中禁用按钮，Host 拒绝/失败后自动恢复可作答状态，组件卸载后不再更新状态。
• 样式通过 ctx.effect 注入一串带 data-plugin-css 标记的 <style>，卸载时移除；类名统一 deu_ 前缀，颜色只引用 --dsw-alias-* 主题变量并带兜底值。

安装

本仓库本身就是一个 DSH bundle（package.json 里的 dsh.bundle.patch + dsh.client）。

• DSH 内：plugin_manager → install_bundle，target 填本仓库目录（例如 D:\dsh-project）。
• 命令行：dsh plugin add D:\dsh-project。
• npm / 插件商店：发布到 npm 后，商店会显示版本号与下载量，并可安装预构建包（免 allowBuilds 构建授权）。

安装后按提示刷新页面或重启 dsh web 生效；命令授权面板出现时即可用数字键 / 回车 / Esc 作答。

开发

npm test

26 项测试，全部通过。测试在 vm 沙箱中加载 client.js（stub 掉 window.__ModuleLoader__、document 与 react），覆盖：槽位注册契约、locale 词典完整性、样式注入与回收、按键映射与全部守卫条件、作答状态机（重复按键 / 不可作答 / 失败回滚）、以及卸载时监听器清理。

上架 dshmarket（插件商店）

dshmarket 的插件列表来自精选目录 awesome-dsh-plugin，条目不写在本仓库里，而在那边「一个插件一个 YAML 文件」。本仓库保留了一份待提交的条目副本：market/dshmarket-entry.yml。

收录条件（对照本仓库现状）：

条件	现状
package.json 声明 dsh.bundle（只有 dsh.client 不算）	✅ dsh.bundle.patch
仓库有真实可用的代码	✅ 26 项测试
仓库创建满 1 天	✅ 首个提交 2026-10-08
仓库添加 dsh-plugin topic	✅ 已设置

提交状态：条目已通过 PR 提交到上游 —— awesome-dsh-plugin#6971（只含 data/plugins/wukiQAQ__dsh-enter-using.yml 一个文件，CI 两项检查均 success、mergeable: clean）。截至 2026-10-15 该 PR 仍为 open（上游按批次合并且积压较多），合并后目录站点与 dshmarket 才会自动收录、商店里才能搜到。

提交方式：把 market/dshmarket-entry.yml 复制到 awesome-dsh-plugin 仓库的 data/plugins/wukiQAQ__dsh-enter-using.yml，提 PR。文件名必须与 url 对应（owner__repo.yml），README 由 CI 生成、不要手改。条目字段已在本地用该仓库的 scripts/lib/entries.mjs 校验：4461 条全量 0 问题。

发布到 npm（版本同步）

商店卡片上的版本号取自 npm 的 dist-tags.latest（见 dshmarket 的 src/registry.ts：只有 GitHub 源码的条目 version 为 null，界面直接不显示版本号）。所以「随版本同步」＝把包装到 npm：之后每次 npm version + npm publish，商店会自动显示新版本，不需要再往目录提 PR。

• 收录与 npm 无关：不发 npm 也能从 GitHub 安装，只是没有版本号与下载量（上游 contributing.md 原文）。
• npm 映射由上游从 registry 自动采集：目录条目里不需要、也不允许手写 npm: 键。
• 发布前提（本仓库已就绪）：repository 指回本仓库（上游靠它把 npm 包与目录条目关联起来）；官方 @deepseek-ai/* 用 peerDependencies 声明，且范围带显式预发布分支（否则 node-semver 会静默排除所有 -rc.* 版本，用户 npm install 时遇到 ERESOLVE）；private 已移除。
• 发布状态：0.1.0 已于 2026-10-15 上线（tarball：https://registry.npmjs.org/dsh-enter-using/-/dsh-enter-using-0.1.0.tgz，dist-tags.latest = 0.1.0）。
• npm 11 的 npm publish 在开启 2FA 的账号上会直接 E403（要求 granular access token with bypass 2fa），而带 bypass 2FA 的 token 只允许暂存发布。新包因此走 npm ≥ 12 的暂存发布：npm login → npx npm@12 stage publish → npx npm@12 stage list → npx npm@12 stage approve <stage-id>（需要时加 --otp <6位动态码>）。prepublishOnly 会先跑 26 项测试。npm 12 要求 node ^22.22.2 || ^24.15.0 || >=26（本机 v24.14.0 只有 EBADENGINE 警告）。
• 自动发布：.github/workflows/release.yml 在推送 v* 标签时用 npm 12 发布，认证走 npm 的 Trusted Publishing（OIDC，无需 NPM_TOKEN）：先在 npm 包设置页 → Publishing access → Trusted Publisher 登记 GitHub Actions（repo wukiQAQ/dsh-enter-using、workflow release.yml）。发版流程：改 version → 提交 → git tag v0.1.1 && git push origin v0.1.1；未登记时改用上面的本地暂存发布。

目录

package.json                  # dsh.bundle.patch + dsh.client（platform: web, immediately）
cordis.patch.yml              # bundle 注入声明
index.js                      # Host 半边（无行为，UI 全在 Client）
client.js                     # Client 半边：审批面板 + 键盘交互
test/client.test.mjs          # 测试
market/dshmarket-entry.yml    # 待提交到 awesome-dsh-plugin 的商店条目
.github/workflows/release.yml # 打 v* 标签时自动 npm publish（npm 12 + OIDC Trusted Publishing）