github-renovationlisted

# GitHub 装修（GitHub-Renovation） 把 GitHub 仓库的门面当产品来打磨，三条产线可单独做也可全套装修： - **项目 README** —— 仓库的第一说服面 - **profile 主页** —— 与用户名同名的公开仓库，事实上成为个人"官网" - **SEO 元数据** —— 让机器（搜索引擎）能读懂，更让用户（开发者）愿意点进来 ## 核心原则（贯穿全程） 1. **先定位，后装修** —— 主页讲一条故事线（我是谁 → 我在做什么 → 代表作），不是仓库清单；README 讲一条价值线（解决什么 → 怎么用 → 凭什么信）。 2. **减法优先于加法** —— 加法容易减法难： - 0-star 阶段不放 star 数、不放 stats 卡片（负资产） - 不放 fork 仓库；不链 private 仓库（访客看到 404 等于死链） 3. **诚实可验证** —— 所有描述从仓库真实 README 提炼、数字可验证、没有营销虚词；这既是内容质量也是信任策略。 4. **SEO 靠元数据不靠玄学** —— 四个杠杆按权重排：仓库 description（= Google 结果标题）＞ README 首两行（= 摘要片段）＞ topics（= 站内标签流量）＞ bio（= 主页 meta description）。 5. **🔴 写入 GitHub 前必须确认** —— 所有 README / 主页文件先在本地落盘给用户过目；`gh repo edit` 等改动线上元数据的命令，先展示将执行的内容，确认后再执行。 ## 模式判定 | 用户说 | 模式 | 路径 | |---|---|---| | "写 README" / "给我的项目写个 README" / "优化这个 README" | **A 项目 README** | Phase 1 → 2A → 3 → 4 | | "装修 GitHub 主页" / "做个 profile README" / "个人主页仓库" | **B 主页仓库** | Phase 1 → 2B → 3 → 4 | | "全套装修" / "项目和主页都要" | **A + B** | Phase 1 → 2A → 2B → 3 → 4 | | "帮我做 GitHub SEO" / "仓库搜不到" / "查一下我的仓库装修现状" | **C SEO 体检** | Phase 1（只查现状）→ 3 → 4 | ## 资源索引（按需读，不要一次全读） | 文件 | 内容 | 何时读 | |---|---|---| | [template/readme参考/README.md](template/readme参考/README.md) | 功能型项目 README 范本（信息架构最全） | 写 README 前必读 | | [template/readme参考/README-1.md](template/readme参考/README-1.md) | 数据工具类范本（强合规 / 隐私声明 / 已知限制写法） | 项目涉及数据采集、隐私、合规时 | | [template/readme参考/README-2.md](template/readme参考/README-2.md) | 媒体视觉型范本（在线画廊 / 社媒徽章 / 素材授权说明） | 项目有画廊、演示站、视频产出时 | | [references/profile-要素.md](references/pr