log-focus-debug

log-focus-debug 技能是一项专为 DashPlayer Electron 代码库设计的工程实用工具。其主要目的是解决调试特定功能时产生的日志噪音问题，允许开发者在不受不相关系统日志干扰的情况下，隔离并追踪 Main 与 Renderer 进程中的完整日志链。此技能强制执行临时诊断标记的结构化生命周期，确保代码库保持整洁与专业。

• 通过配置环境变量（如 DP_LOG_LEVEL 与 DP_LOG_FOCUS_TOKEN）来实现目标日志过滤。

• 标准化 Main 与 Renderer 日志记录器中 withFocus() 方法的使用，以锁定特定的调试会话。

• 支持注入临时聚焦标记（例如 [FOCUS:token]），以便在密集的日志文件中快速搜索关键事件。

• 包含严格的清理规约，防止调试遗留代码进入正式环境或长期维护分支。

• 提供基于静态分析工具（如 ripgrep）与代码检查的验证步骤，确保无任何日志代码泄漏。

• 目标对象：负责 DashPlayer 模块（如 PlaybackService 或 UI 组件）开发的软件工程师与贡献者。

• 操作限制：必须遵守 <feature>-<yyyymmdd> 的命名规范，以防止标记冲突。

• 典型使用情境：当调查复杂的播放同步问题或 UI 状态闪烁时，设定聚焦令牌、重现错误、分析输出，并在结束后立即执行清理流程以删除所有临时标记。

• 输入与输出预期：输入为定义唯一的聚焦令牌；输出则确保在开发期间拥有干净、隔离的日志环境，并在任务完成后保证代码库的验证与清理。