name	sl-ai-insight
description	AI行业洞察平台专属技能。唤醒：「AI洞察」「AI日报」「AI周报」「跑一下日报」「AI有什么动态」「AI深度调研」。不唤醒：研发效能用sl-rd-efficiency-insight。
export	{"policy":"never","reason":"快手AI洞察项目，公司绑定+个人定制"}
category	domain_pack

sl-ai-insight — AI行业洞察

系统化追踪AI行业动态，每日/每周输出调研洞察。

项目目标

AI洞察是一个AI驱动的行业研究平台，核心做四件事：

产出：AI日报、周报、深度调研——稳定、准确、持续地输出行业洞察
沉淀：每次跑完报告/调研，对应的知识自动沉淀到追踪体系和知识库，保持新鲜度
呈现：所有信息同步更新到内外部首页，首页必须能看到最新的日报、周报、深度调研（按月呈现）、追踪体系、知识库
订阅：内部同学可订阅AI日报，订阅后自动接收推送

双版本体系

版本	URL	说明
内部版	`https://ai-insight-internal.frontend-cloud.corp.kuaishou.com`	快手内网（SSO登录），林克品牌+订阅按钮+内部链接
外部版	`https://xiaoxiong20260206.github.io/ai-insight-public/`	GitHub Pages（公开访问），通用品牌，零敏感词

⚠️ 链接体系锁定，不再变更：内部版=frontend-cloud，外部版=GitHub Pages。所有脚本从 config.py SSoT 派生，禁止硬编码。

每次新增内容，必须同时生成内部版和外部版，并同步更新两个首页。

内部版 vs 外部版的设计分界线：

元素	内部版	外部版
林克头像	✅ `link-avatar-small.webp`	❌ 隐藏
标题	"我是林克，这是沈浪让我负责的AI洞察项目"	"AI洞察 · 持续追踪AI行业动态"
Badge	"林克的AI洞察"	"AI行业洞察"
Highlight卡片	"林克：AI不是工具，是项目成员" + "我是林克，沈浪的AI分身。"	"AI不是工具，是项目成员" + 去身份描述
订阅按钮	✅	❌ 外部不可订阅
外部版入口	✅	❌ 不需要
Footer	"❤️‍🔥 林克 · 你负责往前走，记忆这种事我来"	"❤️🔥 AI洞察 · 持续追踪 · 深度洞察"

原则：内部版让人看到"林克在帮沈浪做AI洞察"，外部版让人看到"一个专业的AI行业洞察平台"。

闭环约束

报告产出 → 知识沉淀：日报/周报/调研跑完后，必须检查是否有知识需要沉淀到追踪体系或知识库
知识沉淀 → 首页更新：每次内容变更后，必须同步更新两个首页
首页 → 订阅推送：首页是信息的窗口，订阅推送是信息的渠道，两者联动

时间轴归档规则（P0 — 2026-06-03 血泪教训）

根因：深度调研产出后，手工添加到首页时间轴时，卡片日期和归档月份经常写错——5月报告归到4月，日期写4月20日而非实际5月7日。

硬规则：

卡片日期必须从HTML文件提取，禁止手写 — 新增调研卡片时，先从HTML的 editorial-hero-badge 或 📅 标记提取真实日期
归档月份=日期的年月，不靠猜 — 日期是5月7日，就归到5月；日期是4月8日，就归到4月
没有对应月份的分组就新建 — 不要把5月报告塞进4月分组
计数必须与实际卡片数一致 — 修改后必须验证 timeline-month-count 值

长期方案：gen_timeline.py 脚本可从HTML文件自动提取日期并按月分组，但目前手动调整仍需严格遵守以上规则。

⚠️ 元执行保障（必加载）

本技能命中绑定标准 C1+C2+C3+C4+C5（多阶段+外部可见+部署发布+无人值守+数据完整性），最高优先级绑定 evo-meta-execution。

映射关系：

