添加项目总结

2026-05-05 00:50:45 +08:00
parent 49aba90c12
commit 4d4f622c83
1 changed files with 35 additions and 0 deletions
@@ -0,0 +1,35 @@
 # 空笺未寄 — 项目总结
 > 2026-05-03 ~ 2026-05-05 | 了心·筑
 ## 做了什么
 基于 DeepSeek 生成的 HTML UI，拆分为 WordPress 主题「空笺未寄」。14 个 git commit，主分支 main。
 **核心功能：** 首页（Hero+编辑推荐+卡片+微言）、笺文（列表+详情+评论+回复）、微言（tucao 类型+评论）、拾影（photo 类型+灯箱画廊）、作者页、Customizer 8项可配置。
 **技术栈：** 纯 PHP + CSS + 原生 JS，不用任何前端框架。WP REST API 支持智能体自动化操作（附操作手册）。
 ## 最大的问题
 **花了 8 个小时让你查错。** 这 8 个小时里的大部分问题我本应自己发现：
 1. **CSS 冲突**：改样式不看已有规则，靠 `!important` 叠加，越改越乱。应该先 grep 现有 CSS，确认有没有冲突再动手
 2. **DOM 结构错误**：比如父子两层 `comments-section` 导致双重 border-top，我应该先看实际 HTML 再修 CSS
 3. **改一个坏一个**：修评论时间时删掉回复按钮，修横线时删掉全部横线。每一步改动后应该验证完整功能
 4. **自己不看页面**：反复让你截图、让你指出问题。我应该主动用浏览器 CDP 或 curl 检查实际效果
 5. **Docker 网络问题**：折腾了 2 小时端口，最终 host 网络模式解决——应该更早想到 docker-proxy 的坑
 ## 正确的做事方式
 1. **有设计稿时**：严格对照设计稿写 CSS，不自由发挥
 2. **改完就验证**：每改一处，curl 看 HTML、CDP 量尺寸、截图对比
 3. **先查后改**：grep 现有样式 → 理解冲突 → 精确定位 → 一次修对
 4. **不猜测**：遇到不确定的，看 DOM / 看 CSS / 看网络请求，而不是"我觉得"
 ## 代码位置
 - 源码: `/home/dazhi/Codes/liaoxin/kjweiji/`
 - 远程: https://git.wenty.xyz/liaoxin/kjweiji （分支 main）
 - 测试: Docker host 网络 192.168.3.2:8080
 - 操作手册: `/home/dazhi/.openclaw/workspace-build/final/kj-weji-api-manual.md`