在 Devin 中试用 DeepWiki 处理私有仓库
DeepWiki

ruanyf/weekly

菜单

期刊结构

相关源文件

本文档描述了《科技爱好者周刊》仓库中周刊议题的标准化结构和格式。每期周刊都遵循一个随时间演变的、一致的格式，以确保读者能够轻松地浏览和找到感兴趣的内容。关于议题如何发布和分发的更多信息，请参阅 发布流程。

议题格式概览

每期议题都遵循一个精心设计的结构化格式，旨在以逻辑性的方式组织各种内容类型。一致的结构有助于读者快速定位他们感兴趣的特定部分。

来源: docs/issue-106.md docs/issue-344.md docs/issue-343.md docs/issue-28.md

头部信息

每期议题都以标准化的头部信息开始

  1. 标题：格式为“科技爱好者周刊（第 X 期）：[主题标题]”，其中 X 是期号，主题标题是该期议题的主要主题。

  2. 引言：一段简短的标准段落，说明周刊每周五分享值得关注的技术内容。

  3. 仓库信息：一条声明，说明该杂志在 GitHub 上是开源的，并附有指向仓库的链接和贡献邀请。

  4. 社区链接：通常会引用“谁在招人”的讨论串，提供招聘信息。

第 344 期示例头部

# 科技爱好者周刊（第 344 期）：制造业正在"零工化"

这里记录每周值得分享的科技内容，周五发布。

本杂志<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/开源" undefined  file-path="开源">Hii</FileRef>，欢迎<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/投稿" undefined  file-path="投稿">Hii</FileRef>。另有<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/《谁在招人》" undefined  file-path="《谁在招人》">Hii</FileRef>服务，发布程序员招聘信息。合作请<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/邮件联系" undefined  file-path="邮件联系">Hii</FileRef>（yifeng.ruan@gmail.com）。

来源: docs/issue-344.md1-6 docs/issue-106.md1-7

封面部分

每期议题都包含一个封面部分，由以下几部分组成：

  1. 封面图标题：“封面图”
  2. 图片：一张具有视觉吸引力的照片
  3. 说明：图片的简短描述，通常包含来源出处

第 344 期示例

## 封面图

