GVSDS/ViperOS
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
268 Commits 1 Branch 0 Tags
b9efc30d7134dcbeefe8313701f045169de6d49f
Commit Graph
51 Commits
Author SHA1 Message Date
TermiNexus b9efc30d71 feat(window): 标题栏 hover、最大化图标、边缘缩放与控件光标 
1) 标题栏按钮 hover：min/max 背景按 alpha 压暗，close 变红、图标变白；
   按下态更深。新增 hover_btn_win/kind，仅在变化时重画标题栏。
2) 最大化图标改为单线方框（上边框不再两行加厚）；最大化后显示
   两个错位重叠方框作为“还原”。
3) 窗口边缘 5px 热区支持拖拽缩放：左/右 ↔、上/下 ↕、四角斜向；
   缩放中实时更新几何与内容缓冲（按 1.5 倍扩容，避免 arena 抖动），
   并向 app 发 RESIZE。
4) 新增 DESK_REQ_CURSOR / window.set_cursor_type 真正下发光标类型；
   explorer 按窗口 cursor + 边缘热区选择箭头 / I 形 / 手指 / 缩放光标。
5) vpui.Tk 在 HOVER 时按最上层控件设置光标：Entry/Text → I 形，
   Button → 手指；Entry 自己的光标请求移除，避免与集中逻辑冲突。
 2026-10-27 13:14:42 +08:00
TermiNexus 6ecd891f64 fix(desk): 清空共享区槽表并按版本拒绝旧 app 
现场：所有窗口消失、任务栏多出若干图标，点击后 explorer 以
[0E] rip=0x4061e8 cr2=0x1207e8fff 缺页退出。

原因：desk_format 只清 DeskHeader，没有清 0x100 起的 WinSlot 表。
DESK_SHM_SIZE 从 8MB 提到 32MB 后，mm.malloc 拿到的内存不再恰好全零
（混入 bootloader/固件遗留数据），随机 used/active 被当成窗口，
合成时按垃圾 fb_off 越界读像素。

- desk_format 先 memset 整个控制区（0x000000 ~ 0x200000）
- 分配槽位时整槽清零，避免复用残留
- DESK_VERSION 1 → 2，desk_ready 校验版本：
  旧 app 按旧 WinSlot 偏移读写会写坏共享区，现在直接拒绝挂载
- render_window_rows 校验 fb_off 范围，坏槽位只跳过，不再拖崩合成器
 2026-10-27 12:52:23 +08:00
TermiNexus 632bc877df feat(window): 鼠标捕获与窗口最小化/最大化 
鼠标：
- 内容区按下后记录 capture_win，按住期间的移动仍投 HOVER、松开投 RELEASE
  （即使光标移出窗口）。此前 btn_down != 0 时完全不发 HOVER，滚动条
  拖动拿不到位置更新。
- 标题栏按钮按下态改为通用 btn_win/btn_kind，支持关闭/最小化/最大化。

窗口：
- WinSlot 新增 maximized、restore_*、fb_cap 字段
- 最小化：隐藏窗口并把焦点交给最高可见窗口；任务栏点击恢复，
  再点一次已聚焦窗口则最小化
- 最大化：保存还原几何，铺满工作区（不含任务栏）并发送 RESIZE 事件；
  再次点击还原；拖动最大化窗口会先还原
- 像素缓冲按 fb_cap 复用，仅在容量不足时从 arena 扩容，避免反复
  最大化/还原耗尽 bump arena
- 1920x1080 最大化需要约 7.3MB 内容缓冲：DESK_SHM_SIZE 8MB → 32MB
 2026-10-27 12:43:19 +08:00
TermiNexus 338472e304 fix(vpui): Label 自然尺寸与 pack 交叉轴居中 
Input Demo 的两个显示问题：

- Label 没有显式 w/h，构造后 w/h 恒为 0：pack 时按 0 尺寸计算，
  PACK_BOTTOM 的标签被贴到内容区底边之外（字模被裁），且不占纵向空间，
  后面的按钮与 Name: 标签重叠。新增 _fit_natural() 按文本最长行/行数
  计算自然尺寸，__init__ 与 config() 时更新。
