核心分析¶

项目定位：glide 专注解决三个具体痛点：在浏览器级别实现近乎完全的键盘交互、在保持浏览器扩展兼容性的前提下提供可编程配置、按站点隔离键位与行为以避免全局冲突。

技术特点¶

• 基于 Firefox 的深度集成：相较于只能运行在页面上下文的扩展，glide 能在浏览器层面实现一致的键盘优先交互，同时保留 WebExtensions 支持以兼容现有插件。
• 模态键映射（normal/insert）：用模式区分减少与网页输入的冲突，提高在文本输入与导航间的可控切换。
• TypeScript 作为配置语言：提供类型检查、可维护性和脚本化扩展点，便于定义复杂行为与复用配置。

实用建议¶

1. 目标用户：优先推荐给熟悉模态编辑（例如 Vim）的高级用户、开发者和需要高度自定义的电源用户。
2. 部署方式：使用默认配置先体验键盘交互，再逐步引入 TypeScript 自定义；将常用站点规则写入站点级配置以避免频繁冲突。
3. 评估对比：若你需极简且跨浏览器的解决方案，扩展（Vimium）更轻量；若可接受独立浏览器并偏好最大控制，qutebrowser 更彻底；若要兼顾现代网页兼容与深度可编程，glide 最符合需要。

重要提示：glide 虽接近浏览器层级的改造，但仍受限于 Firefox 的扩展与 UI 政策：某些深度改动可能无法实现或需要额外权限。

总结：glide 通过将 TypeScript 可编程性、模态键映射与站点隔离结合到 Firefox 平台，填补了扩展与独立键盘化浏览器之间的空白，适合追求可维护、高度定制键盘工作流的高级用户。

核心分析¶

项目决策点：将 TypeScript 用作配置语言，目的是提升类型安全、IDE 支持和模块化能力，从而让复杂键位/行为定义更可靠、更易维护。

技术特点¶

• 类型检查与早期错误发现：TypeScript 在保存/构建时能捕获常见配置错误（例如键名或回调签名不匹配），减少运行时故障。
• IDE 与重构支持：自动补全、跳转与重命名提升配置维护效率，便于长期演进和多人协作。
• 模块化与函数抽象：可以将按键映射、站点规则封装成可重用模块或工具库，支持复杂策略的组合与共享。

实用建议¶

1. 为非程序员提供模板：维护一组“starter configs”与注释良好的示例，降低入门门槛。
2. 集成构建/热重载：提供简单的本地构建或内置编译器，以便修改 TypeScript 后即时生效，避免繁琐手动步骤。
3. 将常用片段封装为库：将复杂逻辑（例如站点判定、模式切换）打包为可复用函数，减少每位用户的重复工作。

重要提示：TypeScript 虽带来可靠性，但增加了学习与工具链成本；确保提供清晰文档、编译错误提示并允许导入纯 JSON/简单绑定作为过渡。

总结：TypeScript 为高级配置场景带来显著的可维护性和扩展性优势，但项目需要配套工具与示例以缓解对非开发用户的门槛。

核心分析¶

问题核心：模态键映射通过模式分离来降低与网页输入和应用快捷键的冲突，但在富交互或自定义快捷键的网页上仍需特殊策略才能保证稳定性。

技术特点与行为¶

• 模式隔离的作用：在 normal 模式下将大部分导航/操作键映射到浏览器级命令；进入文本输入或可编辑区后切换到 insert 模式以恢复原生键盘行为。
• 站点级例外：对那些高度依赖快捷键或自定义输入控件的站点使用白名单/黑名单或细粒度的按键覆盖。
• 自动焦点检测：结合 DOM 焦点与可编辑检测（contenteditable、input、textarea）实现自动模式切换，减少用户手动切换需求。

典型需要特殊处理的场景¶

• 在线 IDE / 编辑器（例如 VSCode Web）：自身快捷键丰富且复杂，应在站点规则中优先保留页面快捷行为。
• 协同文档与富文本编辑（Google Docs）：键盘行为高度特化，通常需要完全交还给页面。
• 交互画布/绘图工具（Figma、Canvas 应用）：鼠标+键盘混合交互频繁，键盘主导并不适合全覆盖。
• 嵌入式 iframe 或第三方小组件：可能需要单独的映射或绕过策略。

