dsh-aiterm 0.5.1 → 0.5.12
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/CONTRACTS.md +104 -22
- package/README.md +202 -26
- package/client/HistoryPanel.jsx +342 -29
- package/client/api.js +44 -3
- package/client/locale.js +40 -2
- package/cordis.patch.yml +1 -0
- package/lib/client.js +30 -30
- package/lib/host/autolog.js +107 -4
- package/lib/host/config.js +14 -0
- package/lib/host/disclosure.js +357 -0
- package/lib/host/exporter.js +447 -159
- package/lib/host/history-store.js +1735 -295
- package/lib/host/permission.js +13 -0
- package/lib/host/prompt.js +24 -4
- package/lib/host/registry.js +858 -76
- package/lib/host/routes.js +45 -2
- package/lib/host/tools.js +280 -22
- package/lib/index.js +2 -2
- package/package.json +2 -2
- package/scripts/smoke-client.mjs +193 -6
package/CONTRACTS.md
CHANGED
|
@@ -393,41 +393,110 @@ export class OutputLog {
|
|
|
393
393
|
|
|
394
394
|
目录:`<dataDir>/history/`,`<dataDir>` 默认 `~/.dsh/aiterm`。
|
|
395
395
|
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
396
|
+
> **v8 安全变更(0.5.10)**:
|
|
397
|
+
> 1. 会话 id(`st-N`)不再每次启动从 1 开始。历史目录的 `.ids/st-N` 用 `open(..., 'wx')`
|
|
398
|
+
> 原子预留,跨重启、跨并发宿主续号;分配前还会跳过已有 journal 或已有 `<id>.log` 的 id。
|
|
399
|
+
> 2. 每次 `openSession()` 仍用 `open(..., 'wx')` 独占创建新的 incarnation journal
|
|
400
|
+
> `<sessionId>~<uuid>.ndjson`,绝不追加旧文件。owner 与关闭权限随文件私有保存,不依赖
|
|
401
|
+
> `index.json`。
|
|
402
|
+
> 3. 每个 incarnation 有独立 `historyId`(journal 文件名去掉 `.ndjson`)。列表返回**所有**
|
|
403
|
+
> incarnation;只传 `sessionId` 的旧调用者取最新(兼容),新调用者回传 `historyId` 精确
|
|
404
|
+
> 寻址。绝不把不同 incarnation 的 owner/权限合并。
|
|
405
|
+
> 4. `closeSession()` 只写回本进程实际打开的那个 incarnation(state 或显式 `historyId`);
|
|
406
|
+
> reservation 失败时没有 state 就**不做任何回退**,不会给别的 crash journal 补权限。
|
|
407
|
+
> 5. 旧格式文件原样保留、不删除、不改写;对 AI fail closed。正常 owner-bound 面板通过
|
|
408
|
+
> 独立的**人工专用** `history.legacy.*` 入口访问,AI 工具不暴露。
|
|
409
|
+
|
|
410
|
+
- 新格式:`<sessionId>~<uuid>.ndjson`
|
|
411
|
+
- 第一行:`{"_aiterm":"journal","version":1,"id","owner","title","transport","host","port","username","createdAt"}`;`owner` 为 DSH 会话 id,或显式 `null`(无归属桶)。
|
|
412
|
+
- 数据行:`{"t":<epoch ms>,"d":"<base64 UTF-8>"}`。
|
|
413
|
+
- `closeSession()` 追加:`{"_aiterm":"close","version":1,"closedAt","bytes","lastTs","aiAccess"?}`;`aiAccess` 缺失表示关闭权限未知(AI fail closed)。
|
|
414
|
+
- 文件头缺失/损坏 → unattributed:不列出、AI 不可读;文件不动。
|
|
415
|
+
- 会话 id 预留:`<dir>/.ids/st-N`(0600,空/小 JSON 文件)。`allocateSessionId()` 先扫描最
|
|
416
|
+
大已用号,再用 `wx` 原子创建候选;`EEXIST` 就重试下一个。已有 legacy/new journal 或旧
|
|
417
|
+
`<id>.log` 的 id 不会分配。reservation 永久保留(很小),不参与 retention。
|
|
418
|
+
- 旧格式(迁移前):`<sessionId>.ndjson`(无文件头),仅从 `index.json` 取得公开目录信息;永不改写、永不被保留策略删除。
|
|
419
|
+
- `index.json`:`{ "version": 1, "sessions": [CatalogEntry] }`,**只读旧数据**;新日志通过扫描文件头恢复。索引中的 `owner` 等字段不可信、不参与鉴权。
|
|
420
|
+
- `CatalogEntry`:`{ id, title, transport, host, port, username, createdAt, closedAt?, bytes, lastTs, historyId? }`;私有字段 `owner`、`aiAccess`、journal path 永不出现在工具/浏览器载荷。`historyId` 是公开的 incarnation 地址(不含 owner/权限)。
|
|
399
421
|
|
|
400
422
|
```js
|
|
401
423
|
export class HistoryStore {
|
|
402
424
|
constructor(options: {
|
|
403
425
|
dir: string,
|
|
404
|
-
retentionMs: number, // 默认 24h
|
|
426
|
+
retentionMs: number, // 默认 24h(只作用于新格式日志)
|
|
405
427
|
maxBytesPerSession: number, // 默认 8 MiB
|
|
406
428
|
maxSessions: number, // 默认 100
|
|
407
429
|
flushIntervalMs?: number, // 默认 250
|
|
430
|
+
maxPendingBytes?: number, // 默认 1 MiB/会话(1024..64 MiB),超限丢最旧
|
|
408
431
|
log?: (level: string, message: string) => void,
|
|
409
432
|
})
|
|
410
|
-
async init(): Promise<void>
|
|
411
|
-
async
|
|
412
|
-
|
|
433
|
+
async init(): Promise<void>
|
|
434
|
+
async allocateSessionId(options?): Promise<string | undefined> // 唯一 st-N
|
|
435
|
+
async openSession(meta: { id, owner, title, transport, host, port, username, createdAt }): Promise<{ historyId, journal, fileBytes } | false>
|
|
436
|
+
appendChunk(sessionId: string, text: string, at?: number, owner?: string | null): void
|
|
413
437
|
async flush(sessionId?: string): Promise<void>
|
|
414
|
-
async
|
|
415
|
-
async
|
|
416
|
-
|
|
417
|
-
async
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
438
|
+
async whenIdle(): Promise<void>
|
|
439
|
+
async closeSession(sessionId: string, info?: { closedAt?, permission?: { aiAccess? }, owner?, historyId? }): Promise<void>
|
|
440
|
+
async listRecordings(query?): Promise<Recording[]> // 私有 owner/aiAccess/journal + historyId
|
|
441
|
+
async listLegacySessions(query?): Promise<CatalogEntry[]>
|
|
442
|
+
async legacyEntry(sessionId): Promise<CatalogEntry | undefined>
|
|
443
|
+
async resolveForRead(sessionId, owner, actor, historyId?): Promise<{ kind: 'attributed', recording } | { kind: 'legacy', entry } | undefined>
|
|
444
|
+
async resolveByHistoryId(historyId, owner, actor): Promise<{ kind: 'attributed', recording } | undefined>
|
|
445
|
+
canAiRead(recording): boolean // 仅关闭权限为 ro/rw 才为 true
|
|
446
|
+
journalForSync(sessionId, { owner, actor, historyId? }): string | undefined
|
|
447
|
+
activeJournal(sessionId, owner, historyId?): string | undefined
|
|
448
|
+
activeHandle(sessionId, owner, historyId?): { historyId, journal } | undefined
|
|
449
|
+
async queryRecording(recording, query): Promise<QueryResult>
|
|
450
|
+
async queryLegacy(entry, query): Promise<QueryResult>
|
|
451
|
+
async query(query): Promise<QueryResult> // 便捷封装;无法判定时返回空
|
|
452
|
+
async prune(now?: number): Promise<void> // 只清理新格式日志
|
|
422
453
|
async dispose(): Promise<void>
|
|
423
454
|
}
|
|
424
455
|
```
|
|
425
456
|
|
|
426
457
|
规则:
|
|
427
|
-
- `appendChunk` 只写内存缓冲;`flushIntervalMs` 到点或缓冲超过 64 KiB 时追加写文件(`appendFile
|
|
428
|
-
- 任何磁盘错误只记 warn
|
|
429
|
-
|
|
430
|
-
|
|
458
|
+
- `appendChunk` 只写内存缓冲;`flushIntervalMs` 到点或缓冲超过 64 KiB 时追加写文件(`appendFile`)。只写自己的 incarnation。
|
|
459
|
+
- 任何磁盘错误只记 warn,绝不影响终端会话。**append 失败时批次放回 pending**,close 只有在
|
|
460
|
+
pending 清空后才删除 writer 并追加关闭元数据;否则保留 state 供 `flush()`/`dispose()` 重试,
|
|
461
|
+
且关闭权限保持未知(AI fail closed)。
|
|
462
|
+
- same-id reopen 前会先 flush/检查旧 incarnation;pending 数据、corrupt 或未写入的 close intent 任一存在都会拒绝 retire,避免丢失 close 权限。
|
|
463
|
+
- append 以 batch 为事务:每批先记录起始文件偏移,逐行 write/sync;失败时 truncate 回起始偏移再重试。rollback 失败 → `corrupt=true`,停止写入且不写 close 权限(fail closed,不误报 healthy)。
|
|
464
|
+
- pending 有界:`maxPendingBytes` 默认 1 MiB/会话(1024..64 MiB)。超限时**从最旧未落盘记录开始丢弃**,
|
|
465
|
+
单个超大 chunk 直接丢弃;`stats()` 暴露 `pendingBytes/droppedBytes/writeFailures/retryDelayMs/degraded`。
|
|
466
|
+
`degraded` 一旦发生过丢弃就保持为 true。失败日志按 60s 节流,重试指数退避到 60s。**这不是零丢失语义**。
|
|
467
|
+
- 单文件超过 `maxBytesPerSession` 时截断为尾部内容,**必须保留第一行文件头**;文件头无法确认时放弃截断(fail closed)。
|
|
468
|
+
- 任意 journal 缺文件头/关闭权限缺失 → AI fail closed。legacy 只允许显式 `actor:'human'` 的 `history.legacy.*`
|
|
469
|
+
读取,且必须能在 `index.json` 中存在(孤儿文件不暴露);旧文件不改不删。
|
|
470
|
+
- 未知 id 的查询最多每 `SCAN_COOLDOWN_MS`(1s)扫一次目录,避免被反复猜测 id 放大 I/O。
|
|
471
|
+
- 搜索对 live 与 closed 一致地不区分大小写。`query()` 只读取**尾部 `maxBytes`**(默认 8 MiB,
|
|
472
|
+
上限 256 MiB)到内存;不是整文件 `readFile`。`truncateSession()` 仍会整文件读取后重写为尾部,
|
|
473
|
+
这是唯一非流式的历史操作(文件由 `maxBytesPerSession` 约束,明确记录)。
|
|
474
|
+
- 导出按 64 KiB 块**流式**读取/写入,单文件无固定上限(覆盖配置允许的 512 MiB);单次调用有
|
|
475
|
+
`maxTotalBytes` 预算(默认 512 MiB),超出时整个 incarnation 写入 `skipped[].code='EXPORT_BUDGET'`,
|
|
476
|
+
已完成的文件保持独立有效。`FileHandle.write` 的 partial write 用循环处理;失败不 rename、不残留 temp。
|
|
477
|
+
- 源在 stat 时冻结 `snapshotBytes`;读取严格不超过该边界,因此持续写入不会挂起,也不会把
|
|
478
|
+
快照后的新输出(包括权限撤销后的输出)纳入。
|
|
479
|
+
- stat 后、开始读取前调用 `beforeRead(address)` **复验 owner/actor/当前权限**;explicit 失败抛错,
|
|
480
|
+
`all` 跳过并记录。rw→wo 后不会导出新内容。
|
|
481
|
+
- 显式导出源文件消失 → `SESSION_NOT_FOUND`;`all` 中缺失/不可读的源写入
|
|
482
|
+
`skipped[{sessionId,historyId,code,message}]`,绝不写空文件冒充成功。错误文本不包含私有 journal
|
|
483
|
+
path(宿主日志也优先只记录错误 code)。
|
|
484
|
+
- 同一逻辑 id 的每个可读 incarnation 都单独导出,文件名含 incarnation 短码与随机短码,并发不冲突。
|
|
485
|
+
- `historyId` 单独请求会解析对应 incarnation 后执行 query;找不到明确 404,不会被当成列表请求忽略。
|
|
486
|
+
- 列表分页返回 `truncated/total`;只过滤当前 live 的精确 incarnation(按 `historyId`),同 id 的旧
|
|
487
|
+
incarnation 仍保留。导出上限超出同样进入 `skipped`(`EXPORT_LIMIT`)。
|
|
488
|
+
- 多个 `HistoryStore` 并发/重载/旧实例延迟 flush 时,`wx` id/journal 预留与独立文件名保证不串写;
|
|
489
|
+
`index.json` 的 last-writer-wins 不影响归属判定。
|
|
490
|
+
- **prune 保守策略**:没有跨进程活动租约,因此**无 close 元数据的 journal 永不自动删除**(可能是
|
|
491
|
+
另一进程的 live writer,也可能是 crash 数据;保留优于误删)。只有带 close 元数据的 journal 才按
|
|
492
|
+
`max(lastTs, closedAt, stat.mtime)` 判老;大尾行/最近写入不会因旧 `lastTs` 被误删。maxSessions
|
|
493
|
+
裁剪使用同一 activity 排序,但仍按数量执行:总量超限时可能裁掉近期但排序靠后的日志。不可验证租约时
|
|
494
|
+
不承诺多 Host retention 一致;unclosed 可能长期占用磁盘。
|
|
495
|
+
- 等待读取:AI waiter 记录独立的 `readRevision`。aiAccess 变化、human takeover(以及 release)会以 `permission_changed` 结束且返回空 text、不更新 cursor;AI lock 的自然 idle 过期不会误触发。pattern/idle/timeout/exit/close 都走同一检查。
|
|
496
|
+
- 审计:write/deny **不记录任何输入原文**,只保留 action/source/code/byteLength 等元数据。
|
|
497
|
+
旧内存审计可能含历史原文;`audit({actor:'ai'})` 在返回前把所有 `detail` 脱敏为
|
|
498
|
+
`<action>:redacted`(human 视图保留原值)。live 会话的 history slice/export 写入会话审计环;
|
|
499
|
+
已关闭会话没有进程内审计归属,目前不记录(如需持久审计需另行设计)。
|
|
431
500
|
|
|
432
501
|
## 11. 批量与脚本(`lib/host/batch.js`、`lib/host/scripts.js`)
|
|
433
502
|
|
|
@@ -506,7 +575,7 @@ export class ScriptStore {
|
|
|
506
575
|
| `aiterm_screen` | `{ sessionId, changedOnly?, maxLines?, cursor? }` | 可见屏幕文本(去空行、可只回变化行),返回 `cursor`/`atPrompt`/`unchanged` |
|
|
507
576
|
| `aiterm_screenshot` | `{ sessionId }` | **兼容别名**,载荷精简为 `{ text, cols, rows, cursor, atPrompt, session }`(不再重复 `screen`+`text`) |
|
|
508
577
|
| `aiterm_wait` | `{ sessionId, until?, pattern?, idleMs?, timeoutMs?, cursor?, includeOutput? }` | `until`: `idle`(默认)/`pattern`/`exit` |
|
|
509
|
-
| `aiterm_history` | `{ sessionId?, since?, until?, search?, context?, maxMatches?, maxBytes?, limit? }` | 省略 `sessionId`
|
|
578
|
+
| `aiterm_history` | `{ sessionId?, historyId?, since?, until?, search?, context?, maxMatches?, maxBytes?, limit?, offset?, snapshot? }` | 省略 `sessionId` 时返回会话目录(每个 incarnation 逐条,带 `historyId`;`truncated/total/offset/snapshot` 分页,snapshot 不匹配返回 `stale:true`,服务端来源上限在到达可取边界时返回 `limitReached`,而非静默跳行/首屏死页;render 会输出 snapshot token;仅 truncated:true 时提示下一页 offset,stale 时 limitReached=false);否则返回匹配/片段 |
|
|
510
579
|
| `aiterm_batch` | `{ steps, targets?, stopOnError?, maxTotalMs?, parallel?, label? }` | §11.2 |
|
|
511
580
|
| `aiterm_script_list` | `{}` | 列出脚本 |
|
|
512
581
|
| `aiterm_script_run` | `{ name, params?, sessionId?, targets? }` | 执行脚本(等价 batch,label=`script:<name>`) |
|
|
@@ -529,8 +598,12 @@ export class ScriptStore {
|
|
|
529
598
|
|---|---|---|
|
|
530
599
|
| `read.delta` | `{ id, cursor?, maxBytes? }` | `{ text, cursor, newBytes, atPrompt }` |
|
|
531
600
|
| `read.screen` | `{ id, changedOnly?, maxLines? }` | `{ text, changedLines, cursor, atPrompt, unchanged }` |
|
|
532
|
-
| `history.sessions` | `{ limit?, since?, until? }` | `{ sessions: CatalogEntry[] }` |
|
|
533
|
-
| `history.query` | `{ sessionId?, since?, until?, search?, context?, maxMatches?, maxBytes?, limit? }` | `{ sessions?: CatalogEntry[], matches?: Match[], truncated, scannedBytes }` |
|
|
601
|
+
| `history.sessions` | `{ limit?, offset?, snapshot?, since?, until?, owner? }` | `{ sessions: CatalogEntry[], truncated, total, snapshot, stale?, limitReached? }`(先按 owner 过滤再分页;snapshot 不匹配返回 `stale:true`+空 sessions,UI reload;`limitReached` 仅在当前页到达可取来源边界时为 true;超出 20k 的 legacy 合并 total 是估算,可能高估) |
|
|
602
|
+
| `history.query` | `{ sessionId?, historyId?, since?, until?, search?, context?, maxMatches?, maxBytes?, limit?, offset?, snapshot?, owner? }` | `{ sessions?: CatalogEntry[], matches?: Match[], truncated, scannedBytes, total?, snapshot?, stale? }`(已关闭会话同样按 owner + 关闭权限判定;`historyId` 精确指定 incarnation;列表分页返回 total/snapshot/stale) |
|
|
603
|
+
| `history.export` | `{ sessionId?, historyId?, all?, since?, until?, owner? }` | `{ dir, files, skipped, skippedTotal, omitted? }`(`all` 覆盖本 owner 且当前 actor 可读的**每个** incarnation,最多 5000;超出用 `omitted:{count,limit,reason}` 汇总;skipped 明细最多 100 条+聚合;显式源文件缺失 → `SESSION_NOT_FOUND`) |
|
|
604
|
+
| `history.legacy.sessions` | `{ limit?, offset?, since?, until? }` | `{ sessions: CatalogEntry[], truncated, total }`(**仅人工**;无归属旧数据可分页恢复) |
|
|
605
|
+
| `history.legacy.query` | `{ sessionId, since?, until?, search?, context?, maxMatches?, maxBytes? }` | history.query 同形(**仅人工**,不改写旧文件) |
|
|
606
|
+
| `history.legacy.export` | `{ sessionId, since?, until? }` | `{ dir, files }`(**仅人工**;旧文件不改不删) |
|
|
534
607
|
| `scripts.list` | `{}` | `{ scripts: ScriptSummary[] }` |
|
|
535
608
|
| `scripts.save` | `{ script }` | `{ script: ScriptSummary }`(human only) |
|
|
536
609
|
| `scripts.delete` | `{ name }` | `{ ok: boolean }`(human only) |
|
|
@@ -572,6 +645,15 @@ scriptsDir: scripts # <dataDir> 下脚本目录名
|
|
|
572
645
|
|
|
573
646
|
# v3 增补:配置管理与脚本语言
|
|
574
647
|
|
|
648
|
+
> **AI + profileId 目标约束(0.5.7)**:AI 调用带 `profileId` 的 connect 时必须只传
|
|
649
|
+
> profileId(及 title/cols/rows);`transport`/`host`/`port`/`username`/`authType` 任一字段**存在且
|
|
650
|
+
> 非 undefined**(含 null/空串/false/0/NaN/对象)都会在读取 profile 密钥之前以
|
|
651
|
+
> `AI_PROFILE_TARGET_DENIED` 拒绝;AI 解析只使用 saved 值,不依赖 schema。reconnect 仅在保存 profile 的
|
|
652
|
+
> endpoint/auth 身份与 session 初始绑定完全一致时刷新 secret,否则 `PROFILE_TARGET_CHANGED` 并提示人工重开。
|
|
653
|
+
> Telnet 的有效 auth 身份恒为 none,不读取 profile secret;SSH 才比较 authType。人类遇到 profile 身份改动
|
|
654
|
+
> 时回退到 session 原有 auth(不把新 profile secret 发往旧 endpoint),AI 则严格拒绝。
|
|
655
|
+
> 人工在表单里覆盖地址仍沿用原有行为(保存密码复用于人工编辑的目标)。
|
|
656
|
+
|
|
575
657
|
## 13. 配置(profile)管理
|
|
576
658
|
|
|
577
659
|
`ProfileInfo` 增加两个字段(其余不变):
|
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@ reads, searchable history, batch scripts and a full audit trail.
|
|
|
11
11
|
|
|
12
12
|
- **多会话**:同时打开多台主机,标签页切换;终端输出实时滚动,支持重连回放。
|
|
13
13
|
- **省 token 的读取**:默认 **增量读**(只回上次之后的新输出),另有「只看变化行」的屏幕读、带时间戳的历史搜索、以及"等到有输出/提示符/退出"的等待读,不再反复重传整屏。
|
|
14
|
-
-
|
|
14
|
+
- **历史可查且按 owner 隔离**:输出按会话落盘并保留(默认 24 小时,写入为 best-effort),会话关闭后仍可按时间范围或关键字检索。会话 id 通过历史目录里的原子 reservation **跨重启/跨进程续号**(不会又从 `st-1` 开始),每次打开会话仍预留**独立日志文件**并写入私有归属/关闭权限元数据;重复/历史 incarnation 会以独立 `historyId` 列出,可单独检索和导出。升级前没有归属元数据的旧日志对 AI 一律 fail closed(见「终端与 AI 会话的归属」)。
|
|
15
15
|
- **批量与脚本**:一次调用跑多步(发送 → 等待 → 只读新输出),支持多会话扇出;可保存脚本并在面板里一键运行。
|
|
16
16
|
- **SSH + Telnet**:SSH 走 `ssh2`(密码 / 私钥 / agent),Telnet 为原生实现(完整 IAC 协商、TERMINAL-TYPE、NAWS 窗口尺寸)。
|
|
17
17
|
- **AI 权限按会话设置**:
|
|
@@ -20,7 +20,7 @@ reads, searchable history, batch scripts and a full audit trail.
|
|
|
20
20
|
- `读写(rw)`:两者都可。
|
|
21
21
|
- **AI 操作时屏蔽人工写**:AI 一开始输入就持有「控制权」,人工键盘输入被拒绝并显示提示;AI 空闲超时自动释放,或人工点「接管」立即夺回控制。
|
|
22
22
|
- **双向互斥**:人工「接管」后,AI 的写入被拒绝,直到人工「交还 AI」。
|
|
23
|
-
- **审计**:每次读、写、拒绝、控制权变更都记录来源(human / ai),面板内可查,AI
|
|
23
|
+
- **审计**:每次读、写、拒绝、控制权变更都记录来源(human / ai),面板内可查,AI 也能用工具查。**终端输入原文不写入审计**;旧内存审计在返回给 AI 前会把 `detail` 统一脱敏,只有人工面板保留完整视图。
|
|
24
24
|
- **凭据隔离**:保存的密码/私钥存在 Host 侧(优先 DSH 加密凭据库),不会进入模型上下文、工具结果或日志。
|
|
25
25
|
|
|
26
26
|
> 这是权限与协作层面的护栏,不是远程主机的安全沙箱。对敏感环境请给 AI 设 `只读`,或让 AI 仅通过保存的 profile 连接。
|
|
@@ -39,7 +39,7 @@ dsh plugin --profile web add dsh-aiterm
|
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
41
|
npm install && npm run build # 需要 esbuild / xterm 才能重建 lib/client.js
|
|
42
|
-
npm pack # → dsh-aiterm-0.5.
|
|
42
|
+
npm pack # → dsh-aiterm-0.5.10.tgz
|
|
43
43
|
# 然后 plugin_manager(action:"install_bundle", target:"<tgz 绝对路径>")
|
|
44
44
|
```
|
|
45
45
|
|
|
@@ -68,11 +68,13 @@ sed -i 's#^ ssh-telnet/# aiterm/#' ~/.dsh/.credentials.yaml
|
|
|
68
68
|
sed -i 's#"ssh-telnet/#"aiterm/#' ~/.dsh/aiterm/secrets.json
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
|
|
71
|
+
然后卸载旧包、安装当前版本(`dsh-aiterm@0.5.10`)并重启 DSH Web,浏览器 `Ctrl+F5`。不要新旧并存——两者注册同名工具会冲突。
|
|
72
72
|
|
|
73
73
|
升级后需要自己改的地方:
|
|
74
74
|
|
|
75
75
|
- **提示词 / 脚本 / 外部调用**里写死的 `ssh_telnet_*` 改成 `aiterm_*`(模型工具名变了)。
|
|
76
|
+
- **0.5.3 及更早版本**写下的历史文件没有归属元数据:为了不伪造 owner,AI 不再能检索/导出它们;
|
|
77
|
+
文件原样保留,历史面板的 **[旧历史(无归属)]** 人工入口仍可读取(详见「终端与 AI 会话的归属」)。
|
|
76
78
|
- **反向代理 / 书签**里的 `/dsh-ssh-telnet` 路由改成 `/aiterm`。
|
|
77
79
|
- **前端本地偏好**(脚本面板的排序、方言选择、快捷条分组可见性)用的是新键 `dsh.aiterm.*`,旧值不迁移,重新设置一次即可。
|
|
78
80
|
|
|
@@ -113,7 +115,7 @@ sed -i 's#"ssh-telnet/#"aiterm/#' ~/.dsh/aiterm/secrets.json
|
|
|
113
115
|
| `aiterm_screen` | 可见屏幕文本;`changedOnly:true` 只回变化行(带行号) |
|
|
114
116
|
| `aiterm_screenshot` | `aiterm_screen` 的兼容别名(已精简载荷,不再重复整屏) |
|
|
115
117
|
| `aiterm_wait` | 等到「输出停顿 / 出现匹配 / 会话退出」,只回这期间的新输出 |
|
|
116
|
-
| `aiterm_history` |
|
|
118
|
+
| `aiterm_history` | 按时间范围/正则检索**本对话所属**会话的历史(含已关闭会话与重启后的历史;关闭权限同样受 AI 只读/只写限制;重复 id 用返回的 `historyId` 精确指定) |
|
|
117
119
|
| `aiterm_send` | 发送文本/按键(`\u0003` = Ctrl-C),可选等待并在审计中记录一次 `read:tail` 回读 |
|
|
118
120
|
| `aiterm_batch` | 一次调用执行多步(send → waitFor → 只读新输出),可多会话扇出 |
|
|
119
121
|
| `aiterm_script_list` | 列出保存的脚本(按分组) |
|
|
@@ -125,33 +127,165 @@ sed -i 's#"ssh-telnet/#"aiterm/#' ~/.dsh/aiterm/secrets.json
|
|
|
125
127
|
| `aiterm_disconnect` | 断开但保留会话(可重连) |
|
|
126
128
|
| `aiterm_reconnect` | 重连该会话(同一 id,历史保留) |
|
|
127
129
|
| `aiterm_close` | 关闭会话(终止并从列表移除) |
|
|
130
|
+
| `aiterm_export` | 把**本对话所属**会话输出(含已关闭会话)导出为 Host 上的文本日志文件;只写会话拒绝导出;可用 `historyId` 导出重复 id 的指定 incarnation |
|
|
131
|
+
| `aiterm_autolog` | 查询自动写日志文件状态;该开关是宿主级隐私设置,**仅限人工**在历史面板修改(默认关闭,开关持久化)。旧版遗留的 `enabled:true` 会先保持关闭并等待人工确认 |
|
|
128
132
|
|
|
129
|
-
AI 不能提供密码或私钥:需要密码/私钥的连接必须使用保存的 profile,由 Host
|
|
133
|
+
AI 不能提供密码或私钥:需要密码/私钥的连接必须使用保存的 profile,由 Host 侧解析。**带 `profileId` 时 AI 只能传 profileId(及 title/cols/rows)**;transport/host/port/username/authType 只要**字段存在且非 undefined**(含 null/空串/false/0/NaN/对象)就会被 403 `AI_PROFILE_TARGET_DENIED` 拒绝,且拒绝发生在读取 profile 密钥之前。AI 解析完全使用保存的 transport/host/port/username/authType,不依赖 schema 校验,防止保存的密码被发往 AI 指定的目标或默认端口。人工在表单里的地址覆盖仍保持原有行为(保存密码复用于人工编辑的目标)。
|
|
134
|
+
- AI reconnect 只有在保存 profile 的 endpoint/auth 身份与 session 初始绑定完全一致时才取新 secret;profile 目标或认证方式被人工改动后,AI 会以 `PROFILE_TARGET_CHANGED` 拒绝并提示从面板重开,绝不把新凭据发往旧 endpoint。Telnet 的有效 auth 身份恒为 none,不读取 profile secret;SSH 才比较 authType。人类在身份不一致时复用 session 原有 auth,不把新 profile secret 发往旧目标。
|
|
135
|
+
|
|
136
|
+
以上是 `toolDisclosure: full` 下的完整工具面。本包随包发布的 config 默认是 `progressive`:
|
|
137
|
+
它在 `full` 之上额外常驻一个发现入口
|
|
138
|
+
`aiterm_discover`(它不属于上面任何业务分组,也不接触终端)。其余工具的名称、参数、执行体、
|
|
139
|
+
owner 绑定和权限判定都不变;唯一的注册差异是它们会额外带一个**步骤级可见条件**,因此要按组
|
|
140
|
+
展开后才在下一步可见——见下方「工具渐进披露」。
|
|
130
141
|
|
|
131
142
|
## 配置
|
|
132
143
|
|
|
133
|
-
在 `~/.dsh/profiles/<profile>/cordis.patch.yml`
|
|
144
|
+
在 `~/.dsh/profiles/<profile>/cordis.patch.yml` 覆盖本插件行。**DSH 的补丁层不是深合并**:
|
|
145
|
+
按 `id` 匹配的补丁会**整体替换该行的 `config` 对象**,不是只覆盖你写出的键。未写出的键由插件
|
|
146
|
+
默认值补齐,所以"只写要改的键"会让其余键悄悄回到默认值——例如 `aiAccessDefault` 默认是
|
|
147
|
+
`rw`,此前设为 `ro` 的部署会因为漏写而**放宽 AI 权限**。
|
|
148
|
+
|
|
149
|
+
因此升级或改配置时请**保留完整对象**并显式写出安全值。下面的示例是全量配置(`toolDisclosure`
|
|
150
|
+
显式写回 `full`、`aiAccessDefault` 显式固定为 `ro`,其余为默认值);请按需修改,不要删掉你依赖的键:
|
|
134
151
|
|
|
135
152
|
```yaml
|
|
136
153
|
- id: aiterm
|
|
137
154
|
name: 'dsh-aiterm'
|
|
138
155
|
config:
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
156
|
+
enabled: true
|
|
157
|
+
toolDisclosure: full # full(21 个工具全量注册)| progressive(先发现、按组展开;本包发布默认)
|
|
158
|
+
aiAccessDefault: ro # 新会话默认 AI 权限:ro | wo | rw;显式写出,避免漏写回落到 rw
|
|
159
|
+
aiAutoLock: true # AI 写入时是否自动取得控制权
|
|
160
|
+
aiLockIdleMs: 30000 # AI 控制权空闲自动释放时间
|
|
161
|
+
blockHumanWhileAi: true # 核心行为:AI 操作时屏蔽人工写
|
|
162
|
+
humanCanPreempt: true # 是否允许人工随时接管
|
|
144
163
|
maxSessions: 16
|
|
145
164
|
scrollback: 4000
|
|
146
|
-
replayBufferBytes: 262144
|
|
165
|
+
replayBufferBytes: 262144 # 重连回放保留的原始输出字节数
|
|
147
166
|
aiReadMaxBytes: 65536
|
|
167
|
+
deltaDefaultMaxBytes: 8192
|
|
148
168
|
connectTimeoutMs: 20000
|
|
149
169
|
keepaliveMs: 15000
|
|
150
170
|
routePath: /aiterm
|
|
151
|
-
knownHostsPolicy: accept-new
|
|
171
|
+
knownHostsPolicy: accept-new # accept-new | strict | insecure
|
|
152
172
|
terminalType: xterm-256color
|
|
173
|
+
promptPattern: '[#$%>❯»]\s*$'
|
|
153
174
|
# v2 读取 / 历史 / 脚本
|
|
154
|
-
|
|
175
|
+
historyRetentionMs: 86400000 # 24 小时
|
|
176
|
+
historyMaxBytesPerSession: 8388608
|
|
177
|
+
historyMaxSessions: 100
|
|
178
|
+
historyFlushIntervalMs: 250
|
|
179
|
+
scriptsDir: scripts
|
|
180
|
+
maxDetachedSessions: 20
|
|
181
|
+
autoReconnect: false
|
|
182
|
+
autoReconnectAttempts: 3
|
|
183
|
+
autoReconnectDelayMs: 2000
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
> 如果你原来就用默认的 `aiAccessDefault: rw`,显式写 `rw` 与不写等价;如果你曾设为 `ro` 或
|
|
187
|
+
> `wo`,务必保留该值,否则会被默认的 `rw` 替换。这是 DSH 补丁的替换语义,不是本插件做的
|
|
188
|
+
> 深合并;`aiAccessDefault` 只会影响**新会话**,不会改动已存在会话的权限。
|
|
189
|
+
|
|
190
|
+
`toolDisclosure` 只在插件加载时读取(见下方「工具渐进披露」);切换取值会重载插件行,
|
|
191
|
+
**可能关闭当前终端**。其余配置项与默认值、取值范围见 `CONTRACTS.md`。
|
|
192
|
+
|
|
193
|
+
## 工具渐进披露(`toolDisclosure: progressive`)
|
|
194
|
+
|
|
195
|
+
`full` 保持历史行为:21 个 `aiterm_*` 工具对每个 Agent **无条件**注册,参数、
|
|
196
|
+
描述、执行体、终端 owner 和权限判定全部不变。
|
|
197
|
+
|
|
198
|
+
改为 `progressive`(本包发布默认)后,只常驻一个发现入口 `aiterm_discover`;其余工具仍按原名注册,
|
|
199
|
+
但附带一个**步骤级**条件:只有当前模型步骤的 Agent 已展开对应分组时才进入该步骤的
|
|
200
|
+
工具快照。发现入口本身不接受任何终端操作,也不改变权限。
|
|
201
|
+
|
|
202
|
+
| 分组 | 成员 | 何时可用 |
|
|
203
|
+
| --- | --- | --- |
|
|
204
|
+
| `session` | `list` / `status` / `read` / `screen` / `screenshot` / `wait` / `send` / `release_control` | 展开 `session` 后的**下一个**模型步骤 |
|
|
205
|
+
| `history` | `history` / `audit` / `export` | 展开 `history` 后的下一个步骤 |
|
|
206
|
+
| `automation` | `batch` / `script_list` / `script_save` / `script_run` | 展开 `automation` 后的下一个步骤 |
|
|
207
|
+
| `management` | `connect` / `disconnect` / `reconnect` / `resize` / `close` / `autolog` | 展开 `management` 后的下一个步骤 |
|
|
208
|
+
|
|
209
|
+
> 表中的名字省略了 `aiterm_` 前缀,例如 `session.list` 即 `aiterm_list`。
|
|
210
|
+
|
|
211
|
+
用法(模型侧):
|
|
212
|
+
|
|
213
|
+
1. 第一步调用 `aiterm_discover`(不传参数):返回当前模式、四组名称、当前 Agent 可见的
|
|
214
|
+
工具、已展开分组、组间依赖提示。
|
|
215
|
+
2. 调用 `aiterm_discover { "group": "session" }` 展开一组;再传其他组可继续展开。
|
|
216
|
+
展开是**幂等**的,重复调用不会报错。
|
|
217
|
+
3. 从**下一步**开始,该组工具才可调用;同一步里先发现再调用会得到 `UNKNOWN_TOOL`。
|
|
218
|
+
4. 先展开 `session` 并 `aiterm_list` 拿到会话 id,history / automation / management
|
|
219
|
+
里的操作才有目标可用。
|
|
220
|
+
|
|
221
|
+
### 升级注意:工具 allow-list 必须显式加入 `aiterm_discover`
|
|
222
|
+
|
|
223
|
+
如果部署、Agent preset 或子代理的 `toolFilter` 用 `tools.restrict({ allow: [...] })` 把本插件
|
|
224
|
+
的工具限制为一份**白名单**,这份名单通常只包含改动前的 21 个 `aiterm_*` 名字。`progressive`
|
|
225
|
+
的常驻发现入口 `aiterm_discover` 是**新名字**:白名单不包含它时,它会在步骤解析阶段被过滤
|
|
226
|
+
掉;同时 21 个业务工具又都还没有展开,于是**该 Agent 这一步一个 aiterm 工具都拿不到**。
|
|
227
|
+
这是既有安全限制按预期生效,不是可自动恢复的降级,也不能由模型自行绕过。
|
|
228
|
+
|
|
229
|
+
迁移方式(**不改变任何限制**):
|
|
230
|
+
|
|
231
|
+
1. **想用 `progressive`**:在原有白名单里**追加 `aiterm_discover`**,其余 21 个名字保持原样;
|
|
232
|
+
`deny` 仍然优先,白名单外的工具在展开后也不可见。
|
|
233
|
+
2. **不想改白名单**:保持 `toolDisclosure: full`;`full` 不注册新名字,白名单行为与升级前
|
|
234
|
+
完全一致。
|
|
235
|
+
3. **不要把"放开限制 / 删除 deny / 清空白名单"当作迁移手段**;需要精确白名单时选 `full`。
|
|
236
|
+
|
|
237
|
+
已用真实 DSH `ToolsService` 固定这两个场景:只含 21 个旧名字的白名单得到空步骤快照;追加
|
|
238
|
+
`aiterm_discover` 后发现可用,展开后仍只出现白名单内工具(白名单外的 `aiterm_send` 和整个
|
|
239
|
+
automation 组即使展开也不可见)。见 `test/disclosure-runtime.test.mjs`。
|
|
240
|
+
|
|
241
|
+
边界与限制:
|
|
242
|
+
|
|
243
|
+
- **每次展开只属于一个 Agent 对象**:子 Agent、fork、恢复(resume)或重开后的新 Agent
|
|
244
|
+
(即使复用同一个 session id)都从收起状态开始,不继承父级或旧对象的展开;`agent/disposed`
|
|
245
|
+
或插件卸载也会清空该 Agent 的展开状态。
|
|
246
|
+
- **终端归属与展开身份是两件事**:终端按 DSH 会话 id(owner)隔离,展开按当前 Agent
|
|
247
|
+
对象记忆。恢复后的新 Agent 用同一 owner id 仍能看到同一终端,但必须重新展开;换一个
|
|
248
|
+
owner id 则照常 404,不会因为展开而越权。
|
|
249
|
+
- **发现不是授权**:只读 / 只写(`aiAccess`)、人工接管(`lockOwner === 'human'`)、
|
|
250
|
+
AI 控制权、审计等判定仍在调用时由 Host 侧统一执行;展开前后拒绝码完全一致,
|
|
251
|
+
详见「AI 权限模型」。被其他工具限制隐藏的工具不会出现在发现结果里,展开也不会放宽它。
|
|
252
|
+
- **非模型步骤不能直接执行条件工具**:条件工具只在 DSH 解析出的模型步骤快照里可用;
|
|
253
|
+
绕过步骤的直接调用(例如没有 `agent` 的 `tools.executable`、旧快照、后台脚本)在
|
|
254
|
+
progressive 下看不到它们,这是预期行为。需要脚本/批次能力时先展开对应分组。
|
|
255
|
+
- **发现/展开不重启插件、不断开终端**:它们只改内存中的展开集合,正在运行的
|
|
256
|
+
`aiterm_wait` / `aiterm_batch` 等调用不会被中断。
|
|
257
|
+
- **progressive 依赖模型遵守提示词**:模型若不先发现就直接猜工具名,会收到
|
|
258
|
+
`UNKNOWN_TOOL`;`full` 没有这个前置条件。工具多、模型上下文紧张时用 progressive。
|
|
259
|
+
|
|
260
|
+
### 切换与回滚(会重载插件)
|
|
261
|
+
|
|
262
|
+
> **重载的三项影响**:切换 `toolDisclosure`(或本插件行的任何配置)
|
|
263
|
+
> 会重载插件行,并同时发生:
|
|
264
|
+
> ① **关闭所有当前终端**(不保留连接,重开后是新的远端 shell);
|
|
265
|
+
> ② **清空内存审计**(审计不落盘);
|
|
266
|
+
> ③ 输出历史按保留期留在磁盘。会话 id 现在由历史目录的 `.ids/st-N` 原子 reservation 跨重启续号,
|
|
267
|
+
> 不再从 `st-1` 重来;每次打开会话仍预留**独立日志文件**并写入私有 `owner`/关闭权限元数据。
|
|
268
|
+
> 即使遇到旧的重复 incarnation,它们也会逐条列出并带独立 `historyId`,不会混用/合并权限。
|
|
269
|
+
> 切换前请确认没有正在跑的命令,并接受需要重开终端、重新发现工具、重新积累审计。
|
|
270
|
+
|
|
271
|
+
`toolDisclosure` 是插件行配置,**没有热切换**。修改后 DSH 会重载/重启该插件行:
|
|
272
|
+
|
|
273
|
+
- 插件持有的终端 registry 会随卸载销毁,**当前终端会被关闭**(不保留连接);重新打开
|
|
274
|
+
后远端是新 shell(屏幕重置)。
|
|
275
|
+
- 输出历史写入数据目录并按保留期保留(默认 24 小时;写入是 best-effort,磁盘失败只告警,
|
|
276
|
+
不阻塞终端)。每个会话日志自带私有归属与关闭权限,历史面板/导出/工具都按 owner 过滤;
|
|
277
|
+
插件重载后会话 id 会从已预留的高水位继续,不会复用旧 id;即便出现历史重复 id,也会以独立
|
|
278
|
+
`historyId` 列出并单独导出。升级前没有归属元数据的旧日志不会被自动认领,AI 不可读
|
|
279
|
+
(见「终端与 AI 会话的归属」)。
|
|
280
|
+
- 展开状态和**审计**都只存在内存中:审计是每会话/全局的环形缓冲,不落盘,插件重载或
|
|
281
|
+
DSH 重启后清空。重载后模型需要重新 `aiterm_discover`。
|
|
282
|
+
- 建议在两次操作之间、没有正在跑的命令时切换;不要在长命令执行中切换。
|
|
283
|
+
|
|
284
|
+
回滚:在本插件行写入全量 config 并把 `toolDisclosure` 设为 `full`(只写这一项会让其余键
|
|
285
|
+
回落到默认值)并重载插件/重启 DSH Web。`full`
|
|
286
|
+
不注册 `aiterm_discover`,21 个工具恢复无条件注册。终端需要重新打开;脚本和 profile 是
|
|
287
|
+
磁盘数据,不受影响;输出历史按保留期保留(历史面板/导出可读取这些文件,但重启后的
|
|
288
|
+
归属与可见性见「终端与 AI 会话的归属」);审计只在内存中,重载后已清空。无需迁移数据。
|
|
155
289
|
|
|
156
290
|
## 读取方式与 token 成本
|
|
157
291
|
|
|
@@ -216,18 +350,27 @@ AI 不能提供密码或私钥:需要密码/私钥的连接必须使用保存
|
|
|
216
350
|
也不会被 B 的 AI 读到或操作。
|
|
217
351
|
|
|
218
352
|
- 客户端把当前 DSH 会话 id 作为 `owner` 带在每次会话相关调用上,SSE 流也按 `?owner=` 过滤
|
|
219
|
-
- 宿主侧按 `owner` 隔离:`sessions.list
|
|
220
|
-
用别的对话的 id
|
|
353
|
+
- 宿主侧按 `owner` 隔离:`sessions.list`、读写、断线重连、权限、审计、历史查询、日志导出**按 owner 过滤**;
|
|
354
|
+
用别的对话的 id 访问**存活会话**一律 404,且文案与「id 不存在」完全一致(不泄露存在性)
|
|
355
|
+
- 持久历史同样按 owner 隔离:每个日志文件头部保存私有 `owner`,关闭时追加私有 AI 权限;
|
|
356
|
+
归属不依赖进程内记忆,也不依赖可被其他实例覆盖的 `index.json`
|
|
221
357
|
- `maxSessions` / `maxDetachedSessions` **按每个 AI 会话分别计数**,一个对话开满不会影响另一个
|
|
222
358
|
- AI 通过工具创建的终端,归属**调用它的那个 AI 会话**(工具 schema 里没有 owner 参数,模型无需关心)
|
|
223
359
|
- 身份取自 DSH 的 `agent.id`(兼容 `agent.session.id`);**子代理**开的终端归到它所属的那个对话,
|
|
224
360
|
**fork** 出来的新对话则各管各的
|
|
225
361
|
- 万一宿主读不出调用方身份,工具会直接报 `OWNER_UNKNOWN` 而不是造一个谁都看不见的终端
|
|
226
|
-
- 哪些是宿主级、不按会话隔离:连接配置(`profiles`)、保存的脚本(`scripts
|
|
227
|
-
|
|
362
|
+
- 哪些是宿主级、不按会话隔离:连接配置(`profiles`)、保存的脚本(`scripts`)、自动写日志开关。
|
|
363
|
+
自动写日志开关会写到*所有*会话,因此只允许人工在面板修改,AI 的 `aiterm_autolog` 只能查询
|
|
364
|
+
- **[旧历史(无归属)]** 是明确的人工入口:不向 AI 暴露,不自动给旧文件补 owner,查看/导出都不改写、不删除旧文件
|
|
365
|
+
- `导出全部` **不是**跨对话操作:它只导出本对话拥有、且当前 actor 可读的**每一个 incarnation**(同一 id 的旧 incarnation 也会各自生成文件;wo/未知权限按 AI 权限跳过)
|
|
228
366
|
|
|
229
367
|
> 切换 DSH 会话时面板会清空并重新拉取,这是设计行为——不会把上一个对话的终端带过来。
|
|
230
|
-
>
|
|
368
|
+
> **历史的安全边界**:每次打开会话都会用 `wx` 独占创建 `<sessionId>~<uuid>.ndjson`,因此两个
|
|
369
|
+
> 并行/重载的宿主实例、旧实例延迟的异步 flush 都不会写进同一个文件;`owner` 和关闭时的
|
|
370
|
+
> `aiAccess` 作为私有元数据写在该文件里。只写(wo)的 AI 不能读、检索或导出**已关闭**会话;
|
|
371
|
+
> 关闭权限未记录(崩溃)或缺失归属的日志对 AI 一律拒绝。升级前的旧日志没有归属,保留在磁盘
|
|
372
|
+
> 上但不会被自动分配给任何新 owner:**AI 完全不可读**,只有历史面板的 **[旧历史(无归属)]**
|
|
373
|
+
> 人工入口可读;旧文件不会被改写或删除。
|
|
231
374
|
|
|
232
375
|
## 会话与协议
|
|
233
376
|
|
|
@@ -242,9 +385,11 @@ AI 不能提供密码或私钥:需要密码/私钥的连接必须使用保存
|
|
|
242
385
|
| 按钮 | 作用 |
|
|
243
386
|
|---|---|
|
|
244
387
|
| 导出当前 | 把当前选中会话的输出写成一个文本文件 |
|
|
245
|
-
| 导出全部 |
|
|
388
|
+
| 导出全部 | 本对话拥有、当前可读的每个 incarnation 各写一个文件(含已关闭的;AI 只写/未知权限的 incarnation 跳过) |
|
|
246
389
|
|
|
247
|
-
- 输出目录:`~/.dsh/aiterm/exports/`,文件名 `<会话id
|
|
390
|
+
- 输出目录:`~/.dsh/aiterm/exports/`,文件名 `<会话id>-<incarnation短码>-<标题>-<时间戳>-<随机短码>.log`(旧版/无 historyId 的文件不带 incarnation 短码;随机短码保证并发导出也不会互相覆盖)
|
|
391
|
+
- 导出结果同时返回 `skipped`:源文件缺失/不可读、权限不允许或超出单次预算的条目会明确列出(`code`/`message`),不会伪装成成功的空文件;显式导出单个会话时缺失源直接报错。
|
|
392
|
+
- 导出是**快照式**的:先固定源文件当前字节边界,再在真正读取前复验 owner/权限;持续写入的 live 会话不会让导出挂起,权限撤销后产生的新输出不会进入快照。单次调用默认最多输出 512 MiB(`EXPORT_BUDGET` 跳过),已完成的文件仍是独立有效文件。
|
|
248
393
|
- 内容:头注释(协议 / `user@host:port` / 标题 / 开始时间)+ 每行 `<ISO 时间戳> <输出行>`
|
|
249
394
|
- 文件写在**宿主机**上(不是浏览器下载),用 DSH 的文件面板取走即可;导出结果面板会列出路径、大小、行数
|
|
250
395
|
- 导出失败会显示原因;若提示「重启 DSH 后可用」,说明宿主代码还是旧代际
|
|
@@ -255,7 +400,21 @@ AI 不能提供密码或私钥:需要密码/私钥的连接必须使用保存
|
|
|
255
400
|
`~/.dsh/aiterm/logs/`(可在 Host 侧改目录)
|
|
256
401
|
- 开关状态存在 `~/.dsh/aiterm/settings.json`,重启后保持;写失败只会告警一次并自动停写,
|
|
257
402
|
不影响会话本身
|
|
258
|
-
-
|
|
403
|
+
- **该开关是宿主级的**:一开就会记录*所有*对话的终端输出,因此只有人工可以在面板修改;
|
|
404
|
+
AI 工具 `aiterm_autolog` 只能查询状态,任何开启/关闭/改目录的尝试都会以 `HUMAN_ONLY` 拒绝。
|
|
405
|
+
AI 仍可用 `aiterm_export` 导出**自己 owner 下、AI 可读**的历史(wo 会话拒绝)
|
|
406
|
+
- **从旧版本升级时的安全迁移**:旧版允许 AI 开启自动日志,升级后若读到没有人工确认标记的
|
|
407
|
+
`enabled:true`,*运行时*保持关闭;**原 `settings.json` 和目录不会被自动改写**。面板会显示旧路径,
|
|
408
|
+
并禁用一键开关;人工必须明确点「保持关闭」或「确认并继续使用该目录」后才会写入确认标记;Host 端要求 `confirmLegacy:true` 且目录等于旧路径(`LEGACY_AUTOLOG_CONFIRM_REQUIRED`/`LEGACY_AUTOLOG_DIR_MISMATCH`),普通 enable 无法绕过;UI 在设置读取完成前/读取失败时禁用开关并显示错误。
|
|
409
|
+
若人工不操作,重启后仍保持关闭。这是有意的兼容性变化:升级后既有自动日志不会立即继续,需人工确认一次。
|
|
410
|
+
|
|
411
|
+
### 0.5.10 升级/回滚与历史兼容
|
|
412
|
+
|
|
413
|
+
- **升级**:不需要迁移命令,也不改写/删除现有历史或 `settings.json`。第一次启动会扫描历史头并在 `history/.ids/` 建 id reservation;旧文件保持原样。
|
|
414
|
+
- **会话 id**:从 0.5.4 起跨重启续号,不再回到 `st-1`;如果历史目录被清空,续号信息也一起丢失。
|
|
415
|
+
- **重复 id**:列表会显示全部 incarnation(各带 `historyId`);旧客户端只按 `sessionId` 取最新一条(兼容),新客户端/工具用 `historyId` 精确访问。
|
|
416
|
+
- **回滚**:0.5.3 能读新日志头但仍只挑最新 incarnation;0.5.2 及更早看不到新文件名格式。回滚不会删除旧文件,但旧 incarnation 可能重新变得不可见;需要完整访问时请保留 0.5.4+。自动日志若在 0.5.4+ 已人工确认过,`settings.json` 带 `reviewedAt`;回滚到旧版会按其旧逻辑读取 `enabled`。
|
|
417
|
+
- **旧历史入口**:`[旧历史(无归属)]` 只在面板提供,AI 工具没有对应参数;旧文件永远不自动补 owner。
|
|
259
418
|
|
|
260
419
|
## 脚本
|
|
261
420
|
|
|
@@ -376,14 +535,31 @@ print('hello from the remote host')
|
|
|
376
535
|
(`/^[A-Za-z_][A-Za-z0-9_]*$/`),写入当时不报错,但会让凭据文档在**下次启动**时
|
|
377
536
|
无法解析,导致 DSH 起不来(本项目曾因此事故)。`test/secrets.test.mjs` 会拦截这种回退。
|
|
378
537
|
- RPC 与 SSE 路由经 `connection.admit()` 认证(可信来源 + 签名 Cookie),非授权请求返回 401/403。
|
|
379
|
-
-
|
|
538
|
+
- 审计**不记录任何终端输入原文**(write/deny 只保留 `action`/`code`/`byteLength` 等元数据);旧内存审计在 AI 查询前统一脱敏。human 面板仍保留受信的完整视图。
|
|
539
|
+
- 终端历史:`~/.dsh/aiterm/history/<sessionId>~<uuid>.ndjson`(0600)。每个文件第一行是私有归属元数据,关闭时追加私有 `aiAccess`;`index.json` 仅用于读取升级前的旧目录/旧日志,新日志通过扫描文件头恢复,不依赖共享索引(多个宿主实例并发时索引的最后写入者不会改变归属)。
|
|
540
|
+
- 会话 id 预留:`~/.dsh/aiterm/history/.ids/st-N`(0600,空文件)。首次分配用 `wx` 原子创建,跨重启/跨进程保证 `st-N` 不再复用;这些 reservation 不会被保留策略删除。
|
|
541
|
+
- 升级前的旧历史 `<sessionId>.ndjson` 原样保留;保留策略不会删除或改写它们,代码也不会把新会话追加进去。
|
|
542
|
+
- 新格式日志的每个 incarnation 都有独立 `historyId`(形如 `st-1~<uuid>`);列表会逐条展示,工具/面板把 `historyId` 传回即可精确检索/导出,不会合并权限。关闭只写回本进程实际打开的那个 incarnation;reservation 失败时绝不回退给旧日志补权限。
|
|
380
543
|
|
|
381
544
|
## 已知限制
|
|
382
545
|
|
|
383
546
|
- AI 截屏基于 headless 终端模拟,全屏 TUI 的鼠标/图片类内容无法表达。
|
|
384
547
|
- Telnet 协议本身明文传输(建议只在可信网络使用)。
|
|
385
548
|
- 浏览器端把 RPC 前缀硬编码为默认的 `/aiterm`;若改了 `routePath`,需要同步修改 `client/api.js` 并 `npm run build`。
|
|
386
|
-
-
|
|
549
|
+
- 升级前的历史文件没有归属/关闭权限元数据:为了不伪造归属,它们对 AI 完全 fail closed;只有历史面板的 **[旧历史(无归属)]** 人工入口可以读取。旧文件保留、不会被自动删除(保留策略只清理带 close 元数据的新格式日志;无 close 的 journal 保守保留)。
|
|
550
|
+
- 同一 `st-N` 若因旧数据/异常出现多个 incarnation,列表会列出全部并带独立 `historyId`;只传 `sessionId` 的旧调用者仍取最新一条(兼容),新调用者应回传 `historyId` 精确访问。不会把两条的权限/owner 合并。
|
|
551
|
+
- 已关闭会话的历史读取/导出只在内存审计里记录**活跃**会话(关闭会话没有进程内审计归属);如果完整审计是硬要求,需要另行设计持久审计。
|
|
552
|
+
- 历史写入的 pending 缓冲默认每会话 1 MiB;在**持续磁盘写失败**时按策略丢弃最旧的未落盘数据(`droppedBytes/degraded` 可观察,日志 60s 节流)。这是有意的有界内存策略,**不是零丢失**。
|
|
553
|
+
- 没有跨进程活动租约:prune **不删除无 close 元数据的 journal**(可能属于其他进程的 live writer 或 crash 数据),因此这类文件可能长期保留;带 close 元数据的才按 `max(lastTs, closedAt, mtime)` 计算。多 Host 的 retention 一致性无法承诺。
|
|
554
|
+
- 单次导出默认总预算 512 MiB;超出会以 `EXPORT_BUDGET` 明确跳过,不会静默截断。历史列表超过 limit 时返回 `truncated/total`;导出超过 5000 incarnation 时以 `EXPORT_LIMIT` 跳过。
|
|
555
|
+
- `query()` 只把尾部 `maxBytes` 读入内存;`truncateSession()` 仍需整文件读取后重写(非流式,文件受 `maxBytesPerSession` 约束)。
|
|
556
|
+
- 导出流式读取以 stat 时的 `snapshotBytes` 为界;快照尾部若为未完成行则不会解析成记录;完全依赖底层文件在读取期间不被外部截断/替换。
|
|
557
|
+
- reopen same-id 时若旧 incarnation 还有未写入的 close intent,会拒绝 retire/新建 journal,直到 close 成功或进程结束保持 fail-closed。
|
|
558
|
+
- 历史 append 以 batch 为事务:partial write 失败会 truncate 回 batch 起点再重试;若 truncate 也失败,writer 标记 `corrupt`,停止写入、不写 close 权限并保持 AI fail-closed。
|
|
559
|
+
- 列表 owner 过滤在下发 limit 之前完成,分页返回 `truncated/total/snapshot/limitReached` 并支持 offset;UI 用 raw offset 和 snapshot 翻页,服务端排序/活动变化时返回 `stale` 并重载首页。所有初始/loadNormal/legacy/stale 请求都有 token+mode+mounted 校验,正常↔legacy 的延迟响应不会串页。服务端来源上限(20k)只在当前页真正到达可取边界时返回 `limitReached` 并停止 Load more;之前的页仍可继续翻,不会第一页就显示 50/20001 死页。超出 20k 的 legacy 合并总数是估算(全量 total 减已观察重复),可能略高估,UI/tool 明示,不宣称精确。切源时立即清空旧列表/隐藏旧 Load more,所有请求 token+mode+mounted 校验;分页追加保持服务端顺序(live 先、closed 按 activity),不在客户端重排。模型侧 `aiterm_history` render 会打印 `snapshot`;只有 `truncated:true` 才提示下一页 offset,完整末页不提示;stale/limit 也会呈现 token。导出严格最多 5000 个 incarnation,超出用 `omitted:{count,limit,reason}` 汇总;skipped 明细最多 100 条,`skippedTotal` 给精确总数。
|
|
560
|
+
- AI 的 `aiterm_wait` 使用独立的 readAuthorization revision:aiAccess 变化、human takeover 会以 `permission_changed` 结束且不回 text/不消费 cursor,恢复权限也不追溯授权;AI 自身 lock 的自然 idle 过期**不会**误触发。
|
|
561
|
+
- `maxSessions` 与 retention 使用同一 `max(lastTs, closedAt, mtime)` 活跃度排序;按数量裁剪时仍可能删除“近期但总数超限”的旧日志。
|
|
562
|
+
- **验证范围**:披露/权限测试跑在真实 DSH `ToolsService`、真实 `SessionRegistry` 和真实权限代码上,但模型侧使用 stub LLM、传输使用内存桩;**没有使用真实 provider/模型,没有测量 token 用量、缓存命中或成本,也没有连接真实 SSH 主机**。因此真实 provider/model/token/cache/cost 与真实 SSH 行为均未验证。
|
|
387
563
|
- 提示符识别是正则启发式,非标准 shell 集成;可通过 `promptPattern` 按需调整。
|
|
388
564
|
- 面板视觉验证需要浏览器环境;本项目环境无浏览器控制能力,界面仅做了构建与注册级验证。
|
|
389
565
|
|
|
@@ -395,7 +571,7 @@ npm install # 运行时依赖 ssh2 / @xterm/headless / @xterm/addon-ser
|
|
|
395
571
|
npm run build # 从 client/**.jsx 重新生成 lib/client.js(模块 id 取自 package.json 的 name)
|
|
396
572
|
npm run build:vendor # 重新打包 vendor/ssh2.cjs(需要 devDependency ssh2 + esbuild)
|
|
397
573
|
npm run lint # node --check 全部 Host 端源码
|
|
398
|
-
npm test # 客户端冒烟:槽位注册、locale 键、RPC 方法覆盖
|
|
574
|
+
npm test # Host 端 node:test(权限/披露等)+ 客户端冒烟:槽位注册、locale 键、RPC 方法覆盖
|
|
399
575
|
```
|
|
400
576
|
|
|
401
577
|
改了 `client/` 一定要重新 `build` 并提交 `lib/client.js`:`lib/` 是仓库的一部分,
|