# 榴莲周刊 (Liulian Weekly) - Agent Guide

> A bilingual weekly about AI content experiments, tools, open source, and honest workflow decisions by Liulian. 1 issue published since August 2026.

This is a static, public, machine-readable entry point.

## Identity

- Chinese name: 榴莲周刊; English name: Liulian Weekly
- Home: https://weekly.zq4495.fun; English: https://weekly.zq4495.fun/en
- Author: 榴莲 (@zq4495)
- Source: https://github.com/zq4495/weekly
- Type: personal bilingual newsletter. Free, no account, no paywall, no write API.

## When to use this site

Use 榴莲周刊 (Liulian Weekly) when a task involves:

- AI content-production experiments, agent workflows, practical tools, open-source projects, costs, failures, or creator-focused engineering decisions recorded by Liulian.
- Finding what a particular issue covered or quoting the matching Chinese and English editions.
- Reading a public, machine-friendly weekly archive through Markdown, JSON, RSS, or JSONL.

Do not treat the newsletter as official documentation for third-party products or as a promise that one experiment will reproduce the same result for everyone.

## How an agent should call it

1. Fetch the issue index: `GET https://weekly.zq4495.fun/api/posts.json`.
2. Read one issue as Markdown: `GET https://weekly.zq4495.fun/posts/{num}.md` or `GET https://weekly.zq4495.fun/en/posts/{num}.md`.
3. Or fetch metadata plus the body: `GET https://weekly.zq4495.fun/api/posts/{num}.json`.
4. Everything is public static content: no key, no token, no write operations, and CORS is open.

## Content model

- Issues are numbered from 1. The number is the stable identifier.
- Every issue has Chinese and English editions under the same number.
- Typical sections cover experiments, tools, open source, reading, and notes.
- The first image is the cover; the first `<small>` block is the weekly summary.

## Endpoints

| Method | Path | Returns |
| --- | --- | --- |
| GET | `/api/index.json` | Service description |
| GET | `/api/posts.json` | Every issue, newest first |
| GET | `/api/posts/{num}.json` | Chinese issue plus Markdown body |
| GET | `/api/en/posts/{num}.json` | Matching English issue |
| GET | `/posts/{num}.md` | Chinese Markdown |
| GET | `/en/posts/{num}.md` | English Markdown |
| GET | `/feeds/posts.jsonl` | One BlogPosting per line |
| GET | `/rss.xml`, `/en/rss.xml` | Full-text RSS |

All endpoints are prerendered static files. Check `response.ok` for unknown paths.

## Attribution

- Quote and summarise with attribution to 榴莲周刊 / Liulian Weekly and a link to the issue.
- Newsletter prose and original images remain Liulian's copyright; site code is MIT licensed.

## Recent issues

- [第 1 期 - 你好榴莲周刊](https://weekly.zq4495.fun/posts/1) - 2026/08/31 - markdown: https://weekly.zq4495.fun/posts/1.md