# claude-release-note

**Repository Path**: andershsueh/claude-release-note

## Basic Information

- **Project Name**: claude-release-note
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code Changelog 推文归档

## 来源

- 推主：[@ClaudeCodeLog](https://x.com/ClaudeCodeLog)（unofficial 自动化机器人，跟踪 [@anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code) 的 prompt / flag / CLI 变化）
- 推主元数据：账号 ID `1952842390525693952`，推文总数 1225，覆盖 2025-08-05 至 2025-11-20（账号被 Anthropic 封禁）
- 推文原始 JSON 缓存在 `raw/tweets.json`

## 文件命名

每个 Claude Code 版本一个文件：

```
v{major}-{minor}-{patch}.md
```

例：

- `v1-0-124.md` — Claude Code 1.0.124
- `v2-0-43.md`  — Claude Code 2.0.43
- `v0-2-9.md`    — Claude Code 0.2.9（无推文，stub）

无具体版本归属的推主账号元信息 / 状态变更推文归档在 `_meta.md`。

## 文件类型

| 类型 | 数量 | 内容 |
|---|---|---|
| 推文源（有内容） | 35 | 该版本下的全部推文：tweet ID、URL、`tweet-result` 完整文本 |
| GitHub 兜底（stub） | 448 | 指向镜像仓库 `marckrenn/claude-code-changelog` 对应 tag 的链接 |
| **合计** | **483** | + 1 个 `_meta.md` |

推文源版本区间：`v1.0.89 → v2.0.43`（2025-08-24 → 2025-11-18）— 这是机器人在线期间覆盖的版本窗口。

兜底版本区间：`v0.2.9 → v2.1.231` — 全部 483 个有 tag 的版本。

## 文件结构（有推文版本）

```markdown
# Claude Code v1.0.124

- **Version:** v1.0.124
- **Tweets in this version:** 4

---

## Tweet 1 — Thu Sep 25 04:31:32 +0000 2025
- **Tweet ID:** `1971070039676571993`
- **Source:** `syndication_timeline`
- **URL:** https://x.com/ClaudeCodeLog/status/1971070039676571993

\`\`\`text
Claude Code CLI changes in 1.0.124:
• Set `CLAUDE_BASH_NO_LOGIN` ...
\`\`\`
```

## 复现

```bash
# 全量抓取（注意 syndication 限速很严，会很慢）
python scrape.py

# 重新生 md（基于已有 raw/tweets.json）
python scrape.py --source raw

# 包含 GitHub 兜底 stub
python scrape.py --source raw --include-github

# 只跑端点连通性测试，不写文件
python scrape.py --probe-only
```

## 框架要点（`scrape.py`）

| 端点 | 用途 | 限速 |
|---|---|---|
| `syndication.twitter.com/srv/timeline-profile/...` | 拉最近 ~70 条 | 严，sleep 10s/请求 |
| `syndication.twitter.com/tweet-result?id=X&token=x` | 单条推文完整 JSON | 中，sleep 6s/请求 |
| `api.github.com/repos/marckrenn/claude-code-changelog/tags` | 全部版本清单 | 轻，sleep 1s/请求 |
| `raw.githubusercontent.com/.../cc-prompt.md` | 兜底内容（可关） | 轻，sleep 0.5s/请求 |

### 关键发现

1. `tweet-result` 必须带 `&token=x`（或任意 token），不带就返回 `{}`
2. 推文的 `display_text_range` < `len(text)` 只是因为 t.co URL 被截短显示，**实际正文在 timeline 接口里就已完整**
3. syndication 端点的 cursor 翻页格式未在公开文档里，**目前只能拿到最近一批 ~70 条**
4. 机器人已被封禁（2025-11-20 后无新推文）

### 抓取覆盖

```
已抓取推文：        69 条（syndication 最近一批）
应有推文：        1225 条
覆盖率：             5.6%（受 syndication 接口能力限制）
```

要继续推进覆盖率，需要：
- 解开 syndication cursor 分页协议（需反编译 Next.js bundle 或自建 cookie）
- 或用 snowflake ID 区间采样 + tweet-result 单条探测（~10 小时，限速极严）
- 或购买第三方 Twitter API 凭证（fxtwitter / twitterapi.io / apify）

## 数据源 URL 模板

```
时间线:    https://syndication.twitter.com/srv/timeline-profile/screen-name/ClaudeCodeLog
单条推文:  https://syndication.twitter.com/tweet-result?id=<tweet_id>&token=x
档案:      https://api.fxtwitter.com/ClaudeCodeLog
版本对比:  https://github.com/marckrenn/claude-code-changelog/compare/<prev>...<curr>
单 tag:    https://github.com/marckrenn/claude-code-changelog/tree/v<version>
```

## 已知 gap

推文源里缺失的版本（推文源与 GitHub tag 之间的差）：

```
v0.2.9 → v1.0.88  (Feb-Aug 2025, 机器人还没上线)
v2.0.6 → v2.0.24  (Oct 2025, syndication 接口未翻到)
v2.0.32 → v2.0.42 (Nov 2025, 同上)
v2.0.44 → v2.1.231(Nov 2025 - 现在, 同上)
```

这些版本在 `v*-*-*.md` 里都是 GitHub stub。