慣性聚合 高效追蹤和閱讀你感興趣的部落格、新聞、科技資訊
閱讀原文 在慣性聚合中打開

推薦訂閱源

博客园 - 司徒正美
V
V2EX
T
Tailwind CSS Blog
有赞技术团队
有赞技术团队
aimingoo的专栏
aimingoo的专栏
Apple Machine Learning Research
Apple Machine Learning Research
IT之家
IT之家
Blog — PlanetScale
Blog — PlanetScale
A
About on SuperTechFans
月光博客
月光博客
T
The Blog of Author Tim Ferriss
宝玉的分享
宝玉的分享
Martin Fowler
Martin Fowler
博客园 - 聂微东
The GitHub Blog
The GitHub Blog
V
Visual Studio Blog
WordPress大学
WordPress大学
酷 壳 – CoolShell
酷 壳 – CoolShell
Engineering at Meta
Engineering at Meta
GbyAI
GbyAI

阮一峰的网络日志

科技爱好者周刊(第 396 期):互联网通信的替代方案 科技爱好者周刊(第 396 期):互联网通信的替代方案 - 阮一峰的网络日志 科技爱好者周刊(第 395 期):软件开发的第三种方式 科技爱好者周刊(第 395 期):软件开发的第三种方式 - 阮一峰的网络日志 科技爱好者周刊(第 393 期):脑腐状态 科技爱好者周刊(第 392 期):axios 投毒与好莱坞式骗术 科技爱好者周刊(第 391 期):AI 的贫富分化 科技爱好者周刊(第 390 期):没有语料,大模型就是智障 套壳中国大模型撑起500亿美元估值?扒一扒 Cursor 的"套壳"疑云 科技爱好者周刊(第 389 期):未来如何招聘程序员 科技爱好者周刊(第 388 期):测试是新的护城河 零安装的"云养虾":ArkClaw 使用指南 科技爱好者周刊(第 387 期):你是领先的 科技爱好者周刊(第 386 期):当外卖员接入 AI 字节全家桶 Seed 2.0 + TRAE 玩转 Skill 科技爱好者周刊(第 385 期):马斯克害怕中国车企吗? 智谱旗舰 GLM-5 实测:对比 Opus 4.6 和 GPT-5.3-Codex 科技爱好者周刊(第 384 期):为什么软件股下跌 科技爱好者周刊(第 383 期):你是第几级 AI 编程 Kimi 的一体化,Manus 的分层 科技爱好者周刊(第 382 期):独立软件的黄昏 AI native Workspace 也许是智能体的下一阶段 科技爱好者周刊(第 381 期):中国 AI 大模型领导者在想什么 科技爱好者周刊(第 380 期):为什么人们拥抱"不对称收益" 科技爱好者周刊(第 379 期):《硅谷钢铁侠》摘录 我如何用 AI 处理历史遗留代码:MiniMax M2.1 升级体验 科技爱好者周刊(第 378 期):预测是新的互联网热点 科技爱好者周刊(第 377 期):14万美元的贫困线 科技爱好者周刊(第 376 期):太空数据中心的争议 科技爱好者周刊(第 375 期):一扇门的 Bug 终于有人做了 Subagent,TRAE 国内版 SOLO 模式来了 科技爱好者周刊(第 374 期):6GHz 的问题 VS Code 使用国产大模型 MiniMax M2 教程 科技爱好者周刊(第 373 期):数据模型是新产品的核心 国产大模型接入 Claude Code 教程:以 Doubao-Seed-Code 为例 科技爱好者周刊(第 372 期):软件界面如何设计 大模型比拼:MiniMax M2 vs GLM 4.6 vs Claude Sonnet 4.5 科技爱好者周刊(第 371 期):一个乐观主义者的专访 科技爱好者周刊(第 370 期):正确的代码高亮 错误处理:异常好于状态码 科技爱好者周刊(第 369 期):Tim 与罗永浩的对谈 科技爱好者周刊(第 368 期):不要这样管理软件团队 一天之内,智谱和 Anthropic 都发了最强编程模型 科技爱好者周刊(第 367 期):Nano Banana 的几个妙用 科技爱好者周刊(第 366 期):旧金山疯狂的 AI 广告 科技爱好者周刊(第 365 期):流量变现正在崩塌 科技爱好者周刊(第 364 期):最难还原的魔方 科技爱好者周刊(第 363 期):最好懂的神经网络解释 科技爱好者周刊(第 362 期):GitHub 工程师谈系统设计 科技爱好者周刊(第 361 期):暗网 Tor 安全吗?
科技愛好者週刊(第 288 期):技術寫作的首要訣竅
阮一峰 · 2024-01-26 · via 阮一峰的网络日志

這裡記錄每週值得分享的科技內容,週五發佈。

本雜誌開源,歡迎投稿。另有《誰在招人》服務,發佈程序員招聘信息。合作請郵件聯繫[email protected])。

封面圖

在昔日的"皇家園林"北京頤和園,昆明湖已經完全結冰,變成了遊人玩樂的大冰場。夕陽西下,湖上的十七孔橋現出了"金光穿洞"景觀。(via

技術寫作的首要訣竅

技術寫作非常重要,產品的開發、推廣、維護都需要它。

跟大家想的不一樣,技術寫作的好壞,跟語文水平關係不大,更多是一個技巧問題

因為技術寫作的評價標準,不是藝術性,而是表達是否清楚明白。它不需要華麗的詞藻、巧妙的比喻、深刻的感悟,只需要把問題說清楚。

把問題說清楚的關鍵,在於你的思想是否清楚。

當你想清楚了一個問題,只要掌握幾個基本訣竅,就能寫出一篇很好的技術文章。

今天,我來說說,技術寫作的首要訣竅是什麼。很簡單,就是一句話:文章採用單線結構

所謂"單線結構"(也稱"線性結構"),指的是一篇文章只說一件事,按照線性順序進行敘述,由淺入深、循序漸進、平鋪直敘、層層遞進。

這就好比一個遊覽區,只有一條遊覽路線,從入口到出口,跟著箭頭一路走,就能看到所有景觀,非常明白清楚。

如果同時有好幾條路線,遊客就會糊塗,到底選哪一條?會不會錯過景觀?要是這些路線還互相交叉,那就更糟糕了,遊客非串線不可。

(圖片說明:上面的景區路線圖,應該選擇哪條路線嗎?)

只要採用了單線結構,技術文章就不會太差。即使內容是難懂的,至少結構是清晰的,一環扣一環,讀者能知道自己卡在哪一環上。只要克服了這個難點,就能繼續往前走,不會有陷入迷宮、找不到方向、如墜五里霧中。

有一篇老外的文章,使用圖形表示文章結構,非常形象。

上圖就是單線結構,按照箭頭,一步步推進。

有的問題比較複雜,涉及多個因素,可能是星狀結構。

也可能是"層次結構"。

這時,建議把這個問題拆分成多篇文章,每篇文章保持單線結構,堅持做到一篇文章只講一點,而且爭取把這一點講透。

但是,單線結構說起來容易,做起來難。難就難在,人類的思想不是單線的,而是多線的,甚至是非線性。

你要把混亂而跳躍的思維,整理成單線結構,表達出來,讓他人理解,談何容易,通常都需要反覆推敲和提煉。

舉例來說,我們的思維可能是下圖這樣,好多點各自發散,連接在一起。

這種亂麻一團的思維並不可怕,可怕的是,你把文章也寫成這樣的結構,而不是耐心地梳理出一條線索。

科技動態

1、倉庫機器人

亞馬遜公司開始在倉庫,測試一款人形機器人。

它用於撿貨和搬運,每小時的運行成本是10至12美元。如果將來大量應用,成本可望降到2至3美元。

它跟工人一起工作(下圖)。工人都非常害怕,這種機器人取代他們。亞馬遜表示,機器人只是協助工人,並不會取代後者。

如果讓你跟機器人一起上班,做差不多的事情,而且它還不要薪水,大概沒人會心情好吧。

2、蜜蜂條形碼

科學家研究蜜蜂,需要追蹤每一隻蜜蜂的行為,但怎樣才能在一群蜜蜂中,分清誰是誰呢?

科學家想到了一個絕妙的辦法,在每一隻蜜蜂身上,貼上一個簡化的二維碼。

這種二維碼的面積是2.1平方毫米(即邊長不足1.5毫米),重0.6毫克,是工蜂重量的 0.7%,共可以表示2048只蜜蜂。

科學家手動為每隻蜜蜂貼上二維碼,一共貼了1400只,然後在高速攝像機下就可以讀到這些二維碼,從而分辨出每一隻的行為。

蜂巢裡面同時有上千只蜜蜂,放大圖像後,就可以畫出每隻蜜蜂的行動路線(下圖),分析它們在幹什麼,與誰合作。

3、舌頭鼠標

今年的拉斯維加斯"消費電子展" CES 上,展示了一款"舌頭鼠標"。

它使用牙套,將一塊迷你觸摸板固定在上顎,不需要用手,只用舌頭就能控制鼠標。

這個設備的原意是,方便手部損傷的或癱瘓的人士使用電腦,但後來發現,它在健全人中也有市場,機械師或外科醫生可以用它控制電腦,同時騰出雙手幹其他事情。

4、防盜盒

歐美的小型零售店,比如雜貨店和小超市,越來越流行把商品放在防盜盒裡面。

這種透明的塑料盒,需要鑰匙才能打開,顧客自己取不出商品,只有店員才能打開。

盒子還內置 RFID 芯片,如果擅自帶出商店,會引發警報器。這樣就大大減少了商品損耗和被竊。

文章

1、高德地圖如何實現紅綠燈倒計時?(中文)

高德地圖會顯示,紅綠燈倒計時讀秒。本文介紹背後的專利。

2、2023年前端技術盤點與展望(中文)

騰訊雲開發者公眾號與騰訊 MoonWebTeam 前端團隊聯合推出的長篇技術報告。(@ryantang1991 投稿)

3、JS 空數組的 every() 方法(英文)

every() 方法對於空數組總是返回 true,這是為什麼。

4、8個開源密碼管理器介紹(英文)

密碼管理器用來管理各種登錄密碼,本文介紹8個開源的密碼管理器。

5、令人震驚的 CSS 動畫效果(英文)

本文介紹一些高級的 CSS 動畫技巧。

6、HTTP/3 詳解(英文)

一組系列文章,向初學者介紹 HTTP/3 協議的設計,以及與 HTTP/2 的不同之處。

7、CPU 製造過程圖解(英文)

作者使用大量圖片,簡明通俗解釋如何從石頭製造出 CPU。讀了以後,對於 CPU 的製造流程就有一個大致的瞭解。

工具

1、Gemini Pro Chat

作者修改了 ChatGPT Next Web 的源碼,使其可以用於 Gemini Pro,這裡是 demo。(@lchh5 投稿)

2、WoodenFish

一個敲木魚的網頁 App,移動端打開時,只有偵測到手機陀螺儀的角度變化,才算一次敲擊動作,這時可以把手機想象成敲木魚的棒子。(@jwenjian 投稿)

3、Moodist

一個開源的 Docker 鏡像文件,提供50多種背景聲,比如風聲、雨聲、咖啡館的聲音。(@geekyouth 投稿)

4、Echo UI

一款專為 Web Audio API 設計的 UI 庫,適合用來搭建基於 Web 的音頻應用。(@codeacme17 投稿)

5、Photor

截圖美化工具,可以在線使用,也可以通過瀏覽器插件使用。(@sleepy-zone 投稿)

6、Message Nest

開源的消息推送平臺,整合郵件、釘釘、企業微信等多種通知方式。(@engigu 投稿)

7、Tiny RDM

Redis 桌面管理客戶端,支持 Mac、Windows、Linux。(@tiny-craft 投稿)

8、Frigate

開源的攝像頭固件,具有實時目標物體偵測。

9、InstantID

只使用一張圖片,就可以提取人臉,用於個性化圖像合成,並支持各種不同的風格,試用 Demo。(@zinc1234596 投稿)

10、HandBrake

一個跨平臺的桌面應用,用於轉換視頻編碼。

11、Animotion

一個網頁 CSS 動畫生成器,可視化設定動畫,自動生成代碼。

12、Ada

一個 URL 解析器,符合最新規範,使用 C++ 編寫,可以快速處理 URL。

13、Inpaint-web

開源的圖片修復和超分辨率工具, 純瀏覽器端實現。(@lxfater 投稿)

14、人像生成工具

基於手繪風 SVG 人物畫像集合 Open Peeps,一個人物畫像的在線定製工具。(@zerosoul 投稿)

資源

1、唐庫學習

電子書網站,提供世界名著的中英雙語對照朗讀。(@bigtang5 投稿)

2、AI 字體模型市場

該網站列出 AI 生成的字體,可以在線使用它們進行文字渲染。

它還支持網頁手寫八個字,生成自己的 AI 字體。(@qq345386817 投稿)

3、雲原生應用市場

用戶可以在這裡瀏覽各種雲原生應用,並一鍵安裝到各類運行環境( Docker、Kubernetes、Rainbond),支持國內鏡像加速。(@RainBondsongyg 投稿)

4、iHateRegex

一個收集常用正則表達式的資源庫,並通過可視化幫助理解,基於 regexper。(@zkerhcy 投稿)

5、AsPoem.com

學習欣賞中國古詩詞的網站。(@meetqy 投稿)

6、極簡博客

作者用 NextJS + Laf 雲搭建的博客託管網站,贈送二級域名。(@kingwrcy 投稿)

圖片

1、舊金山人行道

下面是美國舊金山市的一段人行道,2015年的樣子。

一位設計師決心改造這段人行道,營造出"城市森林"的景觀。

人行道寬3.66米,他保留中間一半供通行,兩側改為綠化。

中間一段重新鋪設路面以後,他在2016年在兩側種上植物。

2022年,這段路變成了下面這樣。

這不由讓人想起了那句有名的話:"種一棵樹的最佳時間是十年前,其次就是現在。"

文摘

1、我裝了一臺 NetBSD 服務器

2010年的某一天,我接到一個電話。

客戶想在內網部署幾個服務(dhcp、內部 DNS、Apache + PHP 服務器、NFS 和 Samba 件服務器),需要架設一臺服務器。

我建議客戶購買企業級硬件,但是他們堅持使用已有的服務器,那是一臺消費級電腦:沒有雙電源,沒有遠程管理功能,硬盤也是消費級的。

客戶原計劃安裝 Windows 2008 Server,然後在上面部署這些服務。我考慮到只有兩天時間,就建議改成安裝 NetBSD 系統。客戶同意了。

我安裝完以後,就移交給了客戶。後面的一個月,除了一些網絡延遲問題,客戶的反饋基本是正面的。

接下來的兩三年裡,我偶爾對這臺服務器進行了一些調整,隨後就與客戶失去了聯繫。

2021年2月,我又接到了那個客戶的電話,他們想要一個新的防火牆。這意味著那臺 NetBSD 服務器還在運行!出於好奇,我接受了這個任務。

我驚訝地發現,這臺服務器的工作完全正常。它不再對外網提供訪問了,但在內網運行順利。NFS SMB、DNS、SMTP 都是正常運行,它正在執行大約80%的原始任務。

最讓我驚訝的是它的正常運行時間。上一次重啟是在2012年,那時發生了一次小地震。客戶有備用發電機,因此服務器始終擁有不間斷電源。

誰能想到,這臺機器當初只花了幾個小時安裝,而且全部都是消費級硬件,但是正常運行了九年沒有重啟,並且這些年基本上是無人管理的。

我現在明白了,為什麼我沒有----也永遠不會----發財。我以前的老闆抱怨,我偏愛為客戶推薦穩定可靠的解決方案,這等於較少的長期利潤。據他說,需要頻繁維護的不可靠解決方案,才能帶來最多的收入。但是我覺得,出色的工作應該是持續有效的,不需要不斷的修復。

現在,我不確定這臺服務器是否仍在運行,如果有機會我一定會檢查一下。我很感激 NetBSD,它值得信賴,是一個輕量級、穩定、安全且高效的操作系統。在我看來,它至今仍然沒有得到應有的讚譽和地位。

言論

1、

AI 聊天機器人很快就會變得強大無比,看上去像神一樣,未來也許會出現崇拜 AI 的教派。

-- themessenger.com

2、

那些揹負鉅額債務以完成學業的學生,不太可能有遠大的理想。因為當人們陷入債務時,他們就沒有時間思考其他問題。

債務是一種改造手段,當這些學生畢業時,他們不僅揹負著沉重的債務,思想上已經被改造過了,使他們成為消費經濟的有效組成部分。

-- 諾姆·喬姆斯基,美國著名學者

3、

1931年,奧地利邏輯學家庫爾特·哥德爾提出了重要的"哥德爾不完備定理"。他證明,任何一組數學公理都不可能是完備的,總有一些事實無法用這些公理來證明;同時,他還證明,沒有一組公理具有一致性(即永遠不會導致矛盾)。

這意味著,任何一個理論體系總有一些無法證明的命題,或者說,你能證明什麼,取決於你的起始假設,而這些假設是不能證明的。

-- 《哥德爾不完備定理的證明》

4、

一家公司需要多少工程師?這與軟件功能的數量有關,與軟件用戶的數量無關。

如果軟件要添加更多功能,就需要更多工程師。如果軟件功能單一,但是規模很大,甚至有幾億用戶,事實上並不需要很多工程師。

-- Hacker News 讀者

往年回顧

中國的增長動力在內陸(2023 #241)

一個程序員的財務獨立之路(2022 #191)

封閉系統的勝利(2021 #141)

印度孟買的房價,為什麼跟北京一樣高?(2020 #91)

(完)