知识站与题库小程序怎么联动

难度与前置

难度：入门
前置：知道同仓库有 website/（本站）与 miniprogram/（题库小程序）两套产物；改一边不应默默弄坏另一边。
读完能做什么：在专篇文末用统一 CTA / 占位引流；分清「深读写在站、刷题留在小程序」；审校时拦下重复题解与假链接。

适用场景

给技术文加「去刷题」入口，但题库 AppID / 正式路径尚未敲定
新人问「网站和小程序会不会两套内容打架」
作者想把整篇题解贴进 VitePress，或反过来在小程序里贴长步骤文
发布前检查：改网站 Markdown 会不会误动 miniprogram/ 目录

不适用：

小程序页面开发、发版、审核（不在本站文档展开）
发明尚未存在的公网题库 URL 或二维码图床当正式入口
替代学习路径导读 / 读完自测清单
在本页维护题库题目全文

真实场景（一条）

短剧投放主题「Kafka 积压排查」成稿后，作者把 8 道题的完整解析（含内部集群名与真实 lag 曲线截图）贴进网站文末，又在小程序里复制同一份长文。一周后专篇改正文步骤，小程序题解仍是旧口径，候选人按小程序答、面试官按网站问，对不上。按本规范拆开：网站只保留 3～5 道占位题 + CTA 占位；题干与解析以小程序为准；网站专责步骤/坑/验收。之后改正文只需同步「考察点是否仍成立」，不必维护两份长题解。

怎么做（步骤清单）

1. 职责一句话

产物	仓库目录	读者得到什么	不该承担什么
知识站	`website/`（本文所在）	体系化深读：场景、步骤、坑、可测验收	完整刷题解析库、每日一题推送
题库小程序	`miniprogram/`	打卡刷题、速记、按题号演练	替代专篇长文、发布仓表 DDL 教程全文

同一认知主题（如「幂等双跑」）可以两边都出现，但：

步骤与验收数字以网站专篇为准
题干选项与解析短文以小程序为准
网站文末只用占位链到题号，不复制解析正文

在 ## 相关面试题 提示行之外，如需单独引流句，只用明确标成占位的文案，例如：

markdown

::: tip 刷题入口（占位）
正式小程序路径待定。请勿将下列占位当成可点击生产地址。

- 占位 AppID：`&#123;&#123;MINIPROGRAM_APPID&#125;&#125;`
- 占位路径：`miniprogram://q/＜id＞` 或 小程序码「待设计」
- 同期站内：先按本篇验收自测 → [读完自测清单](/guide/practice-checklist)
:::

规则：

出现 待定 / {{...}} / 占位 字样，避免读者以为已上线
禁止临时填写同事个人体验版二维码当文档长期链接
题库接通后：只替换占位符与 ＜id＞，尽量不改题干「考察点」句（考察点应继续对齐专篇验收）

3. 与「相关面试题」区块如何配合

先按文末面试题占位规范写 3～5 题
每题占位优先 miniprogram://q/＜id＞；无 id 时用 #todo-interview-＜slug＞
CTA tip 块可选；有 tip 时不得再塞第二套假 https:// 题库域名
读者路径建议：读专篇 → 自测清单 →（题库可用时）刷对应题号

4. 仓库操作边界（作者 / Agent 必看）

text

□ 改 website/docs/** 下的 Markdown：允许（本批任务）
□ 改 website 侧栏 config：允许且需与链接一致
□ 改 miniprogram/**：默认禁止（除非单独任务明确授权）
□ 删除 / 重命名已定稿主文或 redirect stub：禁止
□ 在网站贴小程序源码或把题库 JSON 全文拷进 docs：禁止

构建网站时不要 cd miniprogram && npm run build 当作本站验收；本站验收是 website 下 docs 构建（可按任务选择是否跑）。

5. 内容同步检查表（题库上线后）

检查	做法
题号有效	网站占位 `＜id＞` 在小程序侧存在
考察点仍成立	专篇验收改版后，题干是否要改「问法」而非抄旧解析
无双份长题解	网站侧无超过「一句方向」的解析粘贴
无假链	文档内无失效体验码、过期短链

常见坑（至少这些）

网站复制小程序全文题解
双份维护，必然漂。
改正文步骤却不回头看考察点是否失效
候选人按旧题答新验收。
编造正式 URL / 扫码图冒充已上线
信任破产；统一占位。
在 website 任务里改 miniprogram 源码「顺手对齐」
易弄破小程序构建；除非任务明文授权。
把 redirect stub 链进 CTA
主链与侧栏都不应把 stub 当主入口。
CTA 与「相关面试题」两套互相矛盾的链接
只保留一套占位语义。
用真实业务 lag 图、内部集群名当小程序预览素材写进网站
机密与 PII 风险；改用虚构短剧投放表述。

如何验收

项	达标标准
分工表述	能一句话说清：站=深读验收，小程序=刷题
占位	CTA / 题链含「待定」或 `{{...}}` / `miniprogram://` / `#todo-…`，无假生产 URL
题解	网站无大段标准答案副本
仓库	本任务 diff 不含 `miniprogram/` 删除或改动
读者路径	写明：专篇 → 自测 →（可选）刷题

text

站 × 小程序联动审校（可复制）
文章：________
相关面试题条数：____（3～5）
CTA 占位：有/无；含「待定」字样：是/否
网站含完整题解：是* / 否（*打回）
触及 miniprogram/ 目录：是* / 否（*除非授权）
假 https 题库链：是* / 否
审校：________  日期：________

Checklist：

[ ] 职责表与禁止项已读
[ ] 文末链接格式与 related-interview 一致
[ ] 已指向 practice-checklist 作为刷题前自测
[ ] 无真实 PII / 内部指标图

知识站与题库小程序怎么联动 ​

适用场景 ​

真实场景（一条） ​

怎么做（步骤清单） ​

1. 职责一句话 ​

2. 文末 Footer CTA 占位（推荐句式） ​

3. 与「相关面试题」区块如何配合 ​

4. 仓库操作边界（作者 / Agent 必看） ​

5. 内容同步检查表（题库上线后） ​

常见坑（至少这些） ​

如何验收 ​

相关面试题 ​