kjweiji/PROJECT_SUMMARY.md

空笺未寄 — 项目总结

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