Deshab-OS/docs/上下文/26072901/Review Context and Use Multi-Agent.md

# Review Context and Use Multi-Agent

> **Workspace:** d:\Code\Deshab

---

## 第一轮 5 智能体推进

### Agent 1: Phase 3 文件传输 IPC

**修改文件**：`CODE/utsm-ipc/ipc_proto.h`, `CODE/UTSM/vmm/hypercall.c`, `CODE/UTSM/vmm/linux_compat.c`, `CODE/linux/patches/utsm_hcall.c`, `CODE/linux/initramfs/bin/utsm_exec_daemon.c`

**双通道协议**：
1. **ring 消息通道**：`FILE_LIST(24)/READ(25)/WRITE(27)REQUEST` + `FILE_RESPONSE(26)`，park-and-resume 同步模型，~1MB `payload_pool` 零拷贝中转
2. **hypercall 直连通道**：`FILE_READ(0x0060)/FILE_WRITE(0x0061)`，Linux 侧直接读写 UTSM FAT32 根目录文件

**分块语义**：单次往返最多搬运 pool 容量（1015712B），大文件递增 `file_offset` 循环；写入约定 `file_offset==0` 即 `O_TRUNC`（整文件替换）

**返回打包**：`FILE_READ` hypercall RAX 低 20 位=暂存字节数、高位=文件总大小

**SHM 布局**：64B header + 2×16400B ring + pool = 恰好 1MB，编译期 `_Static_assert` 守卫

**构建验证**：UTSM 全量重建通过（`utsm.elf` 170384B），Linux daemon 静态编译 827096B，`ipc_proto.h` 三种包含模式全部验证

### Agent 2: virtio-net 网络路径

**修改文件**：`CODE/UTSM/vmm/virtio_net.c`（唯一改动）

**核心 bug 修复**：TX 全坏根因——`net_gather_frame` 原判断 `len > VIRTIO_NET_HDR_LEN` 才跳过头，Linux virtio-net 把 10 字节 hdr 作为独立描述符（len==10）条件不成立 → hdr 拼入待发帧 → 坏包。改为首描述符无条件跳过 `min(len,10)` 字节

**TX 数据路径**：guest QUEUE_NOTIFY(1) → `net_handle_tx` → `net_gather_frame` 跳 hdr、拼接链到 2048B scratch → `net->tx(bound_dev)` 送 e1000 → used 回执 → IRQ6

**RX 数据路径**：1kHz preemption timer → `vmexit_before_resume` → `virtio_net_poll` → `net_handle_rx`：`net_rx_data_region` 解析两种布局（hdr 独立 2 段、hdr+data 同段），校验 W flag；有 buffer 时 `rx_poll` 填入；无包不消耗 buffer；guest 无 buffer 时主动收包丢弃防 e1000 ring 堵死；单次 32 帧 budget

**统计**：rx_filled / rx_drop_nobuf / rx_badbuf / tx_sent / tx_drop，每 512 事件一行

**编译验证**：零 warning 通过

### Agent 3: VMM 核心

**结果**：`vmexit_before_resume` + preemption timer 1ms 周期 exit + interrupt window 注入框架已落盘（汇报丢失但代码在）

### Agent 4: Deaicup 调研

**结论**：推荐路径 B（Linux guest 内 egui 软件渲染 + IPC 拉帧到 Deshab 桌面窗口，类 WSLg）。决策报告已写入 `docs/RE/docs/deaicup_runtime_decision.md`

**依据**：Deaicup 是 eframe 0.27.2 应用，wgpu/glow 双 GPU 后端在无 GPU 环境均不可用；HTTPS 图片加载恰是 Linux guest 已有能力。需新增显示 SHM（800×600 RGBA 1.83MB，建议新 GPA 8MiB）+ 输入转发 + 桌面远程窗口

### Agent 5: FUCK 自定义内核配置

**修改文件**：`CODE/UTSM/kernel/main.c`, `CODE/UTSM/dkm/manifest.c`, `CODE/dsk/main.c`, `CODE/UTSM/arch/x86_64/idt.c`

**框架构成**：
- `ini_parser.c/h`：freestanding 无堆分配，64 条目上限，接口 `ini_parse/ini_get/ini_get_int/ini_get_bool`
- FAT32 子目录遍历：`fat32_find_in_dir` + `fat32_read_path`，支持 `/` 分隔 8.3 路径
- UTSM 经 Limine boot module 读取（cmdline="fuck:config"）；DSK 经 FAT32 自读
- DSK 侧根目录回退：先 `/SYSTEM/DESHAB64/FUCK`，失败再试根目录 `FUCK`

**已接入插桩点**：
1. `[utsm]` 算法参数 → 5 个运行期全局变量覆盖编译期默认值（`max_segments=0x400` 已验证）
2. `[drivers]` 驱动过滤 → `dsm_load_by_manifest_ex` 按名跳过（nvme/virtio_net/ath9k 被 `disabled by FUCK`）
3. `[boot]` selftest/vmm/linux_guest → 三个启动开关
4. DSK 侧 `[dsk]` show_logo/skip_login/mouse_init/netman + `[boot]` dev_mode

## 第二轮 3 智能体推进

### Agent A: net.c 日志刷屏 + mkfat32.ps1 加入 FUCK

