GVSDS/ViperOS
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
229 Commits 1 Branch 0 Tags
e839b37ee2cf91c8b41bd2e36777f88ab539ba50
Commit Graph
170 Commits
Author SHA1 Message Date
TermiNexus 266e6fbcfb feat(keyboard): 恢复 Shift/CapsLock 与方向键等特殊键 
旧内核桌面 desktop.vp 里有完整的键盘解码（修饰键状态、特殊键映射、重复），S3e 下沉后丢了，只剩一个简化 scancode_to_ascii（shift/caps 字段从未赋值、方向键返回 0 被丢）。① 内核 keyboard.vp：新增解码层 _decode_scancode + 输出队列，跟踪 Shift(0x2A/0x36)/CapsLock(0x3A)/Ctrl/Alt，Shift 输出大写与上档符号、Caps 只翻转字母区；E0 前缀的独立方向键/Home/End/Delete/PageUp/PageDown/Insert 输出 ANSI 序列（ESC[A/B/C/D、ESC[H/F、ESC[3~/5~/6~/2~）；释放码只清状态不产字符。devfs 的 ASCII 字节流契约不变。② vpui：Tk 新增 _ansi_state/_ansi_param 与 _fold_ansi_key()，在 KEY 分发前折叠 ANSI 序列，映射到既有 VK_* 语义（Text/Entry 里那些分支不再是死代码）。Trim：Insert 无 VK_INSERT 定义、被吞掉；typematic 重复未恢复；USB 键盘未涉及。
 2026-10-17 13:01:56 +08:00
TermiNexus 66dc11364a fix(keyboard): 断码不再产出字符，修正每个键输出两个字符 
scancode_to_ascii 先剥掉 bit7（KEY_RELEASED）再查表，导致按键释放也被翻译成同一个 ASCII —— 打 ls 得到 llss。断码直接返回 '\\0'。
 2026-10-17 12:00:26 +08:00
TermiNexus 844fbff31c fix(kernel,explorer): 内核不再画屏消除残留；CREATE 打印 style 诊断 
蓝色残留根因：main.vp 里 VGA_drv.Print 在 __init__ 尾部执行，而它晚于 app spawn —— explorer 已经把桌面画上去了，内核随后又往 framebuffer 打一行测试文本/清屏，于是永远盖在桌面上（整屏刷一次也救不了，因为之后又被画）。S3e 之后屏幕由 explorer 独占合成，直接删除内核侧 VGA 驱动创建与 Print。另：handle_request 的 CREATE 分支加一条诊断打印（style/w/h），用于确认 style 是否真的透传到 explorer —— 5 条日志，定位后撤。
 2026-10-17 11:03:05 +08:00
TermiNexus e1d31c3dc9 diag(explorer,fb0): vblank 返回等待迭代数并打点；脏行合并为一段渲染 
排查'仍闪烁'：① FB_WAIT_VBLANK 改为返回等待消耗的迭代数（到上限 = 超时 = 当前没有 VGA 回扫信号），explorer 首次调用打印一次 —— 用来判定垂直回扫同步是否真的生效；② render() 原来按连续脏行分段、每段各渲染一次，同一帧的多次写屏会跨越多个扫描周期，现在把脏行合并成一段连续范围一次性渲染，缩小撕裂窗口。
 2026-10-16 21:55:36 +08:00
TermiNexus e41701e201 feat(fb0): 新增 FB_WAIT_VBLANK ioctl，合成前等垂直回扫 
explorer 直接写 framebuffer 会与显示器扫描并发，造成撕裂/闪烁；而它在 Ring3 没有 IO 端口权限，不能像历史内核桌面那样自己 inb 0x3DA。所以在 /dev/fb0 上加 FB_WAIT_VBLANK（0x4601）由内核代等垂直回扫（带超时，无 VGA 时序时不死等），vpsdk 暴露 fb_wait_vblank()，desk_server.render() 写屏前调用一次。
 2026-10-16 21:37:58 +08:00
TermiNexus 89c37cea22 fix(mouse): Y 增量取反成屏幕方向，修正上下移动反向 
PS/2 协议的 Y 轴正方向是向上，而屏幕坐标 Y 向下为正，内核出口少了一次取反 —— 现场表现为鼠标上下移动反向。在 devfs 的 mouse_device.read 里统一转换成屏幕方向（消费方直接累加即可），与历史 desktop.vp 中 pkt_dy 的用法保持一致。只改内核，explorer 的 ELF 无需重编。
 2026-10-16 21:33:31 +08:00
TermiNexus 6eb000d01d fix(mouse): 鼠标设备改返回相对位移，光标位置归 explorer 累积 
现场：鼠标一有输入，光标立刻跳到左上角。根因：devfs 的 mouse_device.read 在 size>=9 时填的是 mouse.get_x()/get_y()，而 mouse_x/mouse_y 这两个静态量从未被更新（irq_handler 只把解码后的包入队 packets[]），恒为 0；explorer 拿到 (0,0) 就照抄成光标位置。改法：内核只给出 PS/2 包里的相对位移 dx/dy（uint8 原始字节手工做有符号扩展，不依赖 int8 转换语义），光标位置作为 explorer 自己的状态累积并做边界钳制 —— 内核不知道屏幕几何，钳制本来就该在图形壳这一层。
 2026-10-16 21:23:05 +08:00
TermiNexus 453c353e01 fix(sched): sched_yield 改为无条件切换，原实现只在时间片到期时才切 
现场：app 用 4000 次 yield_cpu() 等 /dev/desk ready（explorer 负责 format 并置 ready=1），却全部超时——三个 app 都打出 [win] desk not ready (attach timeout) / create_window: connect FAILED / geometry win_id=-1，最后静默退出；而 explorer 的 [elf] wrapper pid=5 出现在所有 app 退完之后。根因：YIELD syscall 走 sched.Scheduler.try_reschedule()，而它只在 needs_reschedule（时间片到期，由 tick 置位）时才真正 _yield()，因此 N 次 sched_yield 全落在同一个时间片内一次都不切换 ⇒ 主动等待外设的进程被饿死、初始化者永远轮不上。修法：新增 Scheduler.yield_now() 无条件切换，YIELD 分支改用它；try_reschedule() 仍保留给中断/抢占路径使用。
 2026-10-16 20:57:55 +08:00
TermiNexus 2dacfa85fb fix(input): 启用 PS/2 鼠标初始化，桌面鼠标通路恢复 
main.vp 里 mouse.init() 一直被注释，而 services/mouse.vp 的 start() 只做 USB 鼠标初始化 ⇒ PS/2 鼠标的 IRQ12 从未注册、采样率与数据上报从未使能。表现是 explorer 能 open /dev/input/mouse（fd=3）却永远收不到事件，桌面有键盘无鼠标。恢复调用。
 2026-10-16 20:51:01 +08:00
TermiNexus 48017a3d66 chore(devfs): 清理定位期临时探针，directory_count/file_count 恢复 static 
main.vp：删除 devfs 注册结果回读（[main] devfs reg / files[k] / find_in_dir / serial0(before fb/desk) fd）、fb0 注册后回读（[main] fb0 reg）、desk 共享区地址比对（[main] desk shm）、serial0 查找结果（[main] devfs serial0 fd）共 6 组诊断打印，去掉不再使用的局部量。保留 _CheckFrameLocals 系列（fail-fast 断言，不是探针）。devfs.vp：删除 framebuffer_device.ioctl 内的两条 [fb0] ioctl 诊断打印与随之无用的 import viperlib；directory_count/file_count 恢复 static（跨模块读取点已随探针删除）。fat32_types.vp 的 winread FAIL / dir read failed 保留为正式错误上报（错误必须立即可见），未改动。
 2026-10-16 20:45:40 +08:00
TermiNexus cfb76b1b94 fix(ide): PIO 数据就绪只认 DRQ，并在发命令前/失败后清掉残留扇区 
现场（serial.log 113-136）：winread FAIL abs=8192 res=1，紧接着读根目录扇区 8192 读回 ELF 文件头 ⇒ 目录项全是垃圾 ⇒ Hello/Terminal/Gargantua 三个 spawn 连锁失败，之后又自行恢复（间歇）。两个成因：① waitDataReady 把 DRDY 当作数据就绪（DRDY 空闲时恒为 1），在 BSY 刚清、DRQ 未置的窗口里误判成功，随后从 0x1F0 读到上一次传输的残留；② 一旦某次读提前失败返回、数据没被取走（DRQ 仍置位），ATA 规定设备会忽略命令块寄存器写入 ⇒ LBA 保留旧值 ⇒ 后续每次读都拿到同一块残留缓冲，形成连锁污染。改法：waitDataReady 改为必须 !BSY && DRQ；新增 flushStaleData()，在 readSector/writeSector 发命令前以及失败返回前把残留扇区取走丢弃。未改 includes，无需三重编译。
 2026-10-16 20:39:56 +08:00
TermiNexus 4d0f29d533 fix(devfs): create_file 缺对象时直接失败，不再自建栈实例节点 
把 files[] 改成指针数组后，else 分支的 new_file: devfs_file* = devfs_file() 暴露为栈实例逃逸，编译器以 LifetimeError 拦截（stack address escapes）。改为缺对象一律 return -1：设备节点必须由调用方以长寿命实例（模块级/堆）提供，不静默造占位对象。现有调用点（devfs_register_serial0/serial1/keyboard/mouse/fb0/desk）全部传对象，行为不变。
 2026-10-16 20:34:02 +08:00
TermiNexus 441ea0c883 fix(devfs): files[] 改存指针，避免设备对象按值切片丢掉派生字段 
现场：main.vp 探针读模块级 fb0_file 得 w=1360 h=768 pitch=5440（注册正确），而 explorer 侧 [fb0] ioctl 的 self 读得 w=0 h=0 pitch=0 fmt=0。IR 证据（devfs 编译单元 .text.ll 的 create_file）：files[file_count] = *file_ptr 被生成成 llvm.load/llvm.store 整个 devfs_file 结构体（88 字节基类布局），派生字段 fb_phys/fb_size/fb_w/fb_h/fb_pitch/fb_format 从未被写入，保持 __init__ 的 memset 0；vptr 一并拷过去所以虚调用仍能进 framebuffer_device.ioctl，但读到的派生字段全是 0。这是对象切片而非编译器缺陷。

改法：files 由 [MAX_DEVICE_FILES]devfs_file 改为 devfs_file* 指针数组，create_file 只登记指针（设备对象由 devfs_register_* 以模块级实例持有，生命周期贯穿内核运行期）；find_in_dir/list_in_dir 相应去掉取址；__init__ 的 memset 长度改为指针数组真实大小 8*MAX_DEVICE_FILES（原来按 devfs_file.__sizeof__() 清会越界清掉后面全局量）。顺带修好同样依赖派生字段的 /dev/desk（shm_device.shm_phys/shm_size）。
 2026-10-16 20:32:12 +08:00
TermiNexus 3c595527bc test(fb0): 注册后立刻回读设备对象字段的临时探针 
区分两种真因：devfs_register_fb0 传参即为 0，还是注册正确后设备对象字段被踩成 0。_CheckFrameLocals 只校验 __init__ 的长寿命局部量，管不到设备对象里的字段，因此补一条紧跟注册之后的回读探针，与 explorer 侧 [fb0] ioctl 的 w/h 对读即可定位
 2026-10-16 20:23:58 +08:00
TermiNexus 0fd1bf7567 fix(fb0): 几何登记为 0 + FbInfo 按值返回只回传一半 —— explorer 拿不到 framebuffer 几何 
现场（serial.log 330-339）：[fb0] ioctl fd=6 req=0x4600 arg=0x7fffffdffb78 w=0 h=0 ⇒ request 与 arg 传递都正常、写入回读也正常，真正的问题是设备对象里的 fb_w/fb_h/fb_pitch/fb_format/fb_phys/fb_size 全为 0；随后 explorer 以 pitch=0 调 mmap 失败退出。两个独立缺陷：① 内核侧——devfs_register_fb0 收到的是被清零的 width/height/pitch/fb_format/fb_size（main.vp 顶部注释记录的"__init__ 的 fb/width/height/pitch 局部量被偶发写坏"同类问题：这些长寿命局部量在 L121 之后、L304 之前被写坏，而 L366+ 的 _CheckFrameLocals 又不报，属时点相关），改为在调用点直接从 BootInfo 重取几何并补一条 _CheckFrameLocals(pre_devfs_fb0)；② SDK 侧——fb_get_info 按值返回 32 字节 FbInfo，现场表现为只有前 16 字节有效、后 16 字节是调用方栈残留（size=1802724708 phys=0x130c30），改为出参 out + 返回 ioctl 返回码；③ explorer 侧改为判返回码与 pitch/size 非 0，失败即 _dbg 说明原因后 fail-fast 退出，不再带着 0 几何继续。
 2026-10-16 20:20:36 +08:00
TermiNexus 35fc8b8ea8 chore(devfs): 临时探针 - fb0 ioctl 打印收到的 request/arg 与写入回读，定位 explorer fb 信息全 0 
现场：explorer 打印 [explorer] fb 0x0 pitch=0 fmt=0 size=<垃圾> phys=0x130b90 —— 6 个字段里 3 个为 0、其余是残留，判定「这次 ioctl 没有真正写入用户缓冲」而非写错地址。两种可能：(a) syscall 派发把 request 传成别的值 ⇒ ioctl 直接 return -1；(b) 写入落在用户 VA 之外的地址空间。本探针在内核侧打印 fd/req/arg 与写入后回读的 w/h/pitch/fmt：若 req 不是 0x4600 ⇒ (a)；若 req 正确且回读正常而 app 仍是残留 ⇒ (b)。app 侧应同时检查 ioctl 返回值（非 0 时绝不能用未写入的 info），下一步一并改。
 2026-10-16 20:17:50 +08:00
TermiNexus 14011b1f2d fix(devfs): find_child/list_subdirs 的 dirp 漏了指针星号，导致 devfs_open 返回 -1 
现场：devfs_register_* 之后 files[] 计数与名字全对、find_in_dir 正常，但 files[k].parent_dir 被写成 0x7d218（内核启动栈区 0x60000-0x80000），devfs_open(/dev/serial0) 一律 -1，用户态 app 因此建窗失败、起来就退。根因：devfs_directory.find_child 里 dirp 标注为值类型 devfs_directory 却赋 &directories[d]（指针），list_subdirs 同样是这个 typo；编译器按值类型处理该变量，dirp.parent/dirp.name 读错位数据，return dirp 返回的是栈上残留值（0x7d218），偶然残留槽恰为 &directories[n] 时又看似正常（keyboard 的 0x135018 即此巧合），故表现为时对时错、多数错。改为 devfs_directory*（同文件其余 6 处 &directories[]/&files[] 本就带星号）。
 2026-10-16 20:14:39 +08:00
TermiNexus 745c0e0b83 fix(devfs): directory_count/file_count 去掉 static，允许跨模块读取用于诊断 
编译器报 NameError: drivers.devfs.devfs.directory_count is a static symbol, cross-module use is forbidden（static 仅定义模块内可见）。这两个只是注册计数，改为普通模块级变量即可让 main.vp 的临时探针读取；文件内原有的 global directory_count, file_count 声明语义不变。
 2026-10-16 20:01:10 +08:00
TermiNexus 9469ee8b4d chore(main): 临时探针 - 打印 devfs 注册计数/files[] 名字/直接 find_in_dir，三分 devfs_open=-1 的成因 
devfs_open(/dev/serial0) 在仅注册 serial0/serial1/keyboard/mouse 之后就是 -1，且对象布局已由 MLIR 证明正确（vptr 在偏移 0、files[32] 按值数组、create_file 的路径切分与整份拷贝写法正确）。故加三条探针：注册后打印 directory_count/file_count、逐个打印 files[k].name/private_data/parent_dir、并用 files[0].parent_dir 直接调 find_in_dir(serial0)。判读：counts=0 或名字空 ⇒ 注册没落表；名字正常而 find_in_dir 返回 None ⇒ 名字比较路径坏；两者都正常而 devfs_open 仍 -1 ⇒ 封装层路径切分/返回值问题。
 2026-10-16 19:59:47 +08:00
TermiNexus 73c29a5bd4 fix(fat32): 目录项读取失败时打印 dir read failed 现场并 fail-fast 
dir_read_entry 里 win_read 失败原本静默返回 FR_DISK_ERR：错误虽有上抛，但没有任何现场，上层只能看到 find end res=1（当成找不到文件）或把 win[] 里的残留字节当垃圾目录项（name=ELF、attr=00）解析，无法判断根因是读盘失败。现改为显式打印 [f32] dir read failed sec/off/dirsec/res 后再返回 FR_DISK_ERR。
 2026-10-16 19:49:01 +08:00
TermiNexus 887736d397 chore(main): 临时 bisect 探针 —— 在注册 fb0/desk 之前也查一次 devfs serial0 
上一条探针已否掉重叠假设：desk shm=0xa781000（8MB）与 devfs_files=0x135140 / devfs_dirs=0x134cb0 相距极远，不重叠。本次再补一条 before 探针：若 “before fb/desk” 那行 fd>=0 而之后那行 fd=-1，即证明是本轮新增的 fb0/desk 注册把 devfs 表搞坏；若两行都 -1，则问题在更早（注册顺序/serial0 本身）。
 2026-10-16 19:44:13 +08:00
TermiNexus 7f071b495a chore(main): 临时量出 desk 共享区与 devfs 注册表地址，验证 mm 是否把堆分到内核 .bss 上 
MLIR 已排除编译器布局问题：devfs_file = (ptr, array<64xi8>, ptr, ptr)（vptr 在 0、基类字段在前）、framebuffer_device 在其后追加 6 个字段、files[32] 按值数组 —— 全对、无重叠。于是头号嫌疑转为：devfs_register_desk 里那块 8MB mm.malloc 与内核 .bss（devfs 的 directories/files/directory_count/file_count）重叠，把注册表踩掉 ⇒ devfs_open 查不到设备 ⇒ fd=-1（且 serial0_open 不会被调、无 [serial0] open: 打印）。本探针打印 desk shm 地址/size 与 devfs_files/devfs_dirs 地址，一眼可判重叠。定位后连同上一探针一并删除。
 2026-10-16 19:42:30 +08:00
TermiNexus 2481336dec chore(main): 临时加 devfs serial0 查找结果探针，定位“用户态写串口无输出/设备查找失败” 
症状：三个 app 启动即 [syscall] exit called（create_window 失败 ⇒ is_active(-1) 为 0 ⇒ mainloop 立即返回）、explorer 的 [explorer] start 一行都没有、内核自己的 devfs 冒烟输出（[serial0] open/write）也全缺 ⇒ 三条都指向 devfs_open 查不到设备。探针：[main] devfs serial0 fd=N（<0 即 lookup 失败，serial0_open 不会被调、也就不会有 [serial0] open 打印）。定位后删除。
 2026-10-16 19:38:25 +08:00
TermiNexus d6d07b25ee feat(s5): 删除 TELL/SIZE 私有 syscall —— 用 lseek 的 SEEK_CUR/SEEK_END 表达 
内核：SEEK 补真正的 whence（0=SET 1=CUR 2=END，END 时 offset 为距末尾的距离，offset>size 返回 -1）；删除 TELL/SIZE 的枚举项、派发分支与 TELL/fsize 函数（fat32.tell/size 仍留给 SEEK 内部用）。

SDK：vpsdk/fs.vp 的 seek() 增加 whence 参数（默认 0，调用方不变）；tell() 改为 lseek(fd,0,SEEK_CUR)；fsize() 改为三次 lseek 往返（记住位置 → 跳末尾取大小 → 复位），不改变最终位置。

私有段只剩 5 项：OPENDIR/READDIR/CLOSEDIR（openat+getdents64）与 LOAD_SO/SO_CALL1（动态库加载下沉）。
 2026-10-16 19:33:46 +08:00
TermiNexus c4305301fc fix(vpsdk): 恢复 window.vp 对 vpsdk.stdlib 的 import（app 裸名 malloc 的链接来源） 
现象：ld.lld 报 undefined symbol: malloc，引用来自 Apps/HelloWorld 的 _start（4 处）。根因：malloc 是 vpsdk/stdlib.vp 的 CExport 裸名，app 侧那些裸名调用要靠 window.vp 的 import vpsdk.stdlib 把 stdlib 拉进链接图；S3d 重写 window.vp 时把它当未使用删掉了 ⇒ stdlib 不再进图 ⇒ malloc 无人定义。

同时删除 main.vp 里上一轮加的两处说明注释（按用户要求不保留）。
 2026-10-16 19:20:26 +08:00
TermiNexus d96b632226 chore(main): 删掉内核身份下调 slog.so log_info 的启动冒烟调用 
S4 之后 log_info 走 open(/dev/serial0)+write 两个 syscall，而该调用点在 devfs_init/devfs_register_serial0 之前 ⇒ 那条日志必然丢失。直接删除这个早期验证用的冒烟调用（动态库路径仍被 HelloWorld 的 dynlib.load_so/so_call1 与内核 LOAD_SO/SO_CALL1 覆盖）。同步更新上方的自启动说明注释。
 2026-10-16 19:19:00 +08:00
TermiNexus 5e1cd04478 feat(s4): 删除 SERIAL_PUTS 私有 syscall，用户态改走 /dev/serial0 
内核：删掉 SERIAL_PUTS 的枚举项/派发分支/处理函数（内核自身的 serial.puts 是直接驱动调用，不受影响）。SDK：vpsdk/devfs.vp 新增 serial_puts()（惰性 open /dev/serial0 一次 + write），syscall.vp 删掉该成员。

调用点全部切到 devfs.serial_puts：vpsdk/stdio.vp 的 printf、vpsdk/vpui.vp 的 _serial_puts、Apps/Terminal 的 _sdbg、Apps/Explorer 的 _dbg、Libs/SerialLogger 的 log_info/log_warn（.so 同样走设备节点）。顺带清掉因此失效的 import（vpui 的 _syscall、Terminal 的 _syscall、Explorer 的 syscall）。

至此私有段只剩 7 项：TELL/SIZE/OPENDIR/READDIR/CLOSEDIR（可由 lseek/fstat/openat+getdents64 表达）与 LOAD_SO/SO_CALL1（动态库加载待下沉用户层）。
 2026-10-16 19:17:39 +08:00
TermiNexus 13eee8e8ea feat(s3e)!: 内核 UI 层整体下沉用户态 —— 删 11 个 UI syscall + services/desktop.vp 
内核 intr/syscall.vp：删除 WAIT_WINDOW/CREATE_WINDOW/DRAW_TEXT/GET_WINBUF/WIN_FLUSH/POLL_EVENT/SET_CURSOR/SET_TITLE/SET_GEOMETRY/SET_RESIZABLE/GET_WIN_SIZE 的枚举项、派发分支与对应函数；去掉 services.desktop 依赖；EXIT 不再拆窗口（内核已不持有窗口语义）。

删除 VKernel/Kernel/services/desktop.vp（~2900 行内核桌面/合成/输入分发）；main.vp 不再启动 desktop 线程，只保留一次 fb 局部量一致性校验。剩余 syscall = Linux 对齐段 + 8 个待 devfs 化的私有项（SERIAL_PUTS/TELL/SIZE/OPENDIR/READDIR/CLOSEDIR/LOAD_SO/SO_CALL1）。

SDK：yield_cpu() 从 WAIT_WINDOW(0,2) 改为 Linux 对齐的 sched_yield（内核同样是 try_reschedule）；syscall.vp 同步删掉 11 个 UI 成员。

explorer：关闭按钮改为先通知 CLOSE 再把槽位 used=0 —— window.vp 的 is_active() 见 used==0 返回 0，app 的 while is_active() 自然退出；像素缓冲不复用（bump 分配）⇒ 无别名风险。至此输入只剩 explorer 一家在读（内核桌面已删），两个合成器之争结束。
 2026-10-16 19:11:44 +08:00
TermiNexus bb82c2fe75 fix(desk)!: 事件环改为单环+按 pid 过滤，并补 getpid（S3d 前置） 
缺陷：原设计把事件环按 win_id 索引，但建窗答复 CREATED 必须在 app 知道 win_id 之前送达 —— 按 win_id 索引物理上不可能送达。改为**单一事件环**，每条事件带目标 pid，由 app 用自己的 pid 过滤（与内核旧接口 poll_event(buf, caller_pid) 同口径）。

DeskMsg 增 pid 字段（ring_push/ring_pop 同步搬运，漏搬则事件全被当成 pid=0）；desk_evt_ring_off() 去掉 win_id 参数；desk_format 只初始化一个事件环；服务端 push_event 从窗口槽取 pid、建窗答复走新增的 push_event_pid（此时槽里还没有 pid）。

新增 GETPID（Linux 号 39，此前是"留空"项，现在真正实现）：内核 GETPID() 返回 process.current()，SDK 侧 process.get_pid()。app 需要它才能过滤自己的窗口事件。
 2026-10-16 18:58:43 +08:00
TermiNexus 30708d3250 feat(desk): S3 底座 —— /dev/desk 共享内存通道 + 用户态协议模块 
内核 devfs 新增 shm_device（/dev/desk）：同一物理区间映射给所有打开者；main.vp 启动时 mm.malloc 出 DESK_SHM_SIZE(8MB) 并登记，分配失败只打日志跳过（explorer 的 open 会明确失败，不静默兜底）。内核只负责"分配 + 共享映射"，区间内布局完全不参与。

vpsdk/desk.vp（新增协议模块）：共享区固定布局（DeskHeader / WinSlot / 请求环 / 每窗口事件环 / 像素 arena）、单生产者单消费者环形队列（head/tail，跨进程无锁、全程指针直读写）、explorer 用的 desk_format/desk_arena_alloc 与 app 用的 desk_ready。请求/事件类型常量齐备（CREATE/DESTROY/MOVE/RESIZE/TITLE/FLUSH/ACTIVATE 与 CREATED/CLOSE/KEY/MOUSE/RESIZE）。

vpsdk/devfs.vp 增 DEV_DESK 与 shm_map()；Explorer 启动即 open+mmap /dev/desk、desk_format 初始化并打印头信息，验证 IPC 底座可用。
 2026-10-16 18:53:27 +08:00
TermiNexus 6bd2390e08 feat(explorer): S2 —— 新增图形壳应用 explorer 骨架，用户态经 devfs+mmap 直接写屏 
Apps/Explorer：复制标准 app 骨架（main.vp / linker.ld / project.vpj，链接地址 0x400000）。启动流程：open /dev/fb0 → ioctl(FB_GET_INFO) 打几何 → mmap 拿到线性地址 → 等约 2 秒（等内核桌面首屏全量重绘过去）→ 画一条渐变横条验证像素真上屏 → open /dev/input/keyboard|mouse 验证输入设备可达 → 常驻不退出。

vpsdk/devfs.vp（新增 SDK 设备层）：设备路径常量（与内核注册名逐字一致）、FB_GET_INFO 与 FbInfo 镜像（packed，与内核同布局）、fb_open/fb_get_info/fb_map/kbd_open/mouse_open。

build.py：把 Explorer 加进 required_apps 清单与完整构建分支；内核 main.vp 在四个 app 之后 spawn /APPS/explorer.elf。内核 desktop 与 explorer 并存属迁移中间态，S3 会把窗口合成整体交出去。
 2026-10-16 18:43:13 +08:00
TermiNexus 7d5380148b feat(mmap): S1c —— MMAP 改 Linux 六参形态并支持映射 /dev/fb0 
内核 MMAP(addr,length,prot,flags,fd,offset)：fd=-1 + MAP_ANONYMOUS 走匿名映射（分配物理页、清零后映射到本进程新 VA，对齐 Linux"匿名必为零"语义）；fd 是带 mmap_info 的 devfs 设备（当前仅 /dev/fb0）则把 [phys+offset, phys+offset+len) 按页映射进调用者地址空间（PTE_USER|WRITE）。addr/MAP_FIXED 暂未实现，一律由内核挑 VA 并返回真实起始地址。新增 PROT_*/MAP_*/MMAP_FD_ANON 常量。

参数次序与 Linux mmap 完全一致（rdi/rsi/rdx/r10/r8/r9），syscall_entry 的搬运顺序本就是这个约定，SDK 侧 vpsdk/syscall.vp 加 mmap() 助手走 _syscall6。stdlib.malloc 随之改为匿名映射调用（fd=-1、MAP_PRIVATE|MAP_ANONYMOUS、PROT_READ|PROT_WRITE），行为与原 MMAP(size) 一致且多一层清零。
 2026-10-16 18:40:14 +08:00
TermiNexus f4c653958e feat(devfs): S1 —— 暴露 /dev/fb0 并让用户态可达 /dev/*（含 ioctl） 
devfs：新增 /dev/fb0（framebuffer_device），提供 ioctl(FB_GET_INFO) 回填几何/格式/物理区间，并新增 devfs_file.mmap_info 虚方法（默认不可映射）把物理区间交给内核 mmap 用；main.vp 在 devfs_init 后登记它。输入设备（/dev/input/keyboard、/dev/input/mouse）此前已存在，本轮起从用户态可达。

用户态可达性：Process 增 fd_kind[]（0=FAT32 fileobj*，1=devfs_fd+1），OPEN 对 "/dev/" 前缀改走 devfs，READ/WRITE/CLOSE 按 kind 分派；Process.exit 只对 kind=0 调 fat32.close（把 devfs fd 当 fileobj* 会跑飞）。fd 种类常量放在 process.vp 供 syscall.vp 引用，避免 process 反向 import devfs（devfs→keyboard/mouse→intr.idt→sched→process 会成环）。

新增 IOCTL syscall（Linux 号 16，本轮开始实现）：只放给 devfs 设备，SDK 侧 vpsdk/fs.vp 加 ioctl() 助手。
 2026-10-16 18:38:21 +08:00
TermiNexus ca72ddbbf7 refactor(syscall): 调用号改用 enum 并全面对齐 Linux x86-64 ABI 
内核 intr/syscall.vp 与 vpsdk/syscall.vp 各一份 1..34 的 define 表改为同名 enum Syscall。编号口径：与 Linux 同名同号；Linux 有而我们未实现的留空不占号（12 brk / 39 getpid / 84 rmdir / 217 getdents64 / 257 openat … 需要时按号补）。

15 个语义重合的调用直接用 Linux 号：READ 0 / WRITE 1 / OPEN 2 / CLOSE 3 / STAT 4 / SEEK 8 / MMAP 9 / MUNMAP 11 / YIELD 24 / THREAD_CREATE 56(≈clone) / SPAWN 59(≈execve) / THREAD_EXIT 60(exit) / MKDIR 83 / REMOVE 87 / EXIT 231(exit_group)。

其余 19 个（UI 11 个 + SERIAL_PUTS/TELL/SIZE/OPENDIR/READDIR/CLOSEDIR/LOAD_SO/SO_CALL1）暂放 0x1000 起的**临时私有段**，每条带迁移标注：私有能力最终不占 syscall 号、改走 devfs 设备文件；UI 11 个待用户态 explorer（图形壳）接管 framebuffer 与输入后删除。

内核派发链改 n == int(Syscall.X)（n 是 int/i64、成员是 i32，显式 int() 规避未证实的混合宽度比较）；SDK 全部调用点统一为 syscall.Syscall.X；stdlib 的 SYSCALL_MMAP 别名并入 Syscall.MMAP；Terminal 里硬编码的 uint64(18) 改为常量。
 2026-10-16 18:32:33 +08:00
TermiNexus 4e1be2be88 fix(intr): 修正 isr80 的调用号/arg4 压栈顺序（int 0x80 一直把 arg4 当调用号） 
栈向下增长，先压的落在高地址，而要的布局是 [S+0]=调用号(rax)、[S+8]=arg4(r10)，所以必须先 push r10 后 push rax；原实现反了 ⇒ mov rax,[rsp+40] 取到 arg4 当调用号、mov r8,[rsp+168] 取到调用号当 arg4 ⇒ syscall_handler 收到错误的 n。

现场（探针实测）：用户线程出口跳板 mov eax,34(THREAD_EXIT); int 0x80; jmp $ —— int 0x80 带着错的 n 进 syscall_handler，不匹配任何分支返回 0，iretq 回用户态落到 jmp $ 死转。该线程永不再 yield ⇒ needs_reschedule 无人消费 ⇒ 全系统停止切换：探针显示 cur 冻结在 5、t5 恒为 RUNNING，intr_cs=2B intr_rip=0x7FFFFFDE0007（正是跳板页偏移 7 的 jmp $）rsp=0x7FFFFFDE0000 ⇒ 桌面线程（tid 6）饿死，[perf]/[chk] 永不再打印。

这条路径此前无任何调用者（vpsdk 全走 syscall 指令），所以从未暴露。同时移除定位用的临时探针（timer.vp 心跳/调度器快照、isr.s 的 _intr_*）。
 2026-10-16 18:07:57 +08:00
TermiNexus c29c1953df chore(intr): 探针补记被中断代码的 RIP/CS/RSP，用于定位卡死线程停在哪条指令 
isr.s: ISR_NOERR/ISR_ERR 的 _frame_ready 里把 r8(RIP)/r9(CS)/rax(RSP) 写进新增的 _intr_rip/_intr_cs/_intr_rsp（只读这三个寄存器，不影响随后压栈）。timer.vp: 心跳行追加 3 个 hex32 字段。定时器 1kHz，所以这三个值几乎总是最后一次定时中断打断的现场：intr_cs=2B 表示该线程卡在用户态 intr_rip 处，=08 表示卡在内核。
 2026-10-16 17:58:51 +08:00
TermiNexus 2784b327c7 chore(timer): 临时加 IRQ0 心跳+调度器快照探针，定位「app 退出后 [perf] 停摆」 
每 1000 tick 直接写 COM1 一行 [t] <ticks> <current_tid> <thread_count> <各线程 state>，自带 LSR 超时、不依赖 serial 驱动、绝不挂住 ISR。用来区分三种可能：A) 探针也停 = IRQ0/EOI 死了；B) 探针继续但 cur 恒定且该线程 st=RUNNING = 该线程死循环且不再调用带 try_reschedule 的 syscall，needs_reschedule 无人消费；C) cur 在变 = 调度器活着，问题在桌面线程自身。定位后必须删除。
 2026-10-16 17:40:51 +08:00
TermiNexus f34fe8a378 fix(sched): 用户线程出口改为跳板页，消除「线程函数 return 即 #PF」 
alloc_user_thread 原来在用户栈顶下一格写哨兵返回地址 0：线程函数一旦 return，ret 就把 0 弹进 rip，Ring3 在 VA 0 取指。VA 0 在内核 identity map 里是存在但 supervisor-only 的页，于是现场固定为 rip=0x0 cr2=0x0 err=0x15 (P=1 保护违例 | U=1 用户态 | I/D=1 取指) rsp=线程栈 vtop，日志以 exc in tid=N, terminating 收场 —— 一次正常的线程结束被报成异常崩溃。

实测：Scene3D 渲染线程（唯一的 THREAD_CREATE，其栈顶 vtop 恰为 0x7FFFFFDE0000）在窗口被 taskbar 徽标关闭后 while root.winfo_exists() 退出并 return，日志即 serial.log 489-493 行那三行。

改为一页只含 mov eax,34(THREAD_EXIT); int 0x80; jmp $ 的出口跳板，映射在 [vtop, vtop+0x1000)（线程栈顶之上、栈向下增长永不到达的 64KB 间隙），栈顶哨兵改写成它的 VA。线程函数 return → 跳板 → THREAD_EXIT syscall → 内核干净回收本线程。free_user_thread 同步解映射该页并交还物理页，UserThreadCtx 增 tramp 字段记录。
 2026-10-16 17:02:31 +08:00
TermiNexus 3ee35ad586 fix(sched): exit_current_thread 先标记 THREAD_DONE 再回收资源，堵住已退线程被再调度的窗口 
原顺序是 free_user_thread 在前、state=THREAD_DONE 在后：在已释放用户栈/上下文但 state 仍为 RUNNING 的窗口里，若发生一次再调度（定时器 IRQ → try_reschedule → _yield 仅按 state 过滤），本线程会被再次选中并带着失效上下文回用户态，在已回收的栈上取指 0（现场 [0E] rip=0x0 err=0x15 cr2=0x0 rsp=0x7fffffde0000，紧跟 [syscall] exit called）。_yield 的选择逻辑（THREAD_READY/RUNNING 才可选）本身已正确，故只需把死亡标记提前。
 2026-10-16 16:47:00 +08:00
TermiNexus cc96d00f1a refactor(vesafb): gfx.vp 的 Vec3/Mat4 改为值语义（去指针参数） 2026-10-16 16:40:41 +08:00
TermiNexus 06d24ae1aa chore(kernel): 恢复最小异常现场 dump；EXIT 增加不返回硬保护 
isr.s：ISR_ERR 两条入口写 _fault_rip/_fault_err/_fault_rsp；idt.vp：带错误码向量打印 rip/err/rsp（#PF 追加 cr2），返回槽三连仅在出错 RSP 落在内核栈范围时读取（用户栈下方页未映射，读 [rsp-8] 会触发次生 #PF）。syscall.vp：EXIT 在 exit_current_thread 之后禁止返回（返回会一路 ret 回 app 的 _start 末尾、弹到 0 取指，现场 [0E] rip=0x0 err=0x15）。
 2026-10-16 16:29:04 +08:00
TermiNexus 3a497e38ec fix(usb): 控制传输短读判失败+描述符链完整性校验；CCB 读改写屏蔽 IRQ1；清理已验证探针 
uhci.control_transfer：除错误位外再比对 DATA TD 的 Actual Length(bit10:0)。短读时错误位可能全 0（QEMU/硬件不把短包当错误），只查错误位会漏 —— 现场是 USB 鼠标的 25 字节配置描述符只落下前 9 字节 ⇒ 接口解析为 0 ⇒ [usb_mse] no USB mouse found。

usb._parse_config 改为返回实际走完的偏移，enumerate_port 要求恰好走完 total_len，否则重读、仍不完整即报错返回（fail-fast，不带着半截描述符继续）；同时删除两条探针。

keyboard.init/mouse.init 读-改-写 CCB 全程 pic.setMask(1)：读 CCB 的 0x20 会把 CCB 值放进 0x60 输出缓冲并拉高 IRQ1，IRQ1 handler 会把它当扫描码抢走（现场 sc=0x47），使回读拿到残留值。改为只在校验失败时打印错误，去掉全部 [kbd] 探针。

清理已验证调试输出：idt 的 IRQ1 handler 探针及其计数器、desktop 的 [dbg] back_fb/row_buf/bg_row_buf、main 的 [DBG] LAPIC/idt32/swint/pic_isr 与 [DB] BootInfo 转储、timer 的 [PIT] 与自旋打印及随之无用的 import。
 2026-10-16 15:26:35 +08:00
TermiNexus 82e951ee84 fix(desktop): 建窗与置脏标记加关键区，消除并发导致的共槽/同 z_order 
create() 由各 App 线程经 syscall 并发调用（开机多 App 同时建窗最易命中），但 _win_count/_next_z 的读-改-写无互斥：抢占后读到同一 _win_count ⇒ 两个 App 共用同一 AppWindow 槽，标题/坐标/z_order/fb 互相覆盖；读到同一 _next_z ⇒ z_order 相同，渲染排序退化成槽位下标顺序 —— 均表现为更下方窗口的 title 突然显示到最上方。

改为：关键区①只原子分配槽位，结构体填充留在区外（避免长时间关中断）；关键区②把 active/z_order/焦点一次性发布（渲染线程只在 active==1 后读该槽）。_bring_to_front 的 _next_z 自增同加关键区；_mark_rows_dirty/_mark_all_dirty/_clear_dirty_flags 同加关键区，避免与 App 线程并发时丢置脏标记（丢标记会让该行永不重绘，旧合成滞留在屏幕上）。
 2026-10-16 15:20:49 +08:00
TermiNexus 1b2f6853fc fix(usb): uhci 控制传输逐 TD 校验并暴露错误位，补描述符落盘探针 
- _wait_for_complete 原先只查 status TD 的 bit21|bit22，DATA 阶段的 CRC/超时(bit18)、bitstuff(bit17)、babble(bit20) 会被当成成功 ⇒ GET_DESCRIPTOR 拿到零字节缓冲区仍返回 0，最终表现为 [usb] device class=00 proto=00 ep=0、usb_kbd 找不到键盘（现场）。改为对齐 Linux usb-uhci.h：新增 TD_CTRL_ERR_MASK/NAK_MASK 与 _td_error()，control_transfer 收尾逐个校验 setup/data/status 三个 TD，失败时打印三个状态字。

- usb.vp 增加两条探针：[usb] devdesc blen/btype/maxpkt0 与 [usb] cfgdesc total/b0/t0/iface/proto/ep，用于区分数据未落盘与解析未命中。
 2026-10-16 15:15:58 +08:00
TermiNexus 89907682ec fix(keyboard): init() 对齐 mouse 写法 - 去掉 0xAD/0xAE 键盘接口禁用序列(CCB 回写失败会停在禁用态)，并补 pic.clearMask(1) 2026-10-16 14:14:51 +08:00
TermiNexus d37eac32fe fix(keyboard): init() 改为幂等（避免重复初始化禁用键盘接口）；按键时打印扫描码/字符到串口便于验证 2026-10-16 14:12:50 +08:00
TermiNexus 0d0dba476f fix(vkernel): 键盘无法输入 - 键盘/鼠标共享 0x60 统一为单一消费者(IRQ1 ISR→buffer→desktop 轮询)，IRQ1 只收键盘字节 2026-10-15 17:24:17 +08:00
TermiNexus 0ee5ec5dcc fix(vkernel/ide): PIO 命令块寄存器连写补 io_wait + 读完核 ERR - 修读盘读错扇区(根目录扇区读回 ELF 头致 app spawn 失败) 2026-10-15 17:14:12 +08:00
TermiNexus 2eea065a67 chore(debug): fat32 dir_find/win_read 加取证探针 - 请求8.3短名 vs 磁盘目录项、读盘失败扇区、win_dirty 写盘痕迹 2026-10-15 17:08:58 +08:00
TermiNexus 152c4c5683 feat(vkernel/vpsdk): 用户线程生命周期 - THREAD_EXIT 显式退出；异常终止时回收用户栈并释放槽位；返回哨兵可辨识 2026-10-15 16:50:58 +08:00