# hermes_agent_real **Repository Path**: ycss_1/hermes_agent_real ## Basic Information - **Project Name**: hermes_agent_real - **Description**: 用到了hermes - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-14 - **Last Updated**: 2026-11-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Ticket Hermes Real · Agent 业务问数 本项目由 `ticket-hermes` 的主分支 `d146865` 独立迁出,位于 `E:\ycss\数仓\ticket-hermes-real`。**只提供真正的 Hermes Agent 问数入口**:平台通过隔离进程调用 NousResearch 的 `AIAgent`。指标问数和 Text2SQL 不再是可访问的问数模式,缺少 Agent 时明确提示不可用。 首次阅读建议从[问答、提问规则与技术栈全流程](docs/问答与提问规则全流程-20261113.md)和[项目全流程说明](docs/项目全流程说明.md)开始;本轮验证见[组合规则与聊天图表验收](docs/组合规则与聊天图表验收-20261113.md)。[多指标与问法弹窗验收](docs/多指标与问法弹窗验收-20261113.md)、[六点反馈核查](docs/问数六点反馈核查-20261113.md)和[自主规划工作台验收报告](docs/自主规划工作台验收报告-20261112.md)保留为此前阶段记录,图表与聊天现状以本轮报告为准。修改代码时查阅[模块化开发与代码阅读指南](docs/模块化开发指南.md)。 ## 保留的业务能力 配置维护与代码对照详解:[CFG/DIM 变化后如何升级,以及问题进入系统后每个实体如何处理](docs/CFG-DIM变更与问答实体处理详解-20261113.md)。 - 用户已批准完整多源接入:以远程 `sjbyssh` 的 CFG/DIM 为来源依据,覆盖票务、检票、到访、停车、日报及历史汇总依赖,使用独立本机 MySQL `127.0.0.1:3307` 的 `sjbyssh_cfg`、`sjbyssh_dim`、`sjbyssh_dwb`、`sjbyssh_dws`。 - 本机已接入 43 条来源规则,其中 41 条启用、R30/R32 保持停用;旧口径及草稿保留为停用历史。来源定义由完整快照管理,管理员可查看汇总/明细公式及 SQL 核对,不能通过普通指标编辑覆盖。实际可问范围以当前账号授权为准。 - 景区是收入主体:`MAINBODY_ID / MAINBODY_NAME` → `dim_scenic.scenic_code / scenic_name`。 - 指标配置、校验试算、发布、SQL 核对、账号权限、问法收录与管理。 - 指标中心支持 [AI 创建指标](docs/AI创建指标使用说明.md):DeepSeek 生成可手动修改的草稿,经过本地校验、试算、申请审核、批准和发布后生效。修改草稿或证据会使旧审核失效。 - Hermes 根据授权业务目录理解查数、口径解释、系统操作、一般知识及混合请求,使用 `ticket_respond` 或 `ticket_clarify` 一次提交受限工作单。本地完整检查规则绑定与权限后,编译 SQL 或生成有来源的业务说明;业务日期、私有绑定值、SQL 和查询结果不发给模型。一般知识不要求业务查询日期。 - 单期问数支持最多 10 个指标和 2 个分组维度,要求共同的数据源、时间和固定筛选口径;同比、环比仍限 1 个指标。提问规则弹窗可为 1 至 10 个已发布口径分别标注原句片段,并配置共享分组、筛选和时间解释。共同维度由服务端核验,完整问法经保存、校验、审核及发布后才参与问数。 - 问句可要求饼图、折线图或趋势。已核验来源支持按日/月执行原公式,图表使用同一批本地查询结果,始终保留表格;不适用的指标或分组会解释原因。一般聊天、系统操作与业务口径解释可以直接在问答页提出,只有已确认的数据子句自动收录为待整理问法。 - 业务日历读取本地 DIM 的实际假期和日序;经营日报、项目收入分类表支持对比与 Markdown 输出。规则工作台提供字段差异、审核证据和人工预期验收用例。 - 菜单分为业务分析、规则管理、审核与验收、系统管理;按当前账号权限显示。桌面问数页的“本次执行”位于右侧。 - 自然问数表格前及右侧日志展示“本次理解”:指标、日期、分组、额外筛选和比较方式;右侧还展示授权查询依据及阶段耗时。模型失败、超时、环境和计划异常分别提示。分析预设在 `config/analysis-presets.json`,公式和维度仍在指标中心管理。 ## 独立运行位置 | 项目项 | 本项目默认值 | |---|---| | Windows 源码 | `E:\ycss\数仓\ticket-hermes-real` | | Windows 私有配置 | `D:\chatgpt_cache\hermes-ticket-real\private` | | Windows Python 3.12 | `D:\chatgpt_cache\hermes-ticket-real\platform-env` | | Windows 日志 | `D:\chatgpt_cache\hermes-ticket-real\platform` | | Windows MySQL | `127.0.0.1:3307`,独立进程,不注册为 MySQL90 服务 | | Windows MySQL 数据 | `D:\chatgpt_cache\hermes-ticket-real\mysql3307\data` | | 内部网页 | `http://127.0.0.1:19131/ask/` | | Rocky 服务 | `ticket-hermes-real.service` | | Rocky 安装/配置 | `/opt/ticket-hermes-real` / `/etc/ticket-hermes-real` | | Rocky Nginx 网页入口 | `29131`,需按新入口配置映射 | 旧项目的 3306 四库和 19121 应用已按用户单独授权升级;本项目使用独立的 19131 / 3307,不管理旧项目的启停。相关历史操作见[3306 升级验收](docs/3306四库与旧应用升级验收-20261111.md)。本项目授权远程为 [Gitee · hermes_agent_real](https://gitee.com/ycss_1/hermes_agent_real),主分支为 `master`,不能推回旧仓库。本项目的数据量、校验结果与来源局限见[来源迁移验收](docs/来源迁移验收-20261111.md)。相同 Vastbase 用户/schema 仍会共享向量表,MySQL 隔离不自动隔离向量存储。 ## Windows 使用 先准备新项目的独立 Python 3.12 环境: ```powershell Set-Location 'E:\ycss\数仓\ticket-hermes-real' .\install.ps1 -Python 'D:\python-3.12.0\python.exe' ``` 在本项目私有目录配置 `cfg-reader-mysql.json`、`cfg-admin-mysql.json` 和 `siliconflow.key`。两份数据库配置须显式填写 `host: "127.0.0.1"`、`port: 3307`,分别使用独立实例专用读账号和管理账号,运行账号不能使用 root。不要直接沿用原项目指向 3306 的连接配置。密钥和真实连接不放入源码仓库。 独立 MySQL 的初始化与私有账号由维护步骤单独完成。之后正常启停使用: ```powershell .\start-mysql3307.ps1 .\start.ps1 -NoBrowser ``` 停止本项目时先执行 `.\stop.ps1`,再执行 `.\stop-mysql3307.ps1`;这会结束本项目正在进行的查询。 脚本仅接受固定实例路径,并核对 PID、监听进程及实际数据目录;不会初始化、重建数据库或管理 MySQL90。先启动独立数据库,再启动应用。详细布局和验证要求见 [独立 MySQL 3307 运行说明](docs/独立MySQL3307运行说明.md)。 真实 Agent 必须另外准备固定版本源码和 Python 3.14 环境,然后运行: ```powershell . .\runtime-env.ps1 # 替换为实际的独立 Agent 解释器与固定版本源码路径。 & $platformPython -B -m agent_runtime.install configure --python '' --source '' & $platformPython -B -m agent_runtime.install check ``` 配置完成后双击 **启动业务平台.cmd**;代码更新后双击 **更新业务平台.cmd**。浏览器访问 `http://127.0.0.1:19131/ask/`,配置中心为 `/cfg-admin/`。平台账号来自独立 CFG 库中保留的管理记录;新增管理员 CFG/DIM 目录可核对来源快照、表结构、映射及实际导入记录。 2026-11-12 的本地 3307 已完成治理表增量迁移。其他环境先核对治理表与必要授权;`deploy/migrate_workbench.py --check` 默认只检查,`--apply` 严格限定本机独立 3307,不能当作服务器通用迁移命令。此次没有部署 Linux 服务。 ## Rocky 9 部署与后续更新 当前交付支持源码包首装,不需要先建立 Git 远程仓库。详细步骤见[首次安装](deploy/rocky9/FIRST-INSTALL.md)、[版本更新](deploy/rocky9/UPDATE.md)和[Git 部署](deploy/rocky9/GIT-INSTALL.md),数据库阶段见[生产数据库命令](docs/production-database-contract.md)。本轮验证范围和正式环境待验收项见[Rocky 9 部署验收报告](docs/Rocky9部署验收报告-20261113.md)。 将源码包解压到 `/opt/ticket-hermes-real/app-版本号`,进入该目录执行: ```bash sudo bash install-rocky9.sh ``` 按提示填写数据库地址、原始业务库名、一次性数据库管理账号、应用服务器连接来源和云模型 Key。正式四库默认 `sjyyssh_cfg`、`sjyyssh_dim`、`sjyyssh_dwb`、`sjyyssh_dws`,需要预先存在并清空表数据。脚本先检查所有目标,再导入当前 CFG/DIM 业务种子,从正式原始库的七张依赖表构建 DWB/DWS、核对指标并创建独立运行账号和首位管理员。原始库只读。遇到非空目标、结构不兼容或构建失败会停止,不会自动清表。 安装继续准备固定版本 Hermes、systemd 和 Nginx;默认 Agent 问数不要求向量数据库。应用内部端口 19131,网页入口默认 29131。首次管理员密码随机生成,保存在服务器私有的 `bootstrap/platform-login.json`,不写入源码包。依赖和固定 Hermes 源码仍需联网下载。 更新时保留旧版本目录,将新版解压到另一个 `app-版本号` 目录,在**新版目录**运行: ```bash sudo bash update-rocky9.sh ``` 更新只执行受支持的增量结构升级,保留 CFG/DIM/DWB/DWS 数据、用户、发布规则和草稿,不再导入首装种子或重建事实表。若使用同一组正式库,记录仍然共享;独立代码目录不等于独立业务库。Git 安装和更新使用上述新仓库的 `master` 分支,命令见[Git 部署](deploy/rocky9/GIT-INSTALL.md)。 Git 保存完整应用源码、测试、文档、部署脚本及首装业务种子。私有连接、密钥、日志、运行数据、生成的 `delivery/` 安装包和 `demo/` 原始参考材料保留在本地;其中参考压缩包含私有配置,不能随源码上传。生成安装包的方法见 `deploy/package_release.py`。 Windows 本机仍默认 `sjbyssh_*` / 3307;生产通过 `TICKET_DB_PREFIX` 和 `TICKET_SOURCE_SCHEMA` 独立配置。本轮已用临时 MySQL 验证初始化与升级;正式服务器地址尚未提供,Rocky 9 实机部署和正式云模型访问需要在服务器上另行验收。 ## 验证与边界 测试脚本集中在 [`tests/`](tests/README.md),按平台、指标、数仓、部署、外部适配、Agent、问数、前端、Windows 和真实验收分类。根目录 `selftest.ps1` / `selftest.py` 保留为离线自测入口,主体在 `tests/run.py`,运行时隔离真实凭据。 准备手工测试时查看[新项目用户测试报告](docs/新项目用户测试报告-20261111.md);自定义规则是否能发布并用于 Agent,见[复杂规则能力评估](docs/自定义复杂规则能力评估.md)。 `/api/health` 只表示 HTTP 存活;Agent 就绪使用 `agent_runtime.install check`。真实验收工具位于 [`tests/live/`](tests/live/README.md),须配置环境后显式执行:`verify_multisource_live.py` 是四例冒烟对账,`verify_source_matrix_live.py` 覆盖全部已发布来源指标的有限矩阵。逐指标结果见[全指标云模型验收记录](docs/全指标云模型验收-20261111.md)。`verify_agent_live.py` 属于旧单源历史验证,不能替代当前验收。 本次迁移清单见 [独立项目迁移说明](docs/独立项目迁移说明.md) 和 [源文件校验清单](docs/migration-source.json)。源业务库是已有快照,迁移项目不会增量刷新数据。未授权字段、未知筛选、不支持的分析会拒绝或要求明确,不承诺任意 SQL/任意问题。 ## 代码位置 `hermes_platform/modules/agent/conversation.py` 是当前问答编排,`conversation_privacy.py` / `conversation_state.py` 管隐私与会话,`knowledge*.py` 管业务知识,`planning.py` / `planning_catalog.py` 管受限分析、授权目录与本地绑定,`agent_runtime/` 是上游隔离桥接;`modules/analysis/` 为日历/报表,`modules/governance/` 为差异/审核/验收,`modules/metrics/` 为指标/问法和来源目录,`modules/access/` 为权限。`ticket_warehouse/` 为数仓规则与来源接入,`static/` 为问数页面,`codex_cfg/static/` 为配置中心。 正式初始化与增量升级在 `deploy/database/`,Rocky 编排在 `deploy/rocky9/`;20 个根目录历史脚本的实现已归入 `hermes_platform/legacy/` 和 `maintenance/`,根文件保留兼容入口。模块索引和问数阅读顺序见[模块化开发指南](docs/模块化开发指南.md)。 为保持已验证规则、测试和兼容导入,原查询实现的内部模块仍保留;HTTP 入口不再实例化旧两种问数引擎。`docs/` 中带“历史参考”标记的文档保留迁移来源,不是本项目的发布步骤。