![](https://cdn.beekka.com/blogimg/asset/202504/bg2025040904.webp)

天津海棠花盛开，茶壶倒出的都是海棠。（[via](https://www.sohu.com/a/876850404_121443915)）

来源: docs/issue-344.md7-13 docs/issue-106.md9-13

本期话题部分

“本期话题”部分是每期议题的社论核心。它包含：

  1. 话题标题：与议题标题相同
  2. 社论内容：数段深入讨论特定技术相关话题
  3. 分析：通常包含作者对行业趋势、社会影响或技术发展的看法和分析
  4. 图片/图表：有时会包含相关的图片或图表来支持讨论

此部分长度不一，但通常包含约 500-1000 字的深度评论。话题范围广泛，从技术趋势和市场分析到技术的社会影响和职业建议。

第 344 期话题示例：“制造业正在‘零工化’”，讨论制造业工作如何越来越多地成为短期职位而非长期雇佣。

来源: docs/issue-344.md13-66 docs/issue-106.md15-40 docs/issue-341.md13-57

内容部分

周刊包含几个标准的内��部分，这些部分出现在大多数期数中，但并非所有部分都出现在每期。下面是一个展示主要内容部分之间关系的图表

科技动态

此部分展示最近的技术新闻

  1. 格式：编号列表
  2. 内容：技术新闻的简短摘要，常配有图片
  3. 来源：许多条目包含指向原始来源的链接
  4. 一句话消息：有时包含一个非常简短的新闻条目子部分

示例

## 科技动态

1、[加州禁止"保质期"](https://www.foodandwine.com/california-bans-sell-by-dates-8723111)

美国加州通过一项法律，从2026年7月开始，食品不得标识"保质期"，而要改成"最佳食用日期"（Best Before）。

![](https://cdn.beekka.com/blogimg/asset/202410/bg2024101101.webp)

因为保质期往往被当作可食用的最后日期，一旦过期，食品就要下架，非常浪费。

来源: docs/issue-345.md83-96 docs/issue-344.md67-125

文章

此部分精选值得阅读的有趣文章

  1. 格式：编号列表
  2. 内容：文章的简短描述及链接
  3. 主题：混合了技术教程、分析和思想性文章
  4. 语言：包含中文和英文文章

示例

## 文章

1、[我们正在进入大芯片时代](https://www.xda-developers.com/were-entering-the-big-chip-era-and-i-couldnt-be-more-excited/)（英文）

![](https://cdn.beekka.com/blogimg/asset/202504/bg2025041109.webp)

大芯片指的是 CPU、GPU、内存封装在一块芯片里面，典型代表是苹果的 M 系列芯片。

来源: docs/issue-345.md144-186 docs/issue-343.md190-208

工具

此部分介绍开发者和普通用户的有用软件工具

  1. 格式：编号列表
  2. 内容：工具的简短描述，附带链接，有时还有截图
  3. 类型：包括库、应用程序、网站和开发工具
  4. 来源：混合了成熟的工具和社区贡献（常附有 GitHub 用户名引用）

示例

## 工具

1、<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/NixVis" undefined  file-path="NixVis">Hii</FileRef>

![](https://cdn.beekka.com/blogimg/asset/202503/bg2025032917.webp)

开源的轻量级 Nginx 日志分析工具，自带 Web UI，使用 Go 语言开发。（<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/@BeyondXinXin" undefined  file-path="@BeyondXinXin">Hii</FileRef> 投稿）

来源: docs/issue-344.md161-230 docs/issue-343.md183-267

资源

此部分分享教育资源和参考资料

  1. 格式：编号列表
  2. 内容：简短描述，附带链接
  3. 类型：包括网站、数据集、免费服务、教育材料等

示例

## 资源

1、[Flight Track in 3D Earth](https://flight.is26.com/)

![](https://cdn.beekka.com/blogimg/asset/202504/bg2025041502.webp)

在 3D 地球仪上，显示某个航班的飞行路线。（<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/@foru17" undefined  file-path="@foru17">Hii</FileRef> 投稿）

来源: docs/issue-345.md266-285 docs/issue-343.md297-346

此部分出现在较新的期数中，专注于 AI 工具和开发

  1. 格式：AI 工具和资源的编号列表
  2. 内容：AI 模型、应用程序和服务，附带链接和描述
  3. 类型：常包括开源 AI 项目和社区贡献

示例

## AI 相关

1、<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/Web Design AI Agent" undefined  file-path="Web Design AI Agent">Hii</FileRef>

开源的 AI 应用，根据文字描述和图片生成网页，使用 Claude AI 模型，部署在 Cloudflare worker。（<FileRef file-url="https://github.com/ruanyf/weekly/blob/dc4f9481/@mggger" undefined  file-path="@mggger">Hii</FileRef> 投稿）

来源: docs/issue-344.md239-266 docs/issue-343.md273-296

图片

此部分分享有趣的图片或视觉内容

  1. 格式：带图片和解释性文字的编号条目
  2. 内容：独特、有趣或引人深思的图片
  3. 主题：可以包括科学现象、历史照片、有趣的设计等

示例

## 图片

1、[红绿色盲](https://www.theverge.com/23650428/colorblindness-design-ui-accessibility-wordle)

红绿色盲的患者，看不到红色和绿色。在他们眼里，这两种颜色都会变成黄色。

![](https://cdn.beekka.com/blogimg/asset/202304/bg2023040802.webp)

来源: docs/issue-343.md348-370 docs/issue-28.md268-290

结尾部分

文摘

此部分包含来自有趣文章或书籍的较长摘录

  1. 格式：带标题和大量文本的编号条目
  2. 内容：对有趣话题的深入探讨
  3. 来源：常归因于原始出版物或作者

示例

## 文摘

1、[如何阻止 AI 爬虫](https://tobloef.com/blog/wheel-reinventors-principles/)

我喜欢从头开始写东西，经常有人说，我在重新发明轮子。

我这样做有好几个理由。

来源：docs/issue-343.md372-380 docs/issue-106.md291-342

语录 (Quotes)

本节呈现引人深思的语录

  1. 格式：编号引语，通常非常简短
  2. 内容：关于技术、商业或生活的有趣观点
  3. 归属：通常包含引语的出处

示例

## 言论

1、

科幻电视剧《黑镜》完全是技术悲观主义，只谈技术的风险，不谈技术变革让现在的生活比过去好。它传播对未来的恐惧，让人们惧怕技术变革。

但是，如果我们想要更美好的未来，就只有依靠技术。

-- [英国《卫报》](https://www.theguardian.com/technology/2025/apr/10/black-mirror-tv-show-pessimism)

来源：docs/issue-345.md357-386 docs/issue-344.md362-382

往期回顾 (Previous Years Review)

本节链接至往年同期的issue

  1. 格式：链接列表，指向去年同期发布的issue
  2. 内容：往期issue的标题及链接
  3. 模式：通常包含1年、2年、3年和4年前的issue

示例

## 往年回顾

[轮到硬件工程师吃香了](https://www.ruanyifeng.com/blog/2024/04/weekly-issue-298.html)（#298）

[不要夸大 ChatGPT](https://www.ruanyifeng.com/blog/2023/03/weekly-issue-248.html)（#248）

[美国制造是否可能](https://www.ruanyifeng.com/blog/2022/03/weekly-issue-198.html)（#198）

[微增长时代](https://www.ruanyifeng.com/blog/2021/03/weekly-issue-148.html)（#148）

来源：docs/issue-345.md389-398 docs/issue-344.md383-392

订阅 (Subscription)

在某些issue（尤其是早期issue）中，本节提供了如何订阅该通讯的信息

  1. 格式：带有订阅说明的文本
  2. 内容：关于并行发布渠道（博客、微信）的详细信息
  3. 视觉：有时包含微信公众号的二维码

示例

## 订阅

这个周刊每周五发布，同步更新在[阮一峰的网络日志](http://www.ruanyifeng.com/blog)和[微信公众号](http://weixin.sogou.com/weixin?query=%E9%98%AE%E4%B8%80%E5%B3%B0%E7%9A%84%E7%BD%91%E7%BB%9C%E6%97%A5%E5%BF%97)。

微信搜索"阮一峰的网络日志"或者扫描二维码，即可订阅。

![](http://www.ruanyifeng.com/blogimg/asset/2018/bg2018042311.jpg)

来源：docs/issue-106.md386-392 docs/issue-28.md312-318

Issue结构演变 (Evolution of Issue Structure)

周刊的结构随着时间推移而演变，同时保持了核心部分的连贯性。主要变化包括：

时间段显著变化
2018-2020确立了主要主题、新闻、文章、工具、资源的が基本结构
2021-2022增加了更多视觉内容，扩展了工具部分
2023-2024随着人工智能技术的兴起，引入了人工智能专属部分
2025+进一步完善了人工智能内容，增加了社区贡献

来源：README.md55-140 docs/issue-28.md docs/issue-345.md

文件命名与组织 (File Naming and Organization)

周刊遵循一致的文件命名约定和仓库组织方式

关键方面：

  1. 文件名：每个issue都命名为 issue-X.md，其中X是顺序issue编号
  2. 位置：所有issue都存储在 docs/ 目录中
  3. 索引：README.md 文件提供了所有issue的按时间顺序索引，按年份和月份组织
  4. 辅助文件：仓库还包含特定主题的资源集合和免费资源集合

来源：README.md28-644

内容贡献与社区参与 (Content Contribution and Community Involvement)

该周刊积极鼓励社区贡献

  1. 用户贡献：许多工具、资源和AI项目由社区成员贡献，并附有其GitHub用户名的归属
  2. Issue跟踪器：仓库使用GitHub Issues进行内容提交和建议
  3. 招聘信息板块：维护一个专门用于发布招聘信息的讨论串

这些社区化方面有助于确保内容的多元化，并使周刊与读者的兴趣保持同步。

来源：docs/issue-344.md5-6 docs/issue-343.md4-5

结论

《技术爱好者周刊》的issue结构经过精心设计，以读者友好的格式组织多样化的技术内容。这种一致的结构有助于读者轻松浏览每一期内容，同时允许灵活调整以适应不断变化的技术趋势。从主编辑主题到精选新闻、工具和资源，每个部分在创建全面的每周技术摘要方面都发挥着特定作用。