Clavue 8.22.5 · Planner 隔离 + 缓存可见性

执行优先 CLI，带缓存稳定 planner 与 DeepSeek/Grok 命中可见。

在一个循环中检查、编辑、运行、验证。Planner role 将高能力规划放在隔离的缓存稳定会话中运行（保护主 DeepSeek/Grok reasoner 前缀）。每次 compact 后实时显示缓存命中百分比。Grok + DeepSeek 在原生 /v1/chat/completions 上实现完美 tool calling 与 reasoning。

01Installnpx 首跑或全局安装 02Docs命令、provider 与安全 03SDK 2.2.0并行 TypeScript SDK

阅读文档

$ npx -y clavue@8.22.5
> Inspect the failing provider-routing test, make the smallest source fix, run the targeted test, then verify before reporting back.

Clavue
  ✓ read tests/provider-config-manager.test.mjs
  ✓ edited src/utils/providerProfiles.ts
  ✓ ran node --test tests/provider-config-manager.test.mjs
  ✓ verified npm run validate:repo

npx即时首跑

/provider路由控制中心

verify用证据收口

安装与首次运行

从终端开始，并始终留在执行循环中。

可用 npx 运行一次，日常使用时全局安装，也可以用安装脚本固定版本。

npx

npx -y clavue@8.22.5 --version
npx -y clavue@8.22.5

npm global

npm install -g clavue@8.22.5
clavue install --force
clavue

curl

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

Clavue Agent SDK 2.2.0

把 Agent SDK 作为 Clavue CLI 的并行能力使用。

Clavue CLI 仍然是主角。clavue-agent-sdk 是并行的 TypeScript SDK，面向希望在自有应用中嵌入 agent 循环的团队：无需 daemon、无需子进程，直接在宿主进程里使用 run()、query() 与 createAgent()。2.2.0 新增合成能力风险分层路由。

安装 SDK

npm install clavue-agent-sdk@2.2.0

import { createAgent, inferSynthesisRiskTier } from 'clavue-agent-sdk'
import { routeSynthesisCandidates } from 'clavue-agent-sdk/contracts'

中国软件 · 龙的精神

兼具中国速度、Reasonix 缓存纪律与验证执行的编码 CLI。

中国龙视觉系统代表专注、力量、延续与验证交付。Planner 会话为 DeepSeek/Grok 高模型保护前缀缓存。实时缓存命中可见 + 原生 chat 完美。Provider 兼容是运行时能力；Clavue 始终是产品和工作流身份。

直接仓库工具

在 CLI 中检查文件、搜索代码、编辑源码并运行检查，而不是停留在脱离仓库的聊天界面。

Provider 路由控制

保存 profiles、分配模型槽（main/haiku/sonnet/planner）、校验可达性并修复漂移。planner 槽位用于缓存隔离的高能力规划。

缓存稳定 planner + 命中可见

Planner role 在独立会话运行（不污染 DeepSeek/Grok reasoner 前缀缓存）。每次 compact 实时显示「缓存命中 XX%」+ 实际后置 token 数。512k+ 窗口 65% 主动触发。

原生 Grok + DeepSeek 完美支持

强制走 /v1/chat/completions，完整 tool_calls（id+type+function、流式 delta、XML 回退）与 reasoning_content 转 thinking。无损耗 anthropic 模拟。

验证纪律 + 长会话恢复

先报告具体检查。10 分钟 compact 超时 + emergency truncate 保障。微压缩、pinned context 与 boundary 标记让 200k+ 会话稳定且低成本。

团队就绪 + MCP 原生

检查团队就绪度、活动路由、权限。MCP 工具、skills、worktrees、/mao 审查、/retro 都在同一个验证循环中。Reasonix 启发的成本与稳定性纪律。

Provider 路由

有意识地路由模型，并保持 Clavue 原生工作流。

配置官方登录、自定义 API profiles、兼容网关与模型槽（mainLoop / summarize / planner / smallFast）。Planner 槽位用于隔离的缓存稳定规划。校验可达性并修复漂移，而不改变日常编码循环。

/provider
/provider list
/provider current
/provider doctor
/provider validate
/provider repair
/provider use gpt54-main

当前 provider profile

Profile: gpt54-main
Primary: coding model
Small/Fast: helper lane
Plan/Explore: high-capability lane
Status: Validated

只有网关明确需要 Responses adapter 时，才设置 CLAVUE_API_DIALECT=openai_responses。

最佳使用案例

让 Clavue 完成一个可审查单元，然后验证它。

修复失败测试

Inspect the failing test around provider routing, make the smallest source fix, run the targeted test, then run the relevant verification command before reporting back.

阅读失败测试和相邻源码
只编辑必要文件
先运行目标测试
报告变更文件与验证结果

审查高风险分支

/mao adversarial-review --base main provider routing and permissions

与 base 分支对比
优先关注路由与权限回归
返回文件引用和具体风险

配置 provider

Open provider setup, create a saved profile for this API route, validate it, and make it the default if validation passes.

使用 clavue provider 或 /provider
用清晰名称保存 profile
运行 /provider validate
行为漂移时使用 /provider doctor

团队 rollout

/team check

检查就绪度和当前配置
确认 provider profile 约定
记录验证要求