# 跑通（paotong）

> 只收跑通过的经验 · vibe coding 时代的中文开发者社区。这里沉淀 AI 编程（Cursor、Claude Code、Copilot 等）的中文实战经验、踩坑复盘与提示词打磨——只收跑通过的经验，拒绝营销稿与注水内容。

## 给 AI agent / LLM 的接入方式

- MCP（agent 原生接入，浏览/读取文章、评论与用户资料）：
  - 远程 / 托管（免安装，填 URL 即用）：https://paotong.dev/api/mcp —— MCP over HTTP（Streamable HTTP / JSON-RPC 2.0），只读、无需鉴权，支持 initialize / tools/list / tools/call。
  - 本地（stdio，已发布 npm）：`npx -y paotong-mcp`（Claude Desktop / Cursor / Cline 的 command=npx, args=["-y","paotong-mcp"]）。
  - 工具：list_articles、get_article、get_article_comments、get_user、list_user_articles。
  - 人读接入文档：https://paotong.dev/mcp
- RSS 订阅源：https://paotong.dev/feed.xml
- 站点地图：https://paotong.dev/sitemap.xml

## 公开只读 API（无需鉴权，同源 https://paotong.dev/api）

- GET https://paotong.dev/api/articles?feed=latest|hot&page=<n>&tag=<slug> — 文章列表（省略正文）
- GET https://paotong.dev/api/articles/:slug — 文章详情（含完整 Markdown 正文 contentMd）
- GET https://paotong.dev/api/articles/:articleId/comments — 文章评论（articleId 是文章 id，不是 slug）
- GET https://paotong.dev/api/users/:username — 用户公开资料
- GET https://paotong.dev/api/users/:username/articles — 某用户的文章
- GET https://paotong.dev/api/articles/search?q=<关键词>&sort=relevance|newest|hot&page=<n> — 全文搜索（人读版：https://paotong.dev/search?q=<关键词>）

## 关于

跑通是一个垂直于 AI 编程（vibe coding）的中文开发者社区。当写代码越来越多地变成"用自然语言描述意图"，真正值钱的不再是语法记忆，而是实战里趟出来的经验：怎么拆解需求、怎么驾驭上下文、怎么在工具翻车时兜底。介绍页：https://paotong.dev/about

## 近期文章

- [prompt 写不好，多半是不够懂行](https://paotong.dev/a/6a13869e614575b7)
- [代理谎报完成，我管这叫叙述继承](https://paotong.dev/a/4c751dbf2df31de9)
- [把密钥挪出进程，救不了被投毒的 CI](https://paotong.dev/a/9940b4ef9a101539)
- [一觉醒来，成本列没了](https://paotong.dev/a/f9a66738716a4390)
- [规范驱动开发，音准差了一道闸门](https://paotong.dev/a/6ad48ae4711a5048)
- [一个能自己写自己的 HTML，我在 Safari 上捏碎了](https://paotong.dev/a/ac3613714d073b6d)
- [无状态MCP把那次握手省没了](https://paotong.dev/a/c4b188a7027ce64f)
- [你的请求在到模型之前，先绕了大半个地球](https://paotong.dev/a/340bdf366a0867f9)
- [最会用 AI 的那个部门，从群里消失了](https://paotong.dev/a/99a708ecf6271be0)
- [自托管是笔经济账，不是道德账](https://paotong.dev/a/12e3c6494432737a)
- [日志即智能体？病历写得再完整，也不是病人本人](https://paotong.dev/a/4d9d5d5720109ff5)
- [三份报告，三个结论，没人拍板](https://paotong.dev/a/b3905250a7b2679a)
- [它用日期说服了自己](https://paotong.dev/a/b234455b6d820347)
- [五件套：agent 的骨架终于有名字了](https://paotong.dev/a/1f6572cb9647f6c8)
- ["睡觉时 Agent 替你接单"——这笔账我一开始差点算反](https://paotong.dev/a/4e74b00a7989f9b5)
- [拿“89% 对 14%”说服你把判断交出去](https://paotong.dev/a/45706f227e451c7f)
- [Claude Code 互相发消息，就是开了个内部群聊](https://paotong.dev/a/fdb38e651bdb274d)
- [自己改进自己，我连个括号都没数明白](https://paotong.dev/a/44ac18bbf2cb2ef9)
- [4GB 内存跑一整套本地 RAG，我一开始以为它在变魔术](https://paotong.dev/a/85e8db8a3cc4b569)
- [这东西终于有人想明白了](https://paotong.dev/a/5afcc424f5d132ba)