WorkBuddy热重载需配置文件监听、规则匹配、Live Reload代理、IDE协同及权限调试：启用目录监听并递归监控内容变更；设置正则匹配源码文件并绑定对应框架启动命令；静态项目注入Live Reload脚本；通过IDE插件复用监听事件；最后验证系统权限与事件日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy进行前端或脚本类开发时，发现代码修改后需手动重启才能生效，或无法自动捕获文件变更触发响应，则可能是文件监听机制未启用、热重载路径未注册或开发服务未正确绑定。以下是实现WorkBuddy开发环境文件监听与热重载功能的具体配置步骤：
一、启用桌面与项目目录级文件变更监听
WorkBuddy通过操作系统原生事件接口（如Windows ReadDirectoryChangesW、macOS FSEvents）实时捕获指定路径下的新建、修改、删除操作，为热重载提供底层信号源。必须显式启用监听模块并限定作用范围，避免全盘扫描导致资源占用过高。
1、打开WorkBuddy主界面，点击左下角齿轮图标进入【设置】。
2、在左侧导航栏选择【开发者选项】→【文件监听管理】。
3、点击【添加监听路径】，输入目标开发目录的绝对路径（如：C:\dev\my-react-app 或 /Users/name/project/flutter_app）。
4、勾选「启用子目录递归监听」与「监控文件内容变更（非仅时间戳）」两项。
5、点击【保存并激活监听】，系统托盘图标右键菜单中将显示“监听中：3路径”类似提示。
二、配置热重载触发规则与执行动作
监听到文件变更后，WorkBuddy需依据预设规则匹配文件类型、路径模式及变更事件类型，决定是否触发重载，并调用对应命令或API。该规则支持正则表达式匹配与多动作链式执行，适用于不同框架的刷新需求。
1、在【文件监听管理】页面，点击已添加路径右侧的【编辑规则】按钮。
2、在「匹配模式」栏输入：.*\.(js|ts|jsx|tsx|dart|css|scss)$，覆盖主流前端与跨端语言源码文件。
3、在「触发动作」区域，选择「执行Shell命令」，填入对应框架热重载指令：npm run dev（React/Vite）、flutter run -d chrome --web-hostname localhost --web-port 8080（Flutter Web）或 poetry run uvicorn main:app --reload（FastAPI）。
4、勾选「仅当进程处于运行状态时触发」，防止重复启动冲突实例。
5、点击【测试规则】，手动修改监听目录内一个CSS文件并保存，确认终端窗口自动弹出且命令成功执行。
三、集成浏览器实时刷新代理（Live Reload Server）
对于无内置热重载能力的静态站点或传统HTML项目，WorkBuddy可启动轻量级HTTP服务器并注入Live Reload客户端脚本，实现浏览器侧自动刷新。该方式不依赖框架工具链，纯前端即可生效。
1、进入【开发者选项】→【Web服务管理】，点击【启用Live Reload服务】。
2、设置服务端口为：35729（默认LiveReload标准端口）。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
3、在监听路径对应项目的index.html头部
中插入以下脚本标签：<script src="http://localhost:35729/livereload.js?snipver=1"></script>。4、确保浏览器未屏蔽第三方脚本，且当前页面通过http://localhost:xxxx访问（非file://协议）。
5、修改任意被监听的HTML/CSS/JS文件并保存，观察浏览器是否在1秒内自动刷新页面。
四、启用IDE插件协同监听（VS Code / JetBrains）
当WorkBuddy与本地IDE共存时，可通过插件通信复用IDE已建立的文件监听上下文，避免双重监听开销，并同步IDE调试器断点状态至热重载流程。此方式要求IDE插件已安装且授权WorkBuddy访问其内部事件总线。
1、在VS Code中安装官方扩展「WorkBuddy DevBridge」，或在IntelliJ系列中安装「WorkBuddy Integration」插件。
2、重启IDE，在设置中搜索「WorkBuddy Sync」，启用「转发文件保存事件」与「同步调试会话状态」。
3、在WorkBuddy【开发者选项】→【IDE协同】中，点击【连接IDE】，自动识别已运行的VS Code或WebStorm实例。
4、连接成功后，IDE中任意保存操作将直接触发WorkBuddy热重载规则，无需等待文件系统事件延迟。
5、若使用JetBrains IDE，需在【Build, Execution, Deployment】→【Console】→【Terminal】中确认shell路径指向WorkBuddy CLI所在目录。
五、调试监听失效问题：验证事件捕获与权限状态
若上述配置完成后仍无热重载响应，需逐层验证监听链路完整性——从操作系统权限、路径有效性、事件过滤逻辑到命令执行环境，排除静默失败环节。
1、在PowerShell（Windows）或Terminal（macOS）中执行：workbuddy fs watch status，查看当前活跃监听器列表及最后捕获时间戳。
2、检查监听路径是否含中文、空格或符号链接；若存在，将其移至纯英文路径并重新添加。
3、Windows用户需确认WorkBuddy已获得「后台应用权限」：设置→隐私→后台应用→开启WorkBuddy开关。
4、macOS用户需在「系统设置→隐私与安全性→完全磁盘访问」中，将WorkBuddy客户端拖入授权列表。
5、执行：workbuddy log tail --level debug | grep -i "fsnotify"，观察控制台是否输出类似“IN_MODIFY on /path/to/file.ts”的原始事件日志。