- pack 在未 fill 时原先一律贴左上，导致 Submit 按钮紧贴左边缘。
  改为与 tkinter 默认 anchor=center 一致：TOP/BOTTOM 横向居中、
  LEFT/RIGHT 纵向居中，沿 pack 方向仍保留 padx/pady。
- redraw 先刷新窗口尺寸再 _do_layout()，避免 resize 后布局滞后一帧。
 2026-10-26 23:04:25 +08:00
TermiNexus bc089a0c69 feat(diag): 用户态窗口渲染链路临时打点 
沿 Scene3D → FBCanvas → vpui.redraw → window.flush → explorer 合成器逐段打点，
用于定位窗口内容不上屏停在哪一环：

- Explorer：fb 哨兵像素回读、建窗槽位回读、首个 FLUSH、首帧 back/fb/任务栏像素、
  每 240 帧统计槽位/最上层窗口矩形/中心像素/共享缓冲首像素
- vpui：首次 redraw（缓冲地址尺寸）、st1~st4 分段（malloc/铺底/控件/拷回）、
  首次 flush、FBCanvas 首绘的源缓冲与像素
- Scene3D：主线程预渲染 3 帧（非清屏像素计数、三角形命中/调用数）、渲染线程
  入口与每 60 轮采样；渲染线程参数类型改为 rawptr

以上均为临时诊断，定位完成后应移除。
 2026-10-26 22:41:32 +08:00
TermiNexus 1ccacf8204 refactor(userspace): 清理 t/c 依赖与过时注释 
Terminal、SerialLogger 不再 import t, c；dynlib 删除已失效的指针级数说明。
 2026-10-26 22:40:07 +08:00
TermiNexus a3c1d221e6 fix(kbd,sched,scene3d): 键盘报告去重；用户线程 return 跳板修正；关窗时序 
① Enter 洪流：usb_kbd._on_int_complete 的按下沿依赖 kbd_prev_keycodes，而状态提交在函数末尾第三趟循环；kbd_report 是常驻 DMA 缓冲，按键保持/NAK/重复完成都会让回调反复看到同一份报告 ⇒ 每次中断都注入一次 Enter，Terminal 刷出 [cmd] enter，explorer 被拖死。新增 kbd_prev_sig（modifier+6 keycode 的标量签名）整份报告去重；同一趟循环里先提交 prev 再判定；全 0 报告只更新状态；抽出 _rearm() 保证所有出口都重排中断 IN 且 DMA 读取先于重排。② explorer 限流：kb_pend[64] + _deliver_kb，单轮最多投递 64 字节，ring_push 返回 -1 时停在当前字节（不再当成功丢弃），pending 清空才补读；鼠标取包同样 64 包/轮上限。③ 关窗卡死根因：process.vp 的 _tramp_code 是 mov eax,34; int 0x80; jmp \$，而 Syscall.THREAD_EXIT=60 ⇒ 用户线程 return 后走 syscall 34（无匹配分支）返回 Ring3 在 jmp \$ 空转，空转不再产生 syscall，而内核只在 syscall 返回路径消费 needs_reschedule ⇒ 协作式调度彻底停摆，整机冻结。sched.create_user_thread 在跳板映射后把立即数低字节改为 60（幂等）。④ 次生：主线程先退会立即回收自己的用户栈，而 Scene3D 渲染线程还引用其栈上对象。Scene3D 渲染线程退出改为显式 process.thread_exit() 并置 _render_done；主线程 mainloop 返回后先 yield 等渲染线程退出（上限 10000 次）再 exit。⑤ window.flush 在槽位 used==0 时直接返回；vpui.Tk.redraw 入口判 win_id 与 is_active，窗口已回收时不碰 arena 不 flush。
 2026-10-17 16:49:37 +08:00
TermiNexus 850c4b8adc fix(keyboard,explorer): 键盘解码单队列化消除读循环自旋；关窗清理悬垂状态 
① 卡死/键盘无效：has_data() 把'原始待解码'与'已解码可读'混成一个计数，而 read_scancode() 只看已解码队列；一旦出现 has_data()>0 但本次取不到字节（断码/修饰键/E0 前缀），devfs 的读循环里 count 不前进而 has_data() 恒真 ⇒ asm.sti() 后无 yield 自旋，协作式调度下整机停死。改为解码下沉到 IRQ、只保留一个输出队列（has_data()==out_count，read_scancode() 返回 0 ⟺ 队列空），ANSI 序列整条原子入队；devfs 读循环以 read_scancode() 返回 0 为唯一终止条件。② 关窗：DESTROY 与关闭键路径清 drag_win，focus/_activate_from_taskbar 校验槽位存活；poll_requests 单轮最多处理一圈（head 已推进，剩余留到下轮，不丢消息也不自旋）。③ vpui：孤立 ESC 后紧跟的普通键不再被吞。
 2026-10-17 13:20:22 +08:00
TermiNexus e839b37ee2 fix(desk): 事件环越界 —— 64 槽超出每 pid 0x1000 区间 
每 pid 事件环按 0x1000=4096B 间隔排布，而环总大小 = RingCtrl(16) + 64 × DeskMsg(64) = 4112B：第 63 号槽的最后 16 字节正好覆盖下一个 pid 的 RingCtrl（head/tail/size/_pad 被写成消息尾部）。后果：下一个 pid 的环 size=0、head==tail ⇒ 该进程的键盘/鼠标事件永远收不到；再对它 ring_push 会算 (tail+1)%0，除零异常直接打死 explorer —— 这就是'多窗口关闭后容易卡死/键盘无效'的根因之一。改为 63 槽（4048B），落在区间内。
 2026-10-17 13:20:22 +08:00
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 e0308ba074 feat(input): 键盘接入 app —— 焦点回退 + 无聚焦控件时路由到文本控件 
① explorer：新增 _key_target()，focused 无效（-1/已关/已最小化）时回退到 z 序最高的可见窗口，不再把键盘输入整体丢弃；载荷经核对无需改（explorer 传 evt.x，vpui.Text 读的正是 evt.x）。② vpui：Tk 新增 _first_text_widget()，mainloop 的 KEY 分支在 focused_widget 为空时回退到第一个可见的 Text/Entry，并同步置焦点；顺带修 Text.handle_event 只认 '\\r' 导致回车无效（内核给的是 '\\n'）。Terminal 无需改动。
 2026-10-17 12:00:19 +08:00
TermiNexus 9f372ce814 refactor(desk): ring_push/ring_pop 改整块 memcpy，避免协议加字段漏拷 
原来两个环函数逐字段拷贝（type/win/pid/a..d/title），DeskMsg 新增 style 时漏同步，导致 style 在入队时被丢弃。改为按 DeskMsg.__sizeof__() 整块 memcpy：结构体以后再加字段自动生效，不会再出现忘记同步某一处的问题。
 2026-10-17 11:26:59 +08:00
TermiNexus 384ab6e75f fix(desk): ring_push/ring_pop 漏拷 style 字段 
根因：两个环函数是**逐字段拷贝**（type/win/pid/a/b/c/d + title），新增 DeskMsg.style 时没有同步补上。于是 app 侧正确写入 _msg.style（IR 已核对：store 到字段 7），但入队时被丢弃；explorer 读到的永远是共享槽里的残留 0 —— 日志表现为五个 CREATE 全 style=0，而 app 侧 [vpui] set_style NZ / geometry style!=0 完全正常。补上 push/pop 两侧的 style 拷贝。
 2026-10-17 11:25:43 +08:00
TermiNexus a60c51076a diag(vpui): set_style 与 geometry 打印样式值，定位 style 恒 0 
日志证据：五个 CREATE 全是 style=0，而 Scene3D 明明调了 set_style(window.STYLE_WIN11) —— 断点在 app 侧而不是 explorer。加两条一次性诊断：set_style 打印 0/NZ（确认方法被调用且参数非零），geometry 建窗前打印 self.style 是否为零。判读：两条都非零 ⇒ 断点在 _send/消息；set_style 就为 0 ⇒ window.STYLE_* 跨模块取值有问题。
 2026-10-17 11:06:23 +08:00
TermiNexus aab4643dfa feat(desk): style 透传到 CREATE 请求；任务栏随焦点/窗口集合刷新 
① style 透传：DeskMsg 增加 style 字段（放在 d 与 title 之间），window._send 增加 style 可选参数（默认 0，其它调用点不受影响），create_window 把 style 一并压进 CREATE 请求，explorer 的 handle_request 用它建窗（原来硬编码 0）—— 这样 vpui 的 set_style 才能真正生效，样式区分与圆角才有意义。DeskMsg 是共享协议结构，app 与 explorer 必须一起重编。② 任务栏刷新：mark_titles 追加标记任务栏条带（焦点切换会调它，任务栏图标配色随之更新），CREATE 与 DESTROY 分支也各调一次（图标数量变化）。
 2026-10-16 22:42:58 +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 1c0720a746 perf(explorer,vpui): 矩形填充改 rep stosd，鼠标输入一次取完队列 
性能三处：① vpui._fill_rect 原为逐像素双重循环（带边界判断），app 每帧都要把整窗填一遍背景色（Scene3D 是 640×360 = 23 万次写），改为逐行 string.memset32（rep stosd），先统一裁剪再整行填充；② explorer.row_fill 同样逐像素，任务栏（1360 像素/行）与标题栏每帧要填上万像素，同样改 rep stosd；③ 鼠标延迟：poll_input 原来每轮只从设备取一个包，而 serve 一轮要跑 poll_requests + poll_input + render（毫秒级），PS/2 是 100Hz ⇒ 输入在队列里排队累积、光标明显滞后。改为一次把已到的包全部取完（位移累加、按键以最后一个包为准），并把位移累加+钳制抽成 _move_cursor()。
 2026-10-16 21:31:04 +08:00
TermiNexus d840c7546f fix(vpui): 窗口改双缓冲，消除合成器读到半成品帧造成的闪烁 
根因：Tk.redraw 每帧先 _fill_rect 把整窗填成背景色、再逐控件重画，而这块缓冲就是 explorer 合成时逐行 blit 的共享 arena（render_window_rows 直接从 arena 读）。于是整窗纯背景色、控件还没画的那段窗口期一旦被合成器采到就是一次闪烁；鼠标移动让 explorer 重画窗口所在行时同样会撞上。改法：Tk 增加进程本地后备缓冲（懒分配、窗口变大时重新分配并 free 旧的），整帧画完后一次性 memcpy 进 arena 再 flush，合成器任何时刻读到的都是完整帧。代价是每帧一次全窗拷贝（零拷贝通路只在合成那一段保留）。分配失败不静默：打日志后退回直写 arena。
 2026-10-16 21:27:14 +08:00
TermiNexus 2f20cf42aa fix(vpui): 建窗失败改为可见错误上报；Scene3D 加分步诊断打点 
背景：Tk.mainloop 的循环条件是 window.is_active(win_id)，而 is_active 对 win_id < 0 直接返回 0 ⇒ 一旦 create_window 失败，app 一次循环都不进、一句日志都不打就 process.exit(0)（现场：Scene3D spawn 后静默退出，「没有窗口」就是这么来的）。改动：window.vp 的 _attach / _connect / create_window 四个失败返回点补 [win] 错误上报（open 失败 / mmap 失败 / desk 未就绪超时 / 请求环压入失败 / CREATED 超时），这些是错误可见性而非临时噪音，长期保留；Scene3D/main.vp 加 _dbg 分步打点（start / tk ok / canvas ok / scene ok / geometry 后的 win_id 与 buf / 渲染线程 / mainloop 返回），用于定位它到底死在哪一步，定位完成后撤除。
 2026-10-16 20:51:07 +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 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 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 c5e107e361 fix(vpsdk): 修正 desk_open/desk_map 的模块前缀（链接 undefined symbol 根因） 
现象：ld.lld 报 undefined symbol aeb1805c34e518f8.desk_map / desk_open，引用来自 window.vp 的对象（_attach/_connect）。根因：我在 window.vp 与 Explorer/main.vp 里把这两个函数挂到了 devfs. 前缀上，而它们的定义在 vpsdk/desk.vp（devfs.vp 里只有底层 shm_map）。编译器按名解析到 desk.vp 的声明并发出带 desk 前缀的符号，但调用点的前缀不一致 ⇒ 链接期解析不到。

同时清掉 window.vp 里已不再使用的 import（devfs/stdlib/syscall —— get_winbuf 改用共享区后 stdlib.malloc 与 syscall 都已无引用）。
 2026-10-16 19:14:57 +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 a45b9808b0 feat(s3d): vpsdk/window.vp 改走 /dev/desk 共享协议（对外 API 一字未改） 
window.vp 重写：不再走内核 UI syscall，全部经共享区与用户态 explorer 通信。对外函数名/签名/常量/InputEvent 全部保持原样 ⇒ vpui.vp 与四个 app 零改动。

数据面：get_winbuf 直接返回共享 arena 里本窗口那块像素缓冲的线性地址（app 就地画），flush 只压一条 FLUSH 请求 ⇒ 全程零像素拷贝（旧实现是 app 私有缓冲 + 整块拷给内核）。控制面：请求环 + 按 pid 分的事件环；is_active/get_win_size 直接读共享槽（零 syscall）。create_window 压 CREATE（标题内联在消息里）并等 CREATED 答复拿 win_id。

协议补齐：DeskMsg 增内联 title（CREATE/TITLE 用，ring_push/pop 同步搬运）；事件环按 pid 分（不能按 win_id——建窗答复送不到；也不能单环——单消费者结构多 app 会互抢）；新增 DESK_MOUSE_PRESS/RELEASE/HOVER 语义常量。

合成器：关闭按钮改为置 active=0（app 的 while is_active() 自然退出）并通知一次 CLOSE；点击只投给窗口**内容区**（标题栏用于拖动）、松手投 RELEASE、移动投 HOVER，坐标均换算成窗口内坐标；拖动改为只在标题栏生效；RESIZE 重新从 arena 切片并更新内容尺寸（与 vpui 的 bh = h - TITLE_H - 2 对齐）。
 2026-10-16 19:08:18 +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 1633769534 feat(explorer): S3c —— explorer 窗口服务端与合成器（请求环 + 输入 + 逐行合成） 
Apps/Explorer/desk_server.vp（新增）：窗口槽分配（含 arena 像素缓冲切分与底色预清）、Z 序与焦点、逐脏行合成（背景整行 memcpy → 各窗口按 Z 序只重画落在该行的那一段 → 光标）、请求处理（CREATE/DESTROY/MOVE/RESIZE/FLUSH/ACTIVATE）、事件投递（CREATED/CLOSE/KEY）、输入轮询（读 /dev/input/keyboard 的 ASCII 与 /dev/input/mouse 的按键+x/y，做命中测试、点击聚焦、标题栏右侧关闭按钮发 CLOSE、按住拖动移窗）。

main.vp：fb/desk/输入三者就绪后交给 DeskServer.serve() 主循环；去掉 S2 的渐变条演示（像素通路已由 fb 映射日志与合成器本身证明）。desk.vp：删掉写错且无人使用 的 DESK_MSG_SIZE 常量。

注意：本切片尚未实现标题文字（需用户态字体表）、任务栏、最小化/缩放、窗口侧边框与样式；且此过渡态下内核 desktop 与 explorer 同时在画屏幕，会互相覆盖 —— S3d（app 改走协议）与 S3e（删内核 UI）收口。
 2026-10-16 18:56:30 +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 0886252a08 feat(vpsdk): window/syscall/process/stdio/fs/dynlib 适配 + apps 同步调整 2026-10-16 16:40:41 +08:00
TermiNexus f8b37564da refactor(vpui): 引入 tkinter 式类层次 Misc/Wm/BaseWidget/Widget，新增容器控件 Frame 
层次：Misc(mixin：master/tk + winfo_master/toplevel + bind/unbind) ├─ Tk(Wm, Misc) └─ BaseWidget(Misc) └─ Widget(BaseWidget) ← Label/Button/Entry/Scrollbar/FBCanvas/Text/Frame 全部继承 Widget。约束按 Test/MultiInheritTest 的布局模型：父类字段展平进子类、非首基类必须无字段（故 Wm 无字段）、基类方法内不做 self.<虚拟> 自我分派（多继承非最左基类的虚表索引会整体后移）。控件 master 由 Widget* 改为 Misc*（Tk* 成为合法上转型），原先 8 处 Tk*(self.master) 裸转改为 self.tk；事件派发统一走 BaseWidget.dispatch_event（先跑 bind 回调再 handle_event）。中文。
 2026-10-16 16:29:04 +08:00
TermiNexus 7b58758603 fix(vpsdk): 修正 malloc 块头越界写（ptr-hdr_size → ptr），修复全部 app 启动即 #PF 
块头原写在 mmap 映射区起点之前 8 字节；第一次 malloc 时 mmap 返回用户堆起点 0x20000000，写 0x1ffffff8 落在映射区外 ⇒ #PF（err=0x7 用户态写、cr2=0x1ffffff8），四个 app 启动瞬间全部崩在同一个 stdlib.malloc 上。改为把块头写在映射区起始处 ptr，返回 ptr+hdr_size 不变，free/calloc/realloc 的 ptr-hdr_size 反查仍然正确。
 2026-10-16 16:29:04 +08:00
TermiNexus 6e78a08797 fix(vpsdk/vpui): 回调按闭包 ABI 调用(rdi=env, call [closure]) - 修点击 Submit 跳到堆上执行致用户态缺页 2026-10-15 17:17:42 +08:00
TermiNexus 152c4c5683 feat(vkernel/vpsdk): 用户线程生命周期 - THREAD_EXIT 显式退出；异常终止时回收用户栈并释放槽位；返回哨兵可辨识 2026-10-15 16:50:58 +08:00
TermiNexus 29e1bc6e34 chore(debug): 移除定位用的 MMAP/get_winbuf/redraw 临时探针（线程模型修复后 PF 与卡死均已消失） 2026-10-15 16:48:19 +08:00
TermiNexus 89a319e1be chore(debug): 加临时探针定位 MMAP 返回高半污染与 Tk.buf 野指针 - MMAP/get_winbuf/redraw 2026-10-15 16:20:14 +08:00
TermiNexus 11ad0de988 fix(vpsdk): WINBUF_MAX_BYTES 改单字面量 4194304，避免最小宽度算术回绕成 0（三重故障诱因） 
- `1024 * 1024 * 4` 按最小宽度(i16)做算术：1024×1024 先回绕成 0 ⇒ 缓冲只剩几字节 ⇒ flush 时内核 memcpy(dst, src, 240KB) 从 app 的几字节缓冲后狂读 ⇒ 内核越界读 → 异常路径再出事即三重故障

- 改成单字面量 4194304（不依赖任何算术）。与 V3_POOL 同属“最小宽度算术”坑：静态求值侧已在 61f23d9 按结果值加宽，这处是表达式侧，先按单字面量规避
 2026-10-14 19:35:37 +08:00
TermiNexus c977caec91 fix(vkernel/vpsdk): 窗口缓冲改走“用户缓冲 + WIN_FLUSH 拷贝”，修 app 写内核页 #PF(err=0x7) 
- 现场：四个 app 一画就用户态 #PF，cr2 全在内核堆区（~0xb7c1000/0x9f81000/0xb851000/0xb881000），err=0x7（present + 用户写），RAX 正是各自颜色常量（0x1E1E32/0xC0C0C/0xF0F19）

