echart/continuation.md

continuation.md — 会话检查点

生成时间：2026-08-04（本会话） 工作区：/Users/summer/Downloads/py/www（echart 平台，PHP + jQuery + ECharts，无框架）

当前状态

本会话完成四件事，均已部署上线：

1. 项目文档刷新（init）

• 重写 AGENTS.md，外科手术式修正 CLAUDE.md：Tailwind/ECharts 真实路径（/lib/js/tailwindcss-3.4.17.js、/lib/js/echarts-5.4.2.js）、已移入 deprecated/ 的页面清单、三种数据模式（fetch api.doorcome.cn / ajax.inc.php t= 路由 / 服务端注入）、表名约定（index_hist_pro 等已由 API 替代）、config.php 明文凭据说明。

2. 服务器 → 本地全量拉取

• rsync（不带 --delete）从 simon@www.doorcome.cn:/var/www/html/echart/ 拉取 148M、405 文件。新增 podcast-docs/（deploy.md、usage.html）、quant/intlnews_usage.html、quant/user_guide.html、research/ 每日报告目录（20260608–20260804）。podcast/ 服务器上为空目录。
• 文档按用户选择恢复为本地新版（备份在 /tmp/echart-doc-backup/）。

3. 投资资讯日报前端（核心交付）

• 新建 charts/news_reports.php：报告查询导航页（类型 Tabs + 日期筛选 + 列表 + 详情一体，Tailwind 本地库，零外部链接）。
• 新建 js/newsReports.js：fetch https://api.doorcome.cn/api/news/reports/ 渲染。详情固定模块：AI 摘要 → 事件（finance: xwlb→news→cninfo；intl: intl）→ 数据总览。
• 修改 index-2.php：研究报告下拉框卡片 → 链接 /charts/news_reports.php，删除 showReportGroup。
• 关键坑：真实 API stats 结构与文档示例差异大且随日期变化（8/1 前后两套：新版 pipeline(raw_total)+news/cninfo/xwlb，旧版 pipeline(M1中文键)+sources/sentiment/importance/event_types；intl 的 sentiment 是字符串数组、importance 值是字符串、还有合并格式 {"重要度":"数量","等级 N":"..."}）。已实现 normalizeKV() 归一化，59 份日报全部渲染通过。
• Bug 修复：点击卡片"无法弹出"——根因 openDetail 未隐藏 listView（详情渲染在列表下方，滚动回顶部后用户看不到）。新增 showDetail() 隐藏列表，已部署并用 CDP 真实点击验证（listView class: hidden ✓）。

4. 部署工具 sync-echart

• 创建 ~/bin/sync-echart（rsync 单向推送本地 → simon@www.doorcome.cn:/var/www/html/echart/，排除本地环境文件 + 数据目录 uploads/xls/files/research/podcast/podcast-docs）。-n 预览。
• PATH 已配：~/.bash_profile、~/.zshrc（原注释行改为启用）。
• 部署方式已记录：CLAUDE.md 常用命令节 + 项目记忆 project/sync-echart-deploy.md。
• 已执行 3 次部署（页面+JS+index-2 → CLAUDE.md → JS 修复），服务器 md5 全部验证一致。

后续步骤

1. 让用户在浏览器硬刷新（Cmd+Shift+R）验证 https://echart.doorcome.cn/charts/news_reports.php：列表 → 点击卡片 → 详情各模块。
2. （建议）把 charts/news_reports.php 补进 CLAUDE.md 的页面目录表，sync-echart 部署。
3. （可选）导航页加"重要事件聚合"视图：/api/news/events/（days/importance/report_type/section/limit 参数，已预留 API_EVENTS 常量未用）。
4. （可选）数据总览改 ECharts 图表版（当前是数字卡 + 表格）。
5. （可选）research/ 静态日报 HTML 与 API 页面并存，旧文件仍可直接访问；确认是否需要归档清理。

待解决问题

• 本机无 PHP：php -l 语法检查需 scp 到服务器执行（已建立流程）。
• 数据目录不同步：sync-echart 排除 uploads/xls/files/research/podcast；服务器 ↔ 本地数据同步需手动 rsync（不带 --delete）。
• API stats 结构不稳定：随生成日期变化，前端依赖 normalizeKV() 防御性兼容；若 API 侧统一格式可简化前端（需与 djapi 后端协调）。
• API 文档滞后：/Users/summer/Downloads/cc-cursor/docs/news_report_api.md 中 finance stats 的 sources key 实测不存在（新版为 pipeline.raw_by_source），文档与实测不一致。
• 记忆：曾有一次 remember 被拒（后来明确要求后成功保存）；如后续会话需重新保存，注意用户偏好。