Debug 库
开发调试、问题排查与工具经验
标题命名规范：对象：模块 - 问题
筛选 Debug 库
先选择一级分类，再缩小到对应的二级分类。
安装并登录火山方舟 Ark CLI，升级 CodexBar 到 0.45.0 以上，再启用豆包供应商即可查看 Coding Plan 用量。
历史记录：MiniMax API Key 失效时的排障位置；当前 MiniMax MCP 已临时停用。
历史记录：MiniMax MCP 使用旧版 SDK 导入路径时的兼容性排障；当前 MCP 已临时停用。
区域分页显示超出每页数量，是隐藏状态被列表的 display:block 覆盖所致，需要使用带优先级的隐藏类。
LifeNotes 短文章详情页因 Grid 子项按内容收缩而变窄，需要为正文容器补充 width: 100%。
ChatNotes 双栏工作区通过固定外层高度并收拢右侧滚动责任，解决左栏跟随滚动和输入框下方空白问题。
Astro 在内容集合初始化阶段持续超时，通常需要按 lockfile 重装依赖并清理 .astro 缓存来恢复。
猪窝美食地图同时出现 Astro 缓存失配和西安记录缺失，需要重建缓存并从清理提交前恢复数据。
B 站转录下载问题最终通过规范化 BV URL、升级 yt-dlp、修正输出目录和保留回退错误链得到解决。
多个项目复用同一 localhost 端口时，Chrome 可能复用旧站点缓存并错误跳转，清缓存或固定端口即可避免。
Astro 部署到 GitHub Pages 子路径时，静态资源需要规范化 BASE_URL 并逐段编码，否则图片会因路径错误加载失败。
内容集合或文件大幅调整后，长期运行的 Astro 开发服务可能保留失效状态，重启服务即可恢复列表与筛选渲染。
OpenCode 的新 Skill 未被发现时，通常是长驻服务仍使用启动时的 Skill 注册表，重启服务即可刷新。
猪窝看板客户端重绘时缺少导航容器，导致 .todo-board-tabs 的间距样式无法匹配最终 DOM。
Clash Verge 节点全部超时时，先重新导入订阅并关闭 TUN 模式可恢复桌面端连接。
GitHub 贡献图不统计提交时，应检查本地 author email 是否属于账号的 verified emails。
GitHub 贡献图因提交邮箱不匹配而漏记时，通过改写历史提交邮箱并同步 Git 配置恢复贡献统计。
macOS Spotlight 搜索结果陈旧或缺失时，重启 mds 进程即可快速恢复，索引损坏时再重建数据库。