软件启动与本地服务连接
说明云店AI软件页面与本地任务服务的关系，以及5174页面入口、8765任务服务、云店Agent连接和软件启动后的基础检查方法。
云店AI当前本地测试版由软件页面和任务服务共同工作。软件页面负责显示菜单、设置、任务中心和云店Agent；任务服务负责执行脚本、读取本地文件、保存设置和记录任务结果。
可以把软件页面理解为操作台，把任务服务理解为发动机。两者都正常，功能才能使用。
当前本地测试版怎么启动
第一步：启动任务服务
打开当前项目目录，双击：
应用代码\第一组代码骨架\启动_后端8765_SQLite用户系统.cmd启动窗口显示服务正在运行后，先不要关闭。任务服务默认使用：
http://127.0.0.1:8765第二步：启动软件页面
双击：
应用代码\第一组代码骨架\启动_前端5174_稳定版.cmd然后打开：
http://127.0.0.1:5174/页面右上角显示本地服务已连接后，再登录账号和运行任务。
第三步：不要重复启动
任务栏里已经有任务服务或页面服务窗口时，不要连续双击相同入口。重复启动会遇到端口被占用，也可能让你误以为软件没有启动成功。
127.0.0.1 表示当前这台电脑，不是外部网站；5174 和 8765 是当前本地测试版使用的两个服务编号。
怎么确认任务服务正常
在浏览器打开：
http://127.0.0.1:8765/api/health能看到健康状态内容，说明任务服务已经启动。这个检查只用于确认服务是否存活，不代表店铺已经登录，也不代表某个具体任务的素材和设置已经准备完成。
启动窗口能不能关闭
当前本地测试版的启动窗口负责保持对应服务运行：
- 关闭任务服务窗口，自动化任务、任务中心和云店Agent工具会失去本地执行能力。
- 关闭页面服务窗口，
5174页面会打不开，但已经交给独立任务进程的任务是否继续，应以任务中心和具体任务状态为准。
只是暂时不看窗口时，可以最小化到任务栏，不要在任务运行中直接强制结束进程。
电脑重启、睡眠或断网后
电脑重启或关机后，需要重新启动当前本地测试版的任务服务和页面服务。
电脑从睡眠恢复后，服务进程可能仍在，但平台登录、网络连接或浏览器现场可能已经失效。先查看页面连接状态和任务中心，再决定是否重新登录或重启服务。
短暂断网通常不会让本地页面立即消失，但在线生成、平台后台操作、模型服务和云端任务可能失败或等待。网络恢复后，应先查看原任务状态，不要直接重复提交。
任务运行中如何关闭软件
如果正在上传、编辑商品、生成图片或视频、写入表格、整理文件或操作浏览器，不建议直接关闭软件。
- 打开任务中心。
- 查看是否仍有运行中或等待人工处理的任务。
- 需要停止时，使用任务中心为该任务提供的停止入口。
- 等任务状态稳定、文件写入结束后，再关闭窗口。
不是所有任务都支持暂停；停止任务也可能要等到当前安全步骤结束。强制结束进程可能中断浏览器操作或损坏正在写入的表格和结果文件。
正式桌面软件版本
正式桌面软件应由桌面快捷方式或开始菜单统一启动，普通用户不需要寻找 5174、8765 或项目目录中的脚本。窗口关闭、系统托盘、单实例和任务运行中退出提醒，以正式桌面版本的最终设置为准。
当前文档中的脚本步骤只适用于本地测试版。正式桌面包完成真实回归后，文档中心会更新成桌面版操作步骤。
常见问题
页面一片空白怎么办
先确认页面服务仍在运行，再按 Ctrl+F5 强制刷新。页面服务没有运行时，重新启动 启动_前端5174_稳定版.cmd。
页面能开，但显示本地服务未连接
说明页面服务正常，但任务服务没有连通。先检查 /api/health，再按 04_快速开始_后端服务连接失败怎么办_用户说明 排查。
提示端口被占用怎么办
先检查任务栏和已有页面是否已经启动成功。已有服务健康时不需要再启动；确实需要重启时，先正常停止旧服务，再启动新服务。
只关闭浏览器页面会停止任务吗
关闭浏览器页面不等于正常停止任务。重新打开软件后，到任务中心确认任务状态。需要停止时使用任务中心入口，不要用关闭页面代替停止任务。