Skip to content
JeremyWangCYPublic

About

Windows 桌面实时字幕阅读与中英互译工具(Teams/飞书)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

46 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TeamSub

Windows 桌面实时字幕阅读与多语种翻译工具。

通过 Windows UI Automation 读取 Teams/飞书已经显示在屏幕上的实时字幕,不截图、不 OCR、不修改会议客户端本体。字幕可以搜索、按发言人筛选,也可以按会议主题做多语种翻译(13 种主流语言),并导出为 Markdown 或双语 SRT。

功能

  • 实时字幕阅读:直接读取会议客户端无障碍树里的字幕节点,延迟取决于客户端刷新,通常在 1 秒以内。
  • 多语种翻译:中、英、日、韩、法、德、西、葡、俄、意、阿、泰、越 13 种语言,可选「A ⇄ B 互译」或「全部译成 X」,语言选择器支持搜索;按主题(领域说明 + 译名对照)约束译文,支持上文语境、人工修正回写、译文质检(数字/单位/漏译);思考强度可选自动/关/低/中/高,设置里的「检测」可一键探测上游实际接受哪个参数。
  • 碎句合并:会议客户端按显示行下发字幕,一句话常被切成两三行、同一行还会先出半句再补全。采集层会按「同一人 + 间隔短 + 上一条没收到句末标点」把续写折成一条,改写则就地替换,读起来是一句完整的话。
  • 悬浮字幕条:无边框圆角小窗,可拖动缩放,最小化主窗口时自动切到它,会议中不占地方;滚动保留最近 40 条(旧句淡色、往上翻不会被拽回),断行按中文禁则排(标点不占行首、西文词不拆)。
  • 历史会议:每场会议独立成文件,可浏览、重命名、编辑原文和译文、续接、多选合并导出;列表按「开始时间 · 标题 · 条数 · 时长」显示,同名会议靠日期区分;可在列表页直接打开记录文件夹。
  • 删除会议:确认框逐场列出日期与时长,避免误删同名的「飞书会议」;记录移入系统回收站可还原,逐场报告结果,一场失败不影响其余各场。正在记录的那场会先停止采集并保存再删除,之后的新字幕自动记到新会议。
  • 记录补译:在会议记录里补译缺失内容,开始前可单独选择这次的翻译方向和主题,查看处理进度、已保存和失败条数;译文写回记录,取消或切换页面后已完成内容仍保留。
  • 复制:正文右键可复制选中/全选/全部,Ctrl+C 同样可用。
  • 导航与图标:左侧导航和工具栏使用统一的线性图标(icons.py 绘制,跟随主题色),历史、设置、帮助以独立页面打开,由导航高亮表明位置;纯图标按钮悬停显示用途与快捷键。快捷键:Ctrl+1 实时会议、Ctrl+2 历史会议、Ctrl+, 设置、F1 帮助、Esc 返回。
  • 空状态:正文为空时区分「等待字幕」(附当前会议软件开启字幕的路径)、「已清屏」和「没有匹配的字幕」。
  • 高分屏:进程声明 DPI 感知,按系统缩放比例(125%、150%、200%…)整体换算界面尺寸,文字、图标和圆角都按物理像素渲染,不再发虚。界面代码写 100% 下的逻辑像素,换算集中在 ui_kit.install_scale;调试时可用环境变量 TEAMSUB_UI_SCALE=1.5 强制指定缩放。
  • 界面细节:浅色/暗色统一表面层次,输入框使用内嵌双环聚焦;配置下拉支持长名称省略和键盘操作,API Key 可切换显示/隐藏。复制反馈 2.5 秒后淡出,拖动滚动条查看旧字幕时暂停跟随,点击「回到底部」恢复。
  • 系统托盘:关闭主窗口时收进托盘并继续采集、翻译;最小化时保留任务栏入口。托盘图标可唤回窗口,托盘或更多菜单中的「退出 TeamSub」才会结束程序。托盘不可用时,关闭键退回最小化到任务栏。
  • 导出:Markdown、SRT 字幕、纯文本,导出用快照,不受当前搜索/筛选影响。
  • 导出内容:可选原文、译文或对照;补译完成后直接从会议记录导出。
  • 应用更新:设置 → 更新,检查正式版、查看下载进度、取消或重试;校验通过后保存会议、安装并重启。

安装与启动

需要 Windows 10/11(x64)。普通用户可从 GitHub Releases 下载 TeamSub-Setup-版本号.exe,无需 Python 或管理员权限。安装程序提供开始菜单入口和可选桌面快捷方式。

默认安装目录为 %USERPROFILE%\Apps\TeamSub。已有自动更新功能的版本可在设置 → 更新中下载并更新;旧版首次升级需要从系统托盘退出后覆盖安装。配置和会议记录会保留,卸载不会主动删除用户数据。便携版 ZIP 解压到固定可写目录后启动 TeamSub.exe。兼容性实测范围见 兼容性说明。

源码运行需要 Python 3.12 及可用的 Tkinter:

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\start.bat

排查启动问题时用 debug.bat,它会保留控制台输出。

应用图标

teamsub.ico 由 brand.py 生成(16–256 px 多尺寸,小尺寸单独简化),界面左上角的品牌标用同一份绘制逻辑:

.\.venv\Scripts\python.exe brand.py teamsub.ico

打包成单个 exe

装了 PyInstaller 后直接运行 build_exe.bat,产物在 dist\TeamSub.exe(约 25 MB,无需安装 Python)。

.\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.\build_exe.bat

打包脚本结束时打印产物 SHA256,便于核对。exe 带版本元数据(属性 → 详细信息里能看到产品名与版本)。

安装 Inno Setup 后,运行以下命令生成安装包。安装包采用文件白名单,只包含应用程序和许可证。

.\build_installer.ps1 -IsccPath 'C:\Program Files\Inno Setup 7\ISCC.exe'

Release 中提供 SHA256SUMS.txt,可使用 Get-FileHash 文件名 -Algorithm SHA256 核对下载文件。

单文件模式首次启动会先解压到临时目录(约 2–5 秒),之后快一些。配置、会议记录、日志都保存在 exe 同目录,所以要给它一个固定的文件夹,不要放在临时目录里跑。

使用

  1. 在会议客户端里先打开实时字幕(Teams:更多 → 语言和语音 → 打开实时字幕)。
  2. 启动 TeamSub,选择对应的会议模式。
  3. 翻译默认关闭。在「设置 → 服务」里填引擎、地址、模型和密钥后即可开启。
  4. 「思考强度」在「设置 → 服务」,默认 自动(不改动请求)。选关/低/中/高后,程序按候选字段顺序试探上游,被「不认识这个参数」拒绝就换下一个;点旁边的「检测」可先把实际可用的字段记进配置,之后不再重复试探。

保存与数据位置

默认数据放在程序目录:appconfig.json 保存设置,captions/ 保存会议记录。也可以在启动前设置 TEAMSUB_DATA_DIR 指向别处。

每场会议生成唯一文件名,自动保存为 SQLite(结构化事实源)+ Markdown(可读投影)。记录按 ID 更新,Markdown 用临时文件原子替换。不要在程序正在使用某场会议时删除或编辑它的数据库——SQLite 是恢复依据。

隐私与数据

  • 本工具读取的是屏幕上已经显示的字幕,不录音、不截屏、不触碰会议音频。
  • 会议记录只保存在本机。
  • 开启翻译后,字幕原文与所配置的上文会发送到你自己填写的翻译服务。是否开启、发给谁,完全由你决定。
  • API 密钥用 Windows DPAPI 加密后存在本机配置里,换机器或换 Windows 账户都解不开。
  • 不要把自己的 appconfig.json、cache/、captions/ 提交到任何公开仓库。
  • 更新检查与下载只向 GitHub 的公开 Release API 和官方资源域名发送请求,不读取或发送翻译配置、API Key 和会议记录。

已知限制

  • 依赖会议客户端的无障碍树结构。客户端升级后控件类名可能变化,届时需要更新对应的读取实现;升级后建议先确认字幕仍能被读到。
  • 只读取客户端已经渲染出来的字幕,客户端不显示的内容读不到。
  • 翻译质量取决于所选模型与主题描述,离线测试无法代替真实会议验收。

版本

当前版本 v0.2.8。程序内「帮助」页和设置 → 更新均显示版本号。自动更新与失败恢复策略见 更新说明。

主界面「翻译主题」选择器常驻显示当前主题,选择后立即保存并用于后续翻译,重启后仍保留;已完成的译文保留。设置页浏览其他主题属于草稿,点击保存才切换;「设置 → 主题」支持将主题导出为 JSON 文件(可作为模板发给 AI 仿写)以及从 JSON 导入单个或多个主题。长名称可悬停查看全称。

「译名对照」按每行 原文=译文 填写。OpenAI 兼容引擎会将当前主题的会议背景和译名对照放入每次翻译请求的 system 提示词;模型优先采用对应译名,同时结合句意判断。这属于推理时提供上下文,不会训练模型。当前 DeepL、Azure 适配器未接入这两项。

更新功能测试

python -m unittest discover -s tests -p 'test_*.py' -v

测试覆盖版本比较、请求隐私、损坏/截断/中断下载、取消重试、安装预检、会议保存屏障、启动失败恢复记录写入、页面重建及控件定时器。使用临时数据目录,禁用真实字幕采集与外部网络。Windows 安装集成测试使用独立应用标识和隔离目录,见 tests/test_installer_update.ps1。

许可

MIT,见 LICENSE。

About

Windows 桌面实时字幕阅读与中英互译工具(Teams/飞书)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages