分类 Obsidian 下的文章

Obsidian

浏览器 Agent 附件流式排队与 PDF 提取排障 (Browser Agent Attachment Streaming Queue and PDF Extraction Troubleshooting)

1. 现象与触发场景 (Symptoms & Triggering Scenario)在端侧智能体 (In-Browser Autonomous Agent) 处于运行态(如正在执行复杂工具、或正在接收服务端事件流 Server-Sent Events, SSE 回复)时,用户尝试向对话界面拖入、粘贴或选择上传 PDF 附件并补充指令,出现以下综合异常:静默吞噬与零反馈 (Silent Failu

Obsidian

PDF 阅读器双轨手势解耦与阅读进度保全架构 (PDF Viewer Dual-Track Gesture Decoupling and Reading Progress Preservation Architecture)

在 Web 端构建高保真 PDF 阅览器与数字墨迹批注系统(如类 GoodNotes / Notability 体验)时,存在两个极为隐蔽且破坏用户体验的核心瓶颈:手势动力学失真:批注模式下为防止误触落墨,常试图在 JavaScript 层监听触摸事件并手工计算 scrollTop -= dy 模拟滚动。这种手工位移彻底剥离了浏览器的原生弹性物理曲线与甩动惯性(Momentum / Inertia

Obsidian

EasyPanel 虚拟主机环境轻量服务部署与排坑 (EasyPanel Virtual Host Deployment and Pitfalls)

1. 场景概述 (Overview)在受限的轻量级免备案虚拟主机(如基于 Kangle / EasyPanel、Crzhong 架构的共享空间)上部署现代化轻量应用(短链服务、零知识加密剪贴板、监控探针等)时,往往会面临诸多与标准 VPS 独立服务器不同的底层限制。本文记录在此类受限主机环境中的实践经验与核心避坑指南。2. 核心技术陷阱与解决方案 (Pitfalls and Solutions)陷

Obsidian

NAT VPS 不转发 UDP 导致 QUIC 类协议全废 (NAT VPS Without UDP Forwarding Blocks QUIC Protocols)

1. 触发场景共享 IP / NAT 小鸡(公网 IP 由几十上百人共用,机器自己是内网地址如 192.168.x.x)上部署 Hysteria2 / TUIC / 任何 QUIC 系协议。服务端一切正常启动,客户端连不上。2. 症状服务端 ss -ulnp 显示正常监听,systemctl is-active 是 active,日志无报错。客户端只给一句:FATAL failed to ini