记录 typecho-api 插件常用端点，方便前端直连调试。

端点速查

GET /index.php/api?token=***&method=getbloginfo      站点信息
GET /index.php/api?token=***&method=getarticle       文章列表（分页）
GET /index.php/api?token=***&method=getcomments&cid=1 文章评论
GET /index.php/api?token=***&method=getallcategories 全部分类
GET /index.php/api?token=***&method=getalltags       全部标签
GET /index.php/api?token=***&method=search&keyword=x 搜索

响应结构

{
  "success": true,
  "data": [
    {
      "cid": 1,
      "title": "欢迎使用 Typecho",
      "slug": "start",
      "categories": ["默认分类"],
      "tags": [],
      "summary": "如果您看到这篇文章…",
      "text": "<!--markdown-->如果您看到这篇文章…"
    }
  ],
  "pagination": { "total": 1, "page": 1, "pageSize": 10 }
}

注意事项

1. 所有请求都要带 token
2. text 是原始 Markdown，带 <!--markdown--> 前缀
3. 分页 pageSize 上限为 50
4. 插件没有 CORS 头，浏览器端直连会被拦，需服务端转发

每月底我都会翻一翻 GitHub Trending，挑几个「小而美」的工具。本月的五个候选各有绝活。

1. tsup — 零配置 TS 打包

一行命令产出 ESM / CJS / d.ts，库作者的福音。

2. execa — 更好的 child_process

Promise 化 API + 自动转义，脚本不再一坨回调。

3. zen-observable

规范实现仅 1KB，学习 Observable 语义的最佳材料。

4. markwhen

用 Markdown 时间线描述项目排期，长这样：

2026-01 to 2026-03: 重构内容层
2026-03 to 2026-06: 前端渲染改造 #tag1

5. sqlite-vec

给 SQLite 加上向量检索，个人知识库再也不用起向量数据库服务了。

以上项目共同点：单包解决一个明确问题。反例与正例的差距，往往就在克制二字。

这段文字位于

阅读剩余部分

春天适合读闲书。整理一下最近三个月读过的几本与技术无关的书，以及一些零碎感想。

《夜航西飞》

柏瑞尔·马卡姆写非洲飞行的生活，文字干净得像高空气流。

地图是平的，天空是圆的，两者之间隔着一个人的胆量。

《禅与摩托车维修艺术》

「良质」这个概念读了两遍仍然似懂非懂，但隐约觉得它与写代码时追求的「手感」是同一种东西。

一点感想

技术人的阅读容易陷入「工具书陷阱」——只读能立刻提升生产力的内容。但真正改变认知的，往往是那些「无用之书」。它们不提供答案，只提供新的提问方式。

这个春天，试着把阅读半径扩大一点。

站点完成无头化改造后的第一篇文章，也是渲染链路的冒烟测试。

冒烟清单

• 标题、日期、分类、标签展示正常
• Markdown 渲染无异常
• 评论表单可以提交
• 搜索可以命中这篇文章

如果你能看到这一行，说明整条「Typecho API → Astro 构建 → 浏览器渲染」链路是通的。🎉