@waq666/pneuma 0.7.0 → 0.7.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 +206 -145
- package/lib/app/App.d.ts +3 -1
- package/lib/app/App.js +324 -172
- package/lib/app/App.js.nv-backup +1650 -0
- package/lib/app/ChatView.d.ts +40 -9
- package/lib/app/ChatView.js +150 -38
- package/lib/app/StatusBar.js +21 -92
- package/lib/app/TimelineRail.d.ts +22 -0
- package/lib/app/TimelineRail.js +160 -0
- package/lib/app/TimelineRail.js.negbak +98 -0
- package/lib/app/TimelineRail.js.nv-backup +160 -0
- package/lib/app/ToolCard.d.ts +7 -1
- package/lib/app/ToolCard.js +30 -6
- package/lib/app/ToolCard.js.nv-backup +64 -0
- package/lib/app/TranscriptOverlay.d.ts +23 -8
- package/lib/app/TranscriptOverlay.js +29 -10
- package/lib/app/TranscriptViewport.d.ts +78 -0
- package/lib/app/TranscriptViewport.js +218 -0
- package/lib/app/Welcome.js +13 -8
- package/lib/app/click.d.ts +15 -2
- package/lib/app/click.js +20 -6
- package/lib/app/keymap.d.ts +56 -0
- package/lib/app/keymap.js +56 -0
- package/lib/app/mouse.d.ts +33 -0
- package/lib/app/mouse.js +35 -0
- package/lib/app/pointer.d.ts +16 -0
- package/lib/app/pointer.js +60 -0
- package/lib/app/scroll-model.d.ts +240 -0
- package/lib/app/scroll-model.js +347 -0
- package/lib/app/snapshot-subscribe.d.ts +34 -0
- package/lib/app/snapshot-subscribe.js +110 -0
- package/lib/app/theme.d.ts +29 -1
- package/lib/app/theme.js +46 -1
- package/lib/app/ticker.d.ts +7 -0
- package/lib/app/ticker.js +53 -0
- package/lib/core/llm.d.ts +11 -0
- package/lib/core/llm.js +19 -2
- package/lib/plugins/subagent.js +36 -2
- package/lib/plugins/tool-search.js +11 -2
- package/lib/plugins/tool-search.js.nv-backup +434 -0
- package/package.json +1 -1
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/** 默认合并窗口:与桌面/远程同值(80ms ≈ 12.5 次/秒上限,肉眼仍连续)。 */
|
|
2
|
+
export declare const TUI_SNAPSHOT_MS = 80;
|
|
3
|
+
export interface CoalesceOptions {
|
|
4
|
+
/** 合并窗口毫秒;≤0 = 不合并(测试与排障用)。 */
|
|
5
|
+
ms: number;
|
|
6
|
+
/** 时间源(测试注入假时钟)。 */
|
|
7
|
+
now?: () => number;
|
|
8
|
+
}
|
|
9
|
+
export interface CoalescedStore<T> {
|
|
10
|
+
/** 交给 `useSyncExternalStore` 的 subscribe(多监听者共用一个窗口与一个定时器)。 */
|
|
11
|
+
subscribe: (onStoreChange: () => void) => () => void;
|
|
12
|
+
/** 交给 `useSyncExternalStore` 的 getSnapshot(窗口内引用冻结)。 */
|
|
13
|
+
getSnapshot: () => T;
|
|
14
|
+
/** 还有没有攒着没放出去的变更(探针用)。 */
|
|
15
|
+
pending: () => boolean;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* 把「上游的同步通知 + 每次都变的上游取值」折成「窗口一次的稳定取值」。
|
|
19
|
+
*
|
|
20
|
+
* @param readUpstream - 上游取值(如 `runtime.getSnapshot`)。
|
|
21
|
+
* @param upstream - 上游 subscribe,返回退订函数。
|
|
22
|
+
* @param options - 合并窗口与时间源。
|
|
23
|
+
*/
|
|
24
|
+
export declare function createCoalescedStore<T>(readUpstream: () => T, upstream: (listener: () => void) => () => void, options: CoalesceOptions): CoalescedStore<T>;
|
|
25
|
+
/**
|
|
26
|
+
* 给 App 用的快捷封装:按 runtime 缓存的合并存储。
|
|
27
|
+
*
|
|
28
|
+
* @param runtime - 提供 `subscribe` / `getSnapshot` 的运行时(TUI 里就是 runtime 服务)。
|
|
29
|
+
* @param ms - 合并窗口(测试注入 0 可以要一条直通路径做对照)。
|
|
30
|
+
*/
|
|
31
|
+
export declare function useCoalescedSnapshot<T>(runtime: {
|
|
32
|
+
subscribe: (listener: () => void) => () => void;
|
|
33
|
+
getSnapshot: () => T;
|
|
34
|
+
}, ms?: number): CoalescedStore<T>;
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* TUI 快照存储:把「上游每个 delta 一次」的通知折成「一个窗口一次」的**取值**。
|
|
3
|
+
*
|
|
4
|
+
* 为什么需要(两笔账):
|
|
5
|
+
* 1. `transcript.invalidate()`(src/plugins/transcript.ts:54)是同步通知,TUI 又直接
|
|
6
|
+
* `useSyncExternalStore(runtime.subscribe, ...)` —— 队友流式跑起来时每个 text/
|
|
7
|
+
* reasoning delta 都要走一次 `forwardSubagent → transcript.emit → invalidate`
|
|
8
|
+
* (src/plugins/subagent.ts:459),也就是**一次全树 React reconcile**。三个队友叠
|
|
9
|
+
* 起来就是几十次/秒(ink 只把终端写入限在 30fps,CPU 是花在 React 上的,所以照样卡)。
|
|
10
|
+
* 桌面/远程早就有这道闸(host-stdio / remote 的 80ms 合并),TUI 是唯一没有的消费者。
|
|
11
|
+
* 2. 光节流通知还不够:上游每次 invalidate 都会把快照缓存清掉,`getSnapshot()` 于是
|
|
12
|
+
* 每次读都返回**新对象**;React 会在提交后的被动效果里复读一次做「快照有没有变」的
|
|
13
|
+
* 一致性检查,读到新对象就再提交一帧。实测 60 次变更里通知只落了 3 次,提交却有 10 次。
|
|
14
|
+
* 所以这个存储要在窗口内**冻结取值**:窗口里 React 读几次都拿到同一个引用。
|
|
15
|
+
*
|
|
16
|
+
* 语义(三条都不能丢):
|
|
17
|
+
* - **leading**:静默期后的第一个变更立刻取一次值——点一下、敲一句的响应不能等窗口;
|
|
18
|
+
* - **trailing**:窗口内的后续变更攒到窗口末尾一次性取值——稳态提交次数 ≈ 1000/ms;
|
|
19
|
+
* - **冻结**:两次取值之间 `getSnapshot()` 返回同一个引用,React 不会因为复读而重复提交。
|
|
20
|
+
*
|
|
21
|
+
* @module dsc-tui/app/snapshot-subscribe
|
|
22
|
+
*/
|
|
23
|
+
import { useMemo } from 'react';
|
|
24
|
+
/** 默认合并窗口:与桌面/远程同值(80ms ≈ 12.5 次/秒上限,肉眼仍连续)。 */
|
|
25
|
+
export const TUI_SNAPSHOT_MS = 80;
|
|
26
|
+
/**
|
|
27
|
+
* 把「上游的同步通知 + 每次都变的上游取值」折成「窗口一次的稳定取值」。
|
|
28
|
+
*
|
|
29
|
+
* @param readUpstream - 上游取值(如 `runtime.getSnapshot`)。
|
|
30
|
+
* @param upstream - 上游 subscribe,返回退订函数。
|
|
31
|
+
* @param options - 合并窗口与时间源。
|
|
32
|
+
*/
|
|
33
|
+
export function createCoalescedStore(readUpstream, upstream, options) {
|
|
34
|
+
const { ms } = options;
|
|
35
|
+
const now = options.now ?? Date.now;
|
|
36
|
+
const listeners = new Set();
|
|
37
|
+
let off = null;
|
|
38
|
+
let timer = null;
|
|
39
|
+
/** 窗口内还有没放出去过的变更。 */
|
|
40
|
+
let pending = false;
|
|
41
|
+
/** 上次放值的时刻(-Infinity = 从没放过,第一个变更走 leading)。 */
|
|
42
|
+
let lastFlush = Number.NEGATIVE_INFINITY;
|
|
43
|
+
/** 冻结的取值:只有放值那一刻才换引用。 */
|
|
44
|
+
let value = null;
|
|
45
|
+
/** 取一次上游值并换掉引用,然后通知下游。 */
|
|
46
|
+
const publish = () => {
|
|
47
|
+
value = { current: readUpstream() };
|
|
48
|
+
lastFlush = now();
|
|
49
|
+
pending = false;
|
|
50
|
+
for (const listener of [...listeners])
|
|
51
|
+
listener();
|
|
52
|
+
};
|
|
53
|
+
const flush = () => {
|
|
54
|
+
timer = null;
|
|
55
|
+
if (!pending)
|
|
56
|
+
return;
|
|
57
|
+
publish();
|
|
58
|
+
};
|
|
59
|
+
const cancelTimer = () => {
|
|
60
|
+
if (timer === null)
|
|
61
|
+
return;
|
|
62
|
+
clearTimeout(timer);
|
|
63
|
+
timer = null;
|
|
64
|
+
};
|
|
65
|
+
const onUpstreamChange = () => {
|
|
66
|
+
const at = now();
|
|
67
|
+
if (ms <= 0 || at - lastFlush >= ms) {
|
|
68
|
+
// 静默期已过(或压根不合并):立刻放值,窗口内的后续变更排到窗口末尾
|
|
69
|
+
cancelTimer();
|
|
70
|
+
publish();
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
pending = true;
|
|
74
|
+
if (timer !== null)
|
|
75
|
+
return;
|
|
76
|
+
timer = setTimeout(flush, Math.max(1, ms - (at - lastFlush)));
|
|
77
|
+
timer.unref?.();
|
|
78
|
+
};
|
|
79
|
+
return {
|
|
80
|
+
pending: () => pending,
|
|
81
|
+
getSnapshot() {
|
|
82
|
+
value ??= { current: readUpstream() };
|
|
83
|
+
return value.current;
|
|
84
|
+
},
|
|
85
|
+
subscribe(onStoreChange) {
|
|
86
|
+
listeners.add(onStoreChange);
|
|
87
|
+
if (off === null)
|
|
88
|
+
off = upstream(onUpstreamChange);
|
|
89
|
+
return () => {
|
|
90
|
+
listeners.delete(onStoreChange);
|
|
91
|
+
if (listeners.size > 0)
|
|
92
|
+
return;
|
|
93
|
+
cancelTimer();
|
|
94
|
+
pending = false;
|
|
95
|
+
const stop = off;
|
|
96
|
+
off = null;
|
|
97
|
+
stop?.();
|
|
98
|
+
};
|
|
99
|
+
},
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* 给 App 用的快捷封装:按 runtime 缓存的合并存储。
|
|
104
|
+
*
|
|
105
|
+
* @param runtime - 提供 `subscribe` / `getSnapshot` 的运行时(TUI 里就是 runtime 服务)。
|
|
106
|
+
* @param ms - 合并窗口(测试注入 0 可以要一条直通路径做对照)。
|
|
107
|
+
*/
|
|
108
|
+
export function useCoalescedSnapshot(runtime, ms = TUI_SNAPSHOT_MS) {
|
|
109
|
+
return useMemo(() => createCoalescedStore(() => runtime.getSnapshot(), (l) => runtime.subscribe(l), { ms }), [runtime, ms]);
|
|
110
|
+
}
|
package/lib/app/theme.d.ts
CHANGED
|
@@ -41,9 +41,24 @@ export declare const PALETTE: {
|
|
|
41
41
|
readonly pillText: "#22262E";
|
|
42
42
|
/** 静止描边(输入框、提示条的灰框)。 */
|
|
43
43
|
readonly border: "#55606F";
|
|
44
|
-
/**
|
|
44
|
+
/** 可交互但未激活(对齐 dsh 的 `inactive`):刻度栏箭头这一档。 */
|
|
45
|
+
readonly inactive: "#8D95A6";
|
|
46
|
+
/** 再暗一档(对齐 dsh 的 `subtle`):未选中的刻度,只做位置提示。 */
|
|
47
|
+
readonly subtle: "#5E6673";
|
|
48
|
+
/** 阴影面(工具卡表面)——也是刻度列悬浮读数条的底色(对齐 dsh 的 chip)。 */
|
|
45
49
|
readonly surface: "#242B3A";
|
|
50
|
+
/** 悬浮读数条上的字。 */
|
|
51
|
+
readonly surfaceText: "#C8CDD8";
|
|
46
52
|
};
|
|
53
|
+
/**
|
|
54
|
+
* 两色线性插值(hex → rgb → lerp → hex)。
|
|
55
|
+
*
|
|
56
|
+
* 用途只有一个:流式 spinner 的**呼吸色**(对齐 dsh:品牌蓝 ↔ 冰蓝按正弦来回,约 0.5 秒
|
|
57
|
+
* 一个来回)。终端里没有字号/透明度,颜色是唯一还能动的维度。
|
|
58
|
+
*
|
|
59
|
+
* 两端必须是 6 位 hex;拿不到就原样返回 `a`——降级终端(16 色名)宁可不动也不出错。
|
|
60
|
+
*/
|
|
61
|
+
export declare function mixHex(a: string, b: string, t: number): string;
|
|
47
62
|
/** 可直接展开进 `<Text>` 的文字样式,用法:`<Text {...TEXT.body}>…</Text>`。 */
|
|
48
63
|
export interface TextStyle {
|
|
49
64
|
readonly color?: string;
|
|
@@ -158,6 +173,19 @@ export declare const CONTEXT_SEGMENTS: readonly [{
|
|
|
158
173
|
}];
|
|
159
174
|
/** 强调色:输入行提示符、光标、活动块的描边,对应渲染层的 `--dsc-accent`。 */
|
|
160
175
|
export declare const ACCENT: "#7DA1DE";
|
|
176
|
+
/**
|
|
177
|
+
* 右侧轮数刻度栏的配色(对齐 dsh-TUI):当前视口所在的那一轮用**与正文同色**的亮线,
|
|
178
|
+
* 其余刻度退到 `subtle`,可点的箭头是 `inactive`、没有目标的暗一档。
|
|
179
|
+
*
|
|
180
|
+
* 为什么不给活动刻度上强调蓝:刻度是导航辅助,蓝色是「进行中/焦点」的语义色,
|
|
181
|
+
* 一条蓝线挂在正文右侧最抢眼的位置,读起来像状态而不是位置。
|
|
182
|
+
*/
|
|
183
|
+
export declare const RAIL_COLOR: {
|
|
184
|
+
readonly active: "#E8E6E0";
|
|
185
|
+
readonly idle: "#5E6673";
|
|
186
|
+
readonly arrow: "#8D95A6";
|
|
187
|
+
readonly arrowOff: "#5E6673";
|
|
188
|
+
};
|
|
161
189
|
/** 描边色:默认灰描边,活动块用强调色,告警用琥珀。 */
|
|
162
190
|
export declare const BORDER: {
|
|
163
191
|
readonly frame: "#55606F";
|
package/lib/app/theme.js
CHANGED
|
@@ -41,9 +41,41 @@ export const PALETTE = {
|
|
|
41
41
|
pillText: '#22262E',
|
|
42
42
|
/** 静止描边(输入框、提示条的灰框)。 */
|
|
43
43
|
border: '#55606F',
|
|
44
|
-
/**
|
|
44
|
+
/** 可交互但未激活(对齐 dsh 的 `inactive`):刻度栏箭头这一档。 */
|
|
45
|
+
inactive: '#8D95A6',
|
|
46
|
+
/** 再暗一档(对齐 dsh 的 `subtle`):未选中的刻度,只做位置提示。 */
|
|
47
|
+
subtle: '#5E6673',
|
|
48
|
+
/** 阴影面(工具卡表面)——也是刻度列悬浮读数条的底色(对齐 dsh 的 chip)。 */
|
|
45
49
|
surface: '#242B3A',
|
|
50
|
+
/** 悬浮读数条上的字。 */
|
|
51
|
+
surfaceText: '#C8CDD8',
|
|
46
52
|
};
|
|
53
|
+
/**
|
|
54
|
+
* 两色线性插值(hex → rgb → lerp → hex)。
|
|
55
|
+
*
|
|
56
|
+
* 用途只有一个:流式 spinner 的**呼吸色**(对齐 dsh:品牌蓝 ↔ 冰蓝按正弦来回,约 0.5 秒
|
|
57
|
+
* 一个来回)。终端里没有字号/透明度,颜色是唯一还能动的维度。
|
|
58
|
+
*
|
|
59
|
+
* 两端必须是 6 位 hex;拿不到就原样返回 `a`——降级终端(16 色名)宁可不动也不出错。
|
|
60
|
+
*/
|
|
61
|
+
export function mixHex(a, b, t) {
|
|
62
|
+
const parse = (hex) => {
|
|
63
|
+
const match = /^#([0-9a-f]{6})$/i.exec(hex);
|
|
64
|
+
if (match === null)
|
|
65
|
+
return null;
|
|
66
|
+
const value = Number.parseInt(match[1], 16);
|
|
67
|
+
return [(value >> 16) & 0xff, (value >> 8) & 0xff, value & 0xff];
|
|
68
|
+
};
|
|
69
|
+
const from = parse(a);
|
|
70
|
+
const to = parse(b);
|
|
71
|
+
if (from === null || to === null)
|
|
72
|
+
return a;
|
|
73
|
+
const ratio = Math.max(0, Math.min(1, t));
|
|
74
|
+
const channel = (index) => Math.round(from[index] + (to[index] - from[index]) * ratio)
|
|
75
|
+
.toString(16)
|
|
76
|
+
.padStart(2, '0');
|
|
77
|
+
return `#${channel(0)}${channel(1)}${channel(2)}`;
|
|
78
|
+
}
|
|
47
79
|
/** 文字三档,对应渲染层 `--dsc-text-primary` / `-secondary` / `-scaffold`。 */
|
|
48
80
|
export const TEXT = {
|
|
49
81
|
/** 正文与用户输入:暖白前景,不加粗,永远是画面里最亮的一档。 */
|
|
@@ -133,6 +165,19 @@ export const CONTEXT_SEGMENTS = [
|
|
|
133
165
|
];
|
|
134
166
|
/** 强调色:输入行提示符、光标、活动块的描边,对应渲染层的 `--dsc-accent`。 */
|
|
135
167
|
export const ACCENT = PALETTE.accent;
|
|
168
|
+
/**
|
|
169
|
+
* 右侧轮数刻度栏的配色(对齐 dsh-TUI):当前视口所在的那一轮用**与正文同色**的亮线,
|
|
170
|
+
* 其余刻度退到 `subtle`,可点的箭头是 `inactive`、没有目标的暗一档。
|
|
171
|
+
*
|
|
172
|
+
* 为什么不给活动刻度上强调蓝:刻度是导航辅助,蓝色是「进行中/焦点」的语义色,
|
|
173
|
+
* 一条蓝线挂在正文右侧最抢眼的位置,读起来像状态而不是位置。
|
|
174
|
+
*/
|
|
175
|
+
export const RAIL_COLOR = {
|
|
176
|
+
active: PALETTE.text,
|
|
177
|
+
idle: PALETTE.subtle,
|
|
178
|
+
arrow: PALETTE.inactive,
|
|
179
|
+
arrowOff: PALETTE.subtle,
|
|
180
|
+
};
|
|
136
181
|
/** 描边色:默认灰描边,活动块用强调色,告警用琥珀。 */
|
|
137
182
|
export const BORDER = {
|
|
138
183
|
frame: PALETTE.border,
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 共享节拍器:同一个周期的所有订阅者共用一个 `setInterval`。
|
|
3
|
+
*
|
|
4
|
+
* 为什么需要:ink 的每一帧提交(commit)都要跑一次整棵树的 yoga 布局 + 输出 diff,
|
|
5
|
+
* 所以「有几个动画就有几个定时器」是纯粹的浪费——3 个跑动中的队友各自挂一个 120ms
|
|
6
|
+
* 的 spinner 计时器,就是 25 次/秒的全树提交,而本该只有一个 8.3 次/秒的节拍。
|
|
7
|
+
*
|
|
8
|
+
* 用法:`const frame = useTick(120)` —— 只有订阅这个周期的组件重渲染,且**同周期只
|
|
9
|
+
* 有一个计时器**。计时器在最后一个订阅者走掉时清掉(不占着进程)。
|
|
10
|
+
*
|
|
11
|
+
* @module dsc-tui/app/ticker
|
|
12
|
+
*/
|
|
13
|
+
import { useCallback, useSyncExternalStore } from 'react';
|
|
14
|
+
/** 周期 → 时钟(模块级:同一个周期全局一份)。 */
|
|
15
|
+
const clocks = new Map();
|
|
16
|
+
const subscribeTick = (ms, listener) => {
|
|
17
|
+
let clock = clocks.get(ms);
|
|
18
|
+
if (clock === undefined) {
|
|
19
|
+
const created = { timer: undefined, listeners: new Set(), count: 0 };
|
|
20
|
+
created.timer = setInterval(() => {
|
|
21
|
+
created.count += 1;
|
|
22
|
+
for (const entry of [...created.listeners])
|
|
23
|
+
entry();
|
|
24
|
+
}, ms);
|
|
25
|
+
created.timer.unref?.();
|
|
26
|
+
clock = created;
|
|
27
|
+
clocks.set(ms, clock);
|
|
28
|
+
}
|
|
29
|
+
clock.listeners.add(listener);
|
|
30
|
+
return () => {
|
|
31
|
+
const current = clocks.get(ms);
|
|
32
|
+
if (current === undefined)
|
|
33
|
+
return;
|
|
34
|
+
current.listeners.delete(listener);
|
|
35
|
+
if (current.listeners.size === 0) {
|
|
36
|
+
clearInterval(current.timer);
|
|
37
|
+
clocks.delete(ms);
|
|
38
|
+
}
|
|
39
|
+
};
|
|
40
|
+
};
|
|
41
|
+
/** 读节拍计数(时钟还没建起来时读作 0——不在这里创建时钟,渲染必须无副作用)。 */
|
|
42
|
+
const readTick = (ms) => clocks.get(ms)?.count ?? 0;
|
|
43
|
+
/**
|
|
44
|
+
* 按周期取一个自增计数:值变了就说明该重渲染了。
|
|
45
|
+
*
|
|
46
|
+
* @param ms - 周期毫秒。
|
|
47
|
+
* @param enabled - false 时不订阅(收工的卡停表,静默时一个计时器都不留)。
|
|
48
|
+
*/
|
|
49
|
+
export function useTick(ms, enabled = true) {
|
|
50
|
+
const subscribe = useCallback((listener) => (enabled ? subscribeTick(ms, listener) : () => { }), [ms, enabled]);
|
|
51
|
+
const getSnapshot = useCallback(() => (enabled ? readTick(ms) : 0), [ms, enabled]);
|
|
52
|
+
return useSyncExternalStore(subscribe, getSnapshot);
|
|
53
|
+
}
|
package/lib/core/llm.d.ts
CHANGED
|
@@ -270,3 +270,14 @@ export declare function serializeMessages(messages: ChatMessage[]): unknown[];
|
|
|
270
270
|
* @returns 打了断点的新数组;没有可打点的消息(空数组 / 全是角色不支持的消息)时原样返回。
|
|
271
271
|
*/
|
|
272
272
|
export declare function applyExplicitCache(messages: unknown[]): unknown[];
|
|
273
|
+
/**
|
|
274
|
+
* 超时可覆盖:`DSC_LLM_CONNECT_TIMEOUT_MS` / `DSC_LLM_STREAM_IDLE_MS`(毫秒)。
|
|
275
|
+
*
|
|
276
|
+
* 为什么可配(「子代理很慢」查出来的那笔账):端点连不上时,默认要等 30 秒 × 3 次重试
|
|
277
|
+
* ≈ 90 秒,失败才浮到界面上——慢的不是界面,是这个等待。网络差的把他调小(例如 8 秒),
|
|
278
|
+
* 失败与重试都来得快;内网慢端点可以调大。
|
|
279
|
+
*
|
|
280
|
+
* 每次调用现读(不在模块加载时读死):读一次 `process.env` 是纳秒级,换来「改完环境变量
|
|
281
|
+
* 不用重启内核」。一律夹在 1 秒 ~ 10 分钟之间——写出离谱的数也不会把端点等死或瞬间全失败。
|
|
282
|
+
*/
|
|
283
|
+
export declare function readTimeoutMs(name: string, fallback: number): number;
|
package/lib/core/llm.js
CHANGED
|
@@ -284,7 +284,8 @@ async function streamOnce(request, handlers) {
|
|
|
284
284
|
if (request.signal?.aborted === true)
|
|
285
285
|
controller.abort();
|
|
286
286
|
request.signal?.addEventListener('abort', onOuterAbort, { once: true });
|
|
287
|
-
const
|
|
287
|
+
const connectTimeoutMs = readTimeoutMs('DSC_LLM_CONNECT_TIMEOUT_MS', CONNECT_TIMEOUT_MS);
|
|
288
|
+
const connectTimer = setTimeout(() => controller.abort(new LlmError(`连接超时(${Math.round(connectTimeoutMs / 1000)} 秒无响应)`, undefined, true)), connectTimeoutMs);
|
|
288
289
|
let response;
|
|
289
290
|
try {
|
|
290
291
|
response = await fetch(`${request.baseUrl}/chat/completions`, {
|
|
@@ -323,7 +324,7 @@ async function streamOnce(request, handlers) {
|
|
|
323
324
|
// 打断时保留已收到的部分内容(半截回复对"取消后接着看"有价值);
|
|
324
325
|
// 一字节未得的中途取消则照常抛错。
|
|
325
326
|
try {
|
|
326
|
-
for await (const data of sseData(response.body, STREAM_IDLE_TIMEOUT_MS)) {
|
|
327
|
+
for await (const data of sseData(response.body, readTimeoutMs('DSC_LLM_STREAM_IDLE_MS', STREAM_IDLE_TIMEOUT_MS))) {
|
|
327
328
|
if (data === '[DONE]')
|
|
328
329
|
break;
|
|
329
330
|
let chunk;
|
|
@@ -485,6 +486,22 @@ export function applyExplicitCache(messages) {
|
|
|
485
486
|
const CONNECT_TIMEOUT_MS = 30_000;
|
|
486
487
|
/** 流空闲超时:这么久一个字节都没到就判服务端挂起(SSE 心跳也是字节,会重置计时)。 */
|
|
487
488
|
const STREAM_IDLE_TIMEOUT_MS = 180_000;
|
|
489
|
+
/**
|
|
490
|
+
* 超时可覆盖:`DSC_LLM_CONNECT_TIMEOUT_MS` / `DSC_LLM_STREAM_IDLE_MS`(毫秒)。
|
|
491
|
+
*
|
|
492
|
+
* 为什么可配(「子代理很慢」查出来的那笔账):端点连不上时,默认要等 30 秒 × 3 次重试
|
|
493
|
+
* ≈ 90 秒,失败才浮到界面上——慢的不是界面,是这个等待。网络差的把他调小(例如 8 秒),
|
|
494
|
+
* 失败与重试都来得快;内网慢端点可以调大。
|
|
495
|
+
*
|
|
496
|
+
* 每次调用现读(不在模块加载时读死):读一次 `process.env` 是纳秒级,换来「改完环境变量
|
|
497
|
+
* 不用重启内核」。一律夹在 1 秒 ~ 10 分钟之间——写出离谱的数也不会把端点等死或瞬间全失败。
|
|
498
|
+
*/
|
|
499
|
+
export function readTimeoutMs(name, fallback) {
|
|
500
|
+
const raw = Number(process.env[name] ?? '');
|
|
501
|
+
if (!Number.isFinite(raw) || raw <= 0)
|
|
502
|
+
return fallback;
|
|
503
|
+
return Math.min(Math.max(Math.round(raw), 1_000), 600_000);
|
|
504
|
+
}
|
|
488
505
|
/** Retry-After 头:秒数或 HTTP 日期;认不出返回 undefined(封顶 2 分钟,防服务端给个大数)。 */
|
|
489
506
|
function retryAfterMs(value) {
|
|
490
507
|
if (value === null || value.trim() === '')
|
package/lib/plugins/subagent.js
CHANGED
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* @module dsc/plugins/subagent
|
|
19
19
|
*/
|
|
20
20
|
import { randomUUID } from 'node:crypto';
|
|
21
|
-
import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
|
|
21
|
+
import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
|
|
22
22
|
import { join, resolve } from 'node:path';
|
|
23
23
|
import { Transcript } from '../adapter/transcript.js';
|
|
24
24
|
import { builtinRoleNames, builtinRole, DSC_AGENTS_DIR, ensureBuiltinRoles, findRole, listRoles, writeRole, } from '../core/agent-roles.js';
|
|
@@ -116,7 +116,30 @@ export const subagentPlugin = {
|
|
|
116
116
|
};
|
|
117
117
|
// ── 名册持久化 ──────────────────────────────────────────────────────────
|
|
118
118
|
const rosterFile = join(ctx.settings.about().home, 'team', 'roster.json');
|
|
119
|
-
|
|
119
|
+
/**
|
|
120
|
+
* 名册读缓存。
|
|
121
|
+
*
|
|
122
|
+
* 为什么要有:界面快照每次重建都会问一次名册(`transcript.ts:231` → `team.list()`
|
|
123
|
+
* → 这里),而快照重建跟着流式增量走——原先这里是**每次重建一次同步
|
|
124
|
+
* readFileSync + JSON.parse**,直接落在渲染路径上。
|
|
125
|
+
*
|
|
126
|
+
* 为什么按 mtime 而不是 TTL:名册是「远程待命的双进程共享」的一只文件(见 `list()`
|
|
127
|
+
* 那段僵尸读作 stopped 的注释),别的进程随时可能往里写一条。TTL 会让这类写入有
|
|
128
|
+
* 一段看不见的窗口(`resident-agents-test` 的僵尸用例就是这么抓到的);而 stat 一次
|
|
129
|
+
* 比读全文 + 解析便宜得多,换来的是**从不同步**——文件没动就不重读,动了立刻重读。
|
|
130
|
+
*/
|
|
131
|
+
let rosterCache = null;
|
|
132
|
+
/** 缓存对应的文件 mtime(null = 当时文件不在/读不到)。 */
|
|
133
|
+
let rosterStamp = null;
|
|
134
|
+
const rosterMtime = () => {
|
|
135
|
+
try {
|
|
136
|
+
return statSync(rosterFile).mtimeMs;
|
|
137
|
+
}
|
|
138
|
+
catch {
|
|
139
|
+
return null;
|
|
140
|
+
}
|
|
141
|
+
};
|
|
142
|
+
const readRosterFromDisk = () => {
|
|
120
143
|
try {
|
|
121
144
|
const doc = JSON.parse(readFileSync(rosterFile, 'utf8'));
|
|
122
145
|
return Array.isArray(doc.teammates) ? doc.teammates : [];
|
|
@@ -125,6 +148,14 @@ export const subagentPlugin = {
|
|
|
125
148
|
return [];
|
|
126
149
|
}
|
|
127
150
|
};
|
|
151
|
+
const readRoster = () => {
|
|
152
|
+
const stamp = rosterMtime();
|
|
153
|
+
if (rosterCache !== null && stamp === rosterStamp)
|
|
154
|
+
return rosterCache;
|
|
155
|
+
rosterCache = readRosterFromDisk();
|
|
156
|
+
rosterStamp = stamp;
|
|
157
|
+
return rosterCache;
|
|
158
|
+
};
|
|
128
159
|
const writeRoster = (records) => {
|
|
129
160
|
try {
|
|
130
161
|
mkdirSync(join(ctx.settings.about().home, 'team'), { recursive: true });
|
|
@@ -133,6 +164,9 @@ export const subagentPlugin = {
|
|
|
133
164
|
catch {
|
|
134
165
|
// 名册写不下去只影响重启后侧栏看不到收工的队友,不该让派活失败
|
|
135
166
|
}
|
|
167
|
+
// 写失败也照此记缓存:下次读 mtime 对不上会强制回读
|
|
168
|
+
rosterCache = [...records];
|
|
169
|
+
rosterStamp = rosterMtime();
|
|
136
170
|
};
|
|
137
171
|
const remember = (teammate) => {
|
|
138
172
|
const record = {
|
|
@@ -163,7 +163,9 @@ export const toolSearchPlugin = {
|
|
|
163
163
|
name: 'tool_search',
|
|
164
164
|
description: '在「已从台面上撤下」的工具里检索:按关键词返回工具真名、一句话说明与匹配分数。' +
|
|
165
165
|
'中文与英文都能搜(中文按相邻两字切词)。搜到之后先用 tool_describe 看参数,' +
|
|
166
|
-
'再用 tool_call 按真名调用;台面上已有的工具直接用,不必搜。'
|
|
166
|
+
'再用 tool_call 按真名调用;台面上已有的工具直接用,不必搜。' +
|
|
167
|
+
'注意本工具不是全局工具目录:台面上的工具不会出现在结果里,' +
|
|
168
|
+
'这里搜不到**不等于**这台机器没有这个工具(实测有模型这么误读过)。',
|
|
167
169
|
parameters: {
|
|
168
170
|
type: 'object',
|
|
169
171
|
properties: {
|
|
@@ -189,7 +191,14 @@ export const toolSearchPlugin = {
|
|
|
189
191
|
}
|
|
190
192
|
const hits = index.search(query, limit);
|
|
191
193
|
if (hits.length === 0) {
|
|
192
|
-
|
|
194
|
+
// 空手而归时把「这里是什么目录」与「台面上有什么」一并说清:实测模型会把这句
|
|
195
|
+
// 「没搜到」读成「这台机器上没有这个工具」(会话里据此回答用户「没有网页搜索工具」),
|
|
196
|
+
// 其实它只是没在**撤下的**目录里。台面清单取 visible()——模型面前那份(预设投影过)。
|
|
197
|
+
const table = ctx.tools.visible().map((entry) => entry.name).sort();
|
|
198
|
+
const shown = table.length > 80 ? `${table.slice(0, 80).join('、')}…` : table.join('、');
|
|
199
|
+
return (`「${query}」没搜到匹配的工具:撤下的目录${catalog.length === 0 ? '是空的' : `里有 ${String(catalog.length)} 条`}。` +
|
|
200
|
+
'这个目录只装**被撤下**的工具(MCP 的动手类工具 + 命中渐进披露规则的注册表工具),' +
|
|
201
|
+
`台面上的工具不在里面,搜不到不等于这台机器没有这个工具。台面上现有 ${String(table.length)} 条,直接按真名调用:${shown}`);
|
|
193
202
|
}
|
|
194
203
|
const lines = hits.map((hit, position) => `${String(position + 1)}. ${hit.name} 分数 ${hit.score.toFixed(3)}\n ${hit.summary}`);
|
|
195
204
|
return (`检索「${query}」命中 ${String(hits.length)} 条(撤下的目录共 ${String(catalog.length)} 条):\n` +
|