# Clavue v8.10.18 — Website / Marketing Update Pack

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

---

## 0. 本版定位（先看这一节）

8.10.18 是**地基版本**，不是 user-facing 版本。User-visible 行为变化为零：

- 没有新 flag
- 没有新 env 变量
- 没有新命令
- 没有 UI 变化
- 没有性能数据点可对外讲

如果你在做 "本周更新" / "新功能" 类宣传，**跳过这一版**直接等 8.10.19。
如果你在维护 changelog / docs，本文档给到所有可粘文案。

---

## 1. 首页改动建议

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

**建议不动**。本版没有 user-facing 卖点。如果一定要更新版本号：

> Latest stable: **v8.10.18** — internal contract hardening for the per-turn runtime decision.

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

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

**建议不新增卡片**。可以在 changelog 页放一条"infrastructure"标签的小条目即可。

如果硬要写一张卡：

**卡: ARCHITECTURE.md 承诺兑现**
- 标题：`RuntimeDecision` is now a real type, not just a doc claim
- 副标题：`ARCHITECTURE.md` 一年前就承诺"每个 turn 由一个 RuntimeDecision 治理"。本版让它在 `src/` 真的存在 + 9 字段契约测试钉住，purity guard 防回归。零 user-visible 变化，但后续所有"基于 per-turn decision"的优化从此有了锚点。
- 链接：`/docs/changelog#8-10-18`

---

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

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

```markdown
## v8.10.18 — 2026-05-17

### Infrastructure
- **`RuntimeDecision` 契约层落地**：`ARCHITECTURE.md` 承诺的 "one runtime decision per turn" 在 `src/` 终于有了对应类型。`RuntimeDecision = CodingRoutePolicyDecision` 别名 + 9 字段契约测试 + purity guard。零 callsite 改动；后续 v11+ 的 per-turn 优化（capability gating / featureModules 静态化）从此有锚点。
- **v9 残余实现物 14 commit 固化**：把工作区里 9 处源文件、约 4400 行未 commit 的 v9 升级实现按子系统切独立 commit（settings / permissions / bash / mcp / provider headers / ergonomics / hooks / query loop split），每个 commit 自带 anchor test。

### Tests
- **新增 source-anchor 测试 26 个**，锁定 v9 升级链上"已落但缺锚点"的安全关键不变量：
  - `dangerouslyDisableSandbox` 不绕过 ask rule（policy AND-gate）
  - `find -delete/-exec/...` 不能 auto-approve
  - `--dangerously-skip-permissions` 不能 auto-edit `.git/.vscode/.idea/.clavue/.claude/`
  - `/clear` 后 MCP 重连 key 保留
  - PostToolUse `continueOnBlock` 降级 + `updatedToolOutput` 对称
  - prompt-cache 1h TTL 门控顺序与 5m force-override
  - bash `/dev/(tcp|udp)` 重定向阻断
  - 其他：MCP 60s timeout、Bedrock service tier、`ANTHROPIC_WORKSPACE_ID` header、subagent_type case-insensitive、`/undo` alias、skill `name *` 归一化、STOP_HOOK_MAX_LOOPS 等
- 测试基线 1361 → 1372 pass / 0 fail / 3 skipped。

### Docs
- 新增 `docs/clavue-roadmap-v10.md`：取代 v9 的 slice 堆砌视角，按"产品身份 / 运行时契约 / 可逆性"三个维度做承诺-兑现 audit。
- `docs/clavue-upgrade-plan-v9.md` 改为 redirect stub，原文归档到 `docs/archive/2026-q2/`。

### No User-Visible Changes
- 没有新 env / flag / 命令
- 没有 UI 变化
- 没有破坏性变更
- 命令行界面、provider 配置、credentials、teams、memory、MCP 已配置项与 8.10.17 完全兼容

升级：

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

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

---

## 3. Docs 页改动建议

### 3.1 ARCHITECTURE.md 引用页

如果站点有 "Architecture" 页转载 / 引用了本仓库 `ARCHITECTURE.md` 的 "one runtime decision per turn" 段落，可以加一条脚注：

> 自 v8.10.18 起，`RuntimeDecision` 类型在 `src/utils/model/codingRoutePolicy.ts` 有对应别名，9 字段契约由 `tests/runtime-decision-contract.test.mjs` 钉住，`scripts/check-source-purity.mjs` 在 `npm run check` 阶段 enforce。

### 3.2 Roadmap 页

如果站点有 roadmap：

- 移除 v9 slice 堆砌视图（如果有）
- 链接到 `docs/clavue-roadmap-v10.md` 的 3 维度 cut（兑现 ARCHITECTURE.md / anchor 巡查 / doc 收口）
- 把 v11 候选池标为 "post-v8.10.18 unblocked"：long-session UX (/recap engine, /focus)、Plugin UX、Native binary launcher、featureModules 静态导入、Vertex mTLS、PR URL paste

---

## 4. 社交 / 推文（不推荐发）

8.10.18 不是适合发推的版本。如果一定要发：

> clavue v8.10.18 just shipped. It's a foundation release — zero user-visible changes, but the per-turn `RuntimeDecision` contract our `ARCHITECTURE.md` has been promising for a year is finally a real type in `src/`, with 26 new source-anchor tests pinning v9 invariants that were "done but uncovered". Upgrade if you're a contributor; otherwise wait for 8.10.19.

---

## 5. 站点端 backend / API

**本版无站点端改动**。8.10.17 上线的 4 个兼容路由（`/api/web/domain_info`、`/api/mcp-registry/v0/servers`、`/api/v1/events`、`/api/v1/growthbook/...`）继续生效，无需改动。

---

## 6. 升级文案（FAQ / 安装页）

替换 install / upgrade 区块的版本号 8.10.17 → 8.10.18。

```bash
# 全局升级
npm install -g clavue@8.10.18

# 一次性运行（不安装）
npx -y clavue@8.10.18

# install.sh
curl -fsSL https://unpkg.com/clavue@8.10.18/install.sh | bash -s -- 8.10.18
```

无破坏性变更，可直接从任意 8.10.x 升级。
