惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

博客园 - Franky
Microsoft Azure Blog
Microsoft Azure Blog
阮一峰的网络日志
阮一峰的网络日志
宝玉的分享
宝玉的分享
量子位
N
Netflix TechBlog - Medium
M
MIT News - Artificial intelligence
GbyAI
GbyAI
Apple Machine Learning Research
Apple Machine Learning Research
博客园_首页
博客园 - 叶小钗
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
酷 壳 – CoolShell
酷 壳 – CoolShell
T
Tailwind CSS Blog
Y
Y Combinator Blog
L
LangChain Blog
The Cloudflare Blog
T
The Blog of Author Tim Ferriss
U
Unit 42
Martin Fowler
Martin Fowler
aimingoo的专栏
aimingoo的专栏
G
Google Developers Blog
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
月光博客
月光博客

Recent Commits to openclaw:main

test: merge chat side-result checks · openclaw/openclaw@ddd2c2a test: merge cron history checks · openclaw/openclaw@f7eb746 test: merge responsive navigation shell checks · openclaw/openclaw@c2e4b47 docs(changelog): add codex oauth fixes · openclaw/openclaw@628e6cd test: merge navigation routing cases · openclaw/openclaw@5d8cecb Tests: mock channel registry bundled fallback · openclaw/openclaw@2b08233 Secrets: avoid broad web search discovery for single plugin config · openclaw/openclaw@a464f59 test: merge config view browser checks · openclaw/openclaw@20cf511 fix(status): align oauth health with runtime · openclaw/openclaw@eed7116 feat: add macOS screen snapshots for monitor preview (#67954) thanks … · openclaw/openclaw@f377db1 fix: report shared auth scopes in hello-ok (#67810) thanks @BunsDev · openclaw/openclaw@0b6c39b Auto-reply: avoid eager bundled route fallback · openclaw/openclaw@3ea1bf4 Tests: narrow session binding contract setup · openclaw/openclaw@54e4e16 fix(macOS): enable undo/redo in webchat composer text input (#34962) · openclaw/openclaw@00951dc Tests: speed up channel setup promotion · openclaw/openclaw@82b529a Docs: refresh agent instructions · openclaw/openclaw@5775fe2 fix(auth): serialize OAuth refresh across agents to fix #26322 (#67876) · openclaw/openclaw@8e79080 test: allow ollama public surface boundary test · openclaw/openclaw@7d4f1a6 Docs: add test performance guardrails · openclaw/openclaw@89706d3 Tests: restore context-engine usage proof · openclaw/openclaw@e4c4f95 Tests: slim context engine runtime coverage · openclaw/openclaw@74c198f ci: retry failed custom checkouts · openclaw/openclaw@0ee5baf test: trim duplicate provider auth onboarding cases · openclaw/openclaw@1ffc02e matrix: fix sessions_spawn --thread subagent session spawning (#67643) · openclaw/openclaw@1ce2596 test: reduce auth choice fixture churn · openclaw/openclaw@857b9cd test: mock health status config boundaries · openclaw/openclaw@9d5ab4a test: mock onboard config io boundary · openclaw/openclaw@299694d test: mock legacy state plugin boundaries · openclaw/openclaw@2713089 test: mock channel install boundaries · openclaw/openclaw@b945248 test: mock doctor preview channel boundaries · openclaw/openclaw@b1a3ad4
fix: bound skill index cache invalidation · openclaw/open...
shakkernerd · 2026-05-30 · via Recent Commits to openclaw:main

@@ -1,6 +1,8 @@

11

import crypto from "node:crypto";

22

import path from "node:path";

3+

import { stableStringify } from "../agents/stable-stringify.js";

34

import type { OpenClawConfig } from "../config/types.openclaw.js";

5+

import { resolvePluginMetadataSnapshot } from "../plugins/plugin-metadata-snapshot.js";

46

import { getSkillsSnapshotVersion } from "./refresh-state.js";

57

import { buildSkillIndex, skillIndexEntries, type SkillIndex } from "./registry.js";

68

import type { SkillEligibilityContext, SkillSnapshot } from "./types.js";

@@ -31,15 +33,24 @@ export type SkillSnapshotBuildOptions = {

31333234

export class SkillsService {

3335

private readonly cache = new Map<string, SkillIndex>();

36+

private readonly cacheScopes = new Map<string, string>();

34373538

getIndex(request: SkillIndexRequest): SkillIndex {

36-

const cacheKey = buildSkillIndexCacheKey(request);

39+

const snapshotVersion =

40+

request.snapshotVersion ?? getSkillsSnapshotVersion(request.workspaceDir);

41+

if (!shouldCacheSkillIndex(snapshotVersion)) {

42+

return this.loadIndex(request, buildUncachedSkillIndexCacheKey(request, snapshotVersion));

43+

}

44+

const cacheKeyParts = buildSkillIndexCacheKeyParts(request, snapshotVersion);

45+

const cacheKey = stringifyCacheKeyParts(cacheKeyParts);

3746

const cached = this.cache.get(cacheKey);

3847

if (cached) {

3948

return cached;

4049

}

4150

const index = this.loadIndex(request, cacheKey);

51+

this.pruneScope(cacheKeyParts.scope, cacheKey);

4252

this.cache.set(cacheKey, index);

53+

this.cacheScopes.set(cacheKey, cacheKeyParts.scope);

4354

return index;

4455

}

4556

@@ -62,15 +73,26 @@ export class SkillsService {

6273

pluginSkillsDir: opts?.pluginSkillsDir,

6374

snapshotVersion: opts?.snapshotVersion,

6475

};

65-

const index =

66-

opts?.snapshotVersion === undefined

67-

? this.loadIndex(request, buildSkillIndexCacheKey(request))

68-

: this.getIndex(request);

76+

const snapshotVersion = request.snapshotVersion ?? getSkillsSnapshotVersion(workspaceDir);

77+

const index = shouldCacheSkillIndex(snapshotVersion)

78+

? this.getIndex(request)

79+

: this.loadIndex(request, buildUncachedSkillIndexCacheKey(request, snapshotVersion));

6980

return buildSkillSnapshotFromIndex(workspaceDir, index, opts);

7081

}

71827283

invalidate(): void {

7384

this.cache.clear();

85+

this.cacheScopes.clear();

86+

}

87+88+

private pruneScope(scope: string, keepKey: string): void {

89+

for (const [key, cachedScope] of this.cacheScopes) {

90+

if (key === keepKey || cachedScope !== scope) {

91+

continue;

92+

}

93+

this.cache.delete(key);

94+

this.cacheScopes.delete(key);

95+

}

7496

}

7597

}

7698

@@ -98,13 +120,8 @@ export function buildWorkspaceSkillSnapshot(

98120

return skillsService.buildSnapshot(workspaceDir, opts);

99121

}

100122101-

function stableConfigHash(config?: OpenClawConfig): string {

102-

const skillsConfig = config?.skills ?? {};

103-

return crypto

104-

.createHash("sha256")

105-

.update(JSON.stringify(skillsConfig))

106-

.digest("hex")

107-

.slice(0, 16);

123+

function stableHash(value: unknown): string {

124+

return crypto.createHash("sha256").update(stableStringify(value)).digest("hex").slice(0, 16);

108125

}

109126110127

function normalizedOptionalPath(value?: string): string {

@@ -113,12 +130,82 @@ function normalizedOptionalPath(value?: string): string {

113130114131

export function buildSkillIndexCacheKey(request: SkillIndexRequest): string {

115132

const snapshotVersion = request.snapshotVersion ?? getSkillsSnapshotVersion(request.workspaceDir);

116-

return JSON.stringify({

133+

return stringifyCacheKeyParts(buildSkillIndexCacheKeyParts(request, snapshotVersion));

134+

}

135+136+

type SkillIndexCacheKeyParts = {

137+

scope: string;

138+

snapshotVersion: number;

139+

};

140+141+

function shouldCacheSkillIndex(snapshotVersion: number | undefined): boolean {

142+

return typeof snapshotVersion === "number" && snapshotVersion > 0;

143+

}

144+145+

function buildUncachedSkillIndexCacheKey(

146+

request: SkillIndexRequest,

147+

snapshotVersion: number,

148+

): string {

149+

return stableStringify({

150+

uncached: true,

151+

workspaceDir: path.resolve(request.workspaceDir),

152+

snapshotVersion,

153+

});

154+

}

155+156+

function buildSkillIndexCacheKeyParts(

157+

request: SkillIndexRequest,

158+

snapshotVersion: number,

159+

): SkillIndexCacheKeyParts {

160+

const scope = stableStringify({

117161

workspaceDir: path.resolve(request.workspaceDir),

118162

managedSkillsDir: normalizedOptionalPath(request.managedSkillsDir),

119163

bundledSkillsDir: normalizedOptionalPath(request.bundledSkillsDir),

120164

pluginSkillsDir: normalizedOptionalPath(request.pluginSkillsDir),

121-

skillsConfig: stableConfigHash(request.config),

122-

snapshotVersion,

165+

config: stableHash(request.config ?? {}),

166+

pluginDiscovery: resolvePluginSkillDiscoveryFingerprint(request),

167+

});

168+

return { scope, snapshotVersion };

169+

}

170+171+

function stringifyCacheKeyParts(parts: SkillIndexCacheKeyParts): string {

172+

return stableStringify(parts);

173+

}

174+175+

function resolvePluginSkillDiscoveryFingerprint(request: SkillIndexRequest): string {

176+

const snapshot = resolvePluginMetadataSnapshot({

177+

workspaceDir: request.workspaceDir,

178+

config: request.config ?? {},

179+

env: process.env,

180+

allowWorkspaceScopedCurrent: true,

181+

});

182+

return stableHash({

183+

policyHash: snapshot.policyHash,

184+

configFingerprint: snapshot.configFingerprint ?? null,

185+

registrySource: snapshot.registrySource ?? null,

186+

index: {

187+

hostContractVersion: snapshot.index.hostContractVersion,

188+

compatRegistryVersion: snapshot.index.compatRegistryVersion,

189+

migrationVersion: snapshot.index.migrationVersion,

190+

policyHash: snapshot.index.policyHash,

191+

installRecords: snapshot.index.installRecords,

192+

plugins: snapshot.index.plugins.map((plugin) => ({

193+

pluginId: plugin.pluginId,

194+

enabled: plugin.enabled,

195+

enabledByDefault: plugin.enabledByDefault ?? null,

196+

manifestHash: plugin.manifestHash,

197+

manifestPath: plugin.manifestPath,

198+

origin: plugin.origin,

199+

rootDir: plugin.rootDir,

200+

})),

201+

},

202+

manifestPlugins: snapshot.manifestRegistry.plugins.map((plugin) => ({

203+

id: plugin.id,

204+

enabledByDefault: plugin.enabledByDefault ?? null,

205+

kind: plugin.kind ?? null,

206+

origin: plugin.origin,

207+

rootDir: plugin.rootDir,

208+

skills: plugin.skills,

209+

})),

123210

});

124211

}