P1 启动 → 环境前置检查(#5) + 技能路由表加载 + 踩坑检索(#1-#11) + 自检声明
P0 交付 → 质量门(#4) + fail loud(#6) + 首页脱敏(#7) + 外部版三项替换(#11) + {{message}}禁令(#11) + 知识库禁md链接(#12) + MixCard URL区分场景(#13) + 首页按钮绝对URL(#14)
P2 事后 → skill_calls日志 + token记录 + 知识沉淀(Harvest) + 5项自举扫描

P1 踩坑清单（从29条P0红线提炼高频失败项）：

❌ 续接必须先resume(#1) — 无例外
❌ MixCard必须用脚本生成(#2) — 禁止手写
❌ uv run替代python/python3(#9)
❌ MixCard {{message}}绝对禁止(#11)
❌ 外部版三项URL替换必须同时完成(#10)
❌ 首页修改必须读homepage-spec.md(#7)
❌ KIM消息发送必须指定target={{OWNER_KIM_USERNAME}}
❌ 知识库Tab禁止链接(#12) — 用

❌ MixCard群发按钮URL+footer必须用外部版(#13) — 私发用内部版

❌ 订阅按钮禁止./subscribe/相对路径(#14) — 用绝对URL

❌ 知识沉淀(Harvest)不可跳过(#15) — 日报Step 6强制

❌ frontend-cloud部署失败=硬性阻断(#16) — 禁止当warning继续

❌ 周报更新必须三联动(#17) — 卡片+badge+日历映射

❌ 日报footer禁止手动修改URL(#18) — 内部版用内部URL，外部版用外部URL

自检声明格式："我已读完SKILL.md+对应子技能workflow+29条P0红线+踩坑17条，准备执行Step X"

项目信息

内部版: https://ai-insight-internal.frontend-cloud.corp.kuaishou.com
外部版: https://xiaoxiong20260206.github.io/ai-insight-public/
项目路径: user-skills/sl-ai-insight/

子技能路由表

子技能	触发词	文档
输出格式规范	HTML/卡片/Doc格式	`reference/output-format-spec.md` ← 公共规范，所有子技能先读此
AI日报	AI日报/跑日报	`reference/daily-report/`
AI周报	AI周报	`reference/weekly-report.md`
深度调研	AI深度调研/专题	`reference/deep-research.md`
首页更新	更新首页	`update_homepage.py --type daily/weekly`
首页规范	修改首页必读	`reference/homepage-spec.md` ← 防改坏规范
双版本同步	同步公开版	`reference/dual-version-sync.md`
国内信源	微信/小红书搜AI	`reference/domestic-sources.md`
腾讯研究院AI速递	补充校准源	`scripts/fetch_tencent_research.py`（IMA存在性检查+搜狐镜像抓取）
学术论文监控	arXiv/学术动态	`reference/arxiv-monitor.md`
知识沉淀	沉淀AI知识	`reference/knowledge-accumulation.md`
调研范围管理	添加/管理AI追踪	`reference/scope-management.md`

路由原则：生成任何输出前 → 先读 output-format-spec.md（公共规范） → 再读对应子技能的差异化部分。

底层依赖

技能	用途
`designai-generate-image`	封面/彩蛋AI生图
`designai-Infographic-image`	章节配图（信息图）
`docs-shuttle`	Docs平台发布
`kim-message-send`	KIM推送

Knowledge Dependencies

package: ai-insight
package: product-thinking

MyKnowledge KnowledgePackage 格式。召回方式：读 wiki/index.md → 定位页面 → 读 wiki/<slug>.md（降级路径），或 kcli myknowledge get --package <pkg> --page <slug>。消费方只读 wiki/，禁止读 raw/。 | upload-cdn | CDN链接 | | tavily-search | 海外搜索 | | quark-search | 国内搜索 |

P0红线（21条核心红线）

⚠️ 只有18条需要Agent自觉遵守。其余校验已内置到脚本。

#0. 时间窗口铁律 — 最高优先级，所有内容生成必须遵守

日报：只收录 N-1日08:00 ~ N日08:00 之间的新闻
周报：只收录本周一00:00 ~ 周日23:59 之间的新闻

❌ 绝对禁止：加入搜索结果之外的条目（即使模型"知道"是真实新闻）
❌ 绝对禁止：把旧新闻（超出时间窗口）以当期日期写入
❌ 绝对禁止：URL 含有比日报/周报日期早 3 天以上的日期（视为旧文章充数）
✅ 验证：日报Step2开始前，先列出Step1搜索到的全部原始条目；周报Step2开始前，先从7天日报JSON提取所有news条目

质量门 v13.0 已对以上情况做 URL 嵌入日期二次验证（硬阻断）。

#1. 续接必须先 resume — 无例外

uv run scripts/ai_daily_orchestrator.py resume --date YYYY-MM-DD

#2. KIM卡片必须用脚本生成 — 禁止手写

uv run scripts/build_insight_mixcard.py daily --date YYYY-MM-DD --output /tmp/card.json --with-summary

#3. mixCard只推一次 — 禁止重复

#4. 质量门硬性失败=重做 — 禁止绕过

硬性失败（板块缺失/JSON结构错/HTML空壳）必须回到对应步骤重做。软性失败（搜狗URL占比/微信链接格式/覆盖度略低）= 警告不阻断。

#5. 环境前置检查 — 每次执行必做

ls user-skills/sl-ai-insight/.git/HEAD && ssh -o ConnectTimeout=5 -T git@github.com

#6. fail loud, don't fail silent

找不到文件时报错退出，禁止静默降级为空内容兜底卡片。

#7. 首页修改必须读 homepage-spec.md — 禁止裸复制

❌ cp index.html ai-insight-public/index.html = 敏感词泄露
✅ 必须走 sanitize_html() 脱敏流程
详见 reference/homepage-spec.md

#8. sync_to_external.py 的 sync_all() 禁止复制根级 index.html

❌ sync_all() 无差别复制 public/ → 覆盖外部脱敏版 = 敏感词泄露（经验#118）
✅ sync_all() 必须跳过 index.html，外部版由 sync_to_public.py 单独脱敏
已修复：v2.2 版本 sync_all() 会自动跳过

#9. 深度调研执行前必须读完3个规范文件+1个标杆 — 禁止凭感觉动手

reference/output-format-spec.md（公共规范）
reference/deep-research.md（深度调研流程+4组P0规则）
reference/kim-doc/writing-style.md（KIM Doc写作标准）
02-deep-research/topics/colleague-skill-anti-distill-2026.html（标杆HTML源码）
不读完不能动手。历史上因不读规范就动手导致反复修改8+轮。

#10. 所有Python命令必须用 uv run — 禁止 python/python3

uv run scripts/xxx.py ✅
python3 scripts/xxx.py ❌ — 容器中没有python命令，会直接报错
uv run skills/quark-search/scripts/agent.py news "关键词" ✅
python skills/quark-search/scripts/agent.py news "关键词" ❌

#11. 外部版HTML修改必须完成三项URL替换+线上验证 — 禁止只改一处

修改外部版(ai-insight-public)周报/日报HTML时（无论手动还是子agent），必须同时完成：

替换项	内部版	外部版	验证方法
仓库域名	`ai-insight/`	`ai-insight-public/`	`grep -c "ai-insight/"` 在日报链接区域 = 0
文件后缀	`-v3.html`	`.html`	`grep -c "\-v3\.html"` = 0
首页按钮	内部版首页URL	外部版首页URL	检查所有"访问首页"链接

❌ 只替换域名但遗漏 -v3 后缀 → 外部版日报链接404
❌ 只替换后缀但遗漏域名 → 外部版链接跳到内部版
✅ 三项都替换 + curl线上验证生效 → 才算完成
每次修改外部版HTML后，push之前必须跑 grep -c "\-v3\.html" file.html 确认返回0
内部版修改后必须同步到 public/ 对应路径（GitHub Pages从public/构建）

#12. 容器管布局宽度，文字管可读宽度 — 不可违反

卡片/框等容器：width: 100%（撑满父宽度，等宽排列）
段落/正文文字：max-width: 68ch（限制行宽，提高可读性）
❌ 在 .callout/.news-card-why/.insight-card 等容器上加 max-width: 68ch → 右侧留白参差不齐
✅ 在 .news-card-desc/.callout p/.insight-text 等文字节点上加 max-width: 68ch → 等宽卡片+可读行宽

#13. MixCard {{message}} 绝对禁止 — 已记录（见TOOLS.md）

#14. 知识库Tab禁止可点击的md链接 — 浏览器无法渲染

❌ <a href="04-knowledge-base/*.md"> — Markdown文件浏览器无法渲染，且 public/ 下不存在
✅ <span class="kb-item"> 展示标题，不可点击
2026-06-04：37个链接全部改为span，首页已部署

#18d. 搜索硬限制 — 总次数≤8，每板块≤1次海外+1次微信（2026-06-22新增）

总搜索次数上限：8次（海外tavily≤4次 + 国内quark≤4次）
每板块搜索上限：海外1次 + 微信1次，禁止一个板块搜3-5次
热点探针(Step 0.5)单独计：≤2次（1海外+1国内），计入总上限
❌ 超过8次搜索 = P0违规（6/12搜30次=消耗1.2M input，6倍超限）
❌ 同一关键词重复搜索（换个搜索引擎≠新搜索）
✅ 搜索精简是Token消耗最大的优化杠杆（日报占73%消耗，其中搜索占40-50%）

#19. MixCard按钮URL统一用内部版 — --target仅控制footer文本

#16. 首页按钮必须使用绝对URL — 禁止相对路径

订阅按钮：https://aidailyinsight-subscribe.frontend-cloud.corp.kuaishou.com（禁止 ./subscribe/，frontend-cloud会拦截触发SSO 302）
外部版入口：https://xiaoxiong20260206.github.io/ai-insight-public/
根因：frontend-cloud对 /subscribe/ 路径做SSO认证拦截，点击→302→登录页而非订阅页

#17. 格式升级必须改脚本 — 禁止只改HTML文件

一旦建立了脚本化生成流程（gen_weekly_html.py），所有格式变更必须修改脚本
手工修改HTML输出而不修改脚本 = 债务，下次脚本生成时自动退回旧版
根因（#125）：W22在6月1日经四轮手工格式升级（emoji→SVG + 68ch行宽 + 卡片结构重构），但没回写到 gen_weekly_html.py，导致W23退回升级前格式
判定：如果你正在修改 01-daily-reports/ 下由脚本生成的HTML文件 → 先问自己"这个修改是否应该改脚本"

#18. HTML视觉格式标准（周报+日报统一）

#18a. 结构元素用SVG icon，不用emoji

侧边栏TOC链接、章节标题旁、news-card meta行 → 用 <svg class="meta-icon"> 内联SVG
正文内容中的emoji保留（如事件描述中的🤖📊等）
SVG icon定义见 gen_weekly_html.py 的 SVG_ICONS 字典

#18b. 卡片视觉层级（Top5/洞察卡）

rank pill(12px) → 标题(18px/600) → meta行(13px/SVG icon) → 正文(14px/68ch) → 关键判断独立框

meta行用 news-card-meta + <span class="meta-item"> + <a class="meta-link">
关键判断用 <div class="judgment-label">关键判断</div> 而非 <strong>关键判断</strong>：

#18c. 行宽限制

容器撑满父宽度（100%），只有段落文字限行宽（68ch）
应用位置：.news-card-desc / .news-card-why / .insight-card p / .callout > p
❌ 禁止在 .callout / .news-card-why / .insight-card 等容器上加 max-width

#18d. 概览图位置

概览图/配图放在标题之后，不是之前（标题是语义锚点，图片是补充）

脚本自校验清单

脚本	校验项	失败时行为
`build_insight_mixcard.py`	6锚点+kimMd格式+{{message}}扫描+URL格式	❌硬性报错退出
`gen_daily_html.py`	≥50KB+5板块+{{message}}扫描+overview/深度聚焦+footer URL=INTERNAL_PAGES_BASE	❌硬性报错退出
`update_homepage.py`	内部版+public+索引页包含当天日期 + 周报模式额外检查：日历数据含周号+外部版HTML存在+外部首页含周号+badge链接与文本匹配	❌报错退出
`sync_to_external.py`	footer URL替换(内部→外部)+敏感词零残留+index.html跳过	❌硬性报错退出
`daily_quality_gate.py`	hard/soft分级+frontend-cloud URL可达性	硬性阻断/软性警告

核心脚本清单（精简后）

脚本	用途
`ai_daily_orchestrator.py`	日报状态机+finalize一键命令
`daily_quality_gate.py`	质量门（hard/soft分级）
`build_insight_mixcard.py`	MixCard生成+自校验
`gen_daily_html.py`	HTML生成+自校验
`gen_weekly_json.py`	周报JSON模板+schema验证（event字段Markdown检测+url字段缺失检测）
`gen_weekly_html.py`	周报HTML生成（从JSON动态生成+自校验≥50KB+5板块+class名一致性+SVG icons+68ch行宽+Markdown自清洁+自动cp到public）
`update_homepage.py`	首页更新（统一入口，支持daily+weekly）+ 自动校准统计卡片 + pills href校验（#124防复发）
`calibrate_stats.py`	统计卡片自动校准（从实际文件计算5项数字）
`deploy_daily.sh`	日报一键部署
`sync_to_public.py`	内部版→public+外部版同步
`sync_to_external.py`	外部版仓库同步+脱敏
`gen_daily_json.py`	JSON模板生成+schema校验（按需）
`gen_md_from_json.py`	MD生成（按需）
`inject_weekly_links.py`	周报超链接注入（按需）
`update_tracking.py`	追踪体系更新（低频）
`update_weekly_index.py`	周报首页联动（已归档→update_homepage.py --type weekly）
`fetch_arxiv.py`	arXiv论文监控
`daily_env_init.sh`	环境初始化
`validate_daily_schema.py`	JSON schema校验（按需）
`sync_subscribers.py`	订阅者同步（Appwrite → subscribers.json）
`config.py`	全局配置SSoT

已归档的脚本：fix_0508_json/fix_deep_research_footers/fix_json_quotes/fix_weixin_links/verify_4positions/daily_agent_runner/update_homepage_weekly → _archive/

推送范围

类型	推送范围	禁止
日报	私发订阅者	❌禁止群发
周报	先私发预览{{OWNER_KIM_USERNAME}} → 确认后发AI生产力中心大群(space:3705455482343722)	❌禁止不确认就群发

一次到位执行流程（日报7步）

Step 1: 搜索调研 → orchestrator complete --step 1
Step 2: 内容生成 → orchestrator complete --step 2
Step 3+4: finalize → orchestrator finalize（自动:质量门→HTML→首页更新→部署→外部同步）
Step 5: KIM推送 → sync_subscribers.py → build_insight_mixcard.py → message(kimMixCard, message="")
Step 5.5: 交付链接 → 输出四个链接（内部版日报+首页 + 外部版日报+首页），方便自检
Step 6: 知识沉淀(Harvest) → 检查复用价值 → 写入knowledge包（P0#22强制）

**⚠️ MixCard发送格式（P0红线）**：
- `kimMixCard`参数必须传**inner card格式**（`{config, updateMulti, blocks}`直接在顶层）
- ❌禁止传双层格式`{card: {...}, summary: "..."}` — KIM找不到blocks字段会渲染为空消息
- `message`参数必须传空字符串`""`，禁止同时传message和kimMixCard（会导致{{message}}模板注入泄露）
- 脚本输出已改为inner card格式，读取JSON后直接传给message工具即可

订阅系统

Web 订阅页面：https://aidailyinsight-subscribe.frontend-cloud.corp.kuaishou.com （快手 SSO 登录 → 一键订阅/取消）
内部首页入口：public/subscribe/index.html 重定向到 Web 订阅页面
数据存储：Appwrite TablesDB（subscribers 库 → daily_subscribers 表，行级安全）
同步脚本：scripts/sync_subscribers.py（Appwrite → data/subscribers.json，cron 执行前调用）
订阅者推送：日报 Step 5 读取 data/subscribers.json，遍历 is_active=true 的用户逐一私发
owner 保留：{{OWNER_KIM_USERNAME}} 始终在订阅列表中（source=owner），不可取消
⚠️ 订阅按钮路径：内部首页的订阅按钮必须直接指向 https://aidailyinsight-subscribe.frontend-cloud.corp.kuaishou.com，禁止使用 ./subscribe/ 相对路径——frontend-cloud会拦截 /subscribe/ 路径触发SSO 302重定向，导致用户看到登录页而非订阅页（2026-06-03教训）

首页规则（P0红线 #19-#26 的补充说明）

以下P0红线在主列表(#19-#26)中已声明，此处仅保留补充细节，不重复主列表内容。

#19 补充：知识库Tab禁止可点击链接

✅ <span class="kb-item"><span class="item-icon">📄</span><span class="item-text">标题</span></span>
适用于内部版和外部版（外部版通过 sanitize_html() 自动转换）

#22 补充：知识沉淀(Harvest)是P2强制步骤

当前断档：6/2、6/3日报均未做Harvest，需要补做

#23 补充：frontend-cloud部署失败=硬性阻断

deploy_daily.sh Step 8 设 DEPLOY_FAIL=1（已修复）

#24 补充：周报更新必须三联动

日历映射用周一起始日：W19起05/04(Mon)

#26 补充：日报完成后交付链接

⚠️ 内部版日报链接含-v3.html后缀（历史遗留），外部版不含-v3
URL SSoT = scripts/config.py

#27 模板变量禁止嵌入f-string上下文外的字符串常量（2026-06-22 #128）

禁止在Python字符串常量中直接写{SVG_ICONS["insight"]}或{INTERNAL_BASE}——不在f-string上下文中=原始文本输出
正确：用占位符模板（__SVG_INSIGHT__/__HOMEPAGE_URL__），在generate_html()中显式替换
根因：W25了解更多模块2处模板变量未替换，页面直接显示原始文本

#28 Top5来源必须逐个配超链接（2026-06-22 #128）

禁止合并多个来源到纯文字span（<span class="meta-item">Fortune · 36氪 · Axios</span>不可追溯）
正确：JSON sources[]数组，每个来源独立{name, url}，渲染为<a class="meta-link">
旧source/source_url字段保留为fallback，sources[]优先
根因：W25周报5张Top5卡片来源均为纯文字，违反output-format-spec 1.4

#29 脚本必须防御JSON脏数据（2026-06-22 #128）

日报链接-v3.html后缀 → _clean_daily_url()自动去除
双<strong>嵌套 → _strip_double_strong()清理
空URL → fallback渲染为纯文字span
根因：6类问题中5类因为脚本假设JSON数据干净，实际有-v3后缀、空URL、自带HTML标签、合并文字来源

首页统计卡片维护规则（P1 — 自动校准）

统计卡片数字由 calibrate_stats.py 自动计算，每次 update_homepage.py 运行时自动校准
校准方法：追踪条目从index.html表格行计数、深度调研从时间轴链接数、日报/周报从public/文件计数
当前值（2026-06-04校准）：人物85+、公司183+、深度调研30、日报95+周报14=109+

日历数据维护规则（P1 — cron自动+手动补漏）

日报cron的 update_homepage.py daily 会自动更新日历日期数组
但以下情况需手动修复：漏日期（如5/28）、周报映射错误（如W22重复标记31号）、周报缺失（如W21）
周报日历映射规则：weeklyReportsData['YYYY-MM'] = {周一日期: 'weekly-YYYY-Wxx'}
ISO周号计算：date.fromisocalendar(YYYY, W, 1) → 起始周一日期

系统健康检查（2026-06-05 全面复盘续）

闭环验证结果

子系统	状态	问题	修复
日报cron(08:00)	✅ 运行稳定	frontend-cloud部署被跳过	P0#23: 硬性阻断+手动补部署
周报cron(周一09:00)	✅ 运行稳定	W21缺失	✅ 补跑完成
订阅系统	✅ 7人活跃	—	—
内部首页	✅	周报badge全指向W21+日历映射错+footerURL错	✅ 三联动修复+footer统一
外部首页	✅ 零敏感词	53个日报footerURL错误	✅ 统一外部URL
双版本同步	✅	—	—
frontend-cloud部署	✅	cron跳过→用户404	P0#23: 非阻断→硬性阻断
知识库Tab	⚠️	37个链接→span(临时方案)	长期: 知识渲染为HTML
追踪体系	⚠️	无自动保鲜机制	P1: 待设计cron
时间轴	⚠️	新调研需手动添加	P1: gen_timeline.py待集成
统计卡片	✅	自动校准	calibrate_stats.py集成到update_homepage
MixCard URL	✅	统一内部版	--target仅控制footer文本(#123修正)
林克首页	✅	数据过期(6/1→6/5)	✅ 重新部署

知识沉淀断档分析

现状：知识沉淀(Harvest)仅在6/1日报执行了一次，6/2-6/3均未执行。根因：日报workflow.md的6步流程中没有明确的Harvest步骤——P2阶段只写了skill_calls日志+token记录，遗漏了知识沉淀。修复：

workflow.md Step 5之后增加 Step 6: 知识沉淀(Harvest)
SKILL.md P2事后步骤增加Harvest（P0#22）
cron payload增加Harvest提示

待建设能力（P1优先级排序）

~~日报workflow增加Harvest步骤~~ → ✅ 2026-06-04完成
追踪体系自动保鲜cron — 定期扫描新人物/公司，更新追踪清单
~~时间轴自动生成~~ → gen_timeline.py 已有脚本，待集成到 update_homepage.py
~~统计卡片自动校准~~ → ✅ 2026-06-04: calibrate_stats.py + 集成到 update_homepage.py
知识库HTML渲染 — 将md转为可浏览的HTML页面
~~非owner订阅推送验证~~ → 待08:00 cron触发后验证

踩坑经验（归档，不加载）

完整踩坑经验见 `reference/daily-report/lessons-learned.md`，但执行时不主动加载。关键教训已内置到脚本校验逻辑中。

周报视觉规范（P0 — 2026-06-30 W26重构后锁定）

以下标准已内置到 gen_weekly_html.py，不可手动修改绕过。执行周报前确认脚本是最新版。

P0 新增红线（#30~#34）

#30 周报必须用 gen_weekly_html.py 生成，禁止手动拼 HTML

所有样式/结构均在脚本中固化，手动拼出的 HTML 会绕过 CSS class 规范，样式全失效

#31 CSS 补丁不得超过 3 轮零散追加，必须合并为整洁 CSS 系统

多次追加会导致选择器优先级混乱，效果不可预测。应整合为一个版本块（如 v4.0），关键属性加 !important

#32 board-table 必须用 table-layout: auto，维度列用 white-space: nowrap; width: 1%

禁止用固定百分比列宽（如 width: 20%），会在多层容器嵌套中计算失准导致信号列截断

#33 .table-wrap 必须保持 overflow-x: auto

禁止 overflow: hidden，会截断宽表格内容

#34 stat-card（stats-grid）已废弃，不得在周报中生成

用户确认无阅读价值（2026-06-30），脚本已删除渲染逻辑

周报视觉标准速查表

组件	规范
Header	深色渐变 #0f172a→#1e1b4b，白色渐变标题 36px/800
板块 label	pill 10px/700/uppercase，各板块主题色
板块 h2	22px/700，大模型=绿/Coding=蓝/应用=紫/行业=橙/企业=红
板块分隔	margin-top:48px + border-top:2px 板块色15%淡
Top5 卡片	白底+4px左色条+hover上浮，关键判断独立背景区
事件表格	table-layout:auto, overflow-x:auto, 维度列nowrap
callout strong	800字重 + 各类型对应深色
日报索引	flex布局，标题取 keywords.split(",")[0]
narrative	每块有序号小标题（01/02/03）+ 彩色border-left
正文	15px/#57534E/1.75行高，行宽 65ch 仅限纯文字段落

更新于 2026-06-30 · v3.7 · W26视觉标准锁定 + 周报P0红线#30-#34

#35 部署前必须通过全链路自检（2026-06-30）

日报 deploy_daily.sh 自检链：

JSON Schema 验证 → 阻断
质量门 22项 → 阻断（硬性失败）
HTML 展示验证 → 阻断
首页完整性 verify_homepage.py → 阻断

周报 deploy_weekly.sh 自检链：

JSON Schema 验证 → 阻断
HTML 展示验证 → 阻断
外部版敏感词检查 → 阻断
首页完整性 verify_homepage.py → 阻断

任何一项自检失败 = 禁止部署。修复后重新自检直到全通过。

更新于 2026-06-30 · v3.8 · P0#35 部署前全链路自检

name	sl-ai-insight
description	AI行业洞察平台专属技能。唤醒：「AI洞察」「AI日报」「AI周报」「跑一下日报」「AI有什么动态」「AI深度调研」。不唤醒：研发效能用sl-rd-efficiency-insight。
export	{"policy":"never","reason":"快手AI洞察项目，公司绑定+个人定制"}
category	domain_pack

sl-ai-insight — AI行业洞察

系统化追踪AI行业动态，每日/每周输出调研洞察。

项目目标

AI洞察是一个AI驱动的行业研究平台，核心做四件事：

产出：AI日报、周报、深度调研——稳定、准确、持续地输出行业洞察
沉淀：每次跑完报告/调研，对应的知识自动沉淀到追踪体系和知识库，保持新鲜度
呈现：所有信息同步更新到内外部首页，首页必须能看到最新的日报、周报、深度调研（按月呈现）、追踪体系、知识库
订阅：内部同学可订阅AI日报，订阅后自动接收推送

双版本体系

版本	URL	说明
内部版	`https://ai-insight-internal.frontend-cloud.corp.kuaishou.com`	快手内网（SSO登录），林克品牌+订阅按钮+内部链接
外部版	`https://xiaoxiong20260206.github.io/ai-insight-public/`	GitHub Pages（公开访问），通用品牌，零敏感词

⚠️ 链接体系锁定，不再变更：内部版=frontend-cloud，外部版=GitHub Pages。所有脚本从 config.py SSoT 派生，禁止硬编码。

每次新增内容，必须同时生成内部版和外部版，并同步更新两个首页。

内部版 vs 外部版的设计分界线：

元素	内部版	外部版
林克头像	✅ `link-avatar-small.webp`	❌ 隐藏
标题	"我是林克，这是沈浪让我负责的AI洞察项目"	"AI洞察 · 持续追踪AI行业动态"
Badge	"林克的AI洞察"	"AI行业洞察"
Highlight卡片	"林克：AI不是工具，是项目成员" + "我是林克，沈浪的AI分身。"	"AI不是工具，是项目成员" + 去身份描述
订阅按钮	✅	❌ 外部不可订阅
外部版入口	✅	❌ 不需要
Footer	"❤️‍🔥 林克 · 你负责往前走，记忆这种事我来"	"❤️🔥 AI洞察 · 持续追踪 · 深度洞察"

原则：内部版让人看到"林克在帮沈浪做AI洞察"，外部版让人看到"一个专业的AI行业洞察平台"。

闭环约束

报告产出 → 知识沉淀：日报/周报/调研跑完后，必须检查是否有知识需要沉淀到追踪体系或知识库
知识沉淀 → 首页更新：每次内容变更后，必须同步更新两个首页
首页 → 订阅推送：首页是信息的窗口，订阅推送是信息的渠道，两者联动

时间轴归档规则（P0 — 2026-06-03 血泪教训）

根因：深度调研产出后，手工添加到首页时间轴时，卡片日期和归档月份经常写错——5月报告归到4月，日期写4月20日而非实际5月7日。

硬规则：

卡片日期必须从HTML文件提取，禁止手写 — 新增调研卡片时，先从HTML的 editorial-hero-badge 或 📅 标记提取真实日期
归档月份=日期的年月，不靠猜 — 日期是5月7日，就归到5月；日期是4月8日，就归到4月
没有对应月份的分组就新建 — 不要把5月报告塞进4月分组
计数必须与实际卡片数一致 — 修改后必须验证 timeline-month-count 值

长期方案：gen_timeline.py 脚本可从HTML文件自动提取日期并按月分组，但目前手动调整仍需严格遵守以上规则。

⚠️ 元执行保障（必加载）

本技能命中绑定标准 C1+C2+C3+C4+C5（多阶段+外部可见+部署发布+无人值守+数据完整性），最高优先级绑定 evo-meta-execution。

映射关系：

P1 启动 → 环境前置检查(#5) + 技能路由表加载 + 踩坑检索(#1-#11) + 自检声明
P0 交付 → 质量门(#4) + fail loud(#6) + 首页脱敏(#7) + 外部版三项替换(#11) + {{message}}禁令(#11) + 知识库禁md链接(#12) + MixCard URL区分场景(#13) + 首页按钮绝对URL(#14)
P2 事后 → skill_calls日志 + token记录 + 知识沉淀(Harvest) + 5项自举扫描

P1 踩坑清单（从29条P0红线提炼高频失败项）：

❌ 续接必须先resume(#1) — 无例外
❌ MixCard必须用脚本生成(#2) — 禁止手写
❌ uv run替代python/python3(#9)
❌ MixCard {{message}}绝对禁止(#11)
❌ 外部版三项URL替换必须同时完成(#10)
❌ 首页修改必须读homepage-spec.md(#7)
❌ KIM消息发送必须指定target={{OWNER_KIM_USERNAME}}
❌ 知识库Tab禁止链接(#12) — 用

❌ MixCard群发按钮URL+footer必须用外部版(#13) — 私发用内部版

❌ 订阅按钮禁止./subscribe/相对路径(#14) — 用绝对URL

❌ 知识沉淀(Harvest)不可跳过(#15) — 日报Step 6强制

❌ frontend-cloud部署失败=硬性阻断(#16) — 禁止当warning继续

❌ 周报更新必须三联动(#17) — 卡片+badge+日历映射

❌ 日报footer禁止手动修改URL(#18) — 内部版用内部URL，外部版用外部URL

自检声明格式："我已读完SKILL.md+对应子技能workflow+29条P0红线+踩坑17条，准备执行Step X"

项目信息

内部版: https://ai-insight-internal.frontend-cloud.corp.kuaishou.com
外部版: https://xiaoxiong20260206.github.io/ai-insight-public/
项目路径: user-skills/sl-ai-insight/

子技能路由表

子技能	触发词	文档
输出格式规范	HTML/卡片/Doc格式	`reference/output-format-spec.md` ← 公共规范，所有子技能先读此
AI日报	AI日报/跑日报	`reference/daily-report/`
AI周报	AI周报	`reference/weekly-report.md`
深度调研	AI深度调研/专题	`reference/deep-research.md`
首页更新	更新首页	`update_homepage.py --type daily/weekly`
首页规范	修改首页必读	`reference/homepage-spec.md` ← 防改坏规范
双版本同步	同步公开版	`reference/dual-version-sync.md`
国内信源	微信/小红书搜AI	`reference/domestic-sources.md`
腾讯研究院AI速递	补充校准源	`scripts/fetch_tencent_research.py`（IMA存在性检查+搜狐镜像抓取）
学术论文监控	arXiv/学术动态	`reference/arxiv-monitor.md`
知识沉淀	沉淀AI知识	`reference/knowledge-accumulation.md`
调研范围管理	添加/管理AI追踪	`reference/scope-management.md`

路由原则：生成任何输出前 → 先读 output-format-spec.md（公共规范） → 再读对应子技能的差异化部分。

底层依赖

技能	用途
`designai-generate-image`	封面/彩蛋AI生图
`designai-Infographic-image`	章节配图（信息图）
`docs-shuttle`	Docs平台发布
`kim-message-send`	KIM推送

Knowledge Dependencies

package: ai-insight
package: product-thinking

MyKnowledge KnowledgePackage 格式。召回方式：读 wiki/index.md → 定位页面 → 读 wiki/<slug>.md（降级路径），或 kcli myknowledge get --package <pkg> --page <slug>。消费方只读 wiki/，禁止读 raw/。 | upload-cdn | CDN链接 | | tavily-search | 海外搜索 | | quark-search | 国内搜索 |

P0红线（21条核心红线）

⚠️ 只有18条需要Agent自觉遵守。其余校验已内置到脚本。

#0. 时间窗口铁律 — 最高优先级，所有内容生成必须遵守

日报：只收录 N-1日08:00 ~ N日08:00 之间的新闻
周报：只收录本周一00:00 ~ 周日23:59 之间的新闻

❌ 绝对禁止：加入搜索结果之外的条目（即使模型"知道"是真实新闻）
❌ 绝对禁止：把旧新闻（超出时间窗口）以当期日期写入
❌ 绝对禁止：URL 含有比日报/周报日期早 3 天以上的日期（视为旧文章充数）
✅ 验证：日报Step2开始前，先列出Step1搜索到的全部原始条目；周报Step2开始前，先从7天日报JSON提取所有news条目

质量门 v13.0 已对以上情况做 URL 嵌入日期二次验证（硬阻断）。

#1. 续接必须先 resume — 无例外

uv run scripts/ai_daily_orchestrator.py resume --date YYYY-MM-DD

#2. KIM卡片必须用脚本生成 — 禁止手写

uv run scripts/build_insight_mixcard.py daily --date YYYY-MM-DD --output /tmp/card.json --with-summary

#3. mixCard只推一次 — 禁止重复

#4. 质量门硬性失败=重做 — 禁止绕过

硬性失败（板块缺失/JSON结构错/HTML空壳）必须回到对应步骤重做。软性失败（搜狗URL占比/微信链接格式/覆盖度略低）= 警告不阻断。

#5. 环境前置检查 — 每次执行必做

ls user-skills/sl-ai-insight/.git/HEAD && ssh -o ConnectTimeout=5 -T git@github.com

#6. fail loud, don't fail silent

找不到文件时报错退出，禁止静默降级为空内容兜底卡片。

#7. 首页修改必须读 homepage-spec.md — 禁止裸复制

❌ cp index.html ai-insight-public/index.html = 敏感词泄露
✅ 必须走 sanitize_html() 脱敏流程
详见 reference/homepage-spec.md

#8. sync_to_external.py 的 sync_all() 禁止复制根级 index.html

❌ sync_all() 无差别复制 public/ → 覆盖外部脱敏版 = 敏感词泄露（经验#118）
✅ sync_all() 必须跳过 index.html，外部版由 sync_to_public.py 单独脱敏
已修复：v2.2 版本 sync_all() 会自动跳过

#9. 深度调研执行前必须读完3个规范文件+1个标杆 — 禁止凭感觉动手

reference/output-format-spec.md（公共规范）
reference/deep-research.md（深度调研流程+4组P0规则）
reference/kim-doc/writing-style.md（KIM Doc写作标准）
02-deep-research/topics/colleague-skill-anti-distill-2026.html（标杆HTML源码）
不读完不能动手。历史上因不读规范就动手导致反复修改8+轮。

#10. 所有Python命令必须用 uv run — 禁止 python/python3

uv run scripts/xxx.py ✅
python3 scripts/xxx.py ❌ — 容器中没有python命令，会直接报错
uv run skills/quark-search/scripts/agent.py news "关键词" ✅
python skills/quark-search/scripts/agent.py news "关键词" ❌

#11. 外部版HTML修改必须完成三项URL替换+线上验证 — 禁止只改一处

修改外部版(ai-insight-public)周报/日报HTML时（无论手动还是子agent），必须同时完成：

替换项	内部版	外部版	验证方法
仓库域名	`ai-insight/`	`ai-insight-public/`	`grep -c "ai-insight/"` 在日报链接区域 = 0
文件后缀	`-v3.html`	`.html`	`grep -c "\-v3\.html"` = 0
首页按钮	内部版首页URL	外部版首页URL	检查所有"访问首页"链接

❌ 只替换域名但遗漏 -v3 后缀 → 外部版日报链接404
❌ 只替换后缀但遗漏域名 → 外部版链接跳到内部版
✅ 三项都替换 + curl线上验证生效 → 才算完成
每次修改外部版HTML后，push之前必须跑 grep -c "\-v3\.html" file.html 确认返回0
内部版修改后必须同步到 public/ 对应路径（GitHub Pages从public/构建）

#12. 容器管布局宽度，文字管可读宽度 — 不可违反

卡片/框等容器：width: 100%（撑满父宽度，等宽排列）
段落/正文文字：max-width: 68ch（限制行宽，提高可读性）
❌ 在 .callout/.news-card-why/.insight-card 等容器上加 max-width: 68ch → 右侧留白参差不齐
✅ 在 .news-card-desc/.callout p/.insight-text 等文字节点上加 max-width: 68ch → 等宽卡片+可读行宽

#13. MixCard {{message}} 绝对禁止 — 已记录（见TOOLS.md）

#14. 知识库Tab禁止可点击的md链接 — 浏览器无法渲染

❌ <a href="04-knowledge-base/*.md"> — Markdown文件浏览器无法渲染，且 public/ 下不存在
✅ <span class="kb-item"> 展示标题，不可点击
2026-06-04：37个链接全部改为span，首页已部署

#18d. 搜索硬限制 — 总次数≤8，每板块≤1次海外+1次微信（2026-06-22新增）

总搜索次数上限：8次（海外tavily≤4次 + 国内quark≤4次）
每板块搜索上限：海外1次 + 微信1次，禁止一个板块搜3-5次
热点探针(Step 0.5)单独计：≤2次（1海外+1国内），计入总上限
❌ 超过8次搜索 = P0违规（6/12搜30次=消耗1.2M input，6倍超限）
❌ 同一关键词重复搜索（换个搜索引擎≠新搜索）
✅ 搜索精简是Token消耗最大的优化杠杆（日报占73%消耗，其中搜索占40-50%）

#19. MixCard按钮URL统一用内部版 — --target仅控制footer文本

#16. 首页按钮必须使用绝对URL — 禁止相对路径

订阅按钮：https://aidailyinsight-subscribe.frontend-cloud.corp.kuaishou.com（禁止 ./subscribe/，frontend-cloud会拦截触发SSO 302）
外部版入口：https://xiaoxiong20260206.github.io/ai-insight-public/
根因：frontend-cloud对 /subscribe/ 路径做SSO认证拦截，点击→302→登录页而非订阅页

#17. 格式升级必须改脚本 — 禁止只改HTML文件

一旦建立了脚本化生成流程（gen_weekly_html.py），所有格式变更必须修改脚本
手工修改HTML输出而不修改脚本 = 债务，下次脚本生成时自动退回旧版
根因（#125）：W22在6月1日经四轮手工格式升级（emoji→SVG + 68ch行宽 + 卡片结构重构），但没回写到 gen_weekly_html.py，导致W23退回升级前格式
判定：如果你正在修改 01-daily-reports/ 下由脚本生成的HTML文件 → 先问自己"这个修改是否应该改脚本"

#18. HTML视觉格式标准（周报+日报统一）

#18a. 结构元素用SVG icon，不用emoji

侧边栏TOC链接、章节标题旁、news-card meta行 → 用 <svg class="meta-icon"> 内联SVG
正文内容中的emoji保留（如事件描述中的🤖📊等）
SVG icon定义见 gen_weekly_html.py 的 SVG_ICONS 字典

#18b. 卡片视觉层级（Top5/洞察卡）

rank pill(12px) → 标题(18px/600) → meta行(13px/SVG icon) → 正文(14px/68ch) → 关键判断独立框

meta行用 news-card-meta + <span class="meta-item"> + <a class="meta-link">
关键判断用 <div class="judgment-label">关键判断</div> 而非 <strong>关键判断</strong>：

#18c. 行宽限制

容器撑满父宽度（100%），只有段落文字限行宽（68ch）
应用位置：.news-card-desc / .news-card-why / .insight-card p / .callout > p
❌ 禁止在 .callout / .news-card-why / .insight-card 等容器上加 max-width

#18d. 概览图位置

概览图/配图放在标题之后，不是之前（标题是语义锚点，图片是补充）

脚本自校验清单

脚本	校验项	失败时行为
`build_insight_mixcard.py`	6锚点+kimMd格式+{{message}}扫描+URL格式	❌硬性报错退出
`gen_daily_html.py`	≥50KB+5板块+{{message}}扫描+overview/深度聚焦+footer URL=INTERNAL_PAGES_BASE	❌硬性报错退出
`update_homepage.py`	内部版+public+索引页包含当天日期 + 周报模式额外检查：日历数据含周号+外部版HTML存在+外部首页含周号+badge链接与文本匹配	❌报错退出
`sync_to_external.py`	footer URL替换(内部→外部)+敏感词零残留+index.html跳过	❌硬性报错退出
`daily_quality_gate.py`	hard/soft分级+frontend-cloud URL可达性	硬性阻断/软性警告

核心脚本清单（精简后）

脚本	用途
`ai_daily_orchestrator.py`	日报状态机+finalize一键命令
`daily_quality_gate.py`	质量门（hard/soft分级）
`build_insight_mixcard.py`	MixCard生成+自校验
`gen_daily_html.py`	HTML生成+自校验
`gen_weekly_json.py`	周报JSON模板+schema验证（event字段Markdown检测+url字段缺失检测）
`gen_weekly_html.py`	周报HTML生成（从JSON动态生成+自校验≥50KB+5板块+class名一致性+SVG icons+68ch行宽+Markdown自清洁+自动cp到public）
`update_homepage.py`	首页更新（统一入口，支持daily+weekly）+ 自动校准统计卡片 + pills href校验（#124防复发）
`calibrate_stats.py`	统计卡片自动校准（从实际文件计算5项数字）
`deploy_daily.sh`	日报一键部署
`sync_to_public.py`	内部版→public+外部版同步
`sync_to_external.py`	外部版仓库同步+脱敏
`gen_daily_json.py`	JSON模板生成+schema校验（按需）
`gen_md_from_json.py`	MD生成（按需）
`inject_weekly_links.py`	周报超链接注入（按需）
`update_tracking.py`	追踪体系更新（低频）
`update_weekly_index.py`	周报首页联动（已归档→update_homepage.py --type weekly）
`fetch_arxiv.py`	arXiv论文监控
`daily_env_init.sh`	环境初始化
`validate_daily_schema.py`	JSON schema校验（按需）
`sync_subscribers.py`	订阅者同步（Appwrite → subscribers.json）
`config.py`	全局配置SSoT

已归档的脚本：fix_0508_json/fix_deep_research_footers/fix_json_quotes/fix_weixin_links/verify_4positions/daily_agent_runner/update_homepage_weekly → _archive/

推送范围

类型	推送范围	禁止
日报	私发订阅者	❌禁止群发
周报	先私发预览{{OWNER_KIM_USERNAME}} → 确认后发AI生产力中心大群(space:3705455482343722)	❌禁止不确认就群发

一次到位执行流程（日报7步）

Step 1: 搜索调研 → orchestrator complete --step 1
Step 2: 内容生成 → orchestrator complete --step 2
Step 3+4: finalize → orchestrator finalize（自动:质量门→HTML→首页更新→部署→外部同步）
Step 5: KIM推送 → sync_subscribers.py → build_insight_mixcard.py → message(kimMixCard, message="")
Step 5.5: 交付链接 → 输出四个链接（内部版日报+首页 + 外部版日报+首页），方便自检
Step 6: 知识沉淀(Harvest) → 检查复用价值 → 写入knowledge包（P0#22强制）

**⚠️ MixCard发送格式（P0红线）**：
- `kimMixCard`参数必须传**inner card格式**（`{config, updateMulti, blocks}`直接在顶层）
- ❌禁止传双层格式`{card: {...}, summary: "..."}` — KIM找不到blocks字段会渲染为空消息
- `message`参数必须传空字符串`""`，禁止同时传message和kimMixCard（会导致{{message}}模板注入泄露）
- 脚本输出已改为inner card格式，读取JSON后直接传给message工具即可

订阅系统

Web 订阅页面：https://aidailyinsight-subscribe.frontend-cloud.corp.kuaishou.com （快手 SSO 登录 → 一键订阅/取消）
内部首页入口：public/subscribe/index.html 重定向到 Web 订阅页面
数据存储：Appwrite TablesDB（subscribers 库 → daily_subscribers 表，行级安全）
同步脚本：scripts/sync_subscribers.py（Appwrite → data/subscribers.json，cron 执行前调用）
订阅者推送：日报 Step 5 读取 data/subscribers.json，遍历 is_active=true 的用户逐一私发
owner 保留：{{OWNER_KIM_USERNAME}} 始终在订阅列表中（source=owner），不可取消
⚠️ 订阅按钮路径：内部首页的订阅按钮必须直接指向 https://aidailyinsight-subscribe.frontend-cloud.corp.kuaishou.com，禁止使用 ./subscribe/ 相对路径——frontend-cloud会拦截 /subscribe/ 路径触发SSO 302重定向，导致用户看到登录页而非订阅页（2026-06-03教训）

首页规则（P0红线 #19-#26 的补充说明）

以下P0红线在主列表(#19-#26)中已声明，此处仅保留补充细节，不重复主列表内容。

#19 补充：知识库Tab禁止可点击链接

✅ <span class="kb-item"><span class="item-icon">📄</span><span class="item-text">标题</span></span>
适用于内部版和外部版（外部版通过 sanitize_html() 自动转换）

#22 补充：知识沉淀(Harvest)是P2强制步骤

当前断档：6/2、6/3日报均未做Harvest，需要补做

#23 补充：frontend-cloud部署失败=硬性阻断

deploy_daily.sh Step 8 设 DEPLOY_FAIL=1（已修复）

#24 补充：周报更新必须三联动

日历映射用周一起始日：W19起05/04(Mon)

#26 补充：日报完成后交付链接

⚠️ 内部版日报链接含-v3.html后缀（历史遗留），外部版不含-v3
URL SSoT = scripts/config.py

#27 模板变量禁止嵌入f-string上下文外的字符串常量（2026-06-22 #128）

禁止在Python字符串常量中直接写{SVG_ICONS["insight"]}或{INTERNAL_BASE}——不在f-string上下文中=原始文本输出
正确：用占位符模板（__SVG_INSIGHT__/__HOMEPAGE_URL__），在generate_html()中显式替换
根因：W25了解更多模块2处模板变量未替换，页面直接显示原始文本

#28 Top5来源必须逐个配超链接（2026-06-22 #128）

禁止合并多个来源到纯文字span（<span class="meta-item">Fortune · 36氪 · Axios</span>不可追溯）
正确：JSON sources[]数组，每个来源独立{name, url}，渲染为<a class="meta-link">
旧source/source_url字段保留为fallback，sources[]优先
根因：W25周报5张Top5卡片来源均为纯文字，违反output-format-spec 1.4

#29 脚本必须防御JSON脏数据（2026-06-22 #128）

日报链接-v3.html后缀 → _clean_daily_url()自动去除
双<strong>嵌套 → _strip_double_strong()清理
空URL → fallback渲染为纯文字span
根因：6类问题中5类因为脚本假设JSON数据干净，实际有-v3后缀、空URL、自带HTML标签、合并文字来源

首页统计卡片维护规则（P1 — 自动校准）

统计卡片数字由 calibrate_stats.py 自动计算，每次 update_homepage.py 运行时自动校准
校准方法：追踪条目从index.html表格行计数、深度调研从时间轴链接数、日报/周报从public/文件计数
当前值（2026-06-04校准）：人物85+、公司183+、深度调研30、日报95+周报14=109+

日历数据维护规则（P1 — cron自动+手动补漏）

日报cron的 update_homepage.py daily 会自动更新日历日期数组
但以下情况需手动修复：漏日期（如5/28）、周报映射错误（如W22重复标记31号）、周报缺失（如W21）
周报日历映射规则：weeklyReportsData['YYYY-MM'] = {周一日期: 'weekly-YYYY-Wxx'}
ISO周号计算：date.fromisocalendar(YYYY, W, 1) → 起始周一日期

系统健康检查（2026-06-05 全面复盘续）

闭环验证结果

子系统	状态	问题	修复
日报cron(08:00)	✅ 运行稳定	frontend-cloud部署被跳过	P0#23: 硬性阻断+手动补部署
周报cron(周一09:00)	✅ 运行稳定	W21缺失	✅ 补跑完成
订阅系统	✅ 7人活跃	—	—
内部首页	✅	周报badge全指向W21+日历映射错+footerURL错	✅ 三联动修复+footer统一
外部首页	✅ 零敏感词	53个日报footerURL错误	✅ 统一外部URL
双版本同步	✅	—	—
frontend-cloud部署	✅	cron跳过→用户404	P0#23: 非阻断→硬性阻断
知识库Tab	⚠️	37个链接→span(临时方案)	长期: 知识渲染为HTML
追踪体系	⚠️	无自动保鲜机制	P1: 待设计cron
时间轴	⚠️	新调研需手动添加	P1: gen_timeline.py待集成
统计卡片	✅	自动校准	calibrate_stats.py集成到update_homepage
MixCard URL	✅	统一内部版	--target仅控制footer文本(#123修正)
林克首页	✅	数据过期(6/1→6/5)	✅ 重新部署

知识沉淀断档分析

workflow.md Step 5之后增加 Step 6: 知识沉淀(Harvest)
SKILL.md P2事后步骤增加Harvest（P0#22）
cron payload增加Harvest提示

待建设能力（P1优先级排序）

~~日报workflow增加Harvest步骤~~ → ✅ 2026-06-04完成
追踪体系自动保鲜cron — 定期扫描新人物/公司，更新追踪清单
~~时间轴自动生成~~ → gen_timeline.py 已有脚本，待集成到 update_homepage.py
~~统计卡片自动校准~~ → ✅ 2026-06-04: calibrate_stats.py + 集成到 update_homepage.py
知识库HTML渲染 — 将md转为可浏览的HTML页面
~~非owner订阅推送验证~~ → 待08:00 cron触发后验证

踩坑经验（归档，不加载）

完整踩坑经验见 `reference/daily-report/lessons-learned.md`，但执行时不主动加载。关键教训已内置到脚本校验逻辑中。

周报视觉规范（P0 — 2026-06-30 W26重构后锁定）

以下标准已内置到 gen_weekly_html.py，不可手动修改绕过。执行周报前确认脚本是最新版。

P0 新增红线（#30~#34）

#30 周报必须用 gen_weekly_html.py 生成，禁止手动拼 HTML

所有样式/结构均在脚本中固化，手动拼出的 HTML 会绕过 CSS class 规范，样式全失效

#31 CSS 补丁不得超过 3 轮零散追加，必须合并为整洁 CSS 系统

多次追加会导致选择器优先级混乱，效果不可预测。应整合为一个版本块（如 v4.0），关键属性加 !important

#32 board-table 必须用 table-layout: auto，维度列用 white-space: nowrap; width: 1%

禁止用固定百分比列宽（如 width: 20%），会在多层容器嵌套中计算失准导致信号列截断

#33 .table-wrap 必须保持 overflow-x: auto

禁止 overflow: hidden，会截断宽表格内容

#34 stat-card（stats-grid）已废弃，不得在周报中生成

用户确认无阅读价值（2026-06-30），脚本已删除渲染逻辑

周报视觉标准速查表

组件	规范
Header	深色渐变 #0f172a→#1e1b4b，白色渐变标题 36px/800
板块 label	pill 10px/700/uppercase，各板块主题色
板块 h2	22px/700，大模型=绿/Coding=蓝/应用=紫/行业=橙/企业=红
板块分隔	margin-top:48px + border-top:2px 板块色15%淡
Top5 卡片	白底+4px左色条+hover上浮，关键判断独立背景区
事件表格	table-layout:auto, overflow-x:auto, 维度列nowrap
callout strong	800字重 + 各类型对应深色
日报索引	flex布局，标题取 keywords.split(",")[0]
narrative	每块有序号小标题（01/02/03）+ 彩色border-left
正文	15px/#57534E/1.75行高，行宽 65ch 仅限纯文字段落

更新于 2026-06-30 · v3.7 · W26视觉标准锁定 + 周报P0红线#30-#34

#35 部署前必须通过全链路自检（2026-06-30）

日报 deploy_daily.sh 自检链：

JSON Schema 验证 → 阻断
质量门 22项 → 阻断（硬性失败）
HTML 展示验证 → 阻断
首页完整性 verify_homepage.py → 阻断

周报 deploy_weekly.sh 自检链：

JSON Schema 验证 → 阻断
HTML 展示验证 → 阻断
外部版敏感词检查 → 阻断
首页完整性 verify_homepage.py → 阻断

任何一项自检失败 = 禁止部署。修复后重新自检直到全通过。

更新于 2026-06-30 · v3.8 · P0#35 部署前全链路自检

sl-ai-insight

Más de este repositorio

Más de este repositorio

sl-ai-insight — AI行业洞察

项目目标

双版本体系

闭环约束

时间轴归档规则（P0 — 2026-06-03 血泪教训）

⚠️ 元执行保障（必加载）

项目信息

子技能路由表

底层依赖

Knowledge Dependencies

P0红线（21条核心红线）

#0. 时间窗口铁律 — 最高优先级，所有内容生成必须遵守

#1. 续接必须先 resume — 无例外

#2. KIM卡片必须用脚本生成 — 禁止手写

#3. mixCard只推一次 — 禁止重复

#4. 质量门硬性失败=重做 — 禁止绕过

#5. 环境前置检查 — 每次执行必做

#6. fail loud, don't fail silent

#7. 首页修改必须读 homepage-spec.md — 禁止裸复制

#8. sync_to_external.py 的 sync_all() 禁止复制根级 index.html

#9. 深度调研执行前必须读完3个规范文件+1个标杆 — 禁止凭感觉动手

#10. 所有Python命令必须用 uv run — 禁止 python/python3

#11. 外部版HTML修改必须完成三项URL替换+线上验证 — 禁止只改一处

#12. 容器管布局宽度，文字管可读宽度 — 不可违反

#13. MixCard {{message}} 绝对禁止 — 已记录（见TOOLS.md）

#14. 知识库Tab禁止可点击的md链接 — 浏览器无法渲染

#18d. 搜索硬限制 — 总次数≤8，每板块≤1次海外+1次微信（2026-06-22新增）

#19. MixCard按钮URL统一用内部版 — --target仅控制footer文本

#16. 首页按钮必须使用绝对URL — 禁止相对路径

#17. 格式升级必须改脚本 — 禁止只改HTML文件

#18. HTML视觉格式标准（周报+日报统一）

#18a. 结构元素用SVG icon，不用emoji

#18b. 卡片视觉层级（Top5/洞察卡）

#18c. 行宽限制

#18d. 概览图位置

脚本自校验清单

核心脚本清单（精简后）

推送范围

一次到位执行流程（日报7步）

订阅系统

首页规则（P0红线 #19-#26 的补充说明）

#19 补充：知识库Tab禁止可点击链接

#22 补充：知识沉淀(Harvest)是P2强制步骤

#23 补充：frontend-cloud部署失败=硬性阻断

#24 补充：周报更新必须三联动

#26 补充：日报完成后交付链接

#27 模板变量禁止嵌入f-string上下文外的字符串常量（2026-06-22 #128）

#28 Top5来源必须逐个配超链接（2026-06-22 #128）

#29 脚本必须防御JSON脏数据（2026-06-22 #128）

首页统计卡片维护规则（P1 — 自动校准）

日历数据维护规则（P1 — cron自动+手动补漏）

系统健康检查（2026-06-05 全面复盘续）

闭环验证结果

知识沉淀断档分析

待建设能力（P1优先级排序）

踩坑经验（归档，不加载）

完整踩坑经验见 reference/daily-report/lessons-learned.md，但执行时不主动加载。 关键教训已内置到脚本校验逻辑中。

周报视觉规范（P0 — 2026-06-30 W26重构后锁定）

P0 新增红线（#30~#34）

周报视觉标准速查表

#35 部署前必须通过全链路自检（2026-06-30）

sl-ai-insight — AI行业洞察

项目目标

双版本体系

闭环约束

时间轴归档规则（P0 — 2026-06-03 血泪教训）

⚠️ 元执行保障（必加载）

项目信息

子技能路由表

底层依赖

Knowledge Dependencies

P0红线（21条核心红线）

#0. 时间窗口铁律 — 最高优先级，所有内容生成必须遵守

#1. 续接必须先 resume — 无例外

#2. KIM卡片必须用脚本生成 — 禁止手写

#3. mixCard只推一次 — 禁止重复

#4. 质量门硬性失败=重做 — 禁止绕过

完整踩坑经验见 `reference/daily-report/lessons-learned.md`，但执行时不主动加载。关键教训已内置到脚本校验逻辑中。

完整踩坑经验见 `reference/daily-report/lessons-learned.md`，但执行时不主动加载。关键教训已内置到脚本校验逻辑中。