|
|
此文章由 yrqin 原创或转贴,不代表本站立场和观点,版权归 oursteps.com.au 和作者 yrqin 所有!转贴必须注明作者、出处和本声明,并保持内容完整
Claude Code给的建议(可以参考看看,建议的不一定都对的)
另外,版主似乎是在Mac Mini上跑的这个服务?可以考虑利用Cloudflare的隧道服务(Cloudflare Tunnel,免费的plan就够用了),把网页弄成一个公共的网页(当然这时候需要加上用户登录/用户验证等安全配置。。。);这样可以外面的时候,也可以查看FoxCloud 能源仪表盘
# FoxCloud 能源仪表盘 — 代码审查与改进建议
按优先级排序。
## 安全
- `public/app.js:576` `warningBox.innerHTML = warnings.map(item => \`<p>${item}</p>\`)` 存在 XSS 注入点。建议改为按节点设置 `textContent`。同类风险位置:`app.js:565`(徽章)、`app.js:623`(表格)。即便目前字符串由服务器控制,也应统一通过 `textContent` 或转义工具函数注入。
- `src/server.ts:88,101,115` 未对 `year` / `month` / `range` 做参数校验,`Number(NaN)` 会一路传到下游。建议引入 zod 或手写守卫:`year ∈ [2000, 2100]`、`month ∈ [1, 12]`、`range` 限制为白名单枚举。
- 没有任何限流。`POST /api/rebuild-cache` 与 Basic Auth 暴力破解都缺少防护。建议接入 `express-rate-limit`(例如认证与重负载接口每 IP 每分钟 5 次)。
- 未配置 `Content-Security-Policy` / `helmet`。建议:`helmet({ contentSecurityPolicy: { directives: { defaultSrc: ["'self'"], scriptSrc: ["'self'"] } } })`。
- `/api/health` 当前位于鉴权之后,导致探活探针失败。建议挂载到 `requireDashboardAuth` 之前,或新增公开的 `/api/livez`。
- `src/lib/foxcloudClient.ts:110` 签名拼接使用的是字面量 `\\r\\n`(转义反斜杠 + r + n),而非真正的 CRLF。FoxCloud OpenAPI 示例使用真实的 `\r\n`。需对照 FoxCloud 文档核实,疑似 bug,仅因 demo 模式不走签名路径而被掩盖。
- 确认 `.env` 已在 `.gitignore` 中(占位密码仍会泄漏 `DASHBOARD_USERS` 的格式约定)。
## Bug / 用户体验
- `.env` 中 `SQLITE_BACKUP_DIR=/app/backups` 作为默认值会让本地启动报 `ENOENT mkdir '/app'`。建议默认改为 `./backups`,由 Dockerfile 覆盖。
- `src/server.ts:129` 的 SPA 兜底路由会把 `/api/typo` 也吞掉返回 HTML。建议把 catch-all 限制为非 `/api/*` 路径。
- CSV 导出需要清洗以 `=`、`+`、`-`、`@` 开头的单元格(Excel CSV 注入)。在前面加单引号 `'` 转义。
- 浏览器会拒绝从 URL 含凭据的页面发起 `fetch`(已实测复现)。需在 README 注明:直接打开页面,让 HTTP Basic 弹窗输入凭据,不要把凭据嵌入 URL。
- `tsx watch` 不会监听 `.env` 改动并自动重启。请在 README 标注。
## 代码质量
- `src/services/dashboardService.ts` 1368 行,`public/app.js` 1409 行。建议按职责拆分:demo 数据、FoxCloud 编排、区间计算、视图层各成模块。
- Express 5 已自动转发 async 错误,所有 `try/catch + next(error)` 模板代码可以删除。
- 缺少测试。建议接入 vitest:覆盖算式辅助(`integrateSamples`、demo 每日总量的确定性种子)与输入校验。
- `Number(req.query.year ?? ...)`:当 `?year=abc` 时为 `NaN` 一路传下去。加校验同时也提升 UX。
## 锦上添花
- 将语言选择与表格区间持久化到 `localStorage`。
- 给 `/api/dashboard` 加 ETag / `Cache-Control` 以支持再验证。
- Health 接口返回版本号(git sha),便于运维。
|
评分
-
查看全部评分
|