本项目基于 Google Agent Platform
启动:
uv run main.py首次运行需在「文件 → 设置」(Ctrl+,)中配置 AI 服务,二选一:
方式一:Vertex AI
先完成本地登录,程序将直接使用该凭据:
gcloud auth application-default login然后在设置中填写 GCP 项目 ID 与区域(默认 global)。
方式二:自定义接口
在设置中填写 Base URL 与 API Key,适用于官方 Gemini API 或任何兼容的代理。
配置保存在用户配置目录下的 ai-teachkit/config.json(含 API Key,请勿分享),
具体路径显示在设置窗口底部。
main.py 入口
teachkit/
config.py 配置读写(服务提供方、凭据)
constants.py 评分提示词、视频格式、ffmpeg 预设
assets/ 图标等静态资源
core/ 纯逻辑,不依赖 GUI
client.py Gemini 客户端与评分调用
video.py ffmpeg 转码与探测
results.py 评分结果落盘
ui/ Qt 界面
styles.py 主题与样式表
workers.py 后台线程
widgets/ 自定义控件
windows/ 主窗口与设置窗口
examples/ 最小调用示例
本项目采用 MIT License 授权。