losophy

立项背景和目标：游戏行业中业务同学普遍不会写 SQL，数据分析师也难以记住所有表结构、字段含义、指标用纯和字段取值，若将自然语言问题直接交给大模型生成 SQL，容易出现选错字段、用错指标和 SQL 幻觉等问题，取数慢且结果不可信。本项目目标为让用户用自然语言提问，系统自动召回相关字段、指标和取值，生成并执行 SQL 后流式返回分析结果，从而降低取数门槛、提升分析准确性。 软件功能、核心功能模块的介绍：项目分为元数据知识库构建和自然语言问数两大模块。知识库构建模块使用 MySQL 和 SQLAlchemy 保存表、字段、指标及取值等权威元数据，通过文本向量化服务生成向量存入 Qdrant 支撑字段和指标的语义召回，同时用 Elasticsearch 承载字段真实取值，支持关键词与值域检索；辅助模型自动召回与 SQL 生成，安全可靠。问数模块用 LangGraph 编排关键词抽取、字段/指标/取值混合召回、合并过滤、SQL 生成、校验修正、执行等节点，并辅以 FastAPI 接口，入参返回流式数据，保证流程可追溯、结果可解释。 业务流程、功能路径描述：用户提交问题后，系统先抽取关键词，再从语义库和全文库中并行召回相关字段、指标和取值，合并后过滤无关表与指标，随后生成 SQL，进行语法与字段校验并自动修正，最后在数据仓库中执行返回查询结果，整个过程以流式方式将节点进度和结果实时展示在前端页面。

1、立项背景和目标 在日常使用 Git / TortoiseGit 提交代码时，编写符合规范的提交信息（如 Conventional Commits）既耗时又容易遗漏，提交历史质量参差不齐，影响协作与代码审查。大模型已经具备理解代码差异的能力，但缺少一个把「git 变更采集 + 规范约束 + 模型生成 + 便捷交付」串起来的上手即用的工具。本项目目标是：选中任意 Git 项目目录，即可自动扫描全部未提交变更，一键生成规范、可编辑、可复制的提交信息，同时保持零依赖、免安装、配置集中，让普通开发者也能轻松部署使用。 2、软件功能、核心功能模块的介绍 变更采集模块（git_collector.py）：对选中项目执行 git status --porcelain、git diff HEAD、git log，得到变更文件清单、未跟踪新文件、差异内容与近期提交历史。 提示词组装模块（prompt_builder.py）：按配置的提交风格（Conventional / simple）与语言（auto / zh / en）动态拼装 system / user 提示词；长 diff 自动截断并显式标注，控制 token 开销。 模型生成模块（llm_client.py）：通过 OpenAI 兼容接口调用大模型生成提交信息，并对返回结果做清理（去除多余前后缀 / markdown 代码块）；对 401、429、超时等常见错误给出中文友好提示。 图形界面模块（gui.py）：tkinter 界面，左侧变更文件列表、右侧可直接编辑的提交信息；支持「重新生成」「复制到剪贴板」「打开 .env」「选择项目」；后台线程生成、queue 轮询回填，界面不卡顿。 配置与打包（config.py + build.bat）：全部配置收敛在 exe 同目录 .env，PyInstaller 一键打包成免安装单文件 exe。 3、业务流程、功能路径描述 启动程序 → 检测默认项目目录是否为 Git 仓库； 点击「选择项目」→ 指定任意 Git 项目根目录（非仓库会给出提示）； 自动执行 git status / diff / log 采集变更，并在左侧展示变更文件清单； 配置中心：点击「打开 .env」填写 API_KEY / MODEL / BASE_URL / 提交风格 / 语言等； 点击「重新生成」→ 组装提示词 → 后台线程调用大模型 → 结果回填到右侧可编辑文本框； 人工确认或修改后点击「复制到剪贴板」→ 粘贴到 TortoiseGit 或命令行使用（工具本身不执行提交，由用户人工确认，保证安全）。

1、立项背景和目标 真实研究任务常需判断信息源、联网检索、查数据库、查知识库、读附件并汇总生成报告，单次模型调用或搜索问答无法满足。本项目用 DeepAgents 组织主智能体与专家子智能体，打通多智能体规划、工具接入、上下文隔离、接口交付与前端联调的完整链路，并配套免费教程便于学习。 2、软件功能、核心功能模块的介绍 主智能体负责任务规划、调度、汇总与交付（读附件、生成 Markdown、转 PDF）；网络搜索助手用 Tavily 检索公开资料；数据库查询助手通过 SQL 查结构化数据；RAGFlow 助手查私有知识库；FastAPI 提供任务、上传、文件、下载、WebSocket 接口；monitor 实时推送事件；React 前端提供对话式界面。 3、业务流程、功能路径描述 用户输入任务 → 后端创建会话目录并启动后台 Agent；主智能体规划后分派专家助手检索多来源信息、读取上传附件；汇总后调用文件工具生成 Markdown/PDF 到工作目录；全程通过 WebSocket 推送执行事件，用户可实时查看并下载产物。