文档:整理项目规则与当前开发说明
This commit is contained in:
+10
-2
@@ -1,8 +1,16 @@
|
||||
# AI 智能分析当前要求与排查修复基准
|
||||
|
||||
适用项目:质量数据分析平台。更新日期:2026-11-02。
|
||||
适用项目:质量数据分析平台。基础要求日期:2026-11-02;运行与展示边界补充:2026-11-12。
|
||||
|
||||
本文只列当前有效要求与对应验收标准,供智能分析排查、修复和交付时使用。
|
||||
本文保留基础业务口径及排查要求。当前实现与验收范围另见 [DSH 接入说明](DeepSeekHarness正式接入.md);下文涉及早期执行、模型审阅和图表完成条件的描述,按本节更新理解。
|
||||
|
||||
## 当前运行与展示边界
|
||||
|
||||
- 正式智能分析固定使用 DSH,API 配置不提供双引擎切换;旧引擎与旧实施方案只作历史参考。
|
||||
- 保存和展示模型原始正文,不追加模型审阅、格式修复或固定模板改写;服务端的权限、范围、参数与正式口径检查继续保留。
|
||||
- 普通提问直接回答,只有明确要求时生成报告,追问保留已确认的输出目标。
|
||||
- 图表是可选呈现。生成或加载失败时静默省略并保留后台诊断,不因缺图将已有正常回答标成失败,不展示异常图框或重试入口。
|
||||
- 当前进度与已验证范围见 [当前进度](当前进度.md)。历史验收通过不表示所有未来问题或所有平台均已通过。
|
||||
|
||||
## 1. 全链路要求
|
||||
|
||||
|
||||
@@ -2,10 +2,14 @@
|
||||
|
||||
更新日期:2026年11月12日。
|
||||
|
||||
本文件按当前 Java 引擎约束、独立应用构建入口及最新交付说明整理;项目现状和待办见 [当前进度](当前进度.md)。11月10日的双引擎切换、额外模型审阅和早期报告缺项属于历史阶段,不能作为当前运行说明。
|
||||
|
||||
## 当前入口
|
||||
|
||||
质量智能分析固定使用 DSH。Java 提供身份、授权、正式指标、会话、工具与已保存结果;Python 编排当前模型和工具;DSH 执行思考与工具循环。正式入口是 `scripts/quality_analysis_runtime.py`,独立应用通过 `scripts/build_dsh_application.py` 构建。运行时应用不包含 nao 服务、客户端或执行器。保留的 `nao_*.py` 源文件是打包前的共享业务算子,构建时转换为中性模块名。
|
||||
|
||||
根目录 `scripts/quality_analysis_runtime.py` 仍保留早期双引擎兼容逻辑;当前 Java 正式分析入口固定 DSH,构建后的独立应用使用自己的运行入口。排查线上行为时先核对守护登记的实际运行包,不把根目录兼容源码当作当前部署。
|
||||
|
||||
前端智能分析入口为 `web/src/agent/AgentWorkspace.tsx`。仅保留对话界面,工具调用在对话内展开;会话先加载最近一页,再按需读取历史,通过会话事件流更新。删除会话只操作当前账号拥有的记录。
|
||||
|
||||
## 模型回答与报告
|
||||
|
||||
@@ -0,0 +1,44 @@
|
||||
# 当前进度
|
||||
|
||||
核实日期:2026年11月12日(上海时区)。这是可更新的接续记录,不替代实际代码与运行状态。
|
||||
|
||||
## 当前任务
|
||||
|
||||
目标:修正主目录过时说明,补充轻量项目规则与统一进度入口,并按后续授权同步当前文档到 Gitea。
|
||||
|
||||
验收条件:README 与当前 DSH 实现一致;项目规则简短、入口有效;旧验收明确属于历史记录;仅同步本次当前文档,不改业务代码、数据库或服务配置,不部署。
|
||||
|
||||
已完成:补充根目录 `AGENTS.md`,更新 README、DSH 接入说明和旧文档的适用范围;本文件作为后续接续入口。已核对9个新增本地文档链接、关键代码入口和改动范围,Git 差异空白检查通过;仅6份 Markdown 变化,原交付说明正文及业务源码保留。本次文档整理未运行构建或业务测试。
|
||||
|
||||
## 已核实的项目状态
|
||||
|
||||
| 项目 | 本轮事实及证据 |
|
||||
| --- | --- |
|
||||
| 主工作目录 | 仓库根目录,分支 `codex/analysis-tool-lifecycle-fixes-20261103`,HEAD `52d92c9`。开始整理前显示 379 项修改/删除/未跟踪条目,不等于 379 项未交付功能。 |
|
||||
| 整理前仓库主线 | 文档整理前远端 `main` 为 `bc19475b29fa7331fe729c27af54036cb124db72`,对应交付目录为 `output/gitea-dsh-20261112/worktree/`。本次文档同步在此基础上单独提交;同步后的具体提交以 Git 历史为准。主工作目录的分支与业务改动不变。 |
|
||||
| 与主线的差异 | 整理前按主线已跟踪文件逐一比较,主目录无缺失,8 个文件不同,其中两个仅多空行。其余涉及文档、设计、Docker 打包清单和 Excel 导出实现/测试;本轮文档改动另计。 |
|
||||
| 线上前端 | 公开 `release.json` 返回 `2026.11.12.40`,引擎 DSH 且锁定;保留旧提交 `3962521` 及补丁标记,版本与完整源码尚未一一对齐。 |
|
||||
| 当前后端 | 本机服务守护、MySQL 和后端就绪;本地健康检查为 UP。守护使用已登记的不可变 JAR,DSH 使用独立应用。运行包与根目录源码不应直接视为相同版本。 |
|
||||
| 当前页面 | 既有线上标签页正常显示总体查询与月度数据。本轮未重新执行全业务验收。 |
|
||||
| Excel 导出 | 今日格式调整有部署与页面验收记录,源码相对最新主线仍有差异。此前同日现状检查实际重跑 `node --test web/verification/metric_workbook.test.mjs`,23 项通过;不是全量测试,本次文档整理未重复运行。 |
|
||||
| 自动维护 | 备份和旧数据回收因当前 JAR 与已登记兼容版本不一致而延期。维护状态提示需复核,不能直接解除保护。 |
|
||||
| 现存备份 | 最近记录为11月10日晚,清单状态 `ISOLATED_RESTORE_VERIFIED`;目录存在、清单指针摘要匹配。本轮未重做恢复,清单中的应用启动验证为 false。 |
|
||||
| 容量监控 | 本轮采样:MySQL 约10.79 GiB,交付/构建产物约33.62 GiB,可用空间约534 GiB;提示一个超过24小时的测试资源。仅作时点记录,不据此删除。 |
|
||||
|
||||
运行配置、模型凭据、会话标识、真实业务行和备份内容不复制到本记录。
|
||||
|
||||
## 已约定的执行边界
|
||||
|
||||
- 文档整理后,用户另行授权同步到 Gitea。本次仅提交 `AGENTS.md`、`README.md`、`docs/当前进度.md`、`docs/DeepSeekHarness正式接入.md` 和 `docs/AI智能分析要求与排查修复基准.md`;不发布、不改变现有业务行为。
|
||||
- 仓库为公开仓库,按原有 Git 排除规则将 `开发交付说明.md` 及本地验收资料留在本机。本次同步不解除排除规则,不上传业务原件、备份或账户资料。
|
||||
- 智能分析固定 DSH、模型正文原样保留、报告按明确要求生成、图表故障静默;具体代码与边界见 [DSH 接入说明](DeepSeekHarness正式接入.md)。
|
||||
- 历史源码、交付记录和原表基线继续保留;旧数据覆盖范围和早期方案不能当成当前验收。
|
||||
|
||||
## 待处理与下一步
|
||||
|
||||
1. 运维:检查当前运行包及数据库结构与维护逻辑的兼容性,再决定恢复自动备份和回收;需要新的恢复验证,不能只更新兼容标记。
|
||||
2. 版本:核对线上产物、最新主线和主目录剩余差异,特别是今日 Excel 导出改动;分别记录应同步与应保留的内容,不直接整体提交。
|
||||
3. 平台:Linux Docker 构建、启动、DSH 等效隔离及恢复仍待目标机验收;Windows 更新/恢复也不能由本轮检查替代。
|
||||
4. 容量:核实构建产物及超期测试资源的用途、所有者和活动状态后,再提出清理范围。
|
||||
|
||||
下次继续:先看根目录 `AGENTS.md`,核对本记录、实际分支/未提交内容及服务状态,然后只推进当次明确的任务。状态变化时更新本文件,不新建重复的当前进度文档。
|
||||
Reference in New Issue
Block a user