Skip to content

feat(windterm-importer): 支持分组、Telnet、跳板机、代理、QuickBar 及向后兼容的快捷键导入 - #19

Open
WindDaoist wants to merge 2 commits into
feigeCode:mainfrom
WindDaoist:feat/windterm-importer-groups-quickbar-keybindings
Open

WindDaoist wants to merge 2 commits into
feigeCode:mainfrom
WindDaoist:feat/windterm-importer-groups-quickbar-keybindings

Conversation

@WindDaoist

@WindDaoist WindDaoist commented Nov 20, 2026 •

Copy link
Copy Markdown

变更说明

完善 windterm-importer(com.onetcli.importer.windterm)插件,在兼容现有官方版本 Navop 的前提下,支持完整的 WindTerm 会话与配置迁移:

  • 递归目录扫描:支持选择 WindTerm 安装目录或 .wind 配置目录,自动递归发现 user.sessions、quickbar.config 和 wind.keymaps(跳过 logs、themes、locales、schemes、vendors、plugins、palettes 及嵌套 .wind/.wind 目录)。
  • 会话与分组导入:
    • 支持导入 SSH 与 Telnet 会话,完整保留名称(session.label)、多级嵌套分组路径(group_path → Navop 工作区)、跳板机引用(session.proxyJumpServer1)、代理配置(socks5 / http)以及按当前平台优先解析的私钥路径(ssh.identityFilePath.*,自动去除 .pub 后缀)。
    • 在 scan() 中上报发现的工作区路径列表与预估导入条目数。
    • 继续跳过加密的 autoLogin 数据及非 SSH/Telnet 会话,并给出明确告警。
  • QuickBar 快捷命令导入:解析 quickbar.config 并生成 quick_command 导入记录(保留分组、名称、命令内容、快捷键和排序)。
  • 向后兼容的快捷键导入:通过 WASI 环境变量 NAVOP_IMPORT_CAPABILITIES=keybinding 与宿主进行能力协商:
    • 当宿主声明支持 keybinding 时,解析 wind.keymaps 并输出 keybinding 记录;
    • 在尚未支持 keybinding 协议的现有官方版 Navop 上,自动跳过 keybinding 记录,仅输出 SSH / Telnet / 分组 / QuickBar,避免触发协议解码报错,实现单个插件同时兼容新旧版本。

测试验证

  • cargo test -p windterm_importer_wasm:6 个单元测试与 1 个 doctest 全部通过(包含新/旧宿主能力协商兼容性测试)。
  • cargo build --release -p windterm_importer_wasm --target wasm32-wasip2:编译通过。
  • 已使用真实 WindTerm 2.7.0 目录在官方版 Navop 中实测安装与目录导入,解析与预览正常、无协议报错。

…s, QuickBar, and optional keybindings

- Recursively discover user.sessions, quickbar.config, and wind.keymaps under WindTerm install or .wind directories
- Import SSH/Telnet sessions with labels, nested group paths, jump server references, proxy URLs, and platform-aware identity file paths
- Import QuickBar commands from quickbar.config
- Gate keybinding record emission behind host capability negotiation (NAVOP_IMPORT_CAPABILITIES=keybinding) for full backward compatibility with existing Navop releases
- Add unit tests covering groups, jump servers, proxies, QuickBar, keymaps, and legacy/capable host compatibility
@WindDaoist WindDaoist changed the title feat(windterm-importer): support groups, Telnet, jump servers, proxies, QuickBar, and optional keybindings feat(windterm-importer): 支持分组、Telnet、跳板机、代理、QuickBar 及向后兼容的快捷键导入 Nov 20, 2026
@WindDaoist

Copy link
Copy Markdown
Author

已修复本次 PR 相关的 manifest 校验与脚本单测问题(commit a27e98b):

  • 将 extensions/wasm/windterm-importer/extension.json 的 outputKinds 中的 quick_command 修正为 quick-command;
  • 在 packages/navop-extension-types/schema/extension-manifest.schema.json 的 connectionImporter.outputKinds 枚举中补充 keybinding(对齐主仓 PR #576);
  • 同步更新 manifest.json(版本号、tag 与描述)及 tests/scripts.test.mjs 中 windterm-importer 的断言。

注:Repository checks 中 npm run lint:manifests 仍会报以下 3 个 main 分支既有失败(非本 PR 修改范围,未在此 PR 中改动):

  • extensions/composite/extension-showcase/extension.json(/permissions/1..2 不匹配 schema 正则)
  • extensions/samples/sample-db-explorer/extension.json(/permissions/1..3 不匹配 schema 正则)
  • extensions/samples/sample-db-schema/extension.json(/permissions/1..3 不匹配 schema 正则)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant