mirror of
https://github.com/iflytek/skillhub.git
synced 2026-11-16 09:21:18 +00:00
feat(dsh): add efficient installed skill update overview
Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
This commit is contained in:
parent
347e906dbb
commit
7cbbe8c9b6
29 changed files with 1024 additions and 34 deletions
|
|
@ -16,18 +16,23 @@ const itemSchema = z.object({ registry: text, namespace: text, slug: text, targe
|
|||
|
||||
/** Read only the selected Registry's DSH records in Host-approved roots; never repair or hash all files. */
|
||||
export async function readInstalledProjection(inventory: Pick<InventoryStore, 'read'>, registry: string,
|
||||
targets: readonly InstalledProjectionTarget[]): Promise<InstalledProjection> {
|
||||
let records: unknown[]
|
||||
try {
|
||||
const raw: unknown = await inventory.read()
|
||||
records = z.object({ items: z.array(z.unknown()) }).parse(raw).items
|
||||
} catch { return { items: [], complete: false, issues: ['inventory-unreadable'] } }
|
||||
return readInstalledProjectionRecords(records, registry, targets)
|
||||
}
|
||||
|
||||
/** Internal projection primitive: callers must obtain records from a trusted inventory snapshot. */
|
||||
export async function readInstalledProjectionRecords(records: readonly unknown[], registry: string,
|
||||
targets: readonly InstalledProjectionTarget[]): Promise<InstalledProjection> {
|
||||
const result: InstalledProjection = { items: [], complete: true, issues: [] }
|
||||
const issue = (code: InstalledProjection['issues'][number]) => {
|
||||
result.complete = false
|
||||
if (!result.issues.includes(code)) result.issues.push(code)
|
||||
}
|
||||
let records: unknown[]
|
||||
try {
|
||||
const raw: unknown = await inventory.read()
|
||||
const parsed = z.object({ items: z.array(z.unknown()) }).parse(raw)
|
||||
records = parsed.items
|
||||
} catch { issue('inventory-unreadable'); return result }
|
||||
const roots = targets.map(target => {
|
||||
if (!isAbsolute(target.root)) throw new Error('Installed projection requires absolute Host roots')
|
||||
return { ...target, root: resolve(target.root) }
|
||||
|
|
@ -86,3 +91,44 @@ export async function readInstalledProjection(inventory: Pick<InventoryStore, 'r
|
|||
}
|
||||
return result
|
||||
}
|
||||
|
||||
/** A round-owned snapshot. Inventory identity is checked around every target projection. */
|
||||
export async function openInstalledProjectionSnapshot(inventory: Pick<InventoryStore, 'read' | 'path'>,
|
||||
registry: string, targets: readonly InstalledProjectionTarget[]) {
|
||||
const identity = async () => {
|
||||
const stat = await lstat(inventory.path, { bigint: true }).catch(error => {
|
||||
if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined
|
||||
throw error
|
||||
})
|
||||
if (!stat) return 'absent'
|
||||
if (!stat.isFile()) throw new Error('Inventory is not a regular file')
|
||||
return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(':')
|
||||
}
|
||||
const revision = await identity()
|
||||
const records = (await inventory.read()).items
|
||||
const assertCurrent = async () => {
|
||||
if (await identity() !== revision) throw new Error('Inventory changed during update scan')
|
||||
}
|
||||
await assertCurrent()
|
||||
const projection = await readInstalledProjectionRecords(records, registry, targets)
|
||||
await assertCurrent()
|
||||
const key = (item: Pick<InstalledProjectionItem, 'namespace' | 'slug' | 'scope'>) => JSON.stringify([item.namespace, item.slug, item.scope])
|
||||
const index = new Map<string, unknown[]>()
|
||||
for (const record of records) {
|
||||
for (const target of targets) {
|
||||
const entries = record.targets.filter(entry => isAbsolute(entry.rootDir) && resolve(entry.rootDir) === resolve(target.root) && entry.agent === 'dsh')
|
||||
if (!entries.length) continue
|
||||
const id = key({ ...record, scope: target.scope })
|
||||
const bucket = index.get(id) ?? []
|
||||
bucket.push({ ...record, targets: entries }); index.set(id, bucket)
|
||||
}
|
||||
}
|
||||
return { projection, async read(item: InstalledProjectionItem) {
|
||||
await assertCurrent()
|
||||
const result = await readInstalledProjectionRecords(index.get(key(item)) ?? [], registry, targets.filter(target => target.scope === item.scope))
|
||||
await assertCurrent()
|
||||
const current = result.items.find(value => value.targetPath === item.targetPath)
|
||||
if (!current || JSON.stringify(current) !== JSON.stringify(item)) throw new Error('Installed target changed during update scan')
|
||||
return current
|
||||
} }
|
||||
}
|
||||
|
|
|
|||
1
cli/src/integrations/native-contract.d.ts
vendored
1
cli/src/integrations/native-contract.d.ts
vendored
|
|
@ -81,6 +81,7 @@ export interface NativeRuntime {
|
|||
acceptUpgrade(request: NativeOperationRequest, validateNew: () => Promise<NativeInstallAcceptance>): Promise<NativeOperation | undefined>
|
||||
inspectUpgrade(selected: UpgradeSelection, targets: readonly InstalledProjectionTarget[]): Promise<UpgradeBaseline>
|
||||
assessUpdate(installed: UpdateIdentity, candidate: UpdateIdentity): UpdateAssessment
|
||||
openInstalledSnapshot(registry: string, targets: readonly InstalledProjectionTarget[]): Promise<{ projection: InstalledProjection; read(item: InstalledProjectionItem): Promise<InstalledProjectionItem> }>
|
||||
listInstalled(registry: string, targets: readonly InstalledProjectionTarget[]): Promise<InstalledProjection>
|
||||
readonly hostInstanceId: string
|
||||
listPending(): Promise<NativePendingOperation[]>
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@ import { isDeepStrictEqual } from 'node:util'
|
|||
import { inspectToggle, executeNativeToggle, recoverToggle } from './native-toggle'
|
||||
import { readSkillExamples } from '../services/skill-examples'
|
||||
import { observeInstallationDiscovery } from './install-discovery'
|
||||
import { readInstalledProjection } from './installed-projection'
|
||||
import { readInstalledProjection, openInstalledProjectionSnapshot } from './installed-projection'
|
||||
import { assessSkillUpdate } from './update-assessment'
|
||||
import { inspectUpgradeBaseline } from './upgrade-baseline'
|
||||
import { inspectRemovalBaseline } from './removal-baseline'
|
||||
|
|
@ -115,6 +115,7 @@ export async function openNativeRuntime(options: { stateDirectory: string; inven
|
|||
},
|
||||
assessUpdate: assessSkillUpdate,
|
||||
inspectUpgrade: (selected, targets) => inspectUpgradeBaseline(inventory, { ...selected }, targets.map(target => ({ ...target }))),
|
||||
openInstalledSnapshot: (registry, targets) => openInstalledProjectionSnapshot(inventory, registry, targets),
|
||||
listInstalled: (registry, targets) => readInstalledProjection(inventory, registry, targets.map(target => ({ ...target }))),
|
||||
executeInstall: async request => {
|
||||
await ensureCompatible()
|
||||
|
|
|
|||
79
cli/test/unit/integrations/installed-update-snapshot.test.ts
Normal file
79
cli/test/unit/integrations/installed-update-snapshot.test.ts
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
import { expect, spyOn, test } from 'bun:test'
|
||||
import * as fs from 'node:fs/promises'
|
||||
import { join } from 'node:path'
|
||||
import { tmpdir } from 'node:os'
|
||||
import { InventoryStore } from '../../../src/stores/inventory-store'
|
||||
import { openInstalledProjectionSnapshot } from '../../../src/integrations/installed-projection'
|
||||
|
||||
const registry = 'https://registry.example'
|
||||
async function fixture(count: number, run: (inventory: InventoryStore, targets: { scope: 'user' | 'project'; root: string }[]) => Promise<void>) {
|
||||
const root = await fs.realpath(await fs.mkdtemp(join(tmpdir(), 'skillhub-update-scan-')))
|
||||
try {
|
||||
const inventory = new InventoryStore(root)
|
||||
const targets = [{ scope: 'user' as const, root: join(root, 'user') }, { scope: 'project' as const, root: join(root, 'project') }]
|
||||
const items = []
|
||||
for (let index = 0; index < count / 2; index++) {
|
||||
const slug = `skill-${index}`
|
||||
const entries = targets.map(target => ({ rootDir: target.root, installDir: join(target.root, slug), agent: 'dsh', version: '1.0.0', installedAt: '2026-10-28', fingerprint: 'original' }))
|
||||
for (const entry of entries) {
|
||||
await fs.mkdir(join(entry.installDir, '.skillhub'), { recursive: true })
|
||||
await fs.writeFile(join(entry.installDir, 'SKILL.md'), 'local content')
|
||||
await fs.writeFile(join(entry.installDir, '.skillhub/metadata.json'), JSON.stringify({ registry, namespace: 'demo', slug, ...entry }))
|
||||
}
|
||||
items.push({ registry, namespace: 'demo', slug, targets: entries })
|
||||
}
|
||||
await inventory.write({ items })
|
||||
await run(inventory, targets)
|
||||
} finally { await fs.rm(root, { recursive: true, force: true }) }
|
||||
}
|
||||
|
||||
for (const size of [10, 100, 500]) test(`snapshot ${size} real filesystem targets has linear reads`, async () => {
|
||||
await fixture(size, async (inventory, targets) => {
|
||||
const read = spyOn(inventory, 'read')
|
||||
const files = spyOn(fs, 'readFile')
|
||||
const stats = spyOn(fs, 'lstat')
|
||||
const started = performance.now()
|
||||
try {
|
||||
const snapshot = await openInstalledProjectionSnapshot(inventory, registry, targets)
|
||||
expect(snapshot.projection.items).toHaveLength(size)
|
||||
expect(snapshot.projection.complete).toBe(true)
|
||||
for (const item of snapshot.projection.items) { await snapshot.read(item); await snapshot.read(item) }
|
||||
const metadataReads = files.mock.calls.filter(([path]) => String(path).endsWith('/metadata.json')).length
|
||||
const inventoryStats = stats.mock.calls.filter(([path]) => path === inventory.path).length
|
||||
expect(read).toHaveBeenCalledTimes(1)
|
||||
expect(metadataReads).toBe(size * 3)
|
||||
expect(inventoryStats).toBe(size * 4 + 3)
|
||||
console.info(JSON.stringify({ targets: size, inventoryReads: read.mock.calls.length, metadataReads, inventoryStats, elapsedMs: Math.round(performance.now() - started) }))
|
||||
} finally { read.mockRestore(); files.mockRestore(); stats.mockRestore() }
|
||||
})
|
||||
})
|
||||
|
||||
test('snapshot rejects inventory ABA, atomic replacement and target metadata changes', async () => {
|
||||
await fixture(2, async (inventory, targets) => {
|
||||
let snapshot = await openInstalledProjectionSnapshot(inventory, registry, targets)
|
||||
const original = await fs.readFile(inventory.path, 'utf8')
|
||||
const before = await fs.stat(inventory.path)
|
||||
await fs.writeFile(inventory.path, original.replace('demo', 'evil'))
|
||||
await fs.writeFile(inventory.path, original)
|
||||
await fs.utimes(inventory.path, before.atime, before.mtime)
|
||||
await expect(snapshot.read(snapshot.projection.items[0]!)).rejects.toThrow('Inventory changed')
|
||||
snapshot = await openInstalledProjectionSnapshot(inventory, registry, targets)
|
||||
await fs.writeFile(inventory.path + '.replacement', original)
|
||||
await fs.rename(inventory.path + '.replacement', inventory.path)
|
||||
await expect(snapshot.read(snapshot.projection.items[0]!)).rejects.toThrow('Inventory changed')
|
||||
snapshot = await openInstalledProjectionSnapshot(inventory, registry, targets)
|
||||
await fs.writeFile(join(snapshot.projection.items[0]!.targetPath, '.skillhub/metadata.json'), '{}')
|
||||
await expect(snapshot.read(snapshot.projection.items[0]!)).rejects.toThrow('Installed target changed')
|
||||
})
|
||||
})
|
||||
|
||||
test('absent inventory is an empty snapshot; creation invalidates it', async () => {
|
||||
await fixture(2, async (inventory, targets) => {
|
||||
const existing = await openInstalledProjectionSnapshot(inventory, registry, targets)
|
||||
await fs.unlink(inventory.path)
|
||||
const empty = await openInstalledProjectionSnapshot(inventory, registry, targets)
|
||||
expect(empty.projection).toEqual({ items: [], complete: true, issues: [] })
|
||||
await inventory.write({ items: [] })
|
||||
await expect(empty.read(existing.projection.items[0]!)).rejects.toThrow('Inventory changed')
|
||||
})
|
||||
})
|
||||
|
|
@ -56,8 +56,10 @@
|
|||
|
||||
首期功能范围以本目录规范为准。当前研发基线为 DSH 0.2.0-rc.2,包名为 `@astron-team/skillhub-dsh`;正式平台支持与发布决定按验收门禁执行。过程日志、截图批次和临时研究材料在仓库外留档,仓库仅保留正式规格、验证摘要及可复用测试。
|
||||
|
||||
## 后续增量:安装级技能启停(设计阶段)
|
||||
## 后续增量:安装级技能启停
|
||||
|
||||
[安装级启停设计](skill-toggle-design.md)定义受管理安装的停用、恢复、更新与卸载联动;正式验收见消费规范,执行拆分见 tasks.md 第44节。此增量尚未实现,不属于已发布0.5.0的能力。
|
||||
[安装级启停设计](skill-toggle-design.md)定义受管理安装的停用、恢复、更新与卸载联动;正式验收见消费规范,执行拆分见 tasks.md 第44节。此增量已随 PR #1025 合并,npm 发布与原生平台发布验收另行安排。
|
||||
|
||||
- [使用优先页面与二级安装管理](skill-use-first-design.md):日常动作、只读安装选择及精确管理边界。
|
||||
|
||||
- [已安装技能统一检查更新](installed-update-check-design.md):用户主动检查、技能级汇总筛选与逐位置更新,第46节跟踪验收。
|
||||
|
|
|
|||
|
|
@ -0,0 +1,23 @@
|
|||
# 已安装技能统一检查更新
|
||||
|
||||
## 范围
|
||||
用户主动检查当前来源、当前工作区可见的受管理安装。无进入页面自动扫描、后台轮询、批量执行、自动覆盖或新增Registry/SaaS协议。日常仍按技能聚合;实际检查/更新以精确itemKey为单位。
|
||||
|
||||
## 交互
|
||||
已安装页提供检查更新与进度n/m;结果渐进呈现,不逐项弹通知,不阻断浏览。汇总可更新技能数与检查失败项,支持全部/可更新/检查失败筛选和失败重试,关键词可叠加。已最新无卡片冗余文字;可更新显示目标版本摘要或多位置有更新,查看更新进入现有详情右侧,保持使用技能主动作。位置结果独立:同技能只计一个可更新技能,但不同位置版本与确认分开。blocked显示需处理,不算可执行更新;unavailable/错误算检查失败,不伪报已最新。
|
||||
|
||||
## 技术边界
|
||||
统一检查使用DSH私有只读检查轮次;保留原单项checkUpdate和精确位置prepareUpgrade事务,不另造批量写入API。客户端有界并发只读检查;重入禁用,取消/离开/切来源/会话/工作区时中止在途并丢弃迟到结果。结果仅适用于同一来源会话及同一安装引用。库存变更、更新/卸载/启停导致旧itemKey失效时清除对应结果。详情返回保留仍有效结果与筛选;详情更新执行始终重新核验,不把检查结果当授权。错误/空库存/不完整库存明确表达,不能全局显示全部已最新。
|
||||
|
||||
## 验收
|
||||
覆盖空安装、单份、同技能多位置不同结果、全部最新、可升级、本地修改blocked、网络失败重试、混合结果、扫描中切换与重复点击、迟到结果、安装变化后结果失效。确认没有任何扫描触发写操作。真实DSH检查进度与汇总筛选、详情返回、逐位置升级确认取消、深浅色与窄屏,原安装不变;本轮不需模型调用。
|
||||
|
||||
## 工具栏展示约定
|
||||
搜索和检查操作在同一响应式工具栏,筛选采用与页面一致的紧凑按钮组(全部/可更新/检查失败),不使用平台原生下拉菜单。筛选和单行摘要放在第二行;未检查仅显示技能数量,运行中明确进度,完成后仅显示有意义的更新与失败计数,零失败隐藏。不重复显示列表数量段落;窄屏允许自然换行,保留可见焦点和选中语义。
|
||||
|
||||
## 规模与资源边界
|
||||
每轮仅建立一次可信库存快照并索引目标,逐项只核验对应目标与库存文件版本;不能将全量库存读取/解析或全安装目录核验放入逐项循环。库存文件变更使本轮失效,重新检查建立新快照。快照建立前后需核验文件版本,避免跨变更读取。每轮同来源同技能共用远端resolve;不同安装位置仍独立判断版本结果。失败重试新建轮次,不永久缓存失败或版本。
|
||||
|
||||
轮次引用只由Host生成并绑定真实会话/工作区/来源/文件服务/运行时,客户端不提供路径。数量、生命周期和并发有界,结束、取消、过期和销毁释放资源;单个位置等待取消不误杀同技能其他位置共享请求。旧轮次结果不得流入新上下文,检查快照不能作为写入授权。
|
||||
|
||||
性能验收覆盖10/100/500处安装,分别记录库存读取、目标核验、远端请求次数和耗时;以读取次数和工作量接近线性为主要回归断言,不使用机器相关固定耗时阈值。真实DSH验证新私有协议、渐进结果、取消和原逐项更新确认。
|
||||
|
|
@ -436,3 +436,25 @@ Daily catalog, installed-skill groups, conversation inventory cards and default
|
|||
#### Scenario: Explicit installation management
|
||||
- **WHEN** the user selects a particular installation in secondary management or uses an exact operation receipt
|
||||
- **THEN** its exact reference remains authoritative for that request and is never silently replaced by the skill-level selector's winner
|
||||
|
||||
|
||||
### Requirement: User-triggered installed update overview
|
||||
The installed view SHALL check current managed installations only on explicit user action, aggregate results by skill, and retain exact installation identity for individual updates. It SHALL NOT execute updates during the scan.
|
||||
|
||||
#### Scenario: Mixed installation results
|
||||
- **WHEN** installations of one skill return different update states
|
||||
- **THEN** the view counts the skill once as upgradable if any location can upgrade, and the detail exposes each location independently
|
||||
- **AND** blocked or unavailable results are not represented as current or executable upgrades
|
||||
|
||||
#### Scenario: Context or inventory changes during a scan
|
||||
- **WHEN** the source, session, workspace, or installation reference changes
|
||||
- **THEN** stale results cannot populate the current overview or authorize an update
|
||||
|
||||
#### Scenario: Retry and individual confirmation
|
||||
- **WHEN** a user retries failed checks or opens an upgradable skill
|
||||
- **THEN** checks remain read-only and the existing precise per-installation update confirmation is required before mutation
|
||||
|
||||
#### Scenario: Large inventory update checking
|
||||
- **WHEN** a user checks many installations, including several locations of the same skill
|
||||
- **THEN** a bounded Host-owned scan reads and indexes the trusted inventory once, validates only the requested target and inventory revision per result, and shares remote version resolution for the same source and skill within that scan
|
||||
- **AND** inventory or context changes invalidate the scan, scan resources expire or are released on cancellation, and mutation preparation retains its independent full validation
|
||||
|
|
|
|||
|
|
@ -396,3 +396,13 @@
|
|||
- [ ] 45.4 独立评审、插件检查和真实DSH新对话/案例取消/填入/管理验证已通过;原安装保留。旧草稿往返人工核对受宿主侧栏隔离会话不可见限制,自动保护测试已通过,待补人工证据。
|
||||
|
||||
- [x] 45.5 按人工反馈取消管理弹窗,统一详情内联管理,修复确认层被背景卡片覆盖并验证。
|
||||
|
||||
## 46. 已安装技能统一检查更新
|
||||
|
||||
- [x] 46.1 确定主动统一检查、逐项更新与位置边界。
|
||||
- [x] 46.2 实现有界只读检查、上下文失效、进度汇总与筛选。
|
||||
- [x] 46.3 接入详情逐位置更新,保持原确认与库存变更失效。
|
||||
- [x] 46.4 测试、独立评审与真实DSH预览验收。
|
||||
|
||||
- [x] 46.5 优化统一检查的全量库存重复读取与同技能resolve重复请求,保留精确目标与上下文保护。
|
||||
- [x] 46.6 完成10/100/500位置规模测量、独立复审和真实DSH新协议回归。
|
||||
|
|
|
|||
|
|
@ -519,3 +519,30 @@ CLI 全量结果与后续专项分开记录,不声称最终新增用例都来
|
|||
管理安装改为进入对应详情,右侧直接展示各位置管理;对话入口沿已有详情导航。安装与危险操作确认保留。修复portal位于卡片操作区z-index上下文导致背景按钮盖过确认框的问题;共享确认层移出卡片,原生dialog内保留top layer。
|
||||
|
||||
最终插件619项测试/12357断言、build/typecheck/lint通过。新版真实DSH市场/已安装详情、两位置、深浅色/360窄屏、确认取消和elementFromPoint背景遮挡验证通过,50份技能文件SHA不变。旧历史会话引用按预期拒绝,重新读取后进入详情。无模型调用、未重验旧RC;搜索drawer嵌套确认本轮未独立点击。外部证据real/inline-management-acceptance.md,包SHA256 de575972578be50f4860472cb436111467c0bf9f8dc66ebd6401871b7aa73f03。未提交或发布。
|
||||
|
||||
|
||||
### 已安装技能统一检查更新(2026-10-28)
|
||||
|
||||
已实现用户主动发起的只读检查,最多3个并发、逐位置进度、技能级汇总、可更新/失败筛选及失败重试。进入页面不自动扫描,不提供批量更新。有效结果按itemKey传入详情,更新仍走原逐位置准备与确认;库存和来源/会话/工作区变化使旧引用失效。
|
||||
|
||||
最终 build/typecheck/lint、626项测试(12392次断言,89个文件)通过,独立复审无阻断发现。真实DSH预览检查12个安装位置,发现4个可更新技能;实际1.2.0→1.3.0进入原确认并取消。受控只读响应覆盖混合状态、并发、筛选重试、详情返回、取消与迟到响应;明暗主题及360窄屏无横向溢出。
|
||||
|
||||
来源/会话/同会话工作区切换、ABA和库存替换由真实React组件浏览器夹具验证;本轮未完成真实Host跨会话或工作区切换验收,不将组件证据扩大为Host实测。无模型调用、无安装执行写入,47份技能/项目/配置文件前后哈希一致。未提交、推送或发布。
|
||||
|
||||
外部证据:`dsh-update-overview-20261028/acceptance.md`、`review.md`、`final-check.log`、`browser-result.json`、`component-result.json`。运行包SHA256:`ec70b36c4629e2f8552dfc70c14f2e495f5cf2e2ca9d16e236c81ae3efec7cd6`;97个部署文件与最终包一致。
|
||||
|
||||
### 人工反馈:更新检查工具栏样式
|
||||
|
||||
搜索与操作同行,筛选改为紧凑按钮组,摘要合并且隐藏初始零统计与零失败。定向7项测试/33断言、build/typecheck/lint通过;真实DSH验证12处安装检查、筛选、失败重试、升级确认取消,以及键盘和明暗/窄屏布局。截图在主题切换稳定后采集并人工查看。无模型调用、无安装执行。补充证据见外部 `dsh-update-overview-20261028/toolbar/`;此前跨工作区Host验收边界不变。
|
||||
|
||||
### 统一检查更新:性能整改
|
||||
|
||||
统一检查改为DSH私有begin/check/end轮次,可信库存每轮读取一次并索引;逐目标复核保留,库存文件身份或上下文变化使整轮失效。同技能远端resolve每轮去重,Host实际并发最多3。轮次数量最多4、空闲60秒/硬上限30分钟;取消初始化时保留槽至真实构建结束,避免槽外堆积。原单项检查与升级准备完整验证不变;不新增Registry/SaaS协议或CLI命令。
|
||||
|
||||
真实临时文件系统10/100/500处安装:库存读取均1次,metadata读取30/300/1500次,库存stat43/403/2003次;快照与核验耗时35/186/838ms,仅为本机观测,不包含网络。Host受控远端对应resolve5/50/250次(每技能两位置),额外验证12并发调用实际远端不超过3;未测旧版500项墙钟耗时或生产SaaS负载。
|
||||
|
||||
最终插件build/typecheck/lint和636测试/12451断言通过;CLI共享核心build/typecheck/lint和809测试/3578断言通过。独立复审18项定向测试通过,无剩余阻断。覆盖库存ABA/原子替换/metadata变化、会话与来源上下文、TTL、取消和初始化槽位保护。
|
||||
|
||||
真实DSH最终包两轮12/12扫描通过;等待begin返回时取消,迟到响应不启动检查,随后重扫成功。混合结果/失败重试/详情往返/原升级确认取消及主题窄屏在同逻辑候选包验证,最终补丁只修初始化取消槽位。实际Host跨工作区切换仍未完成,组件竞态验证单独记录。无模型调用、无安装执行,47份本轮基线文件不变;历史release-checklist已在本轮前被调整,未覆盖用户状态。
|
||||
|
||||
最终包SHA256 `2befcc2fd11e9da294183afe8b9e5c3f3d9dfb291b0c0072114fc22e76fce130`,97个运行文件与包一致。外部证据 `dsh-update-overview-20261028/performance/summary.md`、`review.md`、`browser/acceptance.md`、`browser/final-validation.md`。未提交、推送或发布。
|
||||
|
|
|
|||
|
|
@ -238,3 +238,5 @@ Installation locations in the detail view expose secondary actions through a Mor
|
|||
Detail installation checks use a dismissible top-right notification. Ordinary success expires after five seconds; conflicts and failures remain dismissible. Repeated checks replace the notification, and leaving the skill clears it. Upgrade candidates and safety blocks stay in the installation row.
|
||||
|
||||
Check notifications use a scope/version heading and one concise conclusion. Installation scope is directly visible without an advanced disclosure. Confirmation, progress and completion share a stable two-column layout (stacked on narrow screens), with a separate use action after completion. Default scope selection is unchanged.
|
||||
|
||||
The installed page supports an explicit update check with up to three concurrent read-only requests and a 30-second timeout per installation. Progress, distinct upgradable skill counts, failed installation counts, filters, and failed-only retry are shown progressively. Opening details or leaving the list cancels pending checks; returning from details retains valid completed results. Source, session, workspace, or installation-reference changes invalidate old results. Details show checked target versions per location; execution still revalidates the target. Updates still require confirmation for the exact installation in details.
|
||||
|
|
|
|||
|
|
@ -239,3 +239,5 @@ dsh plugin --profile skillhub-test remove @astron-team/skillhub-dsh
|
|||
详情标题旁“在官网查看”仅使用详情API返回的可选`webUrl`。字段缺失、null、空白或不安全时隐藏按钮,详情与安装照常使用。插件不再提供网站地址配置、不拼路由、不从Registry回退;旧`websiteUrl`配置忽略。开源服务端复用可信`SKILLHUB_PUBLIC_BASE_URL`生成完整地址,未配置合法网站基址则返回null。SaaS需单独同步此可选字段。
|
||||
|
||||
安装确认直接展示安装范围,默认范围规则不变。确认、进行中与成功共用稳定的双栏布局,小屏自动纵排;右侧在提交前显示等待提示,完成后使用按钮与进度条分开显示。
|
||||
|
||||
已安装页可主动“检查更新”,以最多 3 个并发检查当前可见的安装位置,并渐进显示进度、可更新技能数与失败位置数;支持关键词叠加全部/可更新/检查失败筛选及失败重试。每项检查最多等待 30 秒,失败不会视为已最新。打开详情或离开列表会取消在途检查,详情返回保留仍有效的结果;来源、会话、工作区或安装引用变化后旧结果失效;进入详情后按位置展示已检查的目标版本,执行前仍重新核验。检查只读,更新仍需在详情按具体位置确认。
|
||||
|
|
|
|||
|
|
@ -1,3 +1,4 @@
|
|||
import { installedContext } from './installed-context.js';
|
||||
import { ManagementToolView, type ManagementViewServices } from './management-tool-view.js';
|
||||
import { SkillDraftRetentions } from './use-skill-drafts.js';
|
||||
import { newSkillConversation } from './use-skill-navigation.js';
|
||||
|
|
@ -255,7 +256,7 @@ export async function apply(ctx: Context): Promise<() => Promise<void>> {
|
|||
}, ({ renderSlot }) => renderSlot('skillhub.catalog', {})));
|
||||
ctx.slots.inject('skillhub.catalog', () => ctx.slots.register({ name: 'skillhub.catalog',
|
||||
inject: sessionId => ({ installation: sessionId ? installationFor(sessionId, true) : undefined,
|
||||
installed: sessionId ? { sessionId, management: managementFor(sessionId), skillUse: useSkills.catalogServices(sessionId), upgradeRequests, removalRequests, compatibility: () => ctx.remote.skillhub.getCompatibility(),
|
||||
installed: sessionId ? { sessionId, context: installedContext(() => ({ scope: ctx.sessions.scope(SessionId(sessionId)), cwd: ctx.sessions.list.getSnapshot().byId[SessionId(sessionId)]?.cwd, active: !!ctx.sessions.list.getSnapshot().byId[SessionId(sessionId)]?.retainedBy.mainView }), listener => ctx.sessions.list.subscribe(listener)), get management() { return managementFor(sessionId); }, skillUse: useSkills.catalogServices(sessionId), upgradeRequests, removalRequests, compatibility: () => ctx.remote.skillhub.getCompatibility(),
|
||||
operation: installationFor(sessionId).operation,
|
||||
recoverOperation: async input => {
|
||||
const scope = ctx.sessions.scope(SessionId(sessionId));
|
||||
|
|
@ -284,6 +285,18 @@ export async function apply(ctx: Context): Promise<() => Promise<void>> {
|
|||
const scope = ctx.sessions.scope(SessionId(sessionId));
|
||||
if (!scope) throw new Error('当前会话已关闭,请重新打开会话。');
|
||||
return withSessionRemote(scope, remote => remote.skillhub.getInstalledDetail(revision, itemKey, signal));
|
||||
}, beginInstalledUpdateScan: async (revision, signal) => {
|
||||
const scope = ctx.sessions.scope(SessionId(sessionId));
|
||||
if (!scope) throw new Error('当前会话已关闭,请重新打开会话。');
|
||||
return withSessionRemote(scope, remote => remote.skillhub.beginInstalledUpdateScan(revision, signal));
|
||||
}, checkInstalledUpdateScan: async (revision, scanId, itemKey, signal) => {
|
||||
const scope = ctx.sessions.scope(SessionId(sessionId));
|
||||
if (!scope) throw new Error('当前会话已关闭,请重新打开会话。');
|
||||
return withSessionRemote(scope, remote => remote.skillhub.checkInstalledUpdateScan(revision, scanId, itemKey, signal));
|
||||
}, endInstalledUpdateScan: async (revision, scanId) => {
|
||||
const scope = ctx.sessions.scope(SessionId(sessionId));
|
||||
if (!scope) throw new Error('当前会话已关闭,请重新打开会话。');
|
||||
return withSessionRemote(scope, remote => remote.skillhub.endInstalledUpdateScan(revision, scanId));
|
||||
}, checkUpdate: async (revision, itemKey, signal) => {
|
||||
const scope = ctx.sessions.scope(SessionId(sessionId));
|
||||
if (!scope) throw new Error('当前会话已关闭,请重新打开会话。');
|
||||
|
|
|
|||
13
plugins/dsh/src/client/installed-context.ts
Normal file
13
plugins/dsh/src/client/installed-context.ts
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
/** A monotonic read context prevents A → B → A from reviving earlier scans. */
|
||||
export function installedContext(read: () => { scope: unknown; cwd: string | undefined; active: boolean }, subscribe: (listener: () => void) => () => void) {
|
||||
let previous = read();
|
||||
let generation = 0;
|
||||
const getSnapshot = () => {
|
||||
const next = read();
|
||||
if (next.scope !== previous.scope || next.cwd !== previous.cwd || next.active !== previous.active) {
|
||||
previous = next; generation++;
|
||||
}
|
||||
return generation;
|
||||
};
|
||||
return { getSnapshot, subscribe: (listener: () => void) => subscribe(() => { getSnapshot(); listener(); }) };
|
||||
}
|
||||
|
|
@ -1,9 +1,10 @@
|
|||
import { checkInstalledUpdates, updateFailed, type UpdateResult } from './update-overview.js';
|
||||
import { SkillWebsiteLink } from './skill-website-link.js';
|
||||
import { groupManagementItems, InstallationManagement, type ManagementViewServices } from './management-tool-view.js';
|
||||
import { SkillPrimaryActions, skillInstallationSummary } from './skill-primary-actions.js';
|
||||
import type { SkillUseServices } from './use-skill.js';
|
||||
import { CardSkeletons } from './loading-layout.js';
|
||||
import { useState, useRef, useLayoutEffect, type RefObject } from 'react';
|
||||
import { useState, useRef, useLayoutEffect, useSyncExternalStore, type RefObject } from 'react';
|
||||
import { useQuery } from '@tanstack/react-query';
|
||||
import type { RemoteResult, TypertRemoteNamespaceMap } from '@deepseek-ai/dsh-typert-protocol';
|
||||
import type { InstalledSkillList, InstalledSkillDetail, InstalledUpdateCheck, SkillHubConfig } from '../host/types.js';
|
||||
|
|
@ -19,16 +20,25 @@ import { SkillAvatar } from './skill-card.js';
|
|||
export interface InstalledServices extends UpgradeServices, RemovalServices {
|
||||
management?: ManagementViewServices;
|
||||
sessionId: string;
|
||||
context?: { getSnapshot(): number; subscribe(listener: () => void): () => void };
|
||||
skillUse?: SkillUseServices;
|
||||
list(sourceRevision: string, signal: AbortSignal): Promise<RemoteResult<InstalledSkillList>>;
|
||||
detail(sourceRevision: string, itemKey: string, signal: AbortSignal): Promise<RemoteResult<InstalledSkillDetail>>;
|
||||
beginInstalledUpdateScan(sourceRevision: string, signal: AbortSignal): Promise<RemoteResult<{ scanId: string; itemKeys: string[] }>>;
|
||||
checkInstalledUpdateScan(sourceRevision: string, scanId: string, itemKey: string, signal: AbortSignal): Promise<RemoteResult<InstalledUpdateCheck>>;
|
||||
endInstalledUpdateScan(sourceRevision: string, scanId: string): Promise<RemoteResult<void>>;
|
||||
checkUpdate(sourceRevision: string, itemKey: string, signal: AbortSignal): Promise<RemoteResult<InstalledUpdateCheck>>;
|
||||
}
|
||||
type Item = InstalledSkillList['items'][number];
|
||||
const noContext = { getSnapshot: () => 0, subscribe: () => () => {} };
|
||||
export function InstalledSkills({ services, sourceRevision, source, remote, modes, scrollContainer, navigation, onInstall }: {
|
||||
services: InstalledServices; sourceRevision: string; source: string; remote: TypertRemoteNamespaceMap['skillhub']; modes: SkillHubConfig['detailTabs'];
|
||||
scrollContainer: RefObject<HTMLElement>; navigation: InstalledNavigation; onInstall?(item: Item): void; onRemove?(item: Item): void; onUpgrade?(item: Item): void;
|
||||
}) {
|
||||
const context = services.context ?? noContext;
|
||||
const generation = useSyncExternalStore(context.subscribe, context.getSnapshot, context.getSnapshot);
|
||||
const contextKey = JSON.stringify([services.sessionId, sourceRevision, generation]);
|
||||
const resultContext = useRef(contextKey);
|
||||
const [keyword, setKeyword] = useState(navigation.keyword);
|
||||
const [selected, setSelected] = useState(navigation.selected);
|
||||
const heading = useRef<HTMLHeadingElement>(null);
|
||||
|
|
@ -44,13 +54,13 @@ export function InstalledSkills({ services, sourceRevision, source, remote, mode
|
|||
if (scrollContainer.current) scrollContainer.current.scrollTop = listScroll.current;
|
||||
}
|
||||
}, [selected, scrollContainer]);
|
||||
const query = useQuery({ queryKey: ['skillhub-installed', services.sessionId, sourceRevision], retry: false,
|
||||
const query = useQuery({ queryKey: ['skillhub-installed', services.sessionId, sourceRevision, ...(services.context ? [generation] : [])], retry: false,
|
||||
queryFn: async ({ signal }) => {
|
||||
const response = await services.list(sourceRevision, signal);
|
||||
if (!response.ok) throw new Error('会话或来源已变化,请重新读取已安装技能。');
|
||||
return response.value;
|
||||
} });
|
||||
const detail = useQuery({ ...readCacheOptions, queryKey: ['skillhub-installed-detail', services.sessionId, sourceRevision, selected?.itemKey],
|
||||
const detail = useQuery({ ...readCacheOptions, queryKey: ['skillhub-installed-detail', services.sessionId, sourceRevision, selected?.itemKey, ...(services.context ? [generation] : [])],
|
||||
enabled: !!selected, retry: false, queryFn: async ({ signal }) => {
|
||||
const response = await services.detail(sourceRevision, selected!.itemKey, signal);
|
||||
if (!response.ok) throw new Error('安装记录已变化或暂时无法读取,请返回列表刷新。');
|
||||
|
|
@ -61,6 +71,73 @@ export function InstalledSkills({ services, sourceRevision, source, remote, mode
|
|||
const actions = (items: Item[], label?: string) => <SkillPrimaryActions items={items} revision={sourceRevision} verified={verified}
|
||||
select={services.management?.selectSkillUse} useSkill={services.skillUse} onManage={!label ? () => { const identity = items[0]; if (identity) { listScroll.current = scrollContainer.current?.scrollTop ?? 0; setSelected(identity); } } : undefined} label={label} summaryVisible={!label} />;
|
||||
|
||||
const [results, setResults] = useState<Record<string, UpdateResult>>({});
|
||||
const [filter, setFilter] = useState('all');
|
||||
const [progress, setProgress] = useState({ done: 0, total: 0, running: false });
|
||||
const scan = useRef<AbortController | null>(null);
|
||||
const inventoryKey = JSON.stringify((query.data?.items ?? []).map(item => item.itemKey).sort());
|
||||
useLayoutEffect(() => {
|
||||
scan.current?.abort(); scan.current = null;
|
||||
const contextChanged = resultContext.current !== contextKey;
|
||||
resultContext.current = contextKey;
|
||||
if (contextChanged) { setSelected(null); setKeyword(''); setFilter('all'); }
|
||||
setResults(previous => contextChanged ? {} : Object.fromEntries(Object.entries(previous).filter(([key]) => (query.data?.items ?? []).some(item => item.itemKey === key))));
|
||||
setProgress({ done: 0, total: 0, running: false });
|
||||
return () => { scan.current?.abort(); scan.current = null; };
|
||||
}, [inventoryKey, contextKey]);
|
||||
useLayoutEffect(() => {
|
||||
if (selected) { scan.current?.abort(); scan.current = null; setProgress(previous => ({ ...previous, running: false })); }
|
||||
}, [selected]);
|
||||
const startCheck = (retry = false) => {
|
||||
if (scan.current || query.isFetching || query.isError) return;
|
||||
const keys = (query.data?.items ?? []).map(item => item.itemKey).filter(key => !retry || updateFailed(results[key]));
|
||||
if (!keys.length) return;
|
||||
const controller = new AbortController(); scan.current = controller;
|
||||
const scanGeneration = context.getSnapshot();
|
||||
setResults(previous => Object.fromEntries(Object.entries(previous).filter(([key]) => !keys.includes(key))));
|
||||
setProgress({ done: 0, total: keys.length, running: true });
|
||||
void (async () => {
|
||||
let scanId: string | undefined;
|
||||
const end = () => { if (scanId) void services.endInstalledUpdateScan(sourceRevision, scanId).catch(() => {}); };
|
||||
controller.signal.addEventListener('abort', end, { once: true });
|
||||
try {
|
||||
const begun = await services.beginInstalledUpdateScan(sourceRevision, controller.signal);
|
||||
if (!begun.ok) throw new Error('scan failed');
|
||||
scanId = begun.value.scanId;
|
||||
controller.signal.throwIfAborted();
|
||||
const accepted = new Set(begun.value.itemKeys);
|
||||
const stale = () => {
|
||||
controller.abort();
|
||||
if (scan.current === controller && context.getSnapshot() === scanGeneration) {
|
||||
setResults(Object.fromEntries(keys.map(key => [key, { state: 'failed' as const }])));
|
||||
setProgress({ done: keys.length, total: keys.length, running: false });
|
||||
}
|
||||
};
|
||||
await checkInstalledUpdates(keys, async (key, signal) => {
|
||||
if (context.getSnapshot() !== scanGeneration) { controller.abort(); throw new Error('context changed'); }
|
||||
if (!accepted.has(key)) { stale(); throw new Error('installed record changed'); }
|
||||
const response = await services.checkInstalledUpdateScan(sourceRevision, scanId!, key, signal);
|
||||
if (!response.ok) { if (response.error.code === 'skillhub/context-stale') stale(); throw new Error('check failed'); }
|
||||
return response.value;
|
||||
}, controller.signal, (key, result) => {
|
||||
if (scan.current !== controller || context.getSnapshot() !== scanGeneration) return;
|
||||
setResults(previous => ({ ...previous, [key]: result }));
|
||||
setProgress(previous => ({ ...previous, done: previous.done + 1 }));
|
||||
});
|
||||
} catch {
|
||||
if (scan.current === controller && !controller.signal.aborted) {
|
||||
setResults(previous => ({ ...previous, ...Object.fromEntries(keys.map(key => [key, { state: 'failed' as const }])) }));
|
||||
setProgress(previous => ({ ...previous, done: keys.length }));
|
||||
}
|
||||
} finally { controller.signal.removeEventListener('abort', end); end(); }
|
||||
})().finally(() => {
|
||||
if (scan.current === controller) { scan.current = null; setProgress(previous => ({ ...previous, running: false })); }
|
||||
});
|
||||
};
|
||||
const allGroups = groupManagementItems(query.data?.items ?? []);
|
||||
const upgradable = allGroups.filter(items => items.some(item => results[item.itemKey]?.state === 'upgradable')).length;
|
||||
const failures = (query.data?.items ?? []).filter(item => updateFailed(results[item.itemKey])).length;
|
||||
|
||||
const detailVerified = !!detail.data && !detail.isError && !detail.isFetching;
|
||||
if (selected) return <section className="skillhub-installed skillhub-controls" aria-label="已安装技能详情">
|
||||
<InstalledStyles />
|
||||
|
|
@ -73,29 +150,42 @@ export function InstalledSkills({ services, sourceRevision, source, remote, mode
|
|||
: detail.isError ? <p role="alert">{detail.error.message}</p>
|
||||
: detail.data.content.state === 'local-only' ? <p role="status">远端说明暂不可用,可在管理安装中查看本地状态。</p>
|
||||
: <DetailContent detail={detail.data.content.detail} modes={modes} remote={remote} retry={() => { void detail.refetch(); }} cacheIdentity={JSON.stringify([services.sessionId, sourceRevision, selected.namespace, selected.slug, detail.data.content.detail.version])} onContextStale={() => { void detail.refetch(); }} />}
|
||||
</article><aside className="astron-sh-detail-aside">{services.management && <InstallationManagement identity={selected} revision={sourceRevision} services={services.management} useSkill={services.skillUse} onInstall={onInstall ? () => onInstall(selected) : undefined} />}</aside></div>
|
||||
</article><aside className="astron-sh-detail-aside">{services.management && <InstallationManagement identity={selected} revision={sourceRevision} services={services.management} updateChecks={Object.fromEntries(Object.entries(results).filter((entry): entry is [string, InstalledUpdateCheck] => entry[1].state !== 'failed'))} useSkill={services.skillUse} onInstall={onInstall ? () => onInstall(selected) : undefined} />}</aside></div>
|
||||
</section>;
|
||||
const term = keyword.trim().toLocaleLowerCase();
|
||||
const groups = groupManagementItems(query.data?.items ?? []).filter(items => !term || items.some(item => `@${item.namespace}/${item.slug} ${item.version}`.toLocaleLowerCase().includes(term)));
|
||||
const groups = allGroups.filter(items => filter === 'all' || items.some(item => filter === 'updates' ? results[item.itemKey]?.state === 'upgradable' : updateFailed(results[item.itemKey]))).filter(items => !term || items.some(item => `@${item.namespace}/${item.slug} ${item.version}`.toLocaleLowerCase().includes(term)));
|
||||
return <section className="skillhub-installed skillhub-controls" aria-label="已安装技能">
|
||||
<InstalledStyles />
|
||||
<div className="skillhub-installed-toolbar"><label className="skillhub-installed-search">本地过滤
|
||||
<input type="search" aria-label="过滤已安装技能" placeholder="名称、命名空间或已安装版本" value={keyword} onChange={event => setKeyword(event.target.value)} />
|
||||
<div className="skillhub-installed-toolbar"><label className="skillhub-installed-search">
|
||||
<input type="search" aria-label="过滤已安装技能" placeholder="搜索已安装技能" value={keyword} onChange={event => setKeyword(event.target.value)} />
|
||||
</label><Button ref={refreshButton} onClick={() => { void query.refetch(); }} disabled={query.isFetching}>刷新已安装</Button>
|
||||
{keyword && <Button variant="ghost" onClick={() => setKeyword('')}>清空过滤</Button>}</div>
|
||||
{keyword && <Button variant="ghost" onClick={() => setKeyword('')}>清空过滤</Button>}
|
||||
<Button onClick={() => startCheck()} disabled={progress.running || query.isFetching || query.isError || !query.data?.items.length}>检查更新</Button>
|
||||
{progress.running && <Button variant="ghost" onClick={() => { scan.current?.abort(); scan.current = null; setProgress(previous => ({ ...previous, running: false })); }}>取消检查</Button>}
|
||||
{failures > 0 && <Button onClick={() => startCheck(true)} disabled={progress.running || query.isFetching}>重试失败项</Button>}
|
||||
</div>
|
||||
<div className="skillhub-installed-summary">
|
||||
<div className="skillhub-installed-filters" role="group" aria-label="更新筛选">
|
||||
{([['all', '全部'], ['updates', '可更新'], ['failed', '检查失败']] as const).map(([value, label]) => <Button key={value} size="sm" variant={filter === value ? 'outline' : 'ghost'} aria-pressed={filter === value} onClick={() => setFilter(value)}>{label}</Button>)}
|
||||
</div>
|
||||
<p role="status">{progress.total > 0 ? `${progress.running ? '检查中' : progress.done < progress.total ? '已停止' : '已检查'} ${progress.done}/${progress.total}${upgradable ? ` · ${upgradable} 个技能可更新` : ''}${failures ? ` · ${failures} 处检查失败` : ''}` : `${groups.length} 个技能`}</p>
|
||||
</div>
|
||||
{query.isPending ? <CardSkeletons message="正在读取已安装技能…" /> : query.isError ? <p role="alert">{query.error.message}</p> : <>
|
||||
{(!query.data.complete || query.data.unavailable.length > 0) && <p role="alert">部分安装记录无法读取,列表可能不完整。</p>}
|
||||
<p role="status">当前显示 {groups.length} 个技能。</p>
|
||||
{!groups.length ? <p className="skillhub-installed-empty">{term ? '没有匹配的技能。' : verified ? '当前来源暂无已安装技能。' : '暂未读取到安装记录。'}</p>
|
||||
{!groups.length ? <p className="skillhub-installed-empty">{term || filter !== 'all' ? '没有匹配的技能。' : verified ? '当前来源暂无已安装技能。' : '暂未读取到安装记录。'}</p>
|
||||
: <div className="astron-sh-card-grid" aria-label="已安装技能列表">{groups.map(items => {
|
||||
const identity = items[0]!;
|
||||
return <Card className="astron-sh-installed-card" key={JSON.stringify([identity.namespace, identity.slug])}>
|
||||
<CardHeader className="astron-sh-skill-heading"><SkillAvatar slug={identity.slug} namespace={identity.namespace} /><div><h3>{identity.slug}</h3><span>@{identity.namespace}/{identity.slug}</span></div></CardHeader>
|
||||
<CardContent><span>{skillInstallationSummary(items)}</span></CardContent>
|
||||
<CardContent><span>{skillInstallationSummary(items)}</span>
|
||||
{items.some(item => results[item.itemKey]?.state === 'upgradable') && <p>{items.length > 1 ? '多位置安装有更新' : `可更新至 ${(() => { const result = results[identity.itemKey]; return result && 'candidateVersion' in result ? result.candidateVersion ?? '新版本' : '新版本'; })()}`}</p>}
|
||||
{items.some(item => results[item.itemKey]?.state === 'blocked') && <p>更新需处理,请查看安装状态。</p>}
|
||||
{items.some(item => updateFailed(results[item.itemKey])) && <p>部分安装位置检查失败,可重试。</p>}
|
||||
</CardContent>
|
||||
<CardFooter className="skillhub-installed-actions">{actions(items)}<Button variant="ghost" onClick={event => {
|
||||
// This record selects documentation only; use always resolves the actual winner on the Host.
|
||||
listScroll.current = scrollContainer.current?.scrollTop ?? 0; trigger.current = event.currentTarget; setSelected(identity);
|
||||
}}>详情</Button></CardFooter>
|
||||
}}>{items.some(item => results[item.itemKey]?.state === 'upgradable') ? '查看更新' : '详情'}</Button></CardFooter>
|
||||
</Card>;
|
||||
})}</div>}
|
||||
</>}
|
||||
|
|
|
|||
|
|
@ -3,9 +3,15 @@ import { NativeControlStyles } from './native-control-styles.js';
|
|||
export function InstalledStyles() {
|
||||
return <><NativeControlStyles /><style>{`
|
||||
.skillhub-installed { container-type: inline-size; line-height: 1.6; overflow-wrap: anywhere; }
|
||||
.skillhub-installed .skillhub-installed-toolbar { display:flex;align-items:end;gap:12px;flex-wrap:wrap; }
|
||||
.skillhub-installed .skillhub-installed-toolbar { display:flex;align-items:center;gap:12px;flex-wrap:wrap; }
|
||||
.skillhub-installed .skillhub-installed-toolbar label { display:grid;gap:6px;font-size:14px; }
|
||||
.skillhub-installed .skillhub-installed-search { flex:1 1 240px; }
|
||||
.skillhub-installed .skillhub-installed-toolbar { margin-bottom:12px; }
|
||||
.skillhub-installed .skillhub-installed-toolbar button { margin:0;white-space:nowrap; }
|
||||
.skillhub-installed .skillhub-installed-summary { display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap;margin-bottom:20px; }
|
||||
.skillhub-installed .skillhub-installed-summary p { margin:0;color:var(--astron-sh-muted);font-size:13px; }
|
||||
.skillhub-installed .skillhub-installed-filters { display:flex;gap:4px; }
|
||||
.skillhub-installed .skillhub-installed-filters button { margin:0; }
|
||||
.skillhub-installed .skillhub-installed-note { font-size:13px;color:var(--astron-sh-muted);margin-block:16px; }
|
||||
.skillhub-installed .astron-sh-installed-card { display:flex;flex-direction:column;min-width:0; }
|
||||
.skillhub-installed .astron-sh-installed-card .astron-sh-card-content { padding:0 18px 18px;font-size:13px; }
|
||||
|
|
|
|||
|
|
@ -201,8 +201,8 @@ function ManagementGroup({ items, revision, services, verified }: { items: Item[
|
|||
}
|
||||
|
||||
/** Read-only position inventory rendered directly in a skill detail, never a management modal. */
|
||||
export function InstallationManagement({ identity, revision, services, useSkill, onInstall, onUsed }: {
|
||||
identity: Pick<Item, 'namespace' | 'slug'>; revision: string; services: ManagementViewServices; onInstall?(): void; onUsed?(): void; useSkill?: import('./use-skill.js').SkillUseServices;
|
||||
export function InstallationManagement({ identity, revision, services, useSkill, onInstall, onUsed, updateChecks }: {
|
||||
updateChecks?: Record<string, InstalledUpdateCheck>; identity: Pick<Item, 'namespace' | 'slug'>; revision: string; services: ManagementViewServices; onInstall?(): void; onUsed?(): void; useSkill?: import('./use-skill.js').SkillUseServices;
|
||||
}) {
|
||||
const [receipt, setReceipt] = useState<ConversationManagementResult>();
|
||||
const [container, setContainer] = useState<HTMLElement | null>(null);
|
||||
|
|
@ -217,7 +217,7 @@ export function InstallationManagement({ identity, revision, services, useSkill,
|
|||
<ManagementNoticeBoundary container={container} key={`${revision}:${identity.namespace}/${identity.slug}:${services.installation.sessionId}`}><h3>安装管理</h3>
|
||||
{query.isPending ? <p role="status">正在读取安装位置…</p> : query.isError ? <p role="alert">安装记录暂不可用。<Button size="sm" variant="ghost" onClick={() => void query.refetch()}>重新读取</Button></p> : <>
|
||||
{(!query.data.complete || query.data.unavailable.length > 0) && <p role="alert">部分位置无法读取,以下记录可能不完整。</p>}
|
||||
<ManagementLocations items={query.data.items.filter(item => item.namespace === identity.namespace && item.slug === identity.slug)} revision={revision} services={scoped} onUsed={onUsed} onManagement={setReceipt} />
|
||||
<ManagementLocations items={query.data.items.filter(item => item.namespace === identity.namespace && item.slug === identity.slug)} revision={revision} services={scoped} updateChecks={updateChecks} onUsed={onUsed} onManagement={setReceipt} />
|
||||
</>}
|
||||
{onInstall && <Button size="sm" variant="outline" onClick={onInstall}>安装其他位置</Button>}
|
||||
{receipt && container && <Dialog open onOpenChange={open => { if (!open) setReceipt(undefined); }}><DialogContent container={container}>
|
||||
|
|
@ -228,14 +228,14 @@ export function InstallationManagement({ identity, revision, services, useSkill,
|
|||
</DialogContent></Dialog>}
|
||||
</ManagementNoticeBoundary></section>;
|
||||
}
|
||||
export function ManagementLocations({ items, revision, services, onUsed, onManagement }: {
|
||||
items: Item[]; revision: string; services: ManagementViewServices; onUsed?(): void; onManagement?(result: ConversationManagementResult): void;
|
||||
export function ManagementLocations({ items, revision, services, onUsed, onManagement, updateChecks }: {
|
||||
items: Item[]; updateChecks?: Record<string, InstalledUpdateCheck>; revision: string; services: ManagementViewServices; onUsed?(): void; onManagement?(result: ConversationManagementResult): void;
|
||||
}) {
|
||||
return <>{!items.length && <p role="status">该技能暂无安装记录。</p>}{items.map(item => {
|
||||
const label = managementTargetLabel(items, item).replace('当前用户', '所有项目').replace('当前项目', '仅此项目');
|
||||
return <section key={item.locationKey ?? item.itemKey} className="astron-sh-management-location-row" aria-label={`${label} v${item.version}`}>
|
||||
<header><h4>{label}</h4><span>v{item.version}</span><span>{item.state === 'present' ? item.installationState === 'disabled' ? '已停用' : '已启用' : '安装待核验'}</span></header>
|
||||
<ManagementRow key={item.itemKey} item={item} revision={revision} services={services} grouped targetLabel={label} expanded onUsed={onUsed} onManagement={onManagement} />
|
||||
<ManagementRow key={item.itemKey} item={item} revision={revision} services={services} initialCheck={updateChecks?.[item.itemKey]} grouped targetLabel={label} expanded onUsed={onUsed} onManagement={onManagement} />
|
||||
</section>;
|
||||
})}</>;
|
||||
}
|
||||
|
|
|
|||
31
plugins/dsh/src/client/update-overview.ts
Normal file
31
plugins/dsh/src/client/update-overview.ts
Normal file
|
|
@ -0,0 +1,31 @@
|
|||
import type { InstalledUpdateCheck } from '../host/types.js';
|
||||
|
||||
export type UpdateResult = InstalledUpdateCheck | { state: 'failed' };
|
||||
/** Bounded read-only queue. Cancellation and timeouts settle even if a transport ignores abort. */
|
||||
export async function checkInstalledUpdates(keys: string[], check: (key: string, signal: AbortSignal) => Promise<InstalledUpdateCheck>, signal: AbortSignal,
|
||||
receive: (key: string, result: UpdateResult) => void, timeoutMs = 30_000) {
|
||||
let cursor = 0;
|
||||
async function worker() {
|
||||
while (!signal.aborted && cursor < keys.length) {
|
||||
const key = keys[cursor++]!;
|
||||
const controller = new AbortController();
|
||||
let timer: ReturnType<typeof setTimeout> | undefined;
|
||||
let cancel = () => {};
|
||||
try {
|
||||
const interrupted = new Promise<never>((_, reject) => {
|
||||
cancel = () => { controller.abort(); reject(new Error('cancelled')); };
|
||||
signal.addEventListener('abort', cancel, { once: true });
|
||||
timer = setTimeout(cancel, timeoutMs);
|
||||
});
|
||||
const result = await Promise.race([check(key, controller.signal), interrupted]);
|
||||
if (!signal.aborted) receive(key, result);
|
||||
} catch {
|
||||
if (!signal.aborted) receive(key, { state: 'failed' });
|
||||
} finally {
|
||||
clearTimeout(timer); signal.removeEventListener('abort', cancel);
|
||||
}
|
||||
}
|
||||
}
|
||||
await Promise.all(Array.from({ length: Math.min(3, keys.length) }, worker));
|
||||
}
|
||||
export const updateFailed = (result?: UpdateResult) => result?.state === 'failed' || result?.state === 'unavailable';
|
||||
|
|
@ -69,6 +69,10 @@ export class SkillHubService extends TypertRemoteService {
|
|||
private readonly upgradePlans = new UpgradePlans();
|
||||
private readonly removalPlans = new RemovalPlans();
|
||||
private readonly togglePlans = new TogglePlans();
|
||||
private readonly installedUpdateScans = new Map<string, {
|
||||
sourceRevision: string; agentId: string; valid(): void; close(): void;
|
||||
check(key: string, signal: AbortSignal): Promise<InstalledUpdateCheck>;
|
||||
}>();
|
||||
private readonly installedReferenceKey = randomBytes(32);
|
||||
private readonly capabilities = new Map<string, ModuleAvailability>();
|
||||
private readonly details = new Map<string, {
|
||||
|
|
@ -105,7 +109,7 @@ export class SkillHubService extends TypertRemoteService {
|
|||
ctx.effect(() => registerSearchTool(ctx.tools, (query, context, signal) => this.searchConversation(query, context, signal)));
|
||||
ctx.effect(() => registerInstallTool(ctx.tools, (request, context, signal) => this.installConversationWithChoice(request, context, signal)));
|
||||
});
|
||||
ctx.effect(() => () => { this.lifetime.abort(); this.pendingConversationInstalls.clear(); this.pendingConversationChoices.clear(); this.managementRequests.clear(); this.managementConfirmations.clear(); this.details.clear(); this.capabilities.clear(); this.selections.clear(); this.installationTargets.clear(); this.upgradePlans.clear(); this.removalPlans.clear(); this.togglePlans.clear(); });
|
||||
ctx.effect(() => () => { this.lifetime.abort(); for (const scan of this.installedUpdateScans.values()) scan.close(); this.pendingConversationInstalls.clear(); this.pendingConversationChoices.clear(); this.managementRequests.clear(); this.managementConfirmations.clear(); this.details.clear(); this.capabilities.clear(); this.selections.clear(); this.installationTargets.clear(); this.upgradePlans.clear(); this.removalPlans.clear(); this.togglePlans.clear(); });
|
||||
}
|
||||
|
||||
/** Internal diagnostics, deliberately not a Remote method. */
|
||||
|
|
@ -541,6 +545,127 @@ export class SkillHubService extends TypertRemoteService {
|
|||
return { item: { itemKey, namespace: item.namespace, slug: item.slug, version: item.version, scope: item.scope, state: item.state }, content };
|
||||
}
|
||||
|
||||
@RemoteScope('agent')
|
||||
async beginInstalledUpdateScan(sourceRevision: string, signal: AbortSignal): Promise<{ scanId: string; itemKeys: string[] }> {
|
||||
this.assertSource(sourceRevision);
|
||||
const agentId = this.ctx.invocation?.request.args.agentId;
|
||||
const agent = typeof agentId === 'string' ? this.ctx.get('agents')?.get(SessionId(agentId)) : undefined;
|
||||
const runtime = this.localRuntime;
|
||||
const fs = agent?.ctx.get('fs');
|
||||
const cwd = agent?.session.header.cwd;
|
||||
const sessionId = agent?.session.id;
|
||||
const controller = new AbortController();
|
||||
const scanId = randomUUID();
|
||||
const combined = AbortSignal.any([controller.signal, this.lifetime.signal]);
|
||||
let timer: ReturnType<typeof setTimeout> | undefined;
|
||||
const deadline = Date.now() + 30 * 60_000;
|
||||
let expiresAt = Date.now() + 60_000;
|
||||
const touch = () => {
|
||||
clearTimeout(timer);
|
||||
expiresAt = Math.min(Date.now() + 60_000, deadline);
|
||||
timer = setTimeout(close, Math.max(0, expiresAt - Date.now())); timer.unref();
|
||||
};
|
||||
let initializing = true;
|
||||
const close = () => {
|
||||
controller.abort(); clearTimeout(timer);
|
||||
// Keep the reserved slot until uncancellable filesystem initialization settles.
|
||||
if (!initializing) this.installedUpdateScans.delete(scanId);
|
||||
};
|
||||
const valid = () => {
|
||||
if (Date.now() >= expiresAt) close();
|
||||
combined.throwIfAborted(); this.assertSource(sourceRevision);
|
||||
if (!agent || !runtime || !fs || !cwd || agent.session.id !== sessionId || agent.session.header.cwd !== cwd
|
||||
|| this.ctx.get('agents')?.get(SessionId(sessionId!)) !== agent || this.localRuntime !== runtime
|
||||
|| serviceIdentity(agent.ctx.get('fs')) !== serviceIdentity(fs)) throw new RemoteError('skillhub/context-stale', 'Update scan context changed.', { retryable: false });
|
||||
};
|
||||
valid(); signal.throwIfAborted();
|
||||
if (this.installedUpdateScans.size >= 4) throw new RemoteError('skillhub/context-stale', 'Too many update scans.', { retryable: false });
|
||||
// Reserve the slot before asynchronous snapshot creation; abandoned begins also expire.
|
||||
this.installedUpdateScans.set(scanId, { sourceRevision, agentId: String(agentId), valid, close,
|
||||
check: async () => { throw new Error('Update scan is initializing'); } });
|
||||
touch();
|
||||
const abort = () => close(); signal.addEventListener('abort', abort, { once: true });
|
||||
try {
|
||||
const roots: Awaited<ReturnType<typeof resolveInstalledPath>>[] = [];
|
||||
for (const scope of ['user', 'project'] as const) {
|
||||
try { roots.push(await resolveInstalledPath({ scope, cwd: cwd!, fs: fs!, signal: combined })); }
|
||||
catch { combined.throwIfAborted(); }
|
||||
}
|
||||
const snapshot = await runtime!.openInstalledSnapshot(this.getContext().registryUrl, roots);
|
||||
valid(); signal.throwIfAborted();
|
||||
const items = new Map(snapshot.projection.items.map(item => [this.installedItemKey(sessionId!, cwd!, sourceRevision, item), item]));
|
||||
const candidates = new Map<string, Promise<Awaited<ReturnType<RegistryAdapter['resolve']>>>>();
|
||||
let resolving = 0;
|
||||
const waiters = new Set<() => void>();
|
||||
const resolveCandidate = async (item: InstalledProjectionItem) => {
|
||||
while (resolving >= 3) {
|
||||
combined.throwIfAborted();
|
||||
await new Promise<void>(done => {
|
||||
const wake = () => { waiters.delete(wake); combined.removeEventListener('abort', wake); done(); };
|
||||
waiters.add(wake); combined.addEventListener('abort', wake, { once: true });
|
||||
});
|
||||
}
|
||||
combined.throwIfAborted(); valid(); resolving++;
|
||||
try { return await this.readSource(sourceRevision, combined, (registry, signal) => registry.resolve(item.namespace, item.slug, undefined, signal)); }
|
||||
finally { resolving--; for (const wake of [...waiters]) wake(); }
|
||||
};
|
||||
const read = async (key: string) => {
|
||||
valid();
|
||||
const item = items.get(key);
|
||||
if (!item) throw new Error('Installed reference is not in this scan');
|
||||
const target = await resolveInstalledPath({ scope: item.scope, cwd: cwd!, fs: fs!, signal: combined });
|
||||
if (join(target.root, item.slug) !== item.targetPath) throw new Error('Installed root changed');
|
||||
const current = await snapshot.read(item); valid(); return current;
|
||||
};
|
||||
this.installedUpdateScans.set(scanId, { sourceRevision, agentId: String(agentId), valid, close,
|
||||
check: async (key, itemSignal) => {
|
||||
try {
|
||||
itemSignal.throwIfAborted(); valid(); touch();
|
||||
const item = await read(key);
|
||||
const base = { currentVersion: item.version, candidateVersion: null, checkedAt: new Date().toISOString() };
|
||||
if (item.state !== 'present') return { ...base, state: 'blocked', reason: 'local-record-unverified' };
|
||||
const identity = JSON.stringify([item.namespace, item.slug]);
|
||||
let candidate = candidates.get(identity);
|
||||
if (!candidate) {
|
||||
candidate = resolveCandidate(item);
|
||||
candidates.set(identity, candidate);
|
||||
}
|
||||
const resolved = await candidate.then(value => ({ value }), error => ({ error }));
|
||||
await read(key); itemSignal.throwIfAborted();
|
||||
if ('error' in resolved) return { ...base, state: 'unavailable', reason: installationFailureCode(resolved.error) };
|
||||
const assessment = await runtime!.assessUpdate(item, resolved.value);
|
||||
valid(); itemSignal.throwIfAborted();
|
||||
return { ...assessment, checkedAt: new Date().toISOString() };
|
||||
} catch (error) {
|
||||
if (itemSignal.aborted) throw error;
|
||||
close();
|
||||
throw new RemoteError('skillhub/context-stale', 'Installed update scan changed or expired.', { retryable: false });
|
||||
}
|
||||
} });
|
||||
return { scanId, itemKeys: [...items.keys()] };
|
||||
} catch (error) { close(); throw error; }
|
||||
finally {
|
||||
initializing = false;
|
||||
signal.removeEventListener('abort', abort);
|
||||
if (controller.signal.aborted) this.installedUpdateScans.delete(scanId);
|
||||
}
|
||||
}
|
||||
|
||||
@RemoteScope('agent')
|
||||
async checkInstalledUpdateScan(sourceRevision: string, scanId: string, itemKey: string, signal: AbortSignal): Promise<InstalledUpdateCheck> {
|
||||
const scan = this.installedUpdateScans.get(scanId);
|
||||
if (!scan || scan.sourceRevision !== sourceRevision || scan.agentId !== this.ctx.invocation?.request.args.agentId) {
|
||||
throw new RemoteError('skillhub/context-stale', 'Update scan expired.', { retryable: false });
|
||||
}
|
||||
return scan.check(itemKey, signal);
|
||||
}
|
||||
|
||||
@RemoteScope('agent')
|
||||
async endInstalledUpdateScan(sourceRevision: string, scanId: string): Promise<void> {
|
||||
const scan = this.installedUpdateScans.get(scanId);
|
||||
if (scan?.sourceRevision === sourceRevision && scan.agentId === this.ctx.invocation?.request.args.agentId) scan.close();
|
||||
}
|
||||
|
||||
@RemoteScope('agent')
|
||||
async checkUpdate(sourceRevision: string, itemKey: string, signal: AbortSignal): Promise<InstalledUpdateCheck> {
|
||||
return this.checkUpdateForVersion(sourceRevision, itemKey, undefined, signal);
|
||||
|
|
|
|||
|
|
@ -129,6 +129,10 @@ export class LocalRuntime {
|
|||
return this.call(runtime => runtime.readSkillExamples(directory));
|
||||
}
|
||||
|
||||
openInstalledSnapshot(registry: string, targets: readonly InstalledProjectionTarget[]) {
|
||||
return this.call(runtime => runtime.openInstalledSnapshot(registry, targets));
|
||||
}
|
||||
|
||||
listInstalled(registry: string, targets: readonly InstalledProjectionTarget[]): Promise<InstalledProjection> {
|
||||
const roots = targets.map(target => ({ ...target }));
|
||||
return this.call(runtime => runtime.listInstalled(registry, roots));
|
||||
|
|
|
|||
18
plugins/dsh/test/installed-context.test.ts
Normal file
18
plugins/dsh/test/installed-context.test.ts
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
import { expect, test } from 'bun:test';
|
||||
import { installedContext } from '../src/client/installed-context.js';
|
||||
test('workspace, scope and retention changes invalidate monotonically including A to B to A', () => {
|
||||
const scope = {};
|
||||
let snapshot = { scope, cwd: 'A', active: true };
|
||||
let listener = () => {};
|
||||
const context = installedContext(() => snapshot, next => { listener = next; return () => { listener = () => {}; }; });
|
||||
const seen: number[] = [];
|
||||
const stop = context.subscribe(() => seen.push(context.getSnapshot()));
|
||||
expect(context.getSnapshot()).toBe(0);
|
||||
snapshot = { ...snapshot, cwd: 'B' }; listener();
|
||||
snapshot = { ...snapshot, cwd: 'A' }; listener();
|
||||
snapshot = { ...snapshot, scope: {} }; listener();
|
||||
snapshot = { ...snapshot, active: false }; listener();
|
||||
expect(seen).toEqual([1, 2, 3, 4]);
|
||||
expect(context.getSnapshot()).toBe(4);
|
||||
stop();
|
||||
});
|
||||
156
plugins/dsh/test/installed-update-scan.test.ts
Normal file
156
plugins/dsh/test/installed-update-scan.test.ts
Normal file
|
|
@ -0,0 +1,156 @@
|
|||
import { expect, spyOn, test } from 'bun:test';
|
||||
import { randomBytes } from 'node:crypto';
|
||||
import { mkdtemp, mkdir, realpath, rm } from 'node:fs/promises';
|
||||
import { tmpdir } from 'node:os';
|
||||
import { join } from 'node:path';
|
||||
import SkillHubService from '@astron-team/skillhub-dsh';
|
||||
import type { InstalledProjectionItem } from '../src/host/generated/native-contract.js';
|
||||
|
||||
async function fixture(run: (fixture: ReturnType<typeof setup>) => Promise<void>) {
|
||||
const root = await realpath(await mkdtemp(join(tmpdir(), 'skillhub-round-')));
|
||||
const previous = process.env.DSH_HOME;
|
||||
process.env.DSH_HOME = join(root, 'home');
|
||||
await mkdir(join(root, 'project'));
|
||||
const f = setup(root);
|
||||
try { await run(f); }
|
||||
finally { for (const scan of f.service.installedUpdateScans.values()) scan.close(); if (previous === undefined) delete process.env.DSH_HOME; else process.env.DSH_HOME = previous; await rm(root, { recursive: true, force: true }); }
|
||||
}
|
||||
function setup(root: string) {
|
||||
const fs = { processPathFromHostPath: (path: string) => path, resolve: async (path: string) => ({ displayPath: path }), processPath: (target: { displayPath: string }) => target.displayPath };
|
||||
const session = { id: 'session', header: { cwd: join(root, 'project') } };
|
||||
const agent = { session, ctx: { get: () => fs } };
|
||||
const state = { reads: 0, snapshots: 0, resolves: 0, invalid: false, revision: 'source', currentAgent: agent,
|
||||
resolve: async (signal: AbortSignal) => { signal.throwIfAborted(); return { version: '2.0.0', fingerprint: 'candidate' }; } };
|
||||
const items: InstalledProjectionItem[] = ['user', 'project'].map(scope => ({ scope: scope as 'user' | 'project', namespace: 'demo', slug: 'writer', version: '1.0.0', state: 'present', fingerprint: 'original', installationState: 'enabled', targetPath: join(root, scope === 'user' ? 'home/skills' : 'project/.dsh/skills', 'writer') }));
|
||||
const service = Object.assign(Object.create(SkillHubService.prototype), {
|
||||
lifetime: new AbortController(), installedReferenceKey: randomBytes(32), installedUpdateScans: new Map(),
|
||||
ctx: { invocation: { request: { args: { agentId: 'session' } } }, get: () => ({ get: () => state.currentAgent }) },
|
||||
assertSource: (revision: string) => { if (revision !== state.revision) throw new Error('source changed'); },
|
||||
getContext: () => ({ registryUrl: 'https://registry.example' }),
|
||||
readSource: async (_revision: string, signal: AbortSignal, read: (registry: object, signal: AbortSignal) => unknown) => read({ resolve: async () => { state.resolves++; return state.resolve(signal); } }, signal),
|
||||
localRuntime: {
|
||||
openInstalledSnapshot: async () => { state.snapshots++; return { projection: { items, complete: true, issues: [] }, read: async (item: InstalledProjectionItem) => { state.reads++; if (state.invalid) throw new Error('Inventory changed'); return item; } }; },
|
||||
assessUpdate: async () => ({ state: 'upgradable', currentVersion: '1.0.0', candidateVersion: '2.0.0', reason: 'newer-version' }),
|
||||
},
|
||||
});
|
||||
const begin = (signal = new AbortController().signal): Promise<{ scanId: string; itemKeys: string[] }> => service.beginInstalledUpdateScan('source', signal);
|
||||
const check = (scan: { scanId: string; itemKeys: string[] }, index = 0, signal = new AbortController().signal) => service.checkInstalledUpdateScan('source', scan.scanId, scan.itemKeys[index], signal);
|
||||
return { service, state, session, fs, agent, items, begin, check };
|
||||
}
|
||||
|
||||
test('round shares resolve across locations, isolates target cancellation, and end aborts shared work', async () => fixture(async f => {
|
||||
let resolve!: (value: { version: string; fingerprint: string }) => void;
|
||||
let shared!: AbortSignal;
|
||||
f.state.resolve = signal => { shared = signal; return new Promise(done => { resolve = done; }); };
|
||||
const scan = await f.begin();
|
||||
const cancelled = new AbortController();
|
||||
const first = f.check(scan, 0, cancelled.signal).catch(() => 'cancelled');
|
||||
const second = f.check(scan, 1);
|
||||
while (!resolve) await new Promise(done => setImmediate(done));
|
||||
cancelled.abort(); expect(shared.aborted).toBe(false);
|
||||
resolve({ version: '2.0.0', fingerprint: 'candidate' });
|
||||
expect(await first).toBe('cancelled'); expect(await second).toMatchObject({ state: 'upgradable' });
|
||||
expect(f.state.resolves).toBe(1); expect(f.state.reads).toBe(4);
|
||||
await f.service.endInstalledUpdateScan('source', scan.scanId);
|
||||
expect(shared.aborted).toBe(true); expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
await expect(f.check(scan)).rejects.toThrow();
|
||||
const next = await f.begin(); f.state.resolve = async () => ({ version: '2.0.0', fingerprint: 'candidate' });
|
||||
await f.check(next); expect(f.state.resolves).toBe(2);
|
||||
}));
|
||||
|
||||
test('round rejects foreign agent, forged item, source and actual session/fs/runtime changes', async () => fixture(async f => {
|
||||
let scan = await f.begin();
|
||||
f.service.ctx.invocation.request.args.agentId = 'foreign';
|
||||
await expect(f.check(scan)).rejects.toThrow();
|
||||
await f.service.endInstalledUpdateScan('source', scan.scanId); expect(f.service.installedUpdateScans.size).toBe(1);
|
||||
f.service.ctx.invocation.request.args.agentId = 'session';
|
||||
await expect(f.check({ ...scan, itemKeys: ['/client/path'] })).rejects.toThrow(); expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
for (const mutate of [() => { f.session.header.cwd += '/changed'; }, () => { f.state.currentAgent = { ...f.agent }; }, () => { f.agent.ctx.get = () => ({ ...f.fs }); }, () => { f.service.localRuntime = { ...f.service.localRuntime }; }, () => { f.state.revision = 'new-source'; }]) {
|
||||
const cwd = f.session.header.cwd; const get = f.agent.ctx.get; const runtime = f.service.localRuntime;
|
||||
scan = await f.begin(); mutate(); await expect(f.check(scan)).rejects.toThrow(); expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
f.session.header.cwd = cwd; f.state.currentAgent = f.agent; f.agent.ctx.get = get; f.service.localRuntime = runtime; f.state.revision = 'source';
|
||||
}
|
||||
}));
|
||||
|
||||
test('bounded rounds, idle expiration, hard expiration and begin abort clean up', async () => fixture(async f => {
|
||||
const scans = await Promise.all(Array.from({ length: 4 }, () => f.begin()));
|
||||
await expect(f.begin()).rejects.toThrow('Too many');
|
||||
for (const scan of scans) await f.service.endInstalledUpdateScan('source', scan.scanId);
|
||||
const aborted = new AbortController(); aborted.abort(); await expect(f.begin(aborted.signal)).rejects.toThrow(); expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
const now = Date.now(); const clock = spyOn(Date, 'now').mockReturnValue(now);
|
||||
try {
|
||||
let scan = await f.begin(); clock.mockReturnValue(now + 60_001); await expect(f.check(scan)).rejects.toThrow();
|
||||
expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
clock.mockReturnValue(now); scan = await f.begin();
|
||||
for (let second = 50; second < 1800; second += 50) { clock.mockReturnValue(now + second * 1000); await f.check(scan); }
|
||||
clock.mockReturnValue(now + 1800_001); await expect(f.check(scan)).rejects.toThrow(); expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
} finally { clock.mockRestore(); }
|
||||
}));
|
||||
|
||||
test('inventory changes during resolve invalidate the whole round, and failures deduplicate', async () => fixture(async f => {
|
||||
f.state.resolve = async () => { f.state.invalid = true; return { version: '2.0.0', fingerprint: 'candidate' }; };
|
||||
const scan = await f.begin(); await expect(f.check(scan)).rejects.toThrow('Installed update scan changed');
|
||||
expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
f.state.invalid = false; f.state.resolve = async () => { throw new Error('offline'); };
|
||||
const retry = await f.begin();
|
||||
const results = await Promise.all([f.check(retry), f.check(retry, 1)]);
|
||||
expect(results.map(value => value.state)).toEqual(['unavailable', 'unavailable']); expect(f.state.resolves).toBe(2);
|
||||
}));
|
||||
|
||||
for (const size of [10, 100, 500]) test(`round ${size} targets resolves unique skills once`, async () => fixture(async f => {
|
||||
const base = [...f.items]; f.items.length = 0;
|
||||
for (let index = 0; index < size / 2; index++) for (const item of base) f.items.push({ ...item, slug: `skill-${index}`, targetPath: join(item.targetPath, '..', `skill-${index}`) });
|
||||
const scan = await f.begin();
|
||||
// Production overview schedules three checks at a time.
|
||||
for (let index = 0; index < size; index += 3) await Promise.all(Array.from({ length: Math.min(3, size - index) }, (_, offset) => f.check(scan, index + offset)));
|
||||
expect(f.state.snapshots).toBe(1); expect(f.state.reads).toBe(2 * size); expect(f.state.resolves).toBe(size / 2);
|
||||
console.info(JSON.stringify({ targets: size, snapshots: f.state.snapshots, targetChecks: f.state.reads, remoteResolves: f.state.resolves }));
|
||||
}));
|
||||
|
||||
|
||||
test('Host bounds actual remote concurrency even when callers exceed the UI queue', async () => fixture(async f => {
|
||||
const base = f.items[0]!; f.items.length = 0;
|
||||
for (let index = 0; index < 12; index++) f.items.push({ ...base, slug: `skill-${index}`, targetPath: join(base.targetPath, '..', `skill-${index}`) });
|
||||
let active = 0; let maximum = 0;
|
||||
const releases: (() => void)[] = [];
|
||||
f.state.resolve = async () => {
|
||||
active++; maximum = Math.max(maximum, active);
|
||||
await new Promise<void>(done => releases.push(done)); active--;
|
||||
return { version: '2.0.0', fingerprint: 'candidate' };
|
||||
};
|
||||
const scan = await f.begin();
|
||||
const results = Promise.all(scan.itemKeys.map((_, index) => f.check(scan, index)));
|
||||
for (let wave = 0; wave < 4; wave++) {
|
||||
while (releases.length < 3) await new Promise(done => setImmediate(done));
|
||||
expect(active).toBe(3);
|
||||
releases.splice(0).forEach(done => done());
|
||||
}
|
||||
expect(await results).toHaveLength(12); expect(maximum).toBe(3); expect(f.state.resolves).toBe(12);
|
||||
}));
|
||||
|
||||
test('aborting begin during snapshot construction releases its reserved slot', async () => fixture(async f => {
|
||||
const snapshot = f.service.localRuntime.openInstalledSnapshot;
|
||||
const controller = new AbortController();
|
||||
f.service.localRuntime.openInstalledSnapshot = async () => { controller.abort(); return snapshot(); };
|
||||
await expect(f.begin(controller.signal)).rejects.toThrow();
|
||||
expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
}));
|
||||
|
||||
|
||||
test('cancelled initializing snapshots retain slots until filesystem work settles', async () => fixture(async f => {
|
||||
const snapshot = f.service.localRuntime.openInstalledSnapshot;
|
||||
const releases: (() => void)[] = [];
|
||||
f.service.localRuntime.openInstalledSnapshot = async () => {
|
||||
await new Promise<void>(done => releases.push(done));
|
||||
return snapshot();
|
||||
};
|
||||
const controllers = Array.from({ length: 4 }, () => new AbortController());
|
||||
const pending = controllers.map(controller => f.begin(controller.signal).catch(() => 'cancelled'));
|
||||
while (releases.length < 4) await new Promise(done => setImmediate(done));
|
||||
controllers.forEach(controller => controller.abort());
|
||||
expect(f.service.installedUpdateScans.size).toBe(4);
|
||||
await expect(f.begin()).rejects.toThrow('Too many');
|
||||
releases.splice(0).forEach(done => done());
|
||||
expect(await Promise.all(pending)).toEqual(['cancelled', 'cancelled', 'cancelled', 'cancelled']);
|
||||
expect(f.service.installedUpdateScans.size).toBe(0);
|
||||
}));
|
||||
|
|
@ -514,3 +514,9 @@ node scripts/smoke-native-host.mjs --artifact artifacts --report host-smoke-summ
|
|||
需要把本机原始日志保存在仓库外时,将 `TMPDIR` 设置为仓库外报告目录;脚本的所有 Host/profile/HOME/探针日志都位于该目录下的独立根。不要指向现有 DSH 安装。
|
||||
|
||||
新 RC 的 Gateway 要求 in-process 调用显式携带 Peer;观察器使用该 Connection 的 `browserPeer`,旧 RC 使用原有 `operator`。不伪造身份,不使用浏览器输入创建主机身份。发布插件通过生成的 Remote 绑定调用,不直接构造 Gateway invocation。
|
||||
|
||||
## 已安装更新总览
|
||||
|
||||
`installed-update-overview-probe.mjs` 导出 `probeInstalledUpdateOverview(page, screenshot)`,由已进入活动会话的真实 DSH Playwright 页面调用。夹具需要至少一个真实可更新安装、至少四个安装位置和一个多位置技能;按当前实际结果选择更新确认目标,不固定某技能的旧版本。先执行真实只读检查并取消逐位置更新确认,扫描断言一次 `beginInstalledUpdateScan`、逐位置 `checkInstalledUpdateScan` 与一次 `endInstalledUpdateScan`,再仅拦截 `checkInstalledUpdateScan` 响应验证混合结果、三并发、失败重试、关键词叠加、详情返回与迟到结果丢弃。不会确认安装写入或调用模型。`screenshot(name)` 由运行器保存图片;深浅色和 360px 布局均有断言。
|
||||
|
||||
`installed-update-context-component.tsx` 是独立 React + QueryClient 组件夹具,使用 Bun 的浏览器构建后挂到含 `#root` 的测试 HTML,供 `installed-update-context-probe.mjs` 的 `probeInstalledUpdateContext(page)` 调用。它验证库存 itemKey 替换、来源/会话切换、同会话工作区 A→B→A 与迟到响应。仅内存服务,不更改真实 DSH 工作区或来源配置;与真实 Host 验收分别记录。上述浏览器探针不由 `bun test` 自动运行。
|
||||
|
|
|
|||
|
|
@ -0,0 +1,62 @@
|
|||
import { createRoot } from 'react-dom/client';
|
||||
import { useState } from 'react';
|
||||
import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
|
||||
import { InstalledSkills, type InstalledServices } from '../../src/client/installed-skills.js';
|
||||
import { installedNavigationFor } from '../../src/client/installed-navigation.js';
|
||||
import { UpgradeRequests, RemovalRequests } from '../../src/client/upgrade-requests.js';
|
||||
import { installedContext } from '../../src/client/installed-context.js';
|
||||
import type { InstalledSkillList, InstalledUpdateCheck } from '../../src/host/types.js';
|
||||
import type { TypertRemoteNamespaceMap } from '@deepseek-ai/dsh-typert-protocol';
|
||||
const client = new QueryClient({ defaultOptions: { queries: { retry: false } } });
|
||||
let session = 'A', source = 'source-A', cwd = 'A';
|
||||
let items: InstalledSkillList['items'] = ['one', 'two', 'three', 'four'].map(slug => ({ itemKey: slug, slug, namespace: 'demo', scope: 'user', state: 'present', version: '1', installationState: 'enabled' }));
|
||||
let held = false, staleRound = false;
|
||||
const begins: string[] = [];
|
||||
const pending: (() => void)[] = [], listeners = new Set<() => void>(), calls: string[] = [];
|
||||
const context = installedContext(() => ({ scope: null, cwd, active: true }), listener => { listeners.add(listener); return () => { listeners.delete(listener); }; });
|
||||
const storage = () => ({ getItem: () => null, setItem() {}, removeItem() {}, key: () => null, length: 0 });
|
||||
const services = { context, get sessionId() { return session; },
|
||||
get management() {
|
||||
const captured = cwd;
|
||||
return { client, assertCurrent: () => { if (captured !== cwd) throw new Error('stale workspace'); },
|
||||
installation: { sessionId: session, installed: async () => ({ ok: true, value: { items, complete: true, issues: [], unavailable: [] } }) },
|
||||
begin: async () => { if (captured !== cwd) throw new Error('stale workspace'); begins.push(captured); return { ok: true, value: { status: 'cancelled' } }; },
|
||||
};
|
||||
}, upgradeRequests: new UpgradeRequests(storage), removalRequests: new RemovalRequests(storage),
|
||||
list: async () => ({ ok: true, value: { items, complete: true, issues: [], unavailable: [] } }),
|
||||
detail: async (_revision: string, itemKey: string) => ({ ok: true, value: { item: items.find(item => item.itemKey === itemKey), content: { state: 'local-only', reason: 'NOT_FOUND' } } }),
|
||||
checkUpdate: async () => ({ ok: true, value: { state: 'upgradable', currentVersion: '1', candidateVersion: '2', reason: '', checkedAt: '' } satisfies InstalledUpdateCheck }),
|
||||
beginInstalledUpdateScan: async () => ({ ok: true, value: { scanId: crypto.randomUUID(), itemKeys: items.map(item => item.itemKey) } }),
|
||||
endInstalledUpdateScan: async () => ({ ok: true, value: undefined }),
|
||||
checkInstalledUpdateScan: async (_revision: string, _scanId: string, key: string) => {
|
||||
calls.push(key);
|
||||
if (staleRound && key !== items[0]?.itemKey) {
|
||||
await new Promise<void>(resolve => pending.push(resolve));
|
||||
if (key === items[1]?.itemKey) return { ok: false, error: { code: 'skillhub/context-stale' } };
|
||||
}
|
||||
if (held) await new Promise<void>(resolve => pending.push(resolve));
|
||||
return { ok: true, value: { state: 'upgradable', currentVersion: '1', candidateVersion: '2', reason: '', checkedAt: '' } satisfies InstalledUpdateCheck };
|
||||
},
|
||||
} as unknown as InstalledServices;
|
||||
let rerender = () => {};
|
||||
function App() {
|
||||
const [, render] = useState(0); rerender = () => render(value => value + 1);
|
||||
return <QueryClientProvider client={client}><InstalledSkills services={services} sourceRevision={source} source="https://registry.example"
|
||||
remote={{} as TypertRemoteNamespaceMap['skillhub']} modes={{ versions: 'hide', reviews: 'hide', securityAudit: 'hide' }} scrollContainer={{ current: null }} navigation={installedNavigationFor({}, session, source)} /></QueryClientProvider>;
|
||||
}
|
||||
Object.assign(window, { fixture: {
|
||||
staleRound: async () => {
|
||||
staleRound = true; held = false; calls.length = 0;
|
||||
items = [...items, ...['five', 'six', 'seven', 'eight'].map(slug => ({ ...items[0]!, slug, itemKey: slug }))];
|
||||
await client.invalidateQueries({ queryKey: ['skillhub-installed'] });
|
||||
},
|
||||
hold: () => { held = true; calls.length = 0; },
|
||||
release: () => { held = false; pending.splice(0).forEach(resolve => resolve()); },
|
||||
calls: () => [...calls],
|
||||
begins: () => [...begins],
|
||||
workspace: (value: string) => { cwd = value; listeners.forEach(listener => listener()); },
|
||||
source: (value: string) => { source = value; rerender(); },
|
||||
session: (value: string) => { session = value; rerender(); },
|
||||
inventory: () => { items = items.map(item => item.slug === 'one' ? { ...item, itemKey: 'one-new', version: '2' } : item); return client.invalidateQueries({ queryKey: ['skillhub-installed'] }); },
|
||||
} });
|
||||
createRoot(document.getElementById('root')!).render(<App />);
|
||||
|
|
@ -0,0 +1,54 @@
|
|||
import assert from 'node:assert/strict';
|
||||
/** Run against installed-update-context-component.tsx bundled for a browser. */
|
||||
export async function probeInstalledUpdateContext(page) {
|
||||
const check = page.getByRole('button', { name: '检查更新', exact: true });
|
||||
const body = () => page.locator('body').innerText();
|
||||
const scan = async () => { await check.click(); await page.getByText('已检查 4/4 · 4 个技能可更新', { exact: true }).waitFor(); };
|
||||
await check.waitFor(); await scan();
|
||||
await page.evaluate(() => window.fixture.inventory());
|
||||
await page.waitForFunction(() => [...document.querySelectorAll('.astron-sh-installed-card')].filter(card => card.textContent.includes('可更新至')).length === 3);
|
||||
assert(!(await page.locator('.astron-sh-installed-card').filter({ hasText: '@demo/one' }).innerText()).includes('可更新至'));
|
||||
for (const change of ['source', 'session']) {
|
||||
await scan();
|
||||
await page.evaluate(change => window.fixture[change]('B'), change);
|
||||
await page.waitForFunction(() => !document.querySelector('.skillhub-installed-summary')?.textContent.includes('已检查'));
|
||||
}
|
||||
await scan();
|
||||
await page.evaluate(() => window.fixture.workspace('B'));
|
||||
await page.waitForFunction(() => !document.querySelector('.skillhub-installed-summary')?.textContent.includes('已检查'));
|
||||
await scan();
|
||||
await page.locator('.astron-sh-installed-card').first().getByRole('button', { name: '查看更新', exact: true }).click();
|
||||
const detail = page.getByRole('region', { name: '已安装技能详情', exact: true });
|
||||
await detail.getByRole('button', { name: '更新', exact: true }).waitFor();
|
||||
await detail.getByRole('button', { name: '更新', exact: true }).click();
|
||||
await page.waitForFunction(() => window.fixture.begins().length === 1);
|
||||
assert.deepEqual(await page.evaluate(() => window.fixture.begins()), ['B']);
|
||||
assert(!(await detail.innerText()).includes('安装记录暂不可用'));
|
||||
await detail.getByRole('button', { name: '← 返回已安装', exact: true }).click();
|
||||
await page.evaluate(() => window.fixture.hold());
|
||||
await check.click();
|
||||
await page.waitForFunction(() => window.fixture.calls().length === 3);
|
||||
// Both context transitions happen before React can commit; generation must still advance twice.
|
||||
await page.evaluate(() => { window.fixture.workspace('C'); window.fixture.workspace('B'); window.fixture.release(); });
|
||||
await page.waitForFunction(() => !document.querySelector('.skillhub-installed-summary')?.textContent.includes('已检查'));
|
||||
assert.equal(await page.evaluate(() => window.fixture.calls().length), 3);
|
||||
assert(!(await body()).includes('可更新至'));
|
||||
for (const change of ['source', 'session']) {
|
||||
await page.evaluate(() => window.fixture.hold());
|
||||
await check.click(); await page.waitForFunction(() => window.fixture.calls().length === 3);
|
||||
await page.evaluate(change => window.fixture[change]('C'), change);
|
||||
await page.waitForFunction(() => !document.querySelector('.skillhub-installed-summary')?.textContent.match(/已检查|检查中/));
|
||||
await page.evaluate(() => window.fixture.release());
|
||||
assert.equal(await page.evaluate(() => window.fixture.calls().length), 3);
|
||||
assert(!(await body()).includes('可更新至'));
|
||||
}
|
||||
await page.evaluate(() => window.fixture.staleRound());
|
||||
await check.click();
|
||||
await page.waitForFunction(() => window.fixture.calls().length === 4);
|
||||
await page.getByText('可更新至 2', { exact: true }).waitFor();
|
||||
await page.evaluate(() => window.fixture.release());
|
||||
await page.getByText('已检查 8/8 · 8 处检查失败', { exact: true }).waitFor();
|
||||
assert.equal(await page.evaluate(() => window.fixture.calls().length), 4);
|
||||
assert(!(await body()).includes('可更新至'));
|
||||
return { passed: true, staleRoundClearsResultsAndStopsQueue: true, inventoryReplacement: true, sourceAndSessionReset: true, workspaceReset: true, workspaceDetailRestored: true, workspaceABALateReplies: true, sourceAndSessionLateReplies: true };
|
||||
}
|
||||
158
plugins/dsh/test/integration/installed-update-overview-probe.mjs
Normal file
158
plugins/dsh/test/integration/installed-update-overview-probe.mjs
Normal file
|
|
@ -0,0 +1,158 @@
|
|||
import assert from 'node:assert/strict';
|
||||
/** Real Host/browser UI acceptance. Only per-item scan responses are controlled; no install writes. */
|
||||
export async function probeInstalledUpdateOverview(page, screenshot) {
|
||||
const rpc = [];
|
||||
const theme = async colorScheme => {
|
||||
await page.emulateMedia({ colorScheme });
|
||||
await page.waitForFunction(dark => {
|
||||
const button = document.querySelector('.skillhub-installed-filters button[aria-pressed="true"]');
|
||||
if (!button) return false;
|
||||
const style = getComputedStyle(button);
|
||||
const rgb = style.backgroundColor.match(/[\d.]+/g)?.map(Number);
|
||||
return rgb && (dark ? rgb[0] < 100 : rgb[0] > 150);
|
||||
}, colorScheme === 'dark');
|
||||
await page.evaluate(async () => { await Promise.all(document.getAnimations().filter(animation => animation.effect?.getComputedTiming().iterations !== Infinity).map(animation => animation.finished.catch(() => {}))); });
|
||||
};
|
||||
page.on('request', request => {
|
||||
const path = new URL(request.url()).pathname;
|
||||
if (path.startsWith('/api/')) rpc.push(path);
|
||||
});
|
||||
await page.getByRole('button', { name: '技能中心', exact: true }).click();
|
||||
const inventoryResponse = page.waitForResponse(response => new URL(response.url()).pathname === '/api/skillhub/listInstalled');
|
||||
await page.getByRole('tab', { name: '已安装', exact: true }).click();
|
||||
const inventory = (await (await inventoryResponse).json()).result.value;
|
||||
const items = inventory.items;
|
||||
assert(items.length > 3);
|
||||
const list = page.getByRole('region', { name: '已安装技能', exact: true });
|
||||
const scan = list.getByRole('button', { name: '检查更新', exact: true });
|
||||
await scan.waitFor();
|
||||
assert(!rpc.some(path => /\/(checkUpdate|beginInstalledUpdateScan|checkInstalledUpdateScan)$/.test(path)), 'Entering must not scan');
|
||||
assert.equal(await list.locator('select').count(), 0);
|
||||
assert(!await list.getByText('尚未检查', { exact: false }).count());
|
||||
await screenshot('initial-light');
|
||||
await theme('dark'); await screenshot('initial-dark');
|
||||
await theme('light');
|
||||
const keyboardFilter = list.getByRole('group', { name: '更新筛选' }).getByRole('button', { name: '可更新', exact: true });
|
||||
await keyboardFilter.focus(); await page.keyboard.press('Enter');
|
||||
assert.equal(await keyboardFilter.getAttribute('aria-pressed'), 'true');
|
||||
await page.keyboard.press('Tab'); await page.keyboard.press('Space');
|
||||
assert.equal(await list.getByRole('button', { name: '检查失败', exact: true }).getAttribute('aria-pressed'), 'true');
|
||||
await list.getByRole('button', { name: '全部', exact: true }).click();
|
||||
const realStart = rpc.length;
|
||||
await scan.click();
|
||||
await page.getByText(`已检查 ${items.length}/${items.length}`, { exact: false }).waitFor();
|
||||
await screenshot('real-results');
|
||||
const realResults = await list.innerText();
|
||||
const realScanRpc = rpc.slice(realStart);
|
||||
assert.equal(realScanRpc.filter(path => path.endsWith('/beginInstalledUpdateScan')).length, 1);
|
||||
assert.equal(realScanRpc.filter(path => path.endsWith('/checkInstalledUpdateScan')).length, items.length);
|
||||
assert(!realScanRpc.some(path => path.endsWith('/checkUpdate')));
|
||||
assert.equal(rpc.slice(realStart).filter(path => path.endsWith('/endInstalledUpdateScan')).length, 1);
|
||||
const actualUpdate = list.locator('.astron-sh-installed-card').filter({ has: page.getByRole('button', { name: '查看更新', exact: true }) }).first();
|
||||
await actualUpdate.getByRole('button', { name: '查看更新', exact: true }).click();
|
||||
const realDetail = page.getByRole('region', { name: '已安装技能详情', exact: true });
|
||||
await realDetail.getByRole('button', { name: '更新', exact: true }).first().click();
|
||||
await page.getByRole('button', { name: '确认更新', exact: true }).waitFor();
|
||||
await screenshot('real-update-confirmation');
|
||||
await page.getByRole('button', { name: '取消', exact: true }).click();
|
||||
await page.getByRole('button', { name: '确认更新', exact: true }).waitFor({ state: 'hidden' });
|
||||
await realDetail.getByRole('button', { name: '← 返回已安装', exact: true }).click();
|
||||
// Stable fixtures are real installed records; overwrite read-only responses to cover mixed outcomes.
|
||||
const multi = items.find(item => items.filter(other => other.slug === item.slug).length > 1);
|
||||
assert(multi, 'Needs a multi-location installation');
|
||||
const other = items.filter(item => item.slug !== multi.slug);
|
||||
const failedKey = other[0].itemKey, blockedKey = other[1].itemKey;
|
||||
let active = 0, peak = 0, calls = [], retry = false, hold = false;
|
||||
const releases = [];
|
||||
await page.route('**/api/skillhub/checkInstalledUpdateScan', async route => {
|
||||
const requestBody = route.request().postDataJSON();
|
||||
const serialized = JSON.stringify(requestBody);
|
||||
const item = items.find(candidate => serialized.includes(candidate.itemKey));
|
||||
assert(item, 'checkInstalledUpdateScan must use an exact inventory itemKey');
|
||||
calls.push(item.itemKey); active++; peak = Math.max(peak, active);
|
||||
const response = await route.fetch();
|
||||
const body = await response.json();
|
||||
if (hold) await new Promise(resolve => releases.push(resolve));
|
||||
else await new Promise(resolve => setTimeout(resolve, 180));
|
||||
body.result = { ok: true, value: { state: item.itemKey === failedKey && !retry ? 'unavailable' : item.itemKey === blockedKey ? 'blocked' : item.slug === multi.slug ? 'upgradable' : 'current', currentVersion: item.version, candidateVersion: item.slug === multi.slug ? '1.3.0' : null, reason: item.itemKey === blockedKey ? 'local-changes' : '', checkedAt: new Date().toISOString() } };
|
||||
active--;
|
||||
await route.fulfill({ response, json: body }).catch(() => {});
|
||||
});
|
||||
await scan.click();
|
||||
await list.getByRole('button', { name: '取消检查' }).waitFor();
|
||||
assert(await scan.isDisabled());
|
||||
await page.waitForFunction(total => {
|
||||
const text = document.querySelector('.skillhub-installed-summary')?.textContent ?? '';
|
||||
const match = text.match(/检查中 (\d+)\/(\d+)/);
|
||||
return match && Number(match[1]) > 0 && Number(match[1]) < total;
|
||||
}, items.length);
|
||||
await screenshot('progress');
|
||||
await page.getByText(`已检查 ${items.length}/${items.length} · 1 个技能可更新 · 1 处检查失败`, { exact: true }).waitFor();
|
||||
assert.equal(peak, 3); assert.equal(calls.length, items.length);
|
||||
assert(await list.getByText('多位置安装有更新').count() === 1);
|
||||
assert(await list.getByText('更新需处理,请查看安装状态。').count() >= 1);
|
||||
await screenshot('mixed-light');
|
||||
const filter = list.getByLabel('更新筛选');
|
||||
await filter.getByRole('button', { name: '可更新', exact: true }).click();
|
||||
assert.equal(await list.locator('.astron-sh-installed-card').count(), 1);
|
||||
const keyword = list.getByRole('searchbox', { name: '过滤已安装技能' });
|
||||
await keyword.fill('does-not-exist');
|
||||
await list.getByText('没有匹配的技能。', { exact: true }).waitFor();
|
||||
await keyword.fill(multi.slug);
|
||||
await list.getByRole('button', { name: '查看更新', exact: true }).click();
|
||||
const detail = page.getByRole('region', { name: '已安装技能详情', exact: true });
|
||||
await detail.getByRole('button', { name: '更新', exact: true }).first().waitFor();
|
||||
assert.equal(await detail.getByRole('button', { name: '更新', exact: true }).count(), items.filter(item => item.slug === multi.slug).length);
|
||||
await screenshot('detail-update-targets');
|
||||
await detail.getByRole('button', { name: '← 返回已安装', exact: true }).click();
|
||||
assert.equal(await filter.getByRole('button', { name: '可更新', exact: true }).getAttribute('aria-pressed'), 'true'); assert.equal(await keyword.inputValue(), multi.slug);
|
||||
await keyword.fill(''); await filter.getByRole('button', { name: '检查失败', exact: true }).click();
|
||||
assert.equal(await list.locator('.astron-sh-installed-card').count(), 1);
|
||||
retry = true; calls = [];
|
||||
await list.getByRole('button', { name: '重试失败项', exact: true }).click();
|
||||
await page.getByText('已检查 1/1 · 1 个技能可更新', { exact: true }).waitFor();
|
||||
assert.deepEqual(calls, [failedKey]);
|
||||
await filter.getByRole('button', { name: '全部', exact: true }).click();
|
||||
await theme('dark'); await screenshot('mixed-dark');
|
||||
await page.setViewportSize({ width: 360, height: 1000 }); await screenshot('mixed-360-dark');
|
||||
assert(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth));
|
||||
await theme('light'); await screenshot('mixed-360-light');
|
||||
await page.setViewportSize({ width: 1440, height: 1000 });
|
||||
hold = true; calls = [];
|
||||
await scan.click();
|
||||
await page.waitForFunction(() => document.body.innerText.includes('检查中 0/'));
|
||||
await page.waitForTimeout(250);
|
||||
await list.getByRole('button', { name: '取消检查', exact: true }).click();
|
||||
releases.splice(0).forEach(resolve => resolve());
|
||||
await page.waitForTimeout(300);
|
||||
assert(calls.length <= 3);
|
||||
assert((await list.innerText()).includes('已停止 0/'));
|
||||
// Switch between existing real sessions while a read-only scan is held.
|
||||
calls = [];
|
||||
await scan.click(); await page.waitForTimeout(250);
|
||||
const originalSessionKey = await page.locator('[data-row-key^="session:"]').first().getAttribute('data-row-key');
|
||||
const workspace = page.locator('[data-row-key^="workspace:"]').filter({ has: page.getByText('layout-review-project', { exact: true }) });
|
||||
if (await workspace.getAttribute('aria-expanded') === 'false') { await workspace.hover(); await workspace.locator('span[class*="_chevron"]').click(); }
|
||||
await page.waitForFunction(() => document.querySelectorAll('[data-row-key^="session:"]').length > 1, undefined, { timeout: 5000 }).catch(() => {});
|
||||
const keys = await page.locator('[data-row-key^="session:"]').evaluateAll(nodes => nodes.map(node => node.getAttribute('data-row-key')));
|
||||
const nextKey = keys.find(key => key !== originalSessionKey);
|
||||
let realSessionSwitch = 'unavailable: no second retained session in fixture workspace';
|
||||
if (nextKey) {
|
||||
await page.locator(`[data-row-key="${nextKey}"]`).click();
|
||||
if (!await page.getByRole('button', { name: '检查更新', exact: true }).isVisible()) await page.getByRole('button', { name: '技能中心', exact: true }).click();
|
||||
await page.getByRole('tab', { name: '已安装', exact: true }).click();
|
||||
releases.splice(0).forEach(resolve => resolve());
|
||||
await page.waitForFunction(() => !document.querySelector('.skillhub-installed-summary')?.textContent.includes('已检查'));
|
||||
assert(calls.length <= 3);
|
||||
await screenshot('real-session-switch');
|
||||
await page.locator(`[data-row-key="${originalSessionKey}"]`).click();
|
||||
realSessionSwitch = 'passed';
|
||||
} else {
|
||||
await list.getByRole('button', { name: '取消检查', exact: true }).click();
|
||||
releases.splice(0).forEach(resolve => resolve());
|
||||
}
|
||||
const writes = rpc.filter(path => /\/(start|commit|execute|send)/i.test(path));
|
||||
assert.deepEqual(writes, []);
|
||||
await page.unroute('**/api/skillhub/checkInstalledUpdateScan');
|
||||
return { passed: true, inventoryPositions: items.length, realScanRpc, realResults, controlledMixed: true, peakConcurrency: peak, grouped: true, filters: true, retryOnlyFailures: true, detailRoundTrip: true, realUpgradeConfirmationCancelled: true, realSessionSwitch, cancellationDropsLateResults: true, installationWrites: writes.length };
|
||||
}
|
||||
|
|
@ -55,8 +55,8 @@ describe('native M0 package', () => {
|
|||
});
|
||||
|
||||
test('official generator publishes the declared endpoints with scoped writes and strict codec', () => {
|
||||
expect(TYPERT_REMOTE.descriptors.map(item => item.method).sort()).toEqual(['acknowledgeConversationDetail', 'beginConversationManagement', 'checkAvailability', 'checkUpdate', 'checkVersionUpdate', 'confirmConversationManagement', 'executePlan', 'getCompatibility', 'getContext', 'getInstalledDetail', 'getOperation', 'getSkillDetail', 'getStatus', 'listCatalog', 'listCatalogByLabel', 'listInstallTargets', 'listInstalled', 'listLabels', 'listReviews', 'listSkills', 'listVersions', 'openConversationDetail', 'prepareSkillUse', 'prepareToggle', 'prepareUninstall', 'prepareUpgrade', 'prepareVersionUpgrade', 'recoverOperation', 'reopenConversationDetail', 'selectSkillUse', 'startInstall', 'testRegistryConnection']);
|
||||
for (const method of ['checkAvailability', 'beginConversationManagement', 'confirmConversationManagement', 'openConversationDetail', 'reopenConversationDetail', 'acknowledgeConversationDetail', 'listInstallTargets', 'listInstalled', 'getInstalledDetail', 'checkUpdate', 'checkVersionUpdate', 'prepareSkillUse', 'prepareToggle', 'prepareUninstall', 'prepareUpgrade', 'prepareVersionUpgrade', 'executePlan', 'startInstall', 'getOperation', 'recoverOperation']) {
|
||||
expect(TYPERT_REMOTE.descriptors.map(item => item.method).sort()).toEqual(['acknowledgeConversationDetail', 'beginConversationManagement', 'beginInstalledUpdateScan', 'checkAvailability', 'checkInstalledUpdateScan', 'checkUpdate', 'checkVersionUpdate', 'confirmConversationManagement', 'endInstalledUpdateScan', 'executePlan', 'getCompatibility', 'getContext', 'getInstalledDetail', 'getOperation', 'getSkillDetail', 'getStatus', 'listCatalog', 'listCatalogByLabel', 'listInstallTargets', 'listInstalled', 'listLabels', 'listReviews', 'listSkills', 'listVersions', 'openConversationDetail', 'prepareSkillUse', 'prepareToggle', 'prepareUninstall', 'prepareUpgrade', 'prepareVersionUpgrade', 'recoverOperation', 'reopenConversationDetail', 'selectSkillUse', 'startInstall', 'testRegistryConnection']);
|
||||
for (const method of ['beginInstalledUpdateScan', 'checkInstalledUpdateScan', 'endInstalledUpdateScan', 'checkAvailability', 'beginConversationManagement', 'confirmConversationManagement', 'openConversationDetail', 'reopenConversationDetail', 'acknowledgeConversationDetail', 'listInstallTargets', 'listInstalled', 'getInstalledDetail', 'checkUpdate', 'checkVersionUpdate', 'prepareSkillUse', 'prepareToggle', 'prepareUninstall', 'prepareUpgrade', 'prepareVersionUpgrade', 'executePlan', 'startInstall', 'getOperation', 'recoverOperation']) {
|
||||
const scoped = TYPERT_REMOTE.descriptors.find(item => item.method === method)!;
|
||||
expect(scoped.invocation).toMatchObject({ kind: 'context', context: 'agent', wire: 'agentId' });
|
||||
}
|
||||
|
|
|
|||
|
|
@ -20,6 +20,7 @@ function native(): NativeRuntime {
|
|||
assessUpdate: () => { throw new Error('Unexpected assessment'); },
|
||||
inspectUpgrade: async () => { throw new Error('Unexpected inspection'); },
|
||||
inspectRemoval: async () => { throw new Error('Unexpected removal inspection'); },
|
||||
openInstalledSnapshot: async () => ({ projection: { items: [], complete: true, issues: [] }, read: async () => { throw new Error('Unexpected scan read'); } }),
|
||||
listInstalled: async () => ({ items: [], complete: true, issues: [] }),
|
||||
executeInstall: async () => { throw new Error('Unexpected execution'); },
|
||||
recover: async () => { throw new Error('Unexpected recovery'); },
|
||||
|
|
|
|||
|
|
@ -20,8 +20,9 @@ test('installed defaults to one skill card with no position filter or management
|
|||
const html = renderToStaticMarkup(<QueryClientProvider client={client}><InstalledSkills services={services} sourceRevision="revision" source="https://registry.example"
|
||||
remote={{} as TypertRemoteNamespaceMap['skillhub']} modes={{ versions: 'auto', reviews: 'auto', securityAudit: 'auto' }} scrollContainer={{ current: null }} navigation={installedNavigationFor({}, 'session', 'revision')} /></QueryClientProvider>);
|
||||
expect(html.match(/astron-sh-installed-card"/g)).toHaveLength(1);
|
||||
expect(html).toContain('当前显示 1 个技能'); expect(html).toContain('使用技能'); expect(html).toContain('管理安装');
|
||||
for (const text of ['筛选安装范围', 'role="combobox"', '>停用</button>', '>启用</button>', '>卸载</button>', '检查更新']) expect(html).not.toContain(text);
|
||||
expect(html).toContain('检查更新'); expect(html).not.toContain('0 处检查失败');
|
||||
expect(html).toContain('1 个技能'); expect(html).toContain('使用技能'); expect(html).toContain('管理安装');
|
||||
for (const text of ['筛选安装范围', 'role="combobox"', '>停用</button>', '>启用</button>', '>卸载</button>']) expect(html).not.toContain(text);
|
||||
} finally { client.clear(); upgrades.dispose(); removals.dispose(); }
|
||||
});
|
||||
test('late cancelled selector responses cannot supply a key', async () => {
|
||||
|
|
|
|||
37
plugins/dsh/test/update-overview.test.ts
Normal file
37
plugins/dsh/test/update-overview.test.ts
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
import { expect, test } from 'bun:test';
|
||||
import { checkInstalledUpdates, updateFailed } from '../src/client/update-overview.js';
|
||||
import type { InstalledUpdateCheck } from '../src/host/types.js';
|
||||
const current: InstalledUpdateCheck = { state: 'current', currentVersion: '1', candidateVersion: null, reason: '', checkedAt: '' };
|
||||
test('bounded queue delivers progressive mixed results and continues after failure', async () => {
|
||||
let active = 0; let peak = 0;
|
||||
const seen: string[] = [];
|
||||
await checkInstalledUpdates(['a', 'b', 'c', 'd'], async key => {
|
||||
active++; peak = Math.max(peak, active);
|
||||
await Promise.resolve(); active--;
|
||||
if (key === 'b') throw new Error('network');
|
||||
return current;
|
||||
}, new AbortController().signal, (key, result) => { seen.push(key); expect(updateFailed(result)).toBe(key === 'b'); });
|
||||
expect(peak).toBe(3); expect(seen.sort()).toEqual(['a', 'b', 'c', 'd']);
|
||||
});
|
||||
test('cancel settles ignored abort transport, stops queue and discards late replies', async () => {
|
||||
const controller = new AbortController(); let calls = 0; let received = 0;
|
||||
const pending: ((value: InstalledUpdateCheck) => void)[] = [];
|
||||
const work = checkInstalledUpdates(['a', 'b', 'c', 'd'], (_key, signal) => {
|
||||
calls++; expect(signal.aborted).toBe(false);
|
||||
return new Promise(resolve => pending.push(resolve));
|
||||
}, controller.signal, () => received++);
|
||||
controller.abort(); await work;
|
||||
pending.forEach(resolve => resolve(current)); await Promise.resolve();
|
||||
expect(calls).toBe(3); expect(received).toBe(0);
|
||||
});
|
||||
test('timeouts settle as failures and abort each request', async () => {
|
||||
let aborted = false;
|
||||
const results: string[] = [];
|
||||
await checkInstalledUpdates(['a'], (_key, signal) => {
|
||||
signal.addEventListener('abort', () => { aborted = true; });
|
||||
return new Promise(() => {});
|
||||
}, new AbortController().signal, (_key, result) => results.push(result.state), 5);
|
||||
expect(aborted).toBe(true); expect(results).toEqual(['failed']);
|
||||
expect(updateFailed({ ...current, state: 'unavailable' })).toBe(true);
|
||||
expect(updateFailed({ ...current, state: 'blocked' })).toBe(false);
|
||||
});
|
||||
Loading…
Add table
Reference in a new issue