需启用qoderwake状态广播服务并配置对应壁纸引擎：一、ctrl+shift+p启用statusbus并获取token；二、lively wallpaper加载适配器并填入token；三、wallpaper engine通过qoder-ws-bridge websocket连接；四、macos用scriptable调用http接口生成live photo。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署QoderWake数字员工并希望将其实时运行状态直观呈现于操作系统桌面，但发现默认界面仅限客户端内展示任务流与思考链，则可能是由于动态壁纸渲染模块未与QoderWake状态总线建立双向绑定。以下是实现QoderWake动态壁纸联动的具体操作路径：
一、启用QoderWake状态广播服务
QoderWake内置状态广播通道（StatusBus），默认处于静默模式，需手动激活以向系统级渲染层推送心跳、任务阶段、Agent活跃度等结构化指标。该服务通过本地IPC协议输出JSON格式状态快照，供第三方壁纸引擎订阅。
1、启动QoderWake桌面客户端，确保已登录有效账户并完成首次Agent初始化。
2、按下Ctrl + Shift + P调出命令面板，输入“Enable StatusBus”并回车执行。
3、在弹出的权限确认窗口中点击“允许系统级状态广播”，系统将生成唯一广播Token并显示于状态栏右下角。
4、打开终端，执行qoderwake-cli status --watch验证广播是否生效，正常应持续输出含"phase":"executing"、"agent_id":"coder-7a2f"等字段的实时流。
二、配置Lively Wallpaper接入QoderWake状态源
Lively Wallpaper作为Windows平台主流动态壁纸引擎，支持自定义WebGL脚本与HTTP/IPC数据源。通过加载QoderWake提供的status-bus.js适配器，可将JSON状态映射为Canvas图层元素，如CPU热力环、任务进度条、Agent头像呼吸灯效等。
1、访问https://github.com/qoder-labs/lively-status-adapter下载最新版适配包，解压至%APPDATA%\Lively\Wallpapers\QoderWakeLive目录。
2、在Lively主界面点击“添加壁纸” → “从文件夹添加”，选择上述解压路径。
3、双击启用该壁纸后，在设置面板中定位“数据源类型”选项，切换为“本地IPC状态总线”。
4、在“认证Token”字段粘贴第一步中获取的广播Token，点击“测试连接”，成功后状态指示灯变为绿色。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、使用Wallpaper Engine + WebSocket桥接方案
对于Steam平台用户，Wallpaper Engine支持WebSocket协议直连。QoderWake提供轻量级WebSocket代理服务qoder-ws-bridge，将本地StatusBus转换为标准WS端点，兼容所有支持JS脚本的WE壁纸模板。
1、在QoderWake设置菜单中进入“高级 → 网络桥接”，开启“启用WebSocket代理”开关。
2、记录显示的本地WS地址，格式为ws://127.0.0.1:8089/status，端口号可能因冲突自动调整。
3、在Wallpaper Engine中导入任意支持脚本的壁纸，编辑其project.json，在"scripts"数组末尾追加"qoder-status-client.js"路径。
4、在该JS文件中调用new WebSocket("ws://127.0.0.1:8089/status")，监听message事件，解析data.phase与data.load_percent驱动UI动画。
四、macOS平台使用Scriptable + Live Photo方案
macOS不支持传统动态壁纸引擎，但可通过Scriptable应用结合Live Photo技术实现近似效果。QoderWake macOS客户端内置HTTP状态端点http://localhost:5001/api/v1/status，每2秒返回一次快照，Scriptable脚本可抓取该接口并生成带状态标签的Live Photo序列。
1、在Scriptable中新建脚本，粘贴官方提供的qoder-macos-livephoto.js模板代码。
2、检查脚本中const STATUS_URL = "http://localhost:5001/api/v1/status"是否与实际QoderWake服务地址一致。
3、运行脚本，首次执行将提示授权访问本地网络与照片库，必须全部允许。
4、脚本生成的Live Photo自动保存至相册，长按桌面照片选择“设为桌面” → “动态”，即可看到桌面角落浮动显示“Coder Active · 3 Tasks”状态徽章。