- 根因：GET_WINBUF 把 desktop 的**内核**窗口后备缓冲地址直接交给 app（该页 U=0），app 当用户指针写 → 必然 #PF，四个 app 全中（tid=5 那条 cr2=0xffffffff52209000 是同一指针继续走坏）

- 内核：WIN_FLUSH 增加源指针 `WIN_FLUSH(win_id, src)`：先 desktop.get_fb 取窗口缓冲、再 desktop.get_fb_bytes 取字节数（配对取，避免 resize 重建导致尺寸/指针不一致），memcpy 后 desktop.flush；syscall_handler 的 WIN_FLUSH 分支透传 arg2；desktop 新增 get_fb_bytes

- app（vpsdk/window.vp）：get_winbuf 改为按窗口分配**用户态**缓冲（stdlib.malloc → MMAP，落在 0x20000000 用户堆）并缓存；flush(win_id) 改为 WIN_FLUSH(win_id, 用户缓冲)
 2026-10-14 19:30:29 +08:00
TermiNexus b5f51415ca fix(vpsdk): so_call1 的 arg1 改为 rawptr（裸地址用通配指针，避免级数不符误报） 
dynlib.so_call1 的 arg1 只是原样交给系统调用的裸地址；原先声明为 t.CPtr（具体类型的
一级指针），调用方传字符串字面量（二级指针）会命中 CastError：
  implicit pointer-to-pointer conversion is forbidden: pointer level differs
  (source level 2 -> target level 1)
改用 rawptr（未定/通配指针，符合既有规则“任一侧 void*/未定（rawptr）允许”）。
 2026-10-14 15:57:38 +08:00
TermiNexus 5b4bab59cc chore(ViperOS): 合并落库内核侧在途改动并移除 vpsdk wiki 拷贝 
VKernel / vpsdk / Apps / Libs 共 30 个源文件：内核与 SDK 侧的新语法适配及编译修正（含 bootinfo.vp / main.vp 位宽改 uint64、gfx.vp 前向引用改指针、devfs.vp 指针解引用赋值、elf.vp 跨模块函数取值等）。删除 vpsdk/wiki/*.md（14 文件，约 -8100 行）：与仓库根 wiki 重复的拷贝，统一以根 wiki 为唯一来源。
 2026-10-07 19:04:33 +08:00
TermiNexus fc1a397c14 docs(vpsdk): 删除 wiki 拷贝里的 t.Anonymous 章节 
与主 wiki（TransPyC/wiki，09fadf3）保持一致：`t.Anonymous` 已废弃且不再维护，
删除 02-type-system.md / 05-classes.md / all.md 中的「匿名结构体成员」章节。
 2026-10-02 00:50:23 +08:00
TermiNexus 2a54e2bafb 清理了 t.CVoid 2026-09-16 16:07:04 +08:00
TermiNexus a518f75b24 chore(vkernel): 重置基线 — 纳入 TPV codegen 修复配合的内核侧调整与既有工作区内容 
- devfs.vp: string.split 传 PATH_BUFFER_SIZE（配合 split 新增容量参数）

- fat32_types.vp: lfn_extract 越界钳制（base+i > MAX_LFN 返回 -1）

- sheet.vp: gfx.Renderer 实参修正为 (fb, zb, w, h)（原单参导致 w/h=0 渲染空操作）

- 同批包含 VKernel 其余既有移植改动与 vpsdk/Apps/Libs 工作区内容
 2026-09-11 14:27:01 +08:00
TermiNexus cd1cc915c5 修正了build.py，重置基线 2026-09-11 10:34:34 +08:00
TermiNexus b887d3d9c2 更新，部分功能可用 2026-08-27 09:47:47 +08:00
TermiNexus 20e7289c61 将 .py 和 .pyi 后缀名改为了 .vp 和 .vpi 后缀名 2026-07-30 16:34:26 +08:00