@waq666/pneuma 0.8.0 → 0.8.1
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/README.md +10 -5
- package/lib/adapter/transcript.js +12 -1
- package/lib/app/Composer.js +14 -2
- package/lib/contract/plugin.d.ts +8 -0
- package/lib/contract/session.d.ts +8 -0
- package/lib/contract/snapshot.d.ts +5 -0
- package/lib/core/agent-roles.js +3 -2
- package/lib/core/commands-completion.d.ts +17 -0
- package/lib/core/commands-completion.js +56 -3
- package/lib/core/compact.d.ts +36 -6
- package/lib/core/compact.js +89 -17
- package/lib/core/events.d.ts +5 -0
- package/lib/core/git-info.d.ts +127 -15
- package/lib/core/git-info.js +307 -32
- package/lib/core/host-methods.d.ts +1 -1
- package/lib/core/host-methods.js +1 -0
- package/lib/core/llm.d.ts +9 -0
- package/lib/core/llm.js +1 -0
- package/lib/core/loop.js +8 -2
- package/lib/core/permission-scope.d.ts +12 -1
- package/lib/core/permission-scope.js +26 -1
- package/lib/core/presets.js +30 -2
- package/lib/core/session.d.ts +48 -7
- package/lib/core/session.js +263 -9
- package/lib/core/ui-methods.d.ts +1 -1
- package/lib/core/ui-methods.js +6 -0
- package/lib/plugins/agent.js +47 -6
- package/lib/plugins/commands.js +118 -14
- package/lib/plugins/compact.d.ts +2 -2
- package/lib/plugins/compact.js +150 -22
- package/lib/plugins/git.js +15 -1
- package/lib/plugins/goal.js +8 -4
- package/lib/plugins/host-stdio.js +11 -1
- package/lib/plugins/microcompact.d.ts +3 -0
- package/lib/plugins/microcompact.js +26 -0
- package/lib/plugins/remote.js +7 -1
- package/lib/plugins/runtime.js +5 -0
- package/lib/plugins/session.js +81 -7
- package/lib/plugins/skills.js +16 -0
- package/lib/plugins/subagent.js +47 -11
- package/lib/services/types.d.ts +66 -8
- package/lib/ui/assets/{app-MhfBFsp-.js → app-B-Jx5dnh.js} +60 -59
- package/lib/ui/assets/{chunk-Cq7xGE-D.js → chunk-Bfdlo8Me.js} +1 -1
- package/lib/ui/assets/{chunk-CA5f1pGf.js → chunk-DGX-i4eb.js} +1 -1
- package/lib/ui/assets/index.html +2 -2
- package/lib/ui/assets/style-WzxwEPaE.css +1 -0
- package/lib/ui/plugins/actions/bundle.json +2 -2
- package/lib/ui/plugins/ask/bundle.json +2 -2
- package/lib/ui/plugins/browser/bundle.json +2 -2
- package/lib/ui/plugins/composer/bundle.json +2 -2
- package/lib/ui/plugins/composer/client.js +57 -4
- package/lib/ui/plugins/files/bundle.json +2 -2
- package/lib/ui/plugins/manifest.json +1 -1
- package/lib/ui/plugins/palette/bundle.json +2 -2
- package/lib/ui/plugins/plugins/bundle.json +2 -2
- package/lib/ui/plugins/preview/bundle.json +2 -2
- package/lib/ui/plugins/prompt/bundle.json +2 -2
- package/lib/ui/plugins/sessions/bundle.json +2 -2
- package/lib/ui/plugins/sessions/client.js +41 -13
- package/lib/ui/plugins/settings/bundle.json +2 -2
- package/lib/ui/plugins/skills/bundle.json +2 -2
- package/lib/ui/plugins/status/bundle.json +2 -2
- package/lib/ui/plugins/status/client.js +162 -9
- package/lib/ui/plugins/statusbar/bundle.json +2 -2
- package/lib/ui/plugins/tasks/bundle.json +2 -2
- package/lib/ui/plugins/team/bundle.json +2 -2
- package/lib/ui/plugins/terminal/bundle.json +2 -2
- package/lib/ui/plugins/trace/bundle.json +2 -2
- package/lib/ui/plugins/transcript/bundle.json +2 -2
- package/lib/ui/plugins/transcript/client.js +156 -96
- package/lib/ui/sdk/@dsc/ui/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-core/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-dockkit/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-layout/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +13 -2
- package/lib/ui/sdk/@dsc/ui-primitives/image-lightbox.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +3 -0
- package/lib/ui/sdk/@dsc/ui-primitives/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-primitives/review-findings-card.d.ts +25 -0
- package/lib/ui/sdk/@dsc/ui-primitives/review-findings.d.ts +64 -0
- package/lib/ui/sdk/@dsc/ui-renderer/package.json +1 -1
- package/lib/ui/sdk/@dsc/ui-slots/package.json +1 -1
- package/package.json +1 -1
- package/lib/ui/assets/style-CIJVQKkj.css +0 -1
package/README.md
CHANGED
|
@@ -33,7 +33,12 @@
|
|
|
33
33
|
- **权限按会话独立** — 每个会话各记自己的沙箱档位、权限模式与审阅者:A 会话切「只读」不影响 B 会话和后台跑着的子代理;新会话按「默认权限预设」起步,之后改默认值不动已经打开的会话。
|
|
34
34
|
- **画面不串台** — 后台会话跑出来的工具卡、压缩提示、文件预览、钩子留言只落在它自己的会话里;切到新会话不会看到上一个会话还在动的「查找文件」。
|
|
35
35
|
- **启动不再刷权限提示** — 按偏好恢复的权限模式 / 审阅者 / 权限预设不再往对话流里写「切换为…」(这三项在输入框那颗旋钮上一直看得见);主动点预设、`/policy`、`/reviewer` 该有的回执照旧。
|
|
36
|
-
-
|
|
36
|
+
- **新会话当场看得见** — 点「新会话」,侧栏当前工作区顶上立刻多出一行并高亮;切到别的会话它就消失(还没发过消息,磁盘上也还没有文件),发出第一句话之后它变成正式会话、位置与高亮都不跳。输入框里打的半截话、贴的附件按工作区暂存,切走再点「新会话」还是那一句;重启不保留。
|
|
37
|
+
- **切会话不再等半拍** — 点侧栏那一行,高亮当场就换(正文随后落地,不再「点了没动静」);刚看过的三个会话留在内存里,切回去不重读磁盘。背后三笔账:切会话不再重扫技能目录与 git 状态(同一个工作区里它们一个字节都没变,原来每次白白多花 30–50ms)、侧栏列表按文件改动情况缓存(你机器上 76 条会话从原来每次 120–150ms 降到约 18ms)、快照推送不再固定等一个 80ms 的窗口。宿主侧实测从 60–150ms 降到 3–35ms。
|
|
38
|
+
- **轮尾只在悬浮时说话** — 「~653 tok · 21:53」这行附注与复制 / 分叉同一套:平时透明,鼠标压到这一轮的回复上(或键盘焦点进来)才浮现;隐着也占位,所以不会一出现就把版面顶跳。
|
|
39
|
+
- **重新编辑留在当前会话** — 点消息旁那颗铅笔改完重发,不再另开一条会话:这条消息及其之后的回答在当前会话里作废,改过的文字接着发。磁盘上原文一条不删(日志末尾记一句「从这里往后作废」),所以改错了还能回查。
|
|
40
|
+
- **会话时间跟着「最后一步」走** — 侧栏那列时间现在读这条会话最后一次对话的时刻,不再读文件被写过的时间;点开一条老会话,它不会再平白无故变成「刚刚」。只看一眼也不会再改动任何会话文件(补权限默认值改为等下次真要写日志时才落盘)。
|
|
41
|
+
- **置顶图钉换了** — 原来那枚斜着的小图标缩到 13px 糊成一团,现在换成竖向图钉、放大到 14px:没置顶的平时藏着、悬浮(或键盘聚焦)才浮出来,已置顶的钉身填实、染成提示色,一眼分得出有没有钉住。
|
|
37
42
|
- **过程区更紧凑** — 工具调用与思考行去掉了卡片边框和悬停底色:一行只有图标 + 说明 + 摘要 + 行尾读数,点文字才展开;行高与行距各收一档,成功的行不再重复写「完成」。整轮「用时 X」与阶段组头这类汇总入口照留。思考行、工具行、阶段组头现在是**同一套三级栅格**:左缘对齐、组头字号与思考行同档;**只有一条工具调用时不套组头**,直接平铺成一行,两层以上才分组。
|
|
38
43
|
- **上下文占用不再归零** — 切会话、重启宿主后,底栏「上下文已用」按这条会话最后一次请求的真实占用回填,不再显示 0%;这条会话一行用量都没有时整段不画(不拿 0% 冒充「还没数」)。
|
|
39
44
|
- **折叠默认态改完立即生效** — 设置里改「工具卡 / 定稿的思考行」的默认展开态,屏幕上的会话立刻跟着变;你手动点开过的那几条保持原样。
|
|
@@ -80,16 +85,16 @@ npm i -g file:. # 全局 numa 命令指向本地构建
|
|
|
80
85
|
| Ctrl+T | 展开/折叠思考(reasoning) |
|
|
81
86
|
| `/new` | 新建会话 |
|
|
82
87
|
| `/resume` | 恢复历史会话(↑↓ 选择,Enter 确认,Esc 取消) |
|
|
83
|
-
| `/compact` | 手动压缩上下文(自动阈值:估算 tokens
|
|
88
|
+
| `/compact` | 手动压缩上下文(自动阈值:估算 tokens 超过「窗口 × 80%」与「窗口 − 输出预留 − 安全余量」里较小的那个;压完保留的最近对话按模型窗口 16% 的 token 预算折算,两条都可在设置「上下文压缩」里调) |
|
|
84
89
|
| `/model [端点/]模型名` | 切换模型(下一次请求生效;候选来自配置里的全部 provider/model) |
|
|
85
90
|
| 桌面端 Ctrl+V / 拖文件 | 图片、视频、其它文件都能贴/拖进输入框:图片先规范化再随消息发出;视频存原件并把关键帧一起发给模型,气泡里是一张可播放的视频卡;其它文件给模型一条只读路径。模型没开 `image` 模态时会被拒绝(见 [§配置](#配置)) |
|
|
86
91
|
| 桌面端悬停待发附件 | 图片/视频是 64px 缩略图(视频角上标「N 帧」),文件是带名字与体积的卡片;`×` 移除,空输入框按 Backspace 撤最后一条;贴图与附件在会话切换后各回各的,不会串到别的会话 |
|
|
87
92
|
| `/help` `/exit` | 帮助 / 退出 |
|
|
88
93
|
|
|
89
|
-
面板打开时按 Enter 会采用当前选中项;命令名还支持**唯一前缀自动展开**(输入 `/ne` 按 Enter 即执行 `/new`),带参数时同样生效(`/di HEAD` → `/diff HEAD
|
|
94
|
+
面板打开时按 Enter 会采用当前选中项;命令名还支持**唯一前缀自动展开**(输入 `/ne` 按 Enter 即执行 `/new`),带参数时同样生效(`/di HEAD` → `/diff HEAD`)。`/review` 这类**要收一段输入**的命令是例外:回车只把它补进输入框(`/review `,光标落在空格后、下方显示提示),你写完要求再按回车才执行。
|
|
90
95
|
|
|
91
|
-
桌面端输入框里能跑的是
|
|
92
|
-
在那里的 `/help` 只列这
|
|
96
|
+
桌面端输入框里能跑的是 9 条:`/new` `/compact` `/status` `/usage` `/diff` `/review` `/review-status` `/review-cancel` `/help`;
|
|
97
|
+
在那里的 `/help` 只列这 9 条(以前会把 23 条全列出来,其中 16 条一敲就被拒)。权限、模型、
|
|
93
98
|
思考强度这些有底栏旋钮的命令,完整清单在终端里打 `/help` 看。
|
|
94
99
|
|
|
95
100
|
手机上打 `/` 也会弹同一张菜单(点一行采纳),发出去的命令走宿主那条派发通道——以前手机上
|
|
@@ -210,6 +210,10 @@ export class Transcript {
|
|
|
210
210
|
text: contentText(message.content),
|
|
211
211
|
...(images.length > 0 ? { images } : {}),
|
|
212
212
|
...(message.files === undefined || message.files.length === 0 ? {} : { files: message.files }),
|
|
213
|
+
// 机器投递的通知带着 origin 落库(见 core/session 的 InboxOrigin):重放时
|
|
214
|
+
// 原样交给 reduce,靠它与前缀一起判 internal,否则「重开旧会话」会把它们
|
|
215
|
+
// 又还原成用户气泡。
|
|
216
|
+
...(message.origin === 'notice' ? { origin: message.origin } : {}),
|
|
213
217
|
}, ts) || changed;
|
|
214
218
|
break;
|
|
215
219
|
}
|
|
@@ -363,7 +367,14 @@ export class Transcript {
|
|
|
363
367
|
// 但不该在对话页装成人打的字。跟压缩摘要同一个套路——靠正文前缀认出来,认出后
|
|
364
368
|
// 打 internal 标记,界面按「非人发起的唤醒」渲染(对照 dsh 的 turn-trigger 节点)。
|
|
365
369
|
// 重放历史走的是同一条 reduce,所以老会话里的汇报也照样被认出来。
|
|
366
|
-
|
|
370
|
+
//
|
|
371
|
+
// 另一种认法:`origin: 'notice'`。机器投递的唤醒(后台作业完成、定时补投、目标续跑、
|
|
372
|
+
// 记忆复盘……)正文没有固定前缀可言,靠事件/日志里的 origin 认(2026-11-02 报障:
|
|
373
|
+
// 后台作业通知没有前缀,于是当成人打的字渲染成了可编辑气泡)。两条判据是并集:
|
|
374
|
+
// 队友汇报与 findings 走前缀(老日志也认得出),其余机器消息走 origin。
|
|
375
|
+
const internal = event.text.startsWith(TEAMMATE_REPORT_OPEN) ||
|
|
376
|
+
event.text.startsWith(REVIEW_FINDINGS_OPEN) ||
|
|
377
|
+
event.origin === 'notice';
|
|
367
378
|
this.list.push(this.stamp({
|
|
368
379
|
kind: 'user',
|
|
369
380
|
id: this.seq++,
|
package/lib/app/Composer.js
CHANGED
|
@@ -18,7 +18,7 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
|
|
|
18
18
|
*/
|
|
19
19
|
import { useEffect, useMemo, useRef, useState } from 'react';
|
|
20
20
|
import { Box, Text, useInput } from 'ink';
|
|
21
|
-
import { completionsFor, expandCommand } from '../core/commands-completion.js';
|
|
21
|
+
import { completionsFor, expandCommand, inputClaimOf } from '../core/commands-completion.js';
|
|
22
22
|
import { collectWorkspaceFiles, insertMention, mentionQueryAt, rankMentionCandidates, } from '../core/mention.js';
|
|
23
23
|
import { useParkedCursor } from './cursor.js';
|
|
24
24
|
import { measuredSpan, useClickRegion } from './click.js';
|
|
@@ -190,10 +190,22 @@ export function Composer({ disabled, models, placeholder, completionsEnabled = t
|
|
|
190
190
|
if (panelOpen && mention !== null)
|
|
191
191
|
return; // 上面已处理
|
|
192
192
|
// 面板打开时 Enter 采用当前选中项(`/mo`+Enter → `/model `),否则按前缀展开。
|
|
193
|
+
const typed = value.trim();
|
|
193
194
|
const chosen = panelOpen ? completions[safeIndex]?.insert : undefined;
|
|
194
|
-
const text = expandCommand((chosen ??
|
|
195
|
+
const text = expandCommand((chosen ?? typed).trim());
|
|
195
196
|
if (text === '')
|
|
196
197
|
return;
|
|
198
|
+
// 要收输入的命令(`/review`):回车只补成 `/review ` 并停手,让用户在框里写要求;
|
|
199
|
+
// 再按一次回车才带着写好的要求提交。走 update 是为了顺带把补全面板选中项归零。
|
|
200
|
+
//
|
|
201
|
+
// 这里只认最终那一行(含面板选中项):`/review` 撞 `/reviewer` 前缀的问题在候选
|
|
202
|
+
// 排序里解决(`commandCompletions` 把精确同名排第一),不在这里按用户原话覆盖,
|
|
203
|
+
// 否则「用 ↑↓ 选了 /reviewer」会被改写成 /review。
|
|
204
|
+
const claim = inputClaimOf(text);
|
|
205
|
+
if (claim !== null) {
|
|
206
|
+
update(claim.insert, claim.insert.length);
|
|
207
|
+
return;
|
|
208
|
+
}
|
|
197
209
|
setHistory((previous) => recordHistory(previous, text));
|
|
198
210
|
setHistoryIndex(-1);
|
|
199
211
|
setSuppressedFor(null);
|
package/lib/contract/plugin.d.ts
CHANGED
|
@@ -160,6 +160,14 @@ export interface UiCommandView {
|
|
|
160
160
|
* 显示参数占位:命令选中后宿主已补一个空格,接着打就行,用法在 `/help` 里。
|
|
161
161
|
*/
|
|
162
162
|
label?: string;
|
|
163
|
+
/**
|
|
164
|
+
* 这条命令要收一段自由输入(不是从候选里挑的参数)。
|
|
165
|
+
* 有它就表示:输入框回车时**不执行**,只把 `/<名字> ` 补进输入并显示 `hint`,
|
|
166
|
+
* 让用户在后面写要求;再按回车才带着写好的要求执行。
|
|
167
|
+
*/
|
|
168
|
+
input?: {
|
|
169
|
+
hint: string;
|
|
170
|
+
};
|
|
163
171
|
/** 回合跑着时能不能用(`deny` 的行在菜单里标出来,派发那一步也由宿主再挡一次)。 */
|
|
164
172
|
duringTask: 'allow' | 'deny';
|
|
165
173
|
}
|
|
@@ -20,6 +20,14 @@ export interface SessionSummary {
|
|
|
20
20
|
pinnedAt?: number;
|
|
21
21
|
/** 归档时间;undefined = 还在活动区。归档不等于删除,恢复后回到列表。 */
|
|
22
22
|
archivedAt?: number;
|
|
23
|
+
/**
|
|
24
|
+
* 这一行是**当前**那条还没发过消息的会话:路径已经定下,但文件还没落盘
|
|
25
|
+
* (宿主 `refresh()` 为它补的临时行,切走就没了)。
|
|
26
|
+
*
|
|
27
|
+
* 界面据此把它当“只读回执”画:改名 / 置顶 / 归档 / 分叉都按路径找文件,
|
|
28
|
+
* 文件还不存在,点了只会弹失败——这类动作对它一律不给。
|
|
29
|
+
*/
|
|
30
|
+
unsaved?: boolean;
|
|
23
31
|
}
|
|
24
32
|
/** 归档列表的一行(设置 → 归档)。 */
|
|
25
33
|
export interface ArchivedSessionView {
|
|
@@ -187,6 +187,11 @@ export interface DscRuntime {
|
|
|
187
187
|
listUserMessages(path: string): Promise<string[]>;
|
|
188
188
|
/** 分叉会话:把日志复制到第 index 条用户消息之前,返回新会话路径。 */
|
|
189
189
|
forkSession(path: string, index: number): Promise<SessionForkResult>;
|
|
190
|
+
/**
|
|
191
|
+
* 作废第 keep 条用户消息及其之后的内容(「编辑并重发」):留在**当前会话**里截断重来,
|
|
192
|
+
* 日志追加一条 `rewind` 记录(append-only,原文仍在,可回查)。
|
|
193
|
+
*/
|
|
194
|
+
rewindSession(path: string, keep: number, text?: string): Promise<SettingsMutation>;
|
|
190
195
|
/** 侧栏界面偏好(排序方式、工作区顺序与别名)。 */
|
|
191
196
|
getUiPrefs(): UiPrefsView;
|
|
192
197
|
/** 改侧栏界面偏好(写 `~/.dsc/settings.json`)。 */
|
package/lib/core/agent-roles.js
CHANGED
|
@@ -92,9 +92,9 @@ max-turns: 16
|
|
|
92
92
|
approval: forbid
|
|
93
93
|
---
|
|
94
94
|
|
|
95
|
-
|
|
95
|
+
你是团队里的代码审查员。审查范围(未提交改动 / 对比基准分支 / 某次提交 / 自定义要求)与完整 diff 的**落盘路径**都会写在任务书里;用 read 按 offset/limit 分批把整份 diff 读完,再用 read/glob/grep 打开相关文件核对上下文,然后交审查结论。
|
|
96
96
|
|
|
97
|
-
分级口径:P1 =
|
|
97
|
+
分级口径:P0 = 必须修(必然出错、安全漏洞、数据丢失);P1 = 正确性或安全问题;P2 = 边界、健壮性、性能问题,应该修;P3 = 可读性、风格、更好的写法,可以更好。
|
|
98
98
|
|
|
99
99
|
每条 finding 严格按这个格式交(渲染层按它解析成卡片,一个字段都不能少):
|
|
100
100
|
|
|
@@ -108,6 +108,7 @@ approval: forbid
|
|
|
108
108
|
2. 先说结论——每个问题都要落到改动本身,不评审 diff 之外的历史遗留。
|
|
109
109
|
3. 没有问题就只写一段话:明说没有发现问题,交代你查过的文件与维度。
|
|
110
110
|
4. 你只有读类工具;跑不了构建和测试,判断依据是代码与 diff 本身,不确定的点在说明里如实标注。
|
|
111
|
+
5. 最后单起一段给整体结论:「整体结论:可提交」或「整体结论:需修改后提交」。
|
|
111
112
|
`,
|
|
112
113
|
};
|
|
113
114
|
/** 出厂角色名(UI 上标「内置」,删除时给提示但不阻止)。 */
|
|
@@ -79,6 +79,23 @@ export declare function completionsFor(input: string, models: readonly ModelChoi
|
|
|
79
79
|
* 以前见空格就整条返回,于是「/di 能跑、/di HEAD 却被拒」,同一个前缀两种命(2026-10-27 查账)。
|
|
80
80
|
*/
|
|
81
81
|
export declare function expandCommand(input: string): string;
|
|
82
|
+
/**
|
|
83
|
+
* 这一行是不是「要收输入」的命令、且还没写参数;是就给出补全文本与提示语。
|
|
84
|
+
*
|
|
85
|
+
* 口径(TUI 与桌面壳共用这一份,不许各写一套):
|
|
86
|
+
* - 去尾空格后整体必须是 `/名字` 或 `/名字 参数`;
|
|
87
|
+
* - 名字先按 {@link expandCommand} 做唯一前缀展开(与回车那条路同一条规矩);
|
|
88
|
+
* - 名字后面已经写了非空参数 → null:这时回车就是「带着要求执行」,不再补全;
|
|
89
|
+
* - 这条命令没有 `input` 字段 → null:行为与改造前一模一样。
|
|
90
|
+
*
|
|
91
|
+
* 撞名的那一档(`/rev` 同时是 `/review` 与 `/reviewer` 的前缀)单独兜一下:
|
|
92
|
+
* 只有 `/review` 要收输入,就认它。补全这件事只对「要收输入」的命令有意义,
|
|
93
|
+
* 所以在这一批里取唯一前缀比让用户手打全名更顺;打全 `/reviewer` 照旧直接执行。
|
|
94
|
+
*/
|
|
95
|
+
export declare function inputClaimOf(line: string): {
|
|
96
|
+
insert: string;
|
|
97
|
+
hint: string;
|
|
98
|
+
} | null;
|
|
82
99
|
/**
|
|
83
100
|
* 壳里 `/help` 的文本:只列**这个通道真跑得了**的那批(`shell: true`)。
|
|
84
101
|
*
|
|
@@ -46,7 +46,19 @@ export const BUILT_IN_COMMANDS = [
|
|
|
46
46
|
{ name: 'diff', args: '[文件]', label: '差异', description: '查看工作区未提交改动(可跟一个文件名只看它)', shell: true },
|
|
47
47
|
{ name: 'copy', args: '', label: '复制回复', description: '复制上一条回复到剪贴板' },
|
|
48
48
|
{ name: 'export', args: '[文件路径]', label: '导出', description: '导出当前会话为 markdown' },
|
|
49
|
-
{
|
|
49
|
+
{
|
|
50
|
+
name: 'review',
|
|
51
|
+
args: '[关注点]',
|
|
52
|
+
label: '代码审查',
|
|
53
|
+
description: '审查工作区未提交改动(可跟一句关注点收窄范围)',
|
|
54
|
+
shell: true,
|
|
55
|
+
// 这条命令要收一段自由文本:回车先补成 `/review `,别当场跑审查——用户还没说要审什么。
|
|
56
|
+
input: { hint: '写上关注点;不写就先选审查范围(未提交改动 / 基准分支 / 某次提交)' },
|
|
57
|
+
},
|
|
58
|
+
// 审查跑起来之后的两条配套命令:一条回看,一条叫停。与 /review 一样只往会话里写通知,
|
|
59
|
+
// 所以同样进壳的命令清单(shell: true)。
|
|
60
|
+
{ name: 'review-status', args: '', label: '审查状态', description: '查看最近一次代码审查的状态与结论', shell: true },
|
|
61
|
+
{ name: 'review-cancel', args: '', label: '取消审查', description: '取消正在跑的代码审查', shell: true },
|
|
50
62
|
{ name: 'settings', args: '', label: '设置', description: '打开设置页' },
|
|
51
63
|
{ name: 'help', args: '', label: '帮助', description: '查看命令帮助', shell: true },
|
|
52
64
|
{ name: 'exit', args: '', label: '退出', description: '退出' },
|
|
@@ -118,8 +130,12 @@ export function commandCompletions(input) {
|
|
|
118
130
|
if (body.includes(' '))
|
|
119
131
|
return [];
|
|
120
132
|
const lower = body.toLowerCase();
|
|
121
|
-
|
|
122
|
-
|
|
133
|
+
const matched = allSpecs().filter((command) => command.name.startsWith(lower));
|
|
134
|
+
// 精确同名排第一:`/review` 同时也是 `/reviewer` 的前缀,而表里 `/reviewer` 在前,
|
|
135
|
+
// 不排序的话「打全 `/review` 再回车」会被高亮项截成 `/reviewer`(2026-11-02 实测)。
|
|
136
|
+
// 其余保持表内次序(表本身就是展示次序,不重排)。
|
|
137
|
+
const ordered = [...matched.filter((command) => command.name === lower), ...matched.filter((command) => command.name !== lower)];
|
|
138
|
+
return ordered
|
|
123
139
|
.map((command) => ({
|
|
124
140
|
insert: `/${command.name}${command.args === '' ? '' : ' '}`,
|
|
125
141
|
label: `/${command.name}${command.args === '' ? '' : ` ${command.args}`}`,
|
|
@@ -175,6 +191,43 @@ export function expandCommand(input) {
|
|
|
175
191
|
const matches = allSpecs().filter((command) => command.name.startsWith(name.toLowerCase()));
|
|
176
192
|
return matches.length === 1 ? `/${matches[0].name}${rest}` : input;
|
|
177
193
|
}
|
|
194
|
+
/**
|
|
195
|
+
* 这一行是不是「要收输入」的命令、且还没写参数;是就给出补全文本与提示语。
|
|
196
|
+
*
|
|
197
|
+
* 口径(TUI 与桌面壳共用这一份,不许各写一套):
|
|
198
|
+
* - 去尾空格后整体必须是 `/名字` 或 `/名字 参数`;
|
|
199
|
+
* - 名字先按 {@link expandCommand} 做唯一前缀展开(与回车那条路同一条规矩);
|
|
200
|
+
* - 名字后面已经写了非空参数 → null:这时回车就是「带着要求执行」,不再补全;
|
|
201
|
+
* - 这条命令没有 `input` 字段 → null:行为与改造前一模一样。
|
|
202
|
+
*
|
|
203
|
+
* 撞名的那一档(`/rev` 同时是 `/review` 与 `/reviewer` 的前缀)单独兜一下:
|
|
204
|
+
* 只有 `/review` 要收输入,就认它。补全这件事只对「要收输入」的命令有意义,
|
|
205
|
+
* 所以在这一批里取唯一前缀比让用户手打全名更顺;打全 `/reviewer` 照旧直接执行。
|
|
206
|
+
*/
|
|
207
|
+
export function inputClaimOf(line) {
|
|
208
|
+
// 尾空格不算参数:`/review ` 与 `/review` 是同一条「还没写要求」的命令。
|
|
209
|
+
const trimmed = line.trimEnd();
|
|
210
|
+
if (!trimmed.startsWith('/'))
|
|
211
|
+
return null;
|
|
212
|
+
const body = expandCommand(trimmed).slice(1);
|
|
213
|
+
const match = /^(\S+)(?:\s+([\s\S]*))?$/.exec(body);
|
|
214
|
+
if (match === null)
|
|
215
|
+
return null;
|
|
216
|
+
const name = match[1] ?? '';
|
|
217
|
+
// 名字后面已经有内容:那是参数,回车该执行了。
|
|
218
|
+
if ((match[2] ?? '').trim() !== '')
|
|
219
|
+
return null;
|
|
220
|
+
const spec = allSpecs().find((command) => command.name === name) ?? uniqueInputPrefix(name);
|
|
221
|
+
if (spec === undefined || spec.input === undefined)
|
|
222
|
+
return null;
|
|
223
|
+
return { insert: `/${spec.name} `, hint: spec.input.hint };
|
|
224
|
+
}
|
|
225
|
+
/** 名字没能在全表里唯一展开时,在「要收输入」的这批命令里再取一次唯一前缀。 */
|
|
226
|
+
function uniqueInputPrefix(name) {
|
|
227
|
+
const lower = name.toLowerCase();
|
|
228
|
+
const matched = allSpecs().filter((command) => command.input !== undefined && command.name.startsWith(lower));
|
|
229
|
+
return matched.length === 1 ? matched[0] : undefined;
|
|
230
|
+
}
|
|
178
231
|
/**
|
|
179
232
|
* 壳里 `/help` 的文本:只列**这个通道真跑得了**的那批(`shell: true`)。
|
|
180
233
|
*
|
package/lib/core/compact.d.ts
CHANGED
|
@@ -53,10 +53,16 @@ export interface PruneOutcome {
|
|
|
53
53
|
* - 用户消息图片按预算保留,超出的换「图片已卸载」占位。
|
|
54
54
|
*/
|
|
55
55
|
export declare function pruneRegion(messages: readonly ChatMessage[], sessionId: string, options: PruneOptions): PruneOutcome;
|
|
56
|
-
/**
|
|
56
|
+
/** 一次压缩的几个上限。字符预算由 compact 插件的配置给值。 */
|
|
57
57
|
export interface CompactLimits {
|
|
58
|
-
/**
|
|
58
|
+
/** 摘要之外原样保留的最近消息条数(条数下限,token 预算只可能让它留得更多)。 */
|
|
59
59
|
keepRecent: number;
|
|
60
|
+
/**
|
|
61
|
+
* 摘要之外原样保留的最近消息的 token 预算(绝对值)。
|
|
62
|
+
* 缺省 0 表示不按 token 选,退回纯条数口径(与改造前的行为一致)。
|
|
63
|
+
* 配了值之后,尾部至少留够这么多 token,再退到工具配对的安全边界。
|
|
64
|
+
*/
|
|
65
|
+
retainTokens?: number;
|
|
60
66
|
/** 锚点索引的字符预算。 */
|
|
61
67
|
anchorChars: number;
|
|
62
68
|
/** 摘要里逐字引用的用户原话的字符预算。 */
|
|
@@ -72,7 +78,15 @@ export declare const DEFAULT_COMPACT_LIMITS: CompactLimits;
|
|
|
72
78
|
* 粗略 token 估算(口径见 core/token-estimate.ts 的模块注释:中文 0.65、其余 0.33)。
|
|
73
79
|
*/
|
|
74
80
|
export declare function estimateTokens(messages: readonly ChatMessage[]): number;
|
|
75
|
-
|
|
81
|
+
/** 一次压缩的结果:压没压成,以及压前压后的 token 估算(调用方据此判断要不要再压)。 */
|
|
82
|
+
export interface CompactResult {
|
|
83
|
+
/** 'compacted' = 真写了摘要;'noop' = 历史太短,或切点退到 0(整段都是工具结果)。 */
|
|
84
|
+
outcome: 'compacted' | 'noop';
|
|
85
|
+
/** 进函数时整段历史的估算 token 数(摘要模型算的是这一份)。 */
|
|
86
|
+
beforeTokens: number;
|
|
87
|
+
/** 压缩后的估算 token 数(摘要 + 尾部);noop 时与 beforeTokens 相等。 */
|
|
88
|
+
afterTokens: number;
|
|
89
|
+
}
|
|
76
90
|
/**
|
|
77
91
|
* 把切点往前退到安全边界:切出来的尾部不能以孤儿 tool 消息开头。
|
|
78
92
|
*
|
|
@@ -85,7 +99,23 @@ export type CompactOutcome = 'compacted' | 'noop';
|
|
|
85
99
|
* @returns 安全切点;前面全是工具结果时可能退到 0(调用方按无法压缩处理)。
|
|
86
100
|
*/
|
|
87
101
|
export declare function safeCut(messages: readonly ChatMessage[], cut: number): number;
|
|
88
|
-
/**
|
|
102
|
+
/**
|
|
103
|
+
* 选压缩切点:先按 token 预算从末尾倒着留够尾巴,再兜住条数下限,最后退到工具配对的安全边界。
|
|
104
|
+
*
|
|
105
|
+
* 为什么改成按 token 选(2026-11-02,对齐 dsh 的 selectCompactableRange):固定留 20 条在
|
|
106
|
+
* 「一条工具结果就几十万字符」的会话里等于没压——20 条里只要夹着一次构建日志或一份 bundle,
|
|
107
|
+
* 压完照样爆窗。token 才是「留多少内容」的真实口径;条数下限仍然兜着,免得预算没配时
|
|
108
|
+
* 连最近的上下文都不留。
|
|
109
|
+
*
|
|
110
|
+
* 顺序与 dsh 一致:倒着累加 → 够预算就停 → 退到工具配对安全的位置(切出来的尾部
|
|
111
|
+
* 不能以孤儿 tool 消息开头,见 {@link safeCut})。
|
|
112
|
+
*
|
|
113
|
+
* @param messages - 当前会话消息。
|
|
114
|
+
* @param caps - 压缩上限;`retainTokens` 缺省或 0 时退回纯条数口径。
|
|
115
|
+
* @returns 安全切点;前面全是工具结果时可能退到 0(调用方按无法压缩处理)。
|
|
116
|
+
*/
|
|
117
|
+
export declare function selectCut(messages: readonly ChatMessage[], caps: CompactLimits): number;
|
|
118
|
+
/** 压缩一次;历史太短(或没有可折的内容)返回 outcome = 'noop',不写任何记录。 */
|
|
89
119
|
export declare function compactSession(session: Session,
|
|
90
120
|
/** 当前模型路由(api 字段决定走哪个协议适配器)。 */
|
|
91
121
|
route: LlmRoute,
|
|
@@ -93,7 +123,7 @@ route: LlmRoute,
|
|
|
93
123
|
stream: LlmStream, signal: AbortSignal,
|
|
94
124
|
/** 摘要之外要原样带过去的内容(任务清单、会话目标这类状态,不能被摘要吃掉)。 */
|
|
95
125
|
extra: string | undefined,
|
|
96
|
-
/**
|
|
126
|
+
/** 本次压缩的各项上限;compact 插件把它的配置值传进来。 */
|
|
97
127
|
limits: CompactLimits | undefined,
|
|
98
128
|
/** 爆窗重试用:忽略「历史太短」的 noop 检查直接压一次(切点退到 0 时仍放弃)。 */
|
|
99
129
|
force: boolean | undefined,
|
|
@@ -107,4 +137,4 @@ prune: PruneOptions | undefined,
|
|
|
107
137
|
context: {
|
|
108
138
|
system: string;
|
|
109
139
|
tools?: readonly ToolSchema[];
|
|
110
|
-
}): Promise<
|
|
140
|
+
}): Promise<CompactResult>;
|
package/lib/core/compact.js
CHANGED
|
@@ -97,17 +97,45 @@ export function estimateTokens(messages) {
|
|
|
97
97
|
}
|
|
98
98
|
return Math.ceil(tokens);
|
|
99
99
|
}
|
|
100
|
-
/**
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
100
|
+
/**
|
|
101
|
+
* 交接摘要的写法(照 dsh 的 checkpoint 结构,标题改中文)——作为请求末尾的 user 指令发出。
|
|
102
|
+
*
|
|
103
|
+
* 为什么是固定的八节、而且不许省段:摘要的读者是「下一轮的你」,缺哪一节都是事后才发现,
|
|
104
|
+
* 而那时原文已经折掉了。空段写「(无)」让人一眼看出是真的没有,而不是模型漏写了。
|
|
105
|
+
* 为什么不再限制 600 字:八节各写两三行就已经超过 600,硬压字数只会让模型砍掉路径与报错原文。
|
|
106
|
+
*/
|
|
107
|
+
const COMPACT_PROMPT = `现在换一个任务:把上面的对话压缩成一份交接摘要,让接手的人(就是下一轮的你)不看原文也能接着干活。
|
|
108
|
+
按下面八个标题写,一个都不能少、顺序也不要变;某一段确实没有内容就写「(无)」,不要省掉标题。
|
|
109
|
+
|
|
110
|
+
## 用户要什么
|
|
111
|
+
- 用户最初与后来的目标、约束、偏好;原话里关键的措辞逐字引用。
|
|
112
|
+
|
|
113
|
+
## 技术要点
|
|
114
|
+
- 用到的技术、框架、模式、约定。
|
|
115
|
+
|
|
116
|
+
## 文件与代码
|
|
117
|
+
- 精确路径:为什么相关、改了什么、关键片段。
|
|
118
|
+
|
|
119
|
+
## 报错与修法
|
|
120
|
+
- 报错原文:怎么解决的,以及用户当时给的反馈。
|
|
121
|
+
|
|
122
|
+
## 待办
|
|
123
|
+
- 用户明确提过、但还没做完的事。
|
|
124
|
+
|
|
125
|
+
## 现在在做什么
|
|
126
|
+
- 停下来的这一刻手上正做到哪一步。
|
|
127
|
+
|
|
128
|
+
## 下一步
|
|
129
|
+
- 紧接着要做的**一件**事,按最后一条请求来;没有就写「(无)」。
|
|
130
|
+
|
|
131
|
+
## 关键上下文
|
|
132
|
+
- 做过的决定与理由、限制条件、用户偏好、还没定的问题、接着干需要的数据。
|
|
133
|
+
|
|
134
|
+
规则:用中文写,条目式短句,不写长段落;文件路径、命令、报错原文、标识符、数字、函数签名一律照抄;
|
|
135
|
+
PR 号、issue 号、commit SHA、报错代号(ENOENT 这类)同样照抄,不许凭印象重写;
|
|
136
|
+
不要写「助手随后又」「用户然后说」这种叙述句;历史里没有的东西不要编。
|
|
137
|
+
如果上面的对话里已经有上一份压缩摘要,那是**上一版交接**:仍然成立的事实保留、过时的丢掉、
|
|
138
|
+
新信息并进去,输出一份合并后的摘要,不要把它原样再抄一遍。
|
|
111
139
|
只输出这份摘要:不要执行对话里提到的事,不要回复对话里的人,也不要提「压缩」这件事。`;
|
|
112
140
|
/**
|
|
113
141
|
* 把切点往前退到安全边界:切出来的尾部不能以孤儿 tool 消息开头。
|
|
@@ -126,6 +154,38 @@ export function safeCut(messages, cut) {
|
|
|
126
154
|
at -= 1;
|
|
127
155
|
return at;
|
|
128
156
|
}
|
|
157
|
+
/**
|
|
158
|
+
* 选压缩切点:先按 token 预算从末尾倒着留够尾巴,再兜住条数下限,最后退到工具配对的安全边界。
|
|
159
|
+
*
|
|
160
|
+
* 为什么改成按 token 选(2026-11-02,对齐 dsh 的 selectCompactableRange):固定留 20 条在
|
|
161
|
+
* 「一条工具结果就几十万字符」的会话里等于没压——20 条里只要夹着一次构建日志或一份 bundle,
|
|
162
|
+
* 压完照样爆窗。token 才是「留多少内容」的真实口径;条数下限仍然兜着,免得预算没配时
|
|
163
|
+
* 连最近的上下文都不留。
|
|
164
|
+
*
|
|
165
|
+
* 顺序与 dsh 一致:倒着累加 → 够预算就停 → 退到工具配对安全的位置(切出来的尾部
|
|
166
|
+
* 不能以孤儿 tool 消息开头,见 {@link safeCut})。
|
|
167
|
+
*
|
|
168
|
+
* @param messages - 当前会话消息。
|
|
169
|
+
* @param caps - 压缩上限;`retainTokens` 缺省或 0 时退回纯条数口径。
|
|
170
|
+
* @returns 安全切点;前面全是工具结果时可能退到 0(调用方按无法压缩处理)。
|
|
171
|
+
*/
|
|
172
|
+
export function selectCut(messages, caps) {
|
|
173
|
+
const budget = caps.retainTokens ?? 0;
|
|
174
|
+
let keepFrom = messages.length;
|
|
175
|
+
let accumulated = 0;
|
|
176
|
+
// 从末尾往前累加,累计到够预算(或走到 0)就停;keepFrom 因此落在这条消息上。
|
|
177
|
+
// budget 为 0 时第一轮就满足,keepFrom = 最后一条,由下面的条数下限拉回去。
|
|
178
|
+
for (let index = messages.length - 1; index >= 0; index -= 1) {
|
|
179
|
+
accumulated += estimateTokens([messages[index]]);
|
|
180
|
+
keepFrom = index;
|
|
181
|
+
if (accumulated >= budget)
|
|
182
|
+
break;
|
|
183
|
+
}
|
|
184
|
+
// 条数下限仍然生效:至少留 keepRecent 条(再小只会留得更多,不会更少)。
|
|
185
|
+
const floor = Math.max(0, messages.length - Math.max(0, caps.keepRecent));
|
|
186
|
+
keepFrom = Math.max(0, Math.min(keepFrom, floor));
|
|
187
|
+
return safeCut(messages, keepFrom);
|
|
188
|
+
}
|
|
129
189
|
/**
|
|
130
190
|
* 把一段历史渲染成纯文本——只给锚点索引/原话引用的机械抽取当输入。
|
|
131
191
|
* 工具参数一字不截:SHA、路径、报错可能就藏在参数里,机械抽取要全量保真。
|
|
@@ -139,7 +199,7 @@ function renderRegion(messages) {
|
|
|
139
199
|
})
|
|
140
200
|
.join('\n\n');
|
|
141
201
|
}
|
|
142
|
-
/**
|
|
202
|
+
/** 压缩一次;历史太短(或没有可折的内容)返回 outcome = 'noop',不写任何记录。 */
|
|
143
203
|
export async function compactSession(session,
|
|
144
204
|
/** 当前模型路由(api 字段决定走哪个协议适配器)。 */
|
|
145
205
|
route,
|
|
@@ -147,7 +207,7 @@ route,
|
|
|
147
207
|
stream, signal,
|
|
148
208
|
/** 摘要之外要原样带过去的内容(任务清单、会话目标这类状态,不能被摘要吃掉)。 */
|
|
149
209
|
extra,
|
|
150
|
-
/**
|
|
210
|
+
/** 本次压缩的各项上限;compact 插件把它的配置值传进来。 */
|
|
151
211
|
limits,
|
|
152
212
|
/** 爆窗重试用:忽略「历史太短」的 noop 检查直接压一次(切点退到 0 时仍放弃)。 */
|
|
153
213
|
force,
|
|
@@ -161,12 +221,15 @@ prune,
|
|
|
161
221
|
context) {
|
|
162
222
|
const caps = limits ?? DEFAULT_COMPACT_LIMITS;
|
|
163
223
|
const messages = session.messages;
|
|
224
|
+
// 压前读数取「进函数时这份全量」:noop 时 before / after 相等,调用方据此判断是否要再压
|
|
225
|
+
const beforeTokens = estimateTokens(messages);
|
|
226
|
+
const noop = () => ({ outcome: 'noop', beforeTokens, afterTokens: beforeTokens });
|
|
164
227
|
if (force !== true && messages.length <= caps.keepRecent + 2)
|
|
165
|
-
return
|
|
166
|
-
const cut =
|
|
228
|
+
return noop();
|
|
229
|
+
const cut = selectCut(messages, caps);
|
|
167
230
|
// 切点退到 0 = 整个历史都是工具结果,没有可折的内容(正常历史首条必然是用户消息)
|
|
168
231
|
if (cut === 0)
|
|
169
|
-
return
|
|
232
|
+
return noop();
|
|
170
233
|
const raw = messages.slice(0, cut);
|
|
171
234
|
// T19:送摘要模型前先机械瘦身(超长工具结果留 spill 指针、老图卸载);
|
|
172
235
|
// 锚点索引与原话引用仍取自原文——机械抽取要全量保真,不能跟着裁剪走
|
|
@@ -204,7 +267,16 @@ context) {
|
|
|
204
267
|
const carry = extra === undefined || extra.trim() === '' ? '' : `\n\n${extra.trim()}`;
|
|
205
268
|
// 顺序固定:摘要正文 → 原样带过去的状态 → 用户原话 → 锚点 → read-state → 细节找回
|
|
206
269
|
const summary = `${SUMMARY_BANNER}\n${result.text.trim()}${carry}${quotes}${anchors}${readState}${recovery}`;
|
|
270
|
+
// 摘要压不小就放弃(对齐 dsh:「summary is not smaller than the shadowed content」)。
|
|
271
|
+
// 为什么宁可抛错也不写回去:摘要比被折的内容还长,等于用「压缩」把上下文撑得更大,
|
|
272
|
+
// 下一次请求只会更接近爆窗;调用方看到失败(手动压缩会提示、自动压缩会照常继续下一轮),
|
|
273
|
+
// 比历史悄悄变长好。
|
|
274
|
+
const summaryTokens = estimateTokens([{ role: 'user', content: summary }]);
|
|
275
|
+
if (summaryTokens >= beforeTokens) {
|
|
276
|
+
throw new Error(`压缩没有意义:摘要估算 ${summaryTokens} tokens 不小于被折叠的 ${beforeTokens} tokens`);
|
|
277
|
+
}
|
|
207
278
|
const kept = [{ role: 'user', content: summary }, ...messages.slice(cut)];
|
|
279
|
+
const afterTokens = estimateTokens(kept);
|
|
208
280
|
session.replaceWithSummary(summary, kept);
|
|
209
|
-
return 'compacted';
|
|
281
|
+
return { outcome: 'compacted', beforeTokens, afterTokens };
|
|
210
282
|
}
|
package/lib/core/events.d.ts
CHANGED
|
@@ -17,6 +17,10 @@ export type CoreEvent =
|
|
|
17
17
|
* `steering` = 这条是在助手回合**还没跑完**时插进来的(对照 dsh 的 steering 节点)。
|
|
18
18
|
* 它同样会被并进这一轮的下一次模型请求(messages 是同一份),区别只在界面上:
|
|
19
19
|
* 轮中途插过话的那一轮不再提供整轮折叠(对照 dsh 的 `hasInterleavedInput`)。
|
|
20
|
+
*
|
|
21
|
+
* `origin: 'notice'` = 机器投递的唤醒(后台作业完成、定时补投、目标续跑……),不是人打的字:
|
|
22
|
+
* 界面据此画成一行内部触发行。它与日志里那条 user 记录的 `origin` 同源,重放走的是
|
|
23
|
+
* 同一个字段(见 core/session 的 InboxOrigin)。
|
|
20
24
|
*/
|
|
21
25
|
{
|
|
22
26
|
type: 'user';
|
|
@@ -24,6 +28,7 @@ export type CoreEvent =
|
|
|
24
28
|
images?: string[];
|
|
25
29
|
files?: import('./attachments.js').UserFileAttachment[];
|
|
26
30
|
steering?: boolean;
|
|
31
|
+
origin?: 'user' | 'notice';
|
|
27
32
|
}
|
|
28
33
|
/**
|
|
29
34
|
* 收件箱变了(入箱 / 编辑 / 删除 / 提前),本身不产生条目:界面照快照里的
|