每日热点新闻（Daily Hot News）

在 VS Code 里刷当天的热点新闻：18 个板块、纯文字、离线可读，每板块 10 条真实新闻、摘要 200–400 字并保留原文链接；另有 30 条真实热搜（合并最近 7 天）、全球股市行情表与近一月真实要闻回顾。

新闻数据随插件包一起分发（放在仓库的 news/ 目录），安装后不需要联网，也不会调用任何第三方接口；维护者每天运行抓取脚本更新仓库中的新闻数据并发布新版本，用户升级插件即可看到最新内容。

✅ 数据说明：当前 news/data/ 内容来自公开 RSS / 频道页的真实新闻，保留原文标题、摘要与链接；热搜来自今日头条热榜，行情表来自腾讯行情、东方财富与新浪财经。抓取失败或正文不足 200 字的条目会被丢弃，不用模板补写。

✨ 功能

• 18 个板块：热搜、科技、人工智能、财经、全球股市、AI 与股市、黄金行情、国际、全球局势、社会、体育、娱乐、健康、教育、汽车、游戏、文化、近一月回顾
• 每板块 10 条真实新闻：标题、200–400 字摘要、来源与原文链接，全部来自公开 RSS / 频道页
• 热搜（真实数据）：每日抓取今日头条热榜 30 条，保留标题、热度、排名与原文链接；运行时合并最近 7 天快照、按标题去重并按热度取前 30 条
• AI 与股市：10 条 AI 公司与资本市场真实新闻
• 长文阅读：侧边栏展开后显示 200–400 字摘要、来源与原文链接；不再使用 1000 字模板
• 全球股市：美股 / 港股 / A股 / 韩股行情表，数据来自公开行情接口
• 黄金行情：现货、期货、国内金价与美元、实际利率对照，并拆解当日涨跌原因
• 侧边栏浏览：活动栏「热点新闻」图标 → 「今日热点」视图，分类标签 + 关键词搜索；点击新闻即可在侧边栏内展开全文
• 侧边栏就地展开：点击任意新闻即可展开全文、表格与要点，再次点击收起
• 一键复制：展开区保留「复制全文」，复制标题、摘要、要点与表格
• 日期切换：默认展示最新一天；顶部下拉可跳转任意历史日期，另有「最新」按钮一键返回
• 历史永久保留：news/data/ 下的旧文件不会被删除，每次发布都包含全部历史新闻
• 状态栏入口：状态栏显示 📰 热点 N，一键打开
• 完全离线：数据来自插件自带 JSON，不发起网络请求
• 主题自适应：颜色全部使用 VS Code 主题变量，自动适配明暗主题

🚀 使用

1. 安装插件后，点击左侧活动栏的 热点新闻 图标（报纸图标）。
2. 在「今日热点」中按分类浏览，或在搜索框输入关键词。
3. 点击任意新闻即可在侧边栏就地展开全文、表格与要点；展开区提供「复制全文」。
4. 查看历史新闻：顶部日期下拉框选择日期，或点击「最新」按钮返回最新一天。

🗓 历史新闻与日期跳转

• 默认最新：每次打开侧边栏，都展示 news/index.json 中最新日期，不会停留在上次查看的历史日期。
• 日期下拉：列出全部可用日期，最新标为「最新」，前一天标为「昨天」，更早显示星期几。
• 回到最新：查看历史日期时，标题栏会出现「最新」按钮，一键跳回。
• 命令跳转：热点新闻: 跳转到指定日期，以 QuickPick 显示「最新 / 昨天 / N 天前」及历史提示。
• 永久保留：news/data/ 下的历史文件不会自动清理，每次发布都会全部打包；news:validate 会检查数据目录中未登记的文件。

命令（Ctrl/Cmd + Shift + P）

设置项

📁 数据结构

news/
├── index.json              # 分类定义 + 日期索引
└── data/
    ├── 2026-11-02.json     # 某一天的新闻
    └── 2026-11-01.json

news/index.json

{
  "version": 1,
  "updatedAt": "2026-11-02T07:55:00+08:00",
  "categories": [
    { "id": "tech", "name": "科技", "emoji": "💻", "description": "芯片、终端与通信" }
  ],
  "days": [
    { "date": "2026-11-02", "file": "data/2026-11-02.json", "counts": { "tech": 3 } }
  ]
}

分类数量必须 ≥ 10；id 只能使用小写字母、数字与连字符，且需与数据文件中的键名一致。

news/data/YYYY-MM-DD.json

{
  "date": "2026-11-02",
  "updatedAt": "2026-11-02T07:55:00+08:00",
  "headline": "今日看点一句话概述",
  "categories": {
    "tech": [
      {
        "time": "07:10",
        "title": "新闻标题",
        "summary": "200–400 字原文摘要，保留来源与原文链接；不足 200 字的条目不会入库。",
        "source": "来源名称",
        "tags": ["芯片", "端侧"],
        "points": ["热点一：一句话要点。", "热点二：一句话要点。"],
        "highlights": [
          { "title": "要闻标题", "detail": "一句话说明", "market": "US", "stage": "listed", "ticker": "NVDA" }
        ],
        "pointItems": [
          { "text": "要点内容，建议 40 至 80 字。", "market": "US", "stage": "pre-ipo", "ticker": "" }
        ],
        "table": {
          "caption": "表格标题（可选）",
          "columns": ["市场", "指数", "收盘", "涨跌幅", "要点"],
          "rows": [["美股", "标普500", "6,842.31", "+0.58%", "科技股领涨"]]
        },
        "url": "https://example.com/optional"
      }
    ]
  }
}

