# Auto_Analysis_Sys

**Repository Path**: lythen/auto_analysis_sys

## Basic Information

- **Project Name**: Auto_Analysis_Sys
- **Description**: 自动问题分析系统，主要用于分析程序运行问题，特别是JAVA程序的（当前第一版）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepTrace

> 大模型驱动的服务器日志 / 堆栈自动分析平台（工作代号，可替换）

**当前状态：M1a 元资产已交付（main=`10b19b2`，审计链/crypto/CI 门禁/golden 锁已落地并有测试）；设计文档 v9（v8 七轮评审关闭设计阶段，v9=2026-09-17 §0.1 核销轮同步）。下一步 M1b 配置闭环，出口复审轮待进行。**

## 它是什么

用户指定**服务器**与**目标程序（App）**并描述问题现象后，平台内的分析 Agent（LLM + Skill）独立自主地连接目标服务器，执行排查命令（`jstat`、`jmap`、`jstack`、`jcmd`、日志检索等），采集并分析日志与堆栈信息，产出**结构化诊断报告**。

对生产环境的每一次操作都处于**分级审批与全量审计**之下，服务器凭据**信封加密存储**。

### 核心特性（设计目标）

- **自主分析，分级审批**：L0-L3 四级命令风险，L2 高危必须人工批准且"执行即消耗"；业务高峰时段干扰类命令自动升级审批
- **模型永不提交命令行**：只选 `commandKey + 结构化参数`，argv 模板白名单 + `execFile` 语义执行，从根上消除命令注入
- **多厂商模型**：Vercel AI SDK 适配 OpenAI / Anthropic / Google / DeepSeek / Ollama / vLLM 等；PRIMARY/SUMMARY 双模型位
- **可插拔连接**：SSH（先行）→ 文件上传 → K8s / 目标机 agent（预留），按服务器配置
- **JVM 纵深**：Java/JVM 技能集起步（GC 日志、jstat 时序、jstack、Arthas 后置）
- **防篡改审计**：RFC 8785 JCS 规范化的哈希链 + 单写队列，等保 2.0 对齐
- **断点恢复**：checkpoint 只存"指针 + 不可推导态"，消息由事件账本重建；崩溃恢复与在线路径逐字节一致

## 文档地图

| 文件 | 说明 |
|---|---|
| [`docs/superpowers/specs/2026-09-15-log-auto-analysis-platform-design.md`](docs/superpowers/specs/2026-09-15-log-auto-analysis-platform-design.md) | **设计文档 v9**——唯一事实源。§0 决策索引（每条决策→章节→来源→一句话依据），§13.1 复审触发条件 |
| [`docs/superpowers/plans/2026-09-15-m1a-meta-assets.md`](docs/superpowers/plans/2026-09-15-m1a-meta-assets.md) | M1a 实施计划（11 任务，测试驱动到代码级） |
| [`docs/对方案的意见.txt`](docs/对方案的意见.txt) | 评审意见原始记录（驱动 v2→v8 修订） |

## 里程碑

| 阶段 | 内容 | 状态 |
|---|---|---|
| **M1a** | 元资产最小可工作版：monorepo、Prisma 全表、信封加密、审计哈希链、CI 门禁①④⑤、break-glass、元测试反例集 | 计划就绪 |
| M1b | 配置闭环：auth/RBAC、Server/App/Model CRUD、连接测试 | — |
| M2 | Agent 核心：ReAct 循环、ToolCallGuard、QuickScan、checkpoint+SSE、JVM Skill | — |
| M3 | 审批/审计/前端/报告 + Arthas 预研 spike + 质量 owner 指名 | — |
| M4 | v2 候选：Arthas、parser 沙箱、K8s 三色、MCP 互操作、hprof 深析 | — |

## 技术栈

Vue 3 + Element Plus ｜ NestJS (Fastify) + Vercel AI SDK ｜ Prisma + SQLite (WAL) ｜ pnpm monorepo ｜ Vitest + Testcontainers + Playwright ｜ Node 22

## 工程纪律（本仓库的运作方式）

- **spec 是唯一事实源**：实现与文档冲突时，停下先修文档（版本 +1）再改代码（§13.1）
- **锁死项不能静默改**：哈希算法 / sampleStrategy / checkpoint schema / 词表被 golden test 锁定，变更唯一路径是 [docs/break-glass.md 流程]（§15.1，M1a 建立）
- **元测试要有反例**：每条 CI 门禁配"故意违反必红"的负例（§11.6）
- 决策可追溯：新决策进 §0 索引表，注明评审轮次来源与一句话依据

## 部署（规划，见 spec §12）

单容器 Docker + 数据卷 + `MASTER_KEY` bind-mount 文件；前端静态由 Nest 同源托管。

---

仓库：`https://gitee.com/lythen/auto_analysis_sys`（main）。开发命令（M1a Task 2 起可用）：`pnpm verify` = typecheck + 全量测试 + CI 门禁。