# Khy-OS 不合格情况记录（2026-05-16）

## 0. 修复后复测更新（2026-05-16 22:42 +0800）

### 0.1 已修复项（本轮通过）

| 条款 | 状态 | 复测证据 |
|---|---|---|
| 3.1.1 / 3.7.1 自动化启动 | 已修复 | `docker compose up -d --build` 成功；`docker compose ps` 显示 `backend/ai-backend` healthy，前端服务运行中。 |
| 3.1.1 文档一致性 | 已修复 | README 已补充 Docker 一键启动与验收地址，端口与 compose 默认值一致。 |
| 3.7.2 依赖人工干预 | 已修复 | 新增 `.env.example`，并在 `docker-compose.yml` 中为关键变量提供默认值，无需手工补齐即可启动。 |
| 3.3.4 测试标准（目录+脚本） | 已修复 | 已具备 `unit_tests/`、`API_tests/`、`run_tests.sh`；`./run_tests.sh` 通过（unit 4/4，api 1/1）。 |
| 3.7.5 依赖污染 | 已修复 | 清理后执行 `find . -maxdepth 3 -type d \( -name node_modules -o -name .venv -o -name .pytest_cache -o -name dist \)` 无输出。 |

### 0.2 仍待整改项（质量维度）

| 条款 | 当前状态 | 说明 |
|---|---|---|
| 3.3.1 架构分层/可维护性 | 待整改 | 仍存在超大职责文件（如 `Dashboard.vue`、`router.js`、`largeTasks.js`），建议继续拆分。 |
| 3.2.2 真实逻辑实现 | 待整改 | 仍有失败路径回落 mock/模拟数据的实现风险，需按题目要求逐项确认是否允许。 |
| 3.3.2 代码整洁度 | 待整改 | 部分调试日志与冗余输出仍需系统性清理。 |

### 0.3 当前判定（更新）

- **红线项（3.1/3.7）本轮已解除。**
- 仍有质量项待整改，建议继续按 3.3/3.2.2 清单推进后再提交最终验收。

## 1. 记录信息
- 记录时间：2026-05-16 22:04:25 +0800
- 评估对象：`/home/kodehu03/Khy-OS`
- 评估标准：你提供的 3.1 ~ 3.7 验收标准
- 初次评估结论：**不合格（当时触发 3.1 与 3.7 红线）**

## 2. 红线不合格项（3.1 / 3.2 红线优先）

| 条款 | 结果 | 问题描述 | 证据 |
|---|---|---|---|
| 3.1.1 / 3.7.1 自动化启动 | 不合格 | `docker compose up -d` 失败，前端镜像构建在 `npm ci` 阶段报错（`package.json` 与 `package-lock.json` 不一致，EUSAGE）。 | [frontend/Dockerfile](/home/kodehu03/Khy-OS/frontend/Dockerfile:7), [frontend/package.json](/home/kodehu03/Khy-OS/frontend/package.json:40), [frontend/package-lock.json](/home/kodehu03/Khy-OS/frontend/package-lock.json:30) |
| 3.1.1 文档一致性 | 不合格 | README 未提供可直接执行的 `docker compose up` 全栈启动与验收步骤。 | [README.md](/home/kodehu03/Khy-OS/README.md:110) |
| 3.7.2 依赖人工干预 | 不合格 | 缺少 `.env.example`，但 compose 依赖 `JWT_SECRET`（以及 profile 下 `POSTGRES_PASSWORD`），新环境需人工猜测/补配置。 | [docker-compose.yml](/home/kodehu03/Khy-OS/docker-compose.yml:53), [docker-compose.yml](/home/kodehu03/Khy-OS/docker-compose.yml:11) |

## 3. 质量不合格项（3.3 ~ 3.6）

| 条款 | 结果 | 问题描述 | 证据 |
|---|---|---|---|
| 3.3.4 测试标准 | 不合格 | 缺少根目录 `unit_tests/`、`API_tests/`、`run_tests.sh`；现有 `backend/tests` 不满足要求的目录与统一 Shell 编排格式。 | 实测：`unit_tests_missing`, `API_tests_missing`, `run_tests_missing` |
| 3.3.1 架构分层/可维护性 | 风险高 | 存在超大“上帝文件”，职责聚合过重。 | [frontend/src/views/Dashboard.vue](/home/kodehu03/Khy-OS/frontend/src/views/Dashboard.vue), [backend/src/cli/router.js](/home/kodehu03/Khy-OS/backend/src/cli/router.js), [backend/src/routes/largeTasks.js](/home/kodehu03/Khy-OS/backend/src/routes/largeTasks.js) |
| 3.2.2 真实逻辑实现 | 风险高 | 多处核心数据路径在失败时直接回落到 `mock/模拟数据`；若题目未明确允许 mock，将判定不达标。 | [backend/src/controllers/comprehensiveDataController.js](/home/kodehu03/Khy-OS/backend/src/controllers/comprehensiveDataController.js:149), [backend/src/routes/marketData.js](/home/kodehu03/Khy-OS/backend/src/routes/marketData.js:37), [frontend/src/views/Dashboard.vue](/home/kodehu03/Khy-OS/frontend/src/views/Dashboard.vue:1251) |
| 3.3.2 代码整洁度 | 不合格 | 存在大量调试日志（`console.log` 等）未清理。 | [frontend/src/api/marketData.js](/home/kodehu03/Khy-OS/frontend/src/api/marketData.js:54), [backend/src/controllers/marketController.js](/home/kodehu03/Khy-OS/backend/src/controllers/marketController.js:27) |

## 4. 不可验收项（3.7）

| 条款 | 结果 | 问题描述 | 证据 |
|---|---|---|---|
| 3.7.1 自动化启动失败 | 不可验收 | 构建失败导致容器未起来。 | 实测 `docker compose ps --all` 无运行容器 |
| 3.7.5 依赖污染 | 不合格 | 项目目录中存在 `node_modules/`、`dist/`、`.pytest_cache/` 等。 | 目录实测：`./node_modules`, `./frontend/node_modules`, `./backend/node_modules`, `./frontend/dist`, `./dist`, `./.pytest_cache` |

## 5. 提交流程不合规项
- 未发现按“AI report prompt 测试指令”提交的自测合格度报告产物。
- `docs/reports/` 目前仅见 skill eval 结果，不等同于本次验收要求的自测报告。

## 6. 本次核查命令（摘要）
```bash
docker compose up -d
docker compose ps --all
find . -maxdepth 2 -type d \( -name unit_tests -o -name API_tests -o -name tests \) | sort
[ -d unit_tests ] && echo unit_tests_exists || echo unit_tests_missing
[ -d API_tests ] && echo API_tests_exists || echo API_tests_missing
[ -f run_tests.sh ] && echo run_tests_exists || echo run_tests_missing
wc -l frontend/src/views/Dashboard.vue backend/src/cli/router.js backend/src/routes/largeTasks.js
```

## 7. 当前判定
- 按你的规则，3.1 与 3.7 命中即一票否决。
- **当前状态：不合格，建议先修复红线项后再进入返修与评分流程。**
