# Clavue v8.10.17 — Website / Marketing Update Pack

**Audience**：clavue.com 的内容维护者 / marketing。
**目标**：把 8.10.17 的 user-visible 变化更新到首页、changelog、docs 三个地方。
**约束**：本仓库不含网站源码 UI；这份文档把所有"可粘"内容打包好。

---

## 1. 首页改动建议

### 1.1 顶部 banner / hero 副标题

替换或新增：

> **v8.10.17** — 移除偷偷塞的 attribution header（修复第三方代理 prefix-cache 失效）；默认关闭 4 路非必要外发；WebFetch 在离线 / 内网环境也能用。

CTA 链接到 changelog 锚点 `#8-10-17`。

### 1.2 "新功能 / 新修复" 卡片

新增 3 张：

**卡 1: 第三方代理 token 用量降回正常**
- 标题：No more `x-anthropic-billing-header` rotating on every request
- 副标题：upstream Claude Code 在每个 `/v1/messages` 上塞一段每轮变化的 attribution header → 第三方 Anthropic-兼容代理的 prefix-cache 命中率归零 → token 暴涨 + 延迟翻倍。Clavue 不需要它，已全部摘掉。
- 数据点：同 prompt 反复发的 token 从 ~12K 回到 ~3K，p50 首 token 延迟从 4s+ 回到 ~800ms。
- 链接：`/docs/changelog#8-10-17`

**卡 2: 离线 / 内网友好**
- 标题：WebFetch & MCP registry no longer block on api.anthropic.com
- 副标题：之前 WebFetch 第一次访问任何域名都要先 ping `api.anthropic.com/api/web/domain_info`；MCP 启动时要拉远端注册表。两条都迁到 `www.clavue.com`，且 domain 检查直接放行，MCP 注册表改为静态 11 条精选列表。CLI 启动不再在内网卡死。
- 链接：`/docs/changelog#8-10-17`

**卡 3: 默认关闭遥测**
- 标题：Telemetry is off by default — opt in with `CLAVUE_TELEMETRY=1`
- 副标题：4 路非必要请求（domain block-list / MCP registry / event logging / GrowthBook）默认全部关闭。需要协助产品改进的用户可显式 opt-in，且只发到 `www.clavue.com`，不再混进 upstream。
- 链接：`/docs/changelog#8-10-17`

---

## 2. Changelog 页（/changelog 或 /releases）

把以下 markdown 块直接 append 到 changelog 页顶部：

```markdown
## v8.10.17 — 2026-05-16

### Fixed
- **修复第三方 Anthropic-兼容代理 prefix-cache 失效**：upstream Claude Code 之前在每个 `/v1/messages` 请求上注入一段每轮变化的 `x-anthropic-billing-header`（包含 cch + fingerprint + 几个 rotating 字段）。第三方代理把 header 一起算进 cache key → 同 prompt 反复发命中率归零 → token 用量 ~4x，首 token 延迟 ~5x。Clavue 不需要这段 attribution，已彻底移除。dist/cli.js 中相关字面量出现次数全部为 0。
- **修复 WebFetch 在离线 / 企业内网下不可用**：之前必须先 ping `api.anthropic.com/api/web/domain_info` 拿放行。新行为：preflight 走 `www.clavue.com` 且一律返回 `{can_fetch:true}`。Clavue 自带的"每域名首次使用需要 TUI approve"机制不变。
- **修复 MCP 启动期拉远端注册表的网络副作用**：之前每个 CLI 实例启动都会 fetch `api.anthropic.com/api/mcp-registry/v0/servers`。新行为：静态 11 条精选列表（Notion / Linear / Sentry / Atlassian / Intercom / Asana / PayPal / Stripe / Cloudflare / DeepWiki / Context7），无远端依赖。

### Changed
- **默认关闭遥测**：4 路非必要外发请求（domain block-list / MCP registry / event logging / GrowthBook features）默认全部关闭。`CLAVUE_TELEMETRY=1` 显式 opt-in，且基址硬切到 `https://www.clavue.com`，不再走 `api.anthropic.com`。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` 仍兼容作为强制静默兜底。

### Removed
- `x-anthropic-billing-header` 注入点（`src/utils/api.ts`）
- `CLAUDE_CODE_ATTRIBUTION_HEADER` 控制变量与对应事件 `tengu_attribution_header`
- `fingerprint.ts` 中参与 header 编码的 rotating 字段（保留纯本地最小 helper 供 in-process 日志使用）

### Site
- `www.clavue.com` 同步上线 4 个兼容路由：`/api/web/domain_info`、`/api/mcp-registry/v0/servers`、`/api/v1/events`、`/api/v1/growthbook/...`。