实用建议¶

1. 启用自动模式切换：优先使用焦点与可编辑检测自动进入 insert mode；对常用站点建立稳妥的默认规则。
2. 维护站点级配置：为每个冲突频繁的站点写明确的覆盖规则（自动进入 insert、禁用部分映射等）。
3. 提供紧急中断键：设置一个安全键（如 Esc 或 Ctrl+\）用于临时禁用键盘化，方便在意外行为发生时快速恢复页面原生交互。

重要提示：模态减少了大多数冲突，但无法对每个第三方 JS 应用自动完美处理；持续维护站点级规则是必要工作。

总结：模态键映射结合自动焦点检测和站点级例外，是在复杂 Web 场景中实现可控键盘优先体验的可行方案，但需用户定期调整规则以覆盖特殊页面。

核心分析¶

问题核心：站点级按键映射是避免全局冲突的关键，但必须有明确的实现与维护策略才能兼顾灵活性与稳定性。

技术实现要点¶

• 匹配粒度：支持基于主域、子域、路径甚至查询参数的规则；优先支持 glob 或 regexp 风格的匹配以覆盖复杂路径。
• 规则优先级：实现白名单/黑名单与优先级层级（全局 < 域 < 路径 < 元素选择器），以便局部覆盖全局映射。
• 行为控制：可为站点预设默认模式（例如自动切入 insert）、禁用特定映射或注入站点定制脚本。

维护与操作策略¶

1. 版本化配置：将 TypeScript 配置放入代码仓库，利用分支与 PR 流程管理站点规则变更，便于回退与审查。
2. 提供模板与导入机制：维护一套常用站点模板（如 Gmail、Google Docs、VSCode Web），用户可直接导入并微调。
3. 运行时可见性与调试工具：在调试模式下显示当前激活的映射与冲突日志，帮助快速定位并修复错误映射。
4. 自动化检测：使用简单的端到端或集成测试（页面加载后检查关键元素是否可编辑、常见快捷键是否被拦截）以发现不兼容项。

重要提示：站点级规则的灵活性越高，维护成本也越高；优先采用保守默认与可选覆盖，而非全局关闭机制。

总结：可扩展且可维护的站点级映射应结合细粒度匹配、优先级规则、模板化配置和版本化治理，从而在最小维护成本下获得最大兼容性与可用性。

核心分析¶

问题核心：基于 Firefox 与 WebExtensions 的实现带来兼容性与安全优势，但同时对可改造的深度集成设有边界；识别这些受限点对功能评估至关重要。

可能受限的功能类别¶

• 浏览器原生 UI 的深度修改：如地址栏、菜单系统或窗口管理器的根本性改造通常超出扩展权限。
• 内核级行为与渲染链替换：不能直接修改浏览器渲染管线或内核特性；性能敏感的深度优化受限。
• 高敏感权限操作：跨域注入广泛脚本、访问本地文件系统或拦截 HTTPS 流量需额外权限或根本不可行。
• 长期兼容性风险：依赖尚未稳定的 API 或边缘权限在浏览器更新时容易失效。

评估与设计建议¶

1. 以 WebExtensions 能力为主线：首先确认是否能用标准扩展 API 实现目标；若不能，评估是否能通过组合扩展与内置功能降级实现。
2. 明确权限模型：列出需请求的权限并评估对用户信任的影响；减少敏感权限的默认使用，改为按需开启。
3. 提供降级方案：对无法实现的高级功能，设计替代功能（例如提供更丰富的页面脚本而不改造浏览器 chrome）。
4. 兼容性与测试承诺：采用自动化测试与矩阵测试（不同 Firefox 版本/平台），并在文档中声明兼容策略与维护计划。

重要提示：不要将所有需求寄望于将来 API 扩展；更稳妥的做法是以现有可用 API 实现核心价值，并为未来扩展保留清晰扩展点。

总结：基于 Firefox 平台的折衷是获得成熟渲染与扩展兼容性的同时放弃部分极端定制能力。把 WebExtensions 能力作为评估基准，并设计权限最小化与降级策略，是保证项目可行性与长期维护的关键。