字段说明：

• title：必填，纯文字。
• summary：必填，200–400 字；侧边栏展开显示正文，复制全文时一并复制。
• points：可选，热点罗列；真实 RSS 模式下默认不生成。
• highlights / pointItems：旧版 AI 股市结构，可选；真实 RSS 模式下不再生成。
• table：可选，结构化表格，详情页以可横向滚动的表格展示；rows 每行列数需与 columns 一致。
• source / time / tags / url：可选，url 仅用于复制，插件不会自动联网打开。
• heat / rank：热搜专用，分别为热度值与原始排名；插件用 heat 合并排序最近 7 天快照。
• 只有 title 非空的条目会被展示。

固定格式（全球股市 / 黄金）

为保证每天更新后展示一致，以下结构不要改动：

• stocks（全球股市）：必须包含 table，表头固定为 市场 / 指数 / 最新 / 涨跌幅 / 说明，行首必须覆盖 美股、港股、A股、韩股。
• aistocks（AI 与股市）：与其他板块一致，固定 10 条真实新闻。
• monthly（近一月回顾）：固定 10 条真实要闻，由中新网归档页抓取；历史日期可留空数组，插件会回退到最新一天。
• gold（黄金行情）：保留行情表（品种 / 最新价 / 日涨跌 / 说明）。
• geopolitics（全球局势）：10 条真实国际局势新闻。
• hotsearch（热搜）：每日快照固定 30 条，必须有 title、source、url、heat、rank；历史日期可留空数组。插件会自动合并最近 7 天快照，按热度取前 30 条。

npm run news:validate 会校验：非热搜板块各 10 条、摘要 200–400 字、原文链接、热搜 30 条结构。--strict 模式下警告也会失败。

🔄 每天更新流程（维护者）

# 1. 生成当天数据（公开 RSS / 频道页，10 条/板块，摘要 200–400 字）
npm run news:fetch
#   或指定日期
node scripts/fetch-news.mjs --date=2026-11-03

# 2. 抓取真实热搜（今日头条热榜，不需要 API Key）
npm run news:hotsearch

# 3. 数据已自动写入 news/data/2026-11-03.json 并同步 index.json
#    真实 RSS 模式不再手工补写；抓取不足 10 条会直接失败，不会用模板凑数
#    不要删除 news/data 下的旧日期文件，历史新闻会永久保留

# 4. 校验数据格式
npm run news:validate          # 严格模式：node scripts/validate-news.mjs --strict

# 5. 检查数据新鲜度
npm run news:freshness

# 6. 提交并发布新版本
git add news
git commit -m "news: 2026-11-03"
git push

# 7. 提升版本号并打包 / 发布
npm version patch --no-git-tag-version
npm run compile
npx vsce package           # 生成 .vsix
npx vsce publish           # 发布到 VS Code Marketplace

也可以直接把整理好的 JSON 手动覆盖到 news/data/ 并更新 news/index.json，插件只依赖文件本身，不关心数据来源。

本地预览技巧：在插件设置中把 hotNews.localDataPath 指向仓库里的 news 目录，然后在 VS Code 中修改 JSON 并执行「刷新新闻数据」即可看到效果，无需重新打包。

GitHub Actions

• .github/workflows/validate-news.yml：推送修改 news/ 时自动校验数据格式与新鲜度。
• .github/workflows/daily-news-reminder.yml：每天北京时间 09:00 检查最新数据日期，落后超过 1 天会自动创建提醒 Issue。

🛠 本地开发

npm install
npm run compile      # 编译 TypeScript 到 out/
npm run watch        # 监听编译

在 VS Code 中按 F5 启动「运行扩展」，即可打开扩展开发宿主窗口调试。

npm test                 # 数据校验 + Webview 冒烟测试 + 宿主逻辑测试

• scripts/validate-news.mjs：校验数据格式（分类数、字段、日期一致性）
• scripts/test-webview.mjs：用 jsdom 验证列表、分类、搜索、详情与复制消息
• scripts/test-host.cjs：用 vscode API 模拟器验证激活、数据下发与命令

node scripts/make-icon.mjs   # 重新生成 icon.png

📦 发布到 VS Code Marketplace

1. 注册 Azure DevOps 并创建 Personal Access Token（Marketplace → Manage 权限）。
2. 在 Marketplace 管理页 创建 publisher。
3. 修改 package.json 中的 publisher、repository、bugs、homepage 为你的真实信息（本项目已配置为 500TSSD / https://github.com/500T-HardDisk/daily-hot-news）。
4. 登录并发布：

npx vsce login 500TSSD
npx vsce publish

发布前检查清单：

• [ ] displayName、description、README.md、CHANGELOG.md、LICENSE 完整
• [ ] icon.png 为 128×128 PNG
• [ ] news/index.json 中至少 18 个分类、每板块 10 条真实新闻、摘要 200–400 字（热搜 30 条除外），且最新日期为当天/昨天
• [ ] npm run news:validate -- --strict 通过
• [ ] out/extension.js 已编译（vsce 会自动执行 npm run vscode:prepublish）

🔒 隐私

• 插件不收集任何数据，不包含遥测，不发任何网络请求。
• 所有新闻内容随插件包分发，来源与版权由维护者负责；请在转载时注明来源。

📄 License

MIT