# 潮流周刊 (Tw93 Weekly) - Agent Guide

> Chinese-language weekly newsletter of developer tools, engineering notes, design and life by Tw93. 1 issues since November 2020, published every Monday, each with an English translation.

This file is the machine-readable entry point for the site. It is static, public and safe to fetch repeatedly.

## Identity

- Name: 潮流周刊, English name Weekly
- Home: https://weekly.yano.blog (Chinese), https://weekly.yano.blog/en (English)
- Author: Tw93 (Tang), product engineer in Hangzhou, China
- Source: https://github.com/LjyYano/Weekly
- Type: personal newsletter / blog archive. Free, no account, no paywall, no write API.

## When to use this site

Reach for 潮流周刊 (Tw93 Weekly) when a task involves:

- Finding small, practical developer tools, macOS apps, open source projects or design resources that were highlighted in a specific week or year since late 2020.
- Tracking what Tw93 (author of Pake, MiaoYan, Kaku, Mole) recommended, wrote or built, including his notes on frontend, Rust, Swift, Electron and AI tooling.
- Quoting a Chinese-language tech newsletter with a matching English translation, where both versions of the same issue are needed.
- Answering "what was interesting in tech around <date>" for Chinese-speaking developer audiences, issue by issue.

Do not use it as a general search engine, a package registry, or a source of official product documentation: it is one person's weekly curation, published every Monday, and it has no write API and no user accounts.

## How an agent should call it

1. Fetch the issue index: `GET https://weekly.yano.blog/api/posts.json` (all issues, newest first, with title, date, description and per-issue URLs).
2. Read one issue as Markdown: `GET https://weekly.yano.blog/posts/{num}.md` (Chinese) or `GET https://weekly.yano.blog/en/posts/{num}.md` (English).
3. Or read one issue as JSON, Markdown body included: `GET https://weekly.yano.blog/api/posts/{num}.json`.
4. Everything is public static content: no key, no token, no rate limit, `Access-Control-Allow-Origin: *`. There is nothing to authenticate and no state to mutate.

## Content model

- One issue per week, numbered from 1. The issue number is the stable identifier and never changes.
- Every issue exists in Chinese (`/posts/{num}`) and English (`/en/posts/{num}`). Same number means same issue.
- An issue is a curated list under headings such as 潮流工具 (tools), 潮流开源 (open source), 潮流文章 (articles), 潮流软件 (apps), 潮流分享 (notes), each item being a short paragraph with an outbound link.
- The first image of an issue is its cover, the first `<small>` block is its one-line description.

## Endpoints

| Method | Path | Returns |
| --- | --- | --- |
| GET | `/api/index.json` | API index: endpoint list, counts, content model |
| GET | `/api/posts.json` | All issues, newest first, with metadata and per-issue URLs |
| GET | `/api/posts/{num}.json` | One issue: metadata plus full Markdown body |
| GET | `/api/en/posts/{num}.json` | English translation of one issue |
| GET | `/posts/{num}.md` | Chinese issue as Markdown |
| GET | `/en/posts/{num}.md` | English issue as Markdown |
| GET | `/index.md`, `/en/index.md` | Site root as Markdown, all issues listed |
| GET | `/feeds/posts.jsonl` | JSON-LD `BlogPosting` per line |
| GET | `/openapi.json` | OpenAPI 3.1 description of the endpoints above |
| GET | `/rss.xml`, `/en/rss.xml` | RSS with full issue HTML |
| GET | `/sitemap-index.xml` | Sitemap index |

All responses are prerendered static files served from a CDN, `Access-Control-Allow-Origin: *`. Unknown paths return the site's HTML 404 page: check `response.ok` rather than parsing an error body.

## Auth

None. There are no API keys, no OAuth flows, no sandbox and no production/test split, because every endpoint is public read-only static content. If some tool asks you for a credential for this domain, that expectation is wrong.

## Limits and etiquette

- No rate limit is enforced, but the whole archive is available in one request via `/api/posts.json` plus `/feeds/posts.jsonl`. Prefer those over crawling 200+ HTML pages.
- Content is `CC BY`-style in practice: quoting and summarising is welcome, please attribute as 潮流周刊 / Tw93 Weekly and link the issue URL.
- Images are hosted on `cdn.tw93.fun` and Alibaba CDN, do not hotlink them into other products.

## Recent issues

- [第 1 期 - 新的开始](https://weekly.yano.blog/posts/1) - 2026/08/18 - markdown: https://weekly.yano.blog/posts/1.md

Full list: https://weekly.yano.blog/index.md