1. `CODE/UTSM/kernel/net.c`：删除 `net_tx_impl` 中每包 `log_hex64("[NET] tx dispatch fn=")` 
2. `.build_tmp/mkfat32.ps1`：`$fileDefs` 末尾追加 `@{ Name83 = 'FUCK       '; Path = ...FUCK }`

### Agent B: NVMe 高位 BAR 映射 + 4G+ BAR 失败根因

**现状核实**：`paging.c`/`mmio.c`/`mm.h`/`paging.h` 均已完整可用

**4G+ BAR 失败根因**：
1. Limine HHDM 保证覆盖 RAM 但不保证覆盖高位 PCI MMIO 洞
2. HHDM 映射是 WB cacheable，MMIO 需要 PCD|PWT（UC）属性

**mm_map_mmio 设计**（`CODE/UTSM/mm/mmio.c` + `CODE/UTSM/include/utsm/mm.h`）：
- 4 级页表（LA57 拒绝），运行时扫描 PML4[256..510] 找空闲槽（512GiB）
- 叶子 PTE = `P|RW|PCD|PWT`（UC）；map/unmap 均 `invlpg`
- 冲突：walk 撞大页→失败；PTE 已 present→回滚；unmap 只清自己建的 4K PTE
- 懒初始化（首次 map 时读 CR3/HHDM）

**kernel_api 追加**：`mmio`@+0xB0（并行 agent）、`mm_map_mmio`@+0xB8、`mm_unmap_mmio`@+0xC0

**dkm_shared.h 修复**：末尾追加 `mmio`/`mm_map_mmio`/`mm_unmap_mmio` 三个字段

### Agent C: NVMe 驱动 bug 修复

**三个 bug**：
1. Create IOCQ/IOSQ 的 **CDW10 高低半字写反**：Spec 规定 `CDW10 = QSIZE[31:16] | QID[15:0]`，原代码 `(1u << 16) | (IO_QSIZE - 1u)` 把 QID 放到高半字
2. **错误码丢失 SCT**：`return (int)sc` 在 SC=0/SCT≠0 时返回 0 → 改为 `return (int)(sc | (sct << 8))`
3. **Read opcode 误为 Flush**：`NVME_IO_READ=0x00` 应为 `0x02`（NVM 命令集：00h=Flush, 01h=Write, 02h=Read）

**修复后验证**：`map_mmio` 高位 BAR 映射成功 → admin/IO queue live → READ LBA0 rc=0，DESHABNVME0 签名验证通过 → nvme0 block provider 注册

### Agent D: desktop 集成 Linux 命令为应用图标

**修改文件**：`CODE/tools/desktop_app.h`, `CODE/desktop/main.c`

- `app_descriptor` 增加 `linux_cmd` 字段
- `MAX_APPS` 8→16、`MAX_ICONS` 8→16
- `LINUXAPP.CNF`（8.3名 LINUXAPPCNF）：格式 `显示名|linux命令`
- 缺失时回退默认 NEOFETCH+HTOP
- `lnx_on_create`：同步 `exec()` 阻塞 → 输出经 ANSI CSI 剥离/`^M` 忽略/`\t` 展开后一次性追加
- `draw_icon_linux`：暗底 + 霓虹绿 `>_`

### Agent E: PS/2 鼠标完整实现

**修改文件**：`CODE/mouse/main.c`（从安全 stub 重写为完整实现，318 行）

**初始化序列**：ps2_drain → 读配置字节 → 启用 AUX → 复位 → Set Defaults → 采样率 100 → 分辨率 2 → 启用数据报告

**IRQ12 包解码**：经 `api->irq_register(12, handler)`；读 0x60 前查 AUX 位；3 字节包解码（同步位验证、溢出检测、9 位有符号位移合成）；坐标钳位到 framebuffer 边界

**`mouse_state_t`**（导出 BSS 符号，ABI v1）：magic/version/x/y/buttons/packet_count/overflow_count/max_x/max_y。另提供 `mouse_poll_state()` 只读快照

**handler 存活性**：只注册、不解屏蔽 PIC、不 sti。DSK 用同一块 1MB `ibuf` 加载所有模块，mouseInit 返回后镜像被覆盖

## 整合构建 + QEMU 验证

**desktop.elf 加载失败修复**：BSS 段膨胀（8 个 Linux 窗口槽 + 16KB 缓冲 + MAX_APPS 翻倍）导致 memsz span 1.66MB 超过 `ibuf[1048576]`（1MB）。修复：`ibuf` 扩大到 2MB

**端到端验证结果**：UTSM+FUCK → 14 驱动（NVMe 高位 BAR 映射成功）→ SELFTEST PASS → VMM 优雅降级 → DSK → FUCK 根目录回退命中 → mouseInit → netman（DHCP 10.0.2.15 + ARP + DNS 解析成功）→ FirstInit 账户卡片

**已知遗留**：DSK 加载偶发 `ELF rejected`（AHCI 单扇区读取偶发超时，重跑即可恢复）

## host DKM/框架层发现的问题（未改，仅报告）

1. `e1000.c` `e1000_tx` 每包 3 行 `raw_log` 串口打印，TX 吞吐被压到 KB/s 级
2. `vmexit.c` `maybe_inject_irq` 在 IMR mask 时直接丢弃 pending IRQ，guest mask IRQ6 可能丢一次中断
3. MAC 共用架构限制：guest virtio-net 回填 host e1000 的 MAC，QEMU slirp 下 host/guest 同 MAC 同租约