Web 前端常见问题

如何在本地运行 Web 前端？

cd web
npm install
npm run dev

开发地址是 http://localhost:3001。首次启动会先把可复用的 C 算法编译成 WebAssembly。

哪些工具能直接在浏览器里运行？

Hash、Base64、Hex、URL 编解码、UUID、密码、时间戳和数字格式化通过 C/WebAssembly 运行；JSON、JWT、正则和文本比较使用 TypeScript。

这些工具不会为了计算而把输入发送到服务器。

为什么网页里没有系统中心和端口管理？

浏览器无权读取 Windows 进程、端口占用、系统托盘、提醒数据库或小助手窗口。 这些能力只存在于 C/C++11 Windows 客户端。Web 端保留工具目录和可在浏览器安全 运行的工具，不伪造原生数据。

如何生成部署文件？

cd web
npm ci
npm run build
# deploy the web/out directory

out 是纯静态目录，可部署到 Cloudflare Pages、Netlify、Vercel 或普通静态文件服务器。详细参数见仓库中的 Web 部署说明。

网页会读取桌面端的提醒或角色图片吗？

不会。桌面端数据保存在用户本机的 %LOCALAPPDATA%/CuteYiyiDesktopPet； 静态网站没有访问该目录的权限。后续若增加账号同步，会单独设计 API、授权和隐私边界。