LearnPrompt/ai-news-radar：README 来源编辑指南

LearnPrompt/ai-news-radar 的 README 将项目描述为"24h AI/tech news radar with GitHub Actions, live web UI, and Scout Skill for AI sources."。本文只整理仓库能直接核验的内容，不把星标、Fork 或宣传语当成质量证明。README 在"24小时AI更新雷达｜三口味锐评"下的说明是：更新说明：v0.9 把界面收敛成单层信息架构（栏目 tab × 精选/全量 × 时间轴），旧的三视图截图存档于 /legacy/，保留至 2026 年 8 月中旬。。这给出的首先是项目边界，而不是已经完成的生产验证。

从 README 的"v0.9：单层信息架构 + 标题增强"和相关条目看，读者可以先判断它是否解决自己的具体问题：精选/全量全局开关：精选读故事合并后的AI强相关高价值池，全量读广义AI相关的原始池（latest-24h-all.json，score >= 0.3），两种模式共用同一套时间轴+日期分组模板。如果你的目标与这段说明不一致，就不应仅凭项目热度采用它。这里保留原项目名、命令和组件名，方便回到一手来源核对。 README 还列出了另一条可核对的信息：双视图：这套单层架构现在有两套 UI 皮肤,,根目录 index.html 默认手机版，右上角「视角」开关可切到 /classic/ 经典桌面版，也支持 ?view=mobile / ?view=classic / ?view=auto 参数直接指定；两套皮肤读同一份 data/，选择记在浏览器本地。这类原文条目可以帮助读者设计试运行步骤，但不能代替自己的环境测试。

README 把工作方式分散写在"30秒选边上车"等段落中。可确认的线索包括：② 直接看网页 → 打开 news.learnprompt.pro。默认是手机版视图，右上角「视角」开关能切到经典版（旧版桌面界面，路径 /classic/），也可以直接用 ?view=mobile / ?view=classic / ?view=auto 指定，两个视图读同一份 data/ 目录数据。v0.9 起是单层信息架构：顶部「全部/模型/产品/开发者/行业/论文/社区/自媒体」栏目 tab +。这篇整理没有把未写出的架构、性能或安全边界补成结论；真正的运行链仍应结合仓库目录、配置文件和版本标签检查。

第一次安装应从 README 给出的入口开始。当前可复核的命令是： git clone https://github.com/LearnPrompt/ai-news-radar.git cd ai-news-radar python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt python scripts/update_news.py --output-dir data --window-hours 24 python -m http.server 8080 如果仓库没有提供命令，本文不会替它编造安装步骤，而是建议先打开 README 的"24小时AI更新雷达｜三口味锐评"部分，确认系统依赖、默认端口和首次初始化动作。

日常使用的细节取决于项目实际文档。README 的"30秒选边上车"段落提到：③ fork 拥有自己的筛子 → fork本仓库，信源换成你自己的 OPML，口味改 personas/ 下的 markdown 文件，数据长在你自己的 GitHub Pages 上。跳到fork 指南。。对于配置文件、环境变量、权限和数据目录，当前稿只记录来源明确的部分；未写明的默认值必须在测试环境中验证，并保留可回滚的配置副本。 同一部分还提到：推荐理由真实化：精选条目的一句话推荐理由由管线侧真实生成,,对过了 AI 相关性筛选的条目抓取全文，交给 DeepSeek 写一句「为什么值得读」（需要 DEEPSEEKAPIKEY）；没有真实理由时前端直接隐藏这个区块，不再用模板句撑场面。