她真好看.png

English Ver. README.en.md

基于 TurnBasedGameData 构建的任务对话数据库和其 TUI 浏览器。

项目将提取任务对话，构建 SQLite 数据库，并用 Textual 提供一个 TUI 来检索和浏览。

主要功能：

• 按台词内容搜索
• 按角色名搜索
• 按 Act / DS / Story / Mission 浏览
• 内联展示选项分支和后续分支对话
• 支持多语言数据库视图和多语言 UI

项目默认只从仓库根目录下的 ./turnbasedgamedata/ 读取游戏资源。

需要的主要目录和文件包括：

• turnbasedgamedata/TextMap/
• turnbasedgamedata/ExcelOutput/TalkSentenceConfig.json
• turnbasedgamedata/Config/Level/Mission/
• turnbasedgamedata/Story/Discussion/Mission/
• turnbasedgamedata/Story/Mission/

推荐直接使用初始化脚本自动拉取

# python init_tui.py
uv run init_tui.py

优先尝试：

1. gh repo clone
2. git clone
3. 下载 main.zip 并用 Python 内置库解压

目标目录固定为 ./turnbasedgamedata/。

目前支持：

• CHS
• CHT
• DE
• EN
• ES
• FR
• ID
• JP
• KR_0
• KR_1

说明：

• build_dialogue_db.py --lang all 会按当前 turnbasedgamedata/TextMap/ 中实际可用的语言扫描。
• dialogue_tui.py --lang ... 需要数据库里存在对应语言视图。

git clone https://github.com/DimbreathBot/TurnBasedGameData turnbasedgamedata

单语言：

uv run build_dialogue_db.py --lang CHS

多语言：

uv run build_dialogue_db.py --lang EN JP KR_0 KR_1

构建所有可用语言：

uv run build_dialogue_db.py --lang all

指定输出数据库：

uv run build_dialogue_db.py --lang all --db dialogue_all.db

默认输出文件是仓库根目录下的 dialogue.db。

uv run dialogue_tui.py --lang CHS

如果数据库不在默认位置：

uv run dialogue_tui.py --db dialogue_all.db --lang EN

TUI 当前常用快捷键：

• Ctrl+L：聚焦搜索框
• Ctrl+N：下一页
• Ctrl+P：上一页
• F2：切换右侧详情的 Rich / 文本 模式
• Ctrl+Q：退出
• Ctrl+C 或 Ctrl+Shift+C：复制当前左侧选中项

说明：

• 复制快捷键面向左侧结果树或 Act 列表。
• 如需复制右侧详细内容中的文本，先按 F2 切换成文本模式再复制
• 在某些终端里，Ctrl+Shift+C 会被终端降级成 Ctrl+C，项目内部已经兼容这种情况。

• init_tui.py 无第三方依赖的初始化与启动向导
• build_dialogue_db.py 从 turnbasedgamedata/ 构建对话数据库
• dialogue_tui.py 对话浏览 TUI
• dialogue_i18n.py TUI 文案本地化
• app_config.py 共享语言配置与视图名辅助函数

仓库里带了 PyInstaller 的 spec：

uv add -r requirements-build.txt
uv run pyinstaller dialogue_browser.spec

默认入口是 dialogue_tui.py，输出程序名为 dialogue_browser。