clavue-v1 1.6.0 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +17 -0
- package/README.md +28 -15
- package/dist/cli.js +381 -350
- package/dist/mao-command.js +2 -2
- package/dist/openai-responses-adapter.js +4 -4
- package/dist/provider-setup.js +1 -1
- package/docs/clavue-provider-model-best-practices.md +7 -7
- package/docs/release-notes-v1.7.0.md +44 -0
- package/docs/tui-feed/feed.json +15 -2
- package/package.json +19 -1
- package/docs/clavue-startup-update-prompt-2026-09-03.md +0 -68
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,23 @@ clavue / 克拉维 发布说明。本文件在构建时注入运行时,驱动
|
|
|
4
4
|
|
|
5
5
|
格式约定(`parseChangelog` 依赖):二级标题为 `## <版本> - <日期>`,条目以 `- ` 开头,一行一条,命令与模型名保留英文。
|
|
6
6
|
|
|
7
|
+
## Unreleased
|
|
8
|
+
|
|
9
|
+
## 1.7.0 - 2026-09-03
|
|
10
|
+
|
|
11
|
+
- 产品路由环境变量统一为 `CLAVUE_*`(`CLAVUE_BASE_URL` / `CLAVUE_API_KEY` 等);旧 `ANTHROPIC_*` 路由名只作只读兼容
|
|
12
|
+
- 官方云默认填 light=`clavue-2.1-fast`、plan=`clavue-2.1-pro`、review=`clavue-2.1-rev`,不盖 `/model`;`CLAVUE_COMBO_OFF=1` 或单槽 `0` 关闭
|
|
13
|
+
- 无视觉模型(含官方 coding SKU 与 light 槽)读图 / 扫描页改为 clavue-ocr 抽字,不再把多模态块塞给不能看图的模型
|
|
14
|
+
- 三方网关采信 `GET /v1/models` 数字窗口作为压缩依据;官方 host 不采信虚标 1M
|
|
15
|
+
- `/girl` `/boy` `/bigdaddy` 改为岗位而不是召唤人设:收口写交接包,破局/交付门能走的工作流会立刻提交 `/mao`
|
|
16
|
+
- `/girl remote` `/boy remote` `/bigdaddy remote` 把同一岗位派到 clavue-bot,优先 clavue-worktree,回来是 PR / 清单 / go-no-go 证据卡
|
|
17
|
+
- `/boy remote` 会先调用 clavue-worktree clone API 打开工作副本,破局岗开树失败则夜班直接 no-go
|
|
18
|
+
- 远程派发带上当前仓库 origin 与分支,worktree 只作工作副本
|
|
19
|
+
- `/girl open|qr|status` 回看上次夜班
|
|
20
|
+
- 摸摸动画不再加羁绊;羁绊只在岗位交付成功时增加
|
|
21
|
+
- 破局岗 remote 默认在 worktree 开树并向 origin 开 PR;收口/交付门不开 PR
|
|
22
|
+
- `/boy remote --no-pr` 只改副本、不开 PR
|
|
23
|
+
|
|
7
24
|
## 1.6.0 - 2026-09-03
|
|
8
25
|
|
|
9
26
|
- 启动时弹出升级对话框:发现新版本后可在对话框内用 Ctrl+U / Enter 立即安装,Esc 本次跳过;开发树与 headless 不弹
|
package/README.md
CHANGED
|
@@ -65,8 +65,8 @@ npx -y clavue-v1
|
|
|
65
65
|
Run a specific version with `npx`:
|
|
66
66
|
|
|
67
67
|
```bash
|
|
68
|
-
npx -y clavue-v1@1.
|
|
69
|
-
npx -y clavue-v1@1.
|
|
68
|
+
npx -y clavue-v1@1.7.0 --version
|
|
69
|
+
npx -y clavue-v1@1.7.0
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
Install globally from npm when you want the `clavue-v1` command to stay available:
|
|
@@ -88,7 +88,7 @@ curl -fsSL https://unpkg.com/clavue-v1/install.sh | bash
|
|
|
88
88
|
Install a specific version globally:
|
|
89
89
|
|
|
90
90
|
```bash
|
|
91
|
-
curl -fsSL https://unpkg.com/clavue-v1@1.
|
|
91
|
+
curl -fsSL https://unpkg.com/clavue-v1@1.7.0/install.sh | bash -s -- 1.7.0
|
|
92
92
|
```
|
|
93
93
|
|
|
94
94
|
## Quick Start: Official Clavue Cloud
|
|
@@ -119,6 +119,15 @@ points from the `x-clavue-points-*` response headers. Official identity is
|
|
|
119
119
|
decided by exact host match only — a third-party gateway can never be
|
|
120
120
|
mistaken for the official cloud.
|
|
121
121
|
|
|
122
|
+
Official sessions fill combo slots without writing them into your shell:
|
|
123
|
+
`light=clavue-2.1-fast`, `plan=clavue-2.1-pro`, `review=clavue-2.1-rev`. MAIN
|
|
124
|
+
stays `/model` (or the profile primary). `CLAVUE_COMBO_OFF=1` or a per-slot
|
|
125
|
+
`0` / `off` turns that fill off.
|
|
126
|
+
|
|
127
|
+
Product routing env names are `CLAVUE_BASE_URL` and `CLAVUE_API_KEY`.
|
|
128
|
+
Legacy `ANTHROPIC_BASE_URL` / `ANTHROPIC_API_KEY` still work as read-only
|
|
129
|
+
aliases until a provider profile is applied.
|
|
130
|
+
|
|
122
131
|
## Quick Start: Custom API
|
|
123
132
|
|
|
124
133
|
Fastest path for custom API users:
|
|
@@ -186,7 +195,7 @@ The startup box is a single-column dashboard rather than a marketing panel. Unde
|
|
|
186
195
|
Interactive TUI sessions check npm for a newer `clavue-v1` after first paint (the check does not block the first frame). If an update is available, a Chinese dialog offers in-place install:
|
|
187
196
|
|
|
188
197
|
```text
|
|
189
|
-
发现新版本 1.
|
|
198
|
+
发现新版本 1.7.0(当前 1.6.0)
|
|
190
199
|
Ctrl+U / Enter 立即升级 · Esc 本次跳过 · /update 随时再来
|
|
191
200
|
```
|
|
192
201
|
|
|
@@ -244,8 +253,10 @@ On macOS, Clavue avoids Keychain by default and stores local credentials in `~/.
|
|
|
244
253
|
## Cross-Family Combo Review
|
|
245
254
|
|
|
246
255
|
The review slot puts an independent model family between "the code changed"
|
|
247
|
-
and "the work is done".
|
|
248
|
-
|
|
256
|
+
and "the work is done". Official cloud sessions fill `light` / `plan` /
|
|
257
|
+
`review` by default (see Official Clavue Cloud). BYOK combo stays opt-in via
|
|
258
|
+
`CLAVUE_COMBO_*`. Since 1.2.0 review is scheduled so it does not tax every
|
|
259
|
+
edit:
|
|
249
260
|
|
|
250
261
|
```bash
|
|
251
262
|
CLAVUE_COMBO_MAIN=glm-5.3-flash # developer model (any slot model is passed through verbatim)
|
|
@@ -298,11 +309,11 @@ Subagents (`Agent` tool, `/agents` definitions, `Explore`, `Plan`, teams) pick t
|
|
|
298
309
|
1. `CLAUDE_CODE_SUBAGENT_MODEL` (written by a provider profile's subagent slot) — an explicit global override that wins over everything.
|
|
299
310
|
2. The `model` the caller or agent definition asked for:
|
|
300
311
|
- a combo slot name — `light`, `main`, `plan`, `review` — resolves to that `CLAVUE_COMBO_*` model verbatim; an unconfigured `light` falls back to `haiku`, the other slots to `inherit`;
|
|
301
|
-
- `haiku` is the fast tier: with `CLAVUE_COMBO_LIGHT` set it runs there (this is what `Explore` uses), otherwise it follows `
|
|
302
|
-
- `sonnet` / `opus` follow the parent's exact model when the parent is the same tier, else `
|
|
312
|
+
- `haiku` is the fast tier: with `CLAVUE_COMBO_LIGHT` set it runs there (this is what `Explore` uses), otherwise it follows `CLAVUE_DEFAULT_HAIKU_MODEL`;
|
|
313
|
+
- `sonnet` / `opus` follow the parent's exact model when the parent is the same tier, else `CLAVUE_DEFAULT_*_MODEL`.
|
|
303
314
|
3. `inherit` (the default) uses the parent conversation's model.
|
|
304
315
|
|
|
305
|
-
Safety net for non-Claude routes: a bare tier alias that is not pinned by any of the variables above, on a gateway whose parent model is not a Claude model, inherits the parent instead of asking the route for a `claude-*` ID it cannot serve. Set `CLAVUE_COMBO_LIGHT` (or the `
|
|
316
|
+
Safety net for non-Claude routes: a bare tier alias that is not pinned by any of the variables above, on a gateway whose parent model is not a Claude model, inherits the parent instead of asking the route for a `claude-*` ID it cannot serve. Set `CLAVUE_COMBO_LIGHT` (or the `CLAVUE_DEFAULT_*_MODEL` pins that provider profiles write) to route tiers deliberately.
|
|
306
317
|
|
|
307
318
|
```bash
|
|
308
319
|
CLAVUE_COMBO_MAIN=deepseek-v4 # developer
|
|
@@ -332,7 +343,7 @@ Version check:
|
|
|
332
343
|
|
|
333
344
|
```bash
|
|
334
345
|
npx -y clavue-v1 --version
|
|
335
|
-
npx -y clavue-v1@1.
|
|
346
|
+
npx -y clavue-v1@1.7.0 --version
|
|
336
347
|
# available after a global install
|
|
337
348
|
clavue-v1 --version
|
|
338
349
|
```
|
|
@@ -458,7 +469,7 @@ Typing `agent teams` at the start of a prompt opens the same native `/team` flow
|
|
|
458
469
|
`/goal` turns a one-line objective into a durable mission. Clavue writes a ledger under `.clavue/goals/`, defines the plan itself, and keeps working across turns until evidence proves the objective, the budget runs out, or a real blocker appears. The loop is bounded: 20 auto-continued turns or 6 hours, whichever comes first. Exhaustion pauses the goal with an explicit `budget_exhausted` event; `/goal resume` grants a fresh budget. Completion is refused until at least one piece of evidence is on record, and starting a new goal supersedes the live one with an audit event.
|
|
459
470
|
|
|
460
471
|
```text
|
|
461
|
-
/goal ship the 1.
|
|
472
|
+
/goal ship the 1.7.0 release and verify npm, GitHub, and the website
|
|
462
473
|
/goal criteria npm run check passes on main
|
|
463
474
|
/goal evidence npm run test:fast passed (24 files)
|
|
464
475
|
/goal status
|
|
@@ -488,12 +499,14 @@ Only completed model turns advance the loop; `/goal status`, `/goal evidence`, a
|
|
|
488
499
|
/review 128 concurrency and error paths
|
|
489
500
|
```
|
|
490
501
|
|
|
491
|
-
Companion
|
|
502
|
+
Companion desks are job contracts, not toys: `/girl` recaps and writes a handoff, `/boy` diagnoses or fixes through `/mao`, `/bigdaddy` reviews for go/no-go. `/girl remote` (and the boy/bigdaddy equivalents) dispatch the same desk to Clavue Bot, preferring a clavue-worktree working copy. They can follow the current app provider or bind to a saved `/provider` profile independently.
|
|
492
503
|
|
|
493
504
|
```text
|
|
494
|
-
/girl
|
|
495
|
-
/boy
|
|
496
|
-
/bigdaddy
|
|
505
|
+
/girl recap
|
|
506
|
+
/boy fix login timeout
|
|
507
|
+
/bigdaddy review
|
|
508
|
+
/girl remote
|
|
509
|
+
/boy remote fix login timeout
|
|
497
510
|
/girl provider
|
|
498
511
|
/girl provider list
|
|
499
512
|
/girl provider inherit
|