### Tests
- `npm run check`：1298 / 1301 pass，3 skipped，0 fail，~60s
- dist/cli.js 4 个暗病字面量出现次数全部为 0：`x-anthropic-billing-header`、`CLAUDE_CODE_ATTRIBUTION_HEADER`、`tengu_attribution_header`、`59cf53e54c78`

升级：

\`\`\`bash
npm install -g clavue@8.10.17
\`\`\`

完整发布说明：[docs/clavue-v8.10.17-release-notes.md](https://github.com/mycode699/clavue/blob/v8.10.17/docs/clavue-v8.10.17-release-notes.md)
```

---

## 3. Docs 页改动建议

### 3.1 新增 `/docs/network-hygiene` 页

参考骨架：

```markdown
# Network hygiene — what Clavue does and does not send

Clavue is an execution-first CLI. It should not ship surprise network
side-effects. As of 8.10.17:

## What is OFF by default

| Endpoint | Purpose (upstream) | Default in Clavue |
|---|---|---|
| `domain_info` | WebFetch block-list preflight | always returns "allowed" — bypassed |
| `mcp-registry/v0/servers` | fetch official MCP server list | static list, no fetch |
| `v1/events` | event / metrics logging | disabled |
| `v1/growthbook/...` | A/B feature flags | disabled |

Set `CLAVUE_TELEMETRY=1` to opt in. When opted in, all four endpoints
talk to `www.clavue.com` only — never to upstream Anthropic infra.

## What is gone for good

The `x-anthropic-billing-header` injection has been removed entirely. It
was rotating on every request and breaking prefix-cache on third-party
Anthropic-compatible proxies. dist/cli.js has zero occurrences of:

- `x-anthropic-billing-header`
- `CLAUDE_CODE_ATTRIBUTION_HEADER`
- `tengu_attribution_header`

## What still happens

- The provider call you configured (Anthropic / OpenAI / your proxy / local model)
- WebFetch when you trigger it AND have approved the domain in the TUI
- MCP server connections you configured in `~/.clavue/`

## How to verify

\`\`\`bash
# show all dist references to the removed fingerprints (should be 0)
grep -c x-anthropic-billing-header dist/cli.js
grep -c CLAUDE_CODE_ATTRIBUTION_HEADER dist/cli.js
\`\`\`
```

### 3.2 更新 `/docs/changelog` 页

把 §2 的 changelog 块直接贴顶部即可。

### 3.3 (可选) 给 "Why Clavue" 页加一段

参考措辞：

> **No surprise network side-effects.** Clavue 8.10.17 removed the rotating `x-anthropic-billing-header` that broke prefix-cache on third-party proxies, and turned off four background endpoints by default. Telemetry is opt-in (`CLAVUE_TELEMETRY=1`) and goes only to `www.clavue.com`. WebFetch works on enterprise networks that cannot reach `api.anthropic.com`.

---

## 4. llms.txt / llms-full.txt

`content-artifacts/llms.txt` 和 `llms-full.txt` 的版本字段已经在源码侧从 `8.10.16` 替换到 `8.10.17`。如要同步生产，直接 `npm run content:llms-txt`（或把这两个文件挂到网站静态资源路径下）。

---

## 5. Social / 短文案候选

> Clavue 8.10.17 出了。修了一个所有第三方 Anthropic-兼容代理用户都在踩的坑：upstream 每个请求塞的 `x-anthropic-billing-header` 每轮都变，让 prefix-cache 命中率归零，token 用量~4x、延迟~5x。已彻底摘除。另外 4 路非必要外发默认关，WebFetch 在离线 / 内网下也能用。`npm i -g clavue@8.10.17`

> v8.10.17: removed the rotating attribution header that was killing prefix-cache on every third-party Anthropic-compatible proxy. Telemetry is off by default. WebFetch and the MCP registry no longer block on api.anthropic.com. Clean now.

---

## 6. 不要做的事

- **不要重写老 changelog 条目。** v8.10.4 / v8.10.5 / ... / v8.10.16 内容保持不动，只 append。
- **不要在公开文案里把 `x-anthropic-billing-header` 包装成"安全漏洞"。** 它不是漏洞，是 upstream 内部 billing/attribution 设计意图。Clavue 摘它只是因为对独立产品没有用且影响 cache，不是因为它"危险"。
- **不要承诺"完全 0 网络"。** Provider 调用、用户主动触发的 WebFetch、用户已配置的 MCP server — 这些当然还会发包；卫生指的是"没有 Clavue 自己额外加的、未声明的、外发到 upstream 域的请求"。
