Movwin：一位开发者自述为何拒绝发布其 TUI 框架

背景

长期以来，图形用户界面（GUI）或终端用户界面（TUI）的开发体验让作者感到不满。现有的库和框架迭代迅速，开发者不得不不断追逐上游（upstream）的新决策并调整代码。更令人疲惫的是，当开发者不同意上游框架的设计决策时，往往被迫寻找新的框架。考虑到许多项目需要维护 5 到 10 年甚至更久，这种技术栈的频繁变动带来了巨大的维护成本。

2025 年 12 月底的 Advent of Code 活动结束后，作者决定着手开发自己的 TUI 框架。这一决定并非轻率之举，因为作者深知这将是一项繁重的工作。在寻找替代方案时，作者发现现有的框架要么不符合喜好，要么性能不足——近期某些框架的初始化时间甚至长达两秒，性能表现令人失望。

尽管完成了初步开发，作者决定暂时不公开 movwin 的代码。主要原因在于对当前开源生态的担忧：公开发布的项目容易被“AI 公司”抓取并用于训练，随后以商业产品形式出售，而忽视代码原有的许可证限制。作者无法接受这种违背开源精神的行为。

核心内容

movwin 全称为 "movq's windows and widgets"，是一个基于 Python 的 TUI 框架。虽然作者对 Python 的热情有所下降，但其庞大的标准库使得实现许多功能变得容易。

技术架构与依赖

movwin 构建在 ncurses 之上，利用 ncurses 处理终端兼容性的繁重工作。与传统的 ncurses 应用不同，movwin 不使用子窗口（subwindows）或填充（pads），而是将 ncurses 视为一种智能的帧缓冲区（framebuffer），用于绘制界面并作为键盘和鼠标输入的源头。

唯一的依赖项是 wcwidth 库及其 wcswidth() 函数，用于测量文本的“表观宽度”。例如，表情符号 "♀️" 占据两个字符单元。

设计目标与限制

1. Unicode 支持：目标是提供“可接受”的 Unicode 支持。虽然不太可能支持从右到左（RTL）书写系统，但必须确保插入 Emoji 时不会导致布局崩溃。关键在于准确计算 Unicode 序列在终端中占用的单元格数，但这取决于具体终端，因此无法做到完美。
2. 性能优化：启动时间控制在 200-300 毫秒以内。针对 Python import 速度慢的问题，作者做出了牺牲，例如不使用 dataclasses。在作者使用的老旧 Intel NUC（Celeron CPU）上，仅导入 dataclasses 就需要 0.151 秒，这显著影响了启动速度。
3. 鼠标支持有限：受限于 UNIX 终端对鼠标事件报告的不一致性（许多终端默认不报告鼠标移动，仅报告按下/释放，且在大型窗口中部分事件可能失效），movwin 的鼠标支持非常有限。作者甚至考虑完全移除鼠标支持，因为键盘驱动本身是一种优势，尽管在某些场景（如窗口移动、滚动控制）下鼠标体验更佳。

应用场景演示

作者通过几个实际程序展示了 movwin 的能力：

• tracktivity：一个基于 CSV 文件的活动追踪工具（记录咖啡因摄入、天气等）。它根据配置文件自动生成 UI 表单，支持自由文本评论和预定义选项。虽然目前缺乏完善的表格或列表组件，但支持窗口调整大小、移动以及弹窗（Popups）功能。
• bine：一个基础十六进制编辑器。利用 Python 的 bytes.find() 和 mmap() 技术，即使在 2GB 的文件中搜索 ASCII 字符串也仅需约 1 秒，性能表现良好。bine 展示了多窗口管理功能，支持平铺布局、全屏模式及自由移动窗口。底部信息面板可实时解析光标处字节的不同数据类型（如 signed/unsigned 8/16/32/64 位整数及 UTF-8 解读）。
• 时间追踪器：一个简单的计时程序，记录工作时段。有趣的是，它还能通过 timerfd 和 select() 机制，将时间数据实时发送到连接在 Arduino 上的 7 段数码管显示器，实现了硬件与软件的联动。

主题与配置

movwin 内置两种主题：“amber”（琥珀色，致敬早期 DOS 时代的 CRT 显示器）和“bluegray”（蓝灰色，更明亮）。默认情况下，主题会根据月份自动切换（北半球冬季为琥珀色，其他月份为蓝灰色），也可设置为南半球模式或通过环境变量 $MOVWIN_THEME 强制指定。用户还可通过 ~/.config/movwin/colors.json 自定义主题，但需注意与应用程序内置颜色的冲突。

关键要点

• 动机源于维护痛点：开发者因现有 TUI 框架迭代快、兼容性差、性能下降以及长期维护成本高而选择自研框架。
• 拒绝开源的商业考量：作者暂不发布代码，主要担忧是防止 AI 公司未经合规使用其代码训练模型并进行商业变现。
• 技术选型务实：基于 Python 和 ncurses，通过牺牲部分语言特性（如 dataclasses）来换取极快的启动速度（<300ms）。
• 终端兼容性妥协：承认 Unicode 宽度和鼠标事件在不同终端中的不一致性，因此将目标设定为“可接受”而非“完美”，并限制了鼠标功能。
• 实际效能验证：通过 bine（十六进制编辑器）和 tracktivity 等实际案例，证明了该框架在处理大文件搜索、多窗口管理及硬件交互（Arduino）时的实用性。
• 人性化设计细节：内置基于季节/月份自动切换的主题，以及通过 timerfd 实现 UI 与外部硬件（数码管）的实时同步。

意义与影响

movwin 的开发反映了资深开发者对当前软件开发生态中“框架疲劳”和“开源伦理”问题的深刻反思。

首先，它揭示了终端界面开发中常被忽视的性能瓶颈。在追求功能丰富的同时，初始化速度和资源占用往往是用户体验的短板，movwin 对启动时间的极致追求为轻量级 TUI 开发提供了参考。

其次，作者关于“不发布代码”的决定具有强烈的时代隐喻。在生成式 AI 大规模抓取开源代码的背景下，开发者对知识产权和数据主权的焦虑日益增加。这一举动挑战了传统的“开源即共享”范式，引发了关于 AI 训练数据版权和开发者权益保护的讨论。

最后，movwin 展示了回归基础（Bare-metal style）TUI 设计的价值。通过直接操作 ncurses 帧缓冲区并简化依赖，它证明了在特定约束下，自建框架比盲目追随主流库更能满足个性化和性能需求。尽管目前仅作为内部工具存在，但其设计理念和对细节的关注（如 Unicode 处理、硬件联动）为 TUI 框架的设计提供了独特的视角。