36 lines
2.0 KiB
Markdown
36 lines
2.0 KiB
Markdown
# 空笺未寄 — 项目总结
|
||
|
||
> 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`
|