[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6XCAYFW5GW70HERWT0QAF6Y":3,"skill-same:01M6XCAYFW5GW70HERWT0QAF6Y":63},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":32,"linkOnly":33,"markdownContent":34,"markdownBody":35,"frontMatter":36,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":13,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M6XCAYFW5GW70HERWT0QAF6Y","refresh-scheduler",null,"Manage timed data refresh intervals for all dashboard panels. Handles pause-when-hidden, stale-data flush on visibility restore, and staggered refresh to avoid API bursts.","UF-gzj\u002Fopenspace-claude-evolution","UF-gzj","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F272393507?v=4","01M6XBCZB755P01VVYGQWPYZY3","01M6XBCZFJA5AREA17WGETA3FW",0,"MIT","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Frefresh-scheduler\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29,30,31],"scheduler","refresh","refresh scheduler","dashboard","data","api","stale","restore","manage","panels","for","pause","hidden","when","2026-11-10 10:12:30",false,"---\nname: refresh-scheduler\ndescription: Manage timed data refresh intervals for all dashboard panels. Handles pause-when-hidden, stale-data flush on visibility restore, and staggered refresh to avoid API bursts.\n---\n\n# Refresh Scheduler Pattern\n\nThe refresh scheduler manages periodic data fetching for all panels, pausing when the tab is hidden and flushing stale data when the user returns.\n\n## Implementation\n\nCreate `src\u002Fservices\u002Frefresh-scheduler.ts`:\n\n```typescript\nexport interface RefreshRegistration {\n  name: string;\n  fn: () => Promise\u003Cvoid>;\n  intervalMs: number;\n  condition?: () => boolean;\n}\n\ninterface RunnerEntry {\n  timer: ReturnType\u003Ctypeof setInterval> | null;\n  intervalMs: number;\n  fn: () => Promise\u003Cvoid>;\n  condition?: () => boolean;\n  lastRun: number;\n}\n\nexport class RefreshScheduler {\n  private runners = new Map\u003Cstring, RunnerEntry>();\n  private inFlight = new Set\u003Cstring>();\n  private hiddenSince = 0;\n  private visibilityHandler: (() => void) | null = null;\n\n  constructor() {\n    this.visibilityHandler = () => this.onVisibilityChange();\n    document.addEventListener('visibilitychange', this.visibilityHandler);\n  }\n\n  private onVisibilityChange(): void {\n    if (document.hidden) {\n      this.hiddenSince = Date.now();\n      \u002F\u002F Pause all timers\n      for (const entry of this.runners.values()) {\n        if (entry.timer) {\n          clearInterval(entry.timer);\n          entry.timer = null;\n        }\n      }\n    } else {\n      \u002F\u002F Resume and flush stale\n      this.flushStaleRefreshes();\n      for (const [name, entry] of this.runners) {\n        if (!entry.timer) {\n          entry.timer = setInterval(() => this.runRefresh(name), entry.intervalMs);\n        }\n      }\n    }\n  }\n\n  private async runRefresh(name: string): Promise\u003Cvoid> {\n    const entry = this.runners.get(name);\n    if (!entry) return;\n    if (this.inFlight.has(name)) return;\n    if (entry.condition && !entry.condition()) return;\n\n    this.inFlight.add(name);\n    try {\n      await entry.fn();\n      entry.lastRun = Date.now();\n    } catch (err) {\n      console.error(`[Refresh] ${name} failed:`, err);\n    } finally {\n      this.inFlight.delete(name);\n    }\n  }\n\n  scheduleRefresh(\n    name: string,\n    fn: () => Promise\u003Cvoid>,\n    intervalMs: number,\n    condition?: () => boolean,\n  ): void {\n    \u002F\u002F Clean up existing\n    const existing = this.runners.get(name);\n    if (existing?.timer) clearInterval(existing.timer);\n\n    const entry: RunnerEntry = {\n      timer: null,\n      intervalMs,\n      fn,\n      condition,\n      lastRun: 0,\n    };\n\n    if (!document.hidden) {\n      entry.timer = setInterval(() => this.runRefresh(name), intervalMs);\n    }\n\n    this.runners.set(name, entry);\n  }\n\n  \u002F**\n   * After returning from hidden, flush all runners whose data\n   * is older than their interval. Stagger to avoid API burst.\n   *\u002F\n  flushStaleRefreshes(): void {\n    if (!this.hiddenSince) return;\n    const hiddenMs = Date.now() - this.hiddenSince;\n    this.hiddenSince = 0;\n\n    let stagger = 0;\n    for (const [name, entry] of this.runners) {\n      if (hiddenMs \u003C entry.intervalMs) continue;\n      const delay = stagger;\n      stagger += 150; \u002F\u002F 150ms between each flush\n      setTimeout(() => this.runRefresh(name), delay);\n    }\n  }\n\n  registerAll(registrations: RefreshRegistration[]): void {\n    for (const reg of registrations) {\n      this.scheduleRefresh(reg.name, reg.fn, reg.intervalMs, reg.condition);\n    }\n  }\n\n  \u002F** Manually trigger a specific refresh immediately *\u002F\n  trigger(name: string): void {\n    this.runRefresh(name);\n  }\n\n  destroy(): void {\n    if (this.visibilityHandler) {\n      document.removeEventListener('visibilitychange', this.visibilityHandler);\n    }\n    for (const entry of this.runners.values()) {\n      if (entry.timer) clearInterval(entry.timer);\n    }\n    this.runners.clear();\n    this.inFlight.clear();\n  }\n}\n```\n\n## Usage\n\n```typescript\n\u002F\u002F src\u002Fmain.ts\nimport { RefreshScheduler } from '.\u002Fservices\u002Frefresh-scheduler';\n\nconst scheduler = new RefreshScheduler();\n\n\u002F\u002F Register panel refresh intervals\nscheduler.registerAll([\n  { name: 'stocks', fn: () => stockPanel.refresh(), intervalMs: 60_000 },\n  { name: 'news',   fn: () => newsPanel.refresh(),  intervalMs: 5 * 60_000 },\n  { name: 'email',  fn: () => emailPanel.refresh(), intervalMs: 2 * 60_000 },\n  { name: 'calendar', fn: () => calendarPanel.refresh(), intervalMs: 5 * 60_000 },\n]);\n```\n\n## Key Behaviors\n\n1. **Pause when hidden** — stops all intervals when tab is not visible\n2. **Flush on return** — refreshes stale panels with 150ms stagger to avoid API burst\n3. **In-flight guard** — prevents duplicate requests for the same panel\n4. **Configurable intervals** — each panel has its own refresh rate\n5. **Condition guard** — optional condition function to skip refresh (e.g. panel hidden)\n\n","# Refresh Scheduler Pattern\n\nThe refresh scheduler manages periodic data fetching for all panels, pausing when the tab is hidden and flushing stale data when the user returns.\n\n## Implementation\n\nCreate `src\u002Fservices\u002Frefresh-scheduler.ts`:\n\n```typescript\nexport interface RefreshRegistration {\n  name: string;\n  fn: () => Promise\u003Cvoid>;\n  intervalMs: number;\n  condition?: () => boolean;\n}\n\ninterface RunnerEntry {\n  timer: ReturnType\u003Ctypeof setInterval> | null;\n  intervalMs: number;\n  fn: () => Promise\u003Cvoid>;\n  condition?: () => boolean;\n  lastRun: number;\n}\n\nexport class RefreshScheduler {\n  private runners = new Map\u003Cstring, RunnerEntry>();\n  private inFlight = new Set\u003Cstring>();\n  private hiddenSince = 0;\n  private visibilityHandler: (() => void) | null = null;\n\n  constructor() {\n    this.visibilityHandler = () => this.onVisibilityChange();\n    document.addEventListener('visibilitychange', this.visibilityHandler);\n  }\n\n  private onVisibilityChange(): void {\n    if (document.hidden) {\n      this.hiddenSince = Date.now();\n      \u002F\u002F Pause all timers\n      for (const entry of this.runners.values()) {\n        if (entry.timer) {\n          clearInterval(entry.timer);\n          entry.timer = null;\n        }\n      }\n    } else {\n      \u002F\u002F Resume and flush stale\n      this.flushStaleRefreshes();\n      for (const [name, entry] of this.runners) {\n        if (!entry.timer) {\n          entry.timer = setInterval(() => this.runRefresh(name), entry.intervalMs);\n        }\n      }\n    }\n  }\n\n  private async runRefresh(name: string): Promise\u003Cvoid> {\n    const entry = this.runners.get(name);\n    if (!entry) return;\n    if (this.inFlight.has(name)) return;\n    if (entry.condition && !entry.condition()) return;\n\n    this.inFlight.add(name);\n    try {\n      await entry.fn();\n      entry.lastRun = Date.now();\n    } catch (err) {\n      console.error(`[Refresh] ${name} failed:`, err);\n    } finally {\n      this.inFlight.delete(name);\n    }\n  }\n\n  scheduleRefresh(\n    name: string,\n    fn: () => Promise\u003Cvoid>,\n    intervalMs: number,\n    condition?: () => boolean,\n  ): void {\n    \u002F\u002F Clean up existing\n    const existing = this.runners.get(name);\n    if (existing?.timer) clearInterval(existing.timer);\n\n    const entry: RunnerEntry = {\n      timer: null,\n      intervalMs,\n      fn,\n      condition,\n      lastRun: 0,\n    };\n\n    if (!document.hidden) {\n      entry.timer = setInterval(() => this.runRefresh(name), intervalMs);\n    }\n\n    this.runners.set(name, entry);\n  }\n\n  \u002F**\n   * After returning from hidden, flush all runners whose data\n   * is older than their interval. Stagger to avoid API burst.\n   *\u002F\n  flushStaleRefreshes(): void {\n    if (!this.hiddenSince) return;\n    const hiddenMs = Date.now() - this.hiddenSince;\n    this.hiddenSince = 0;\n\n    let stagger = 0;\n    for (const [name, entry] of this.runners) {\n      if (hiddenMs \u003C entry.intervalMs) continue;\n      const delay = stagger;\n      stagger += 150; \u002F\u002F 150ms between each flush\n      setTimeout(() => this.runRefresh(name), delay);\n    }\n  }\n\n  registerAll(registrations: RefreshRegistration[]): void {\n    for (const reg of registrations) {\n      this.scheduleRefresh(reg.name, reg.fn, reg.intervalMs, reg.condition);\n    }\n  }\n\n  \u002F** Manually trigger a specific refresh immediately *\u002F\n  trigger(name: string): void {\n    this.runRefresh(name);\n  }\n\n  destroy(): void {\n    if (this.visibilityHandler) {\n      document.removeEventListener('visibilitychange', this.visibilityHandler);\n    }\n    for (const entry of this.runners.values()) {\n      if (entry.timer) clearInterval(entry.timer);\n    }\n    this.runners.clear();\n    this.inFlight.clear();\n  }\n}\n```\n\n## Usage\n\n```typescript\n\u002F\u002F src\u002Fmain.ts\nimport { RefreshScheduler } from '.\u002Fservices\u002Frefresh-scheduler';\n\nconst scheduler = new RefreshScheduler();\n\n\u002F\u002F Register panel refresh intervals\nscheduler.registerAll([\n  { name: 'stocks', fn: () => stockPanel.refresh(), intervalMs: 60_000 },\n  { name: 'news',   fn: () => newsPanel.refresh(),  intervalMs: 5 * 60_000 },\n  { name: 'email',  fn: () => emailPanel.refresh(), intervalMs: 2 * 60_000 },\n  { name: 'calendar', fn: () => calendarPanel.refresh(), intervalMs: 5 * 60_000 },\n]);\n```\n\n## Key Behaviors\n\n1. **Pause when hidden** — stops all intervals when tab is not visible\n2. **Flush on return** — refreshes stale panels with 150ms stagger to avoid API burst\n3. **In-flight guard** — prevents duplicate requests for the same panel\n4. **Configurable intervals** — each panel has its own refresh rate\n5. **Condition guard** — optional condition function to skip refresh (e.g. panel hidden)\n\n",{"name":5,"description":7},"main","0650921d63895de3997bc81f1ff1d0ac67032072","showcase\u002Fskills\u002Frefresh-scheduler","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution","https:\u002F\u002Fgithub.com\u002FUF-gzj","2026-04-16 09:31:03",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add UF-gzj\u002Fopenspace-claude-evolution --skill refresh-scheduler",{"tool":49,"command":50},"bunx","bunx skills add UF-gzj\u002Fopenspace-claude-evolution --skill refresh-scheduler",{"tool":52,"command":53},"pnpm","pnpm dlx skills add UF-gzj\u002Fopenspace-claude-evolution --skill refresh-scheduler","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Frefresh-scheduler\u002FSKILL.md",true,[57],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},".skill_id","OTHER","其他",32,"https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Frefresh-scheduler\u002F.skill_id",[64,88,105,114,140,156],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":32},"01M6XCCXD3NCM2YKR3WNGBASPC","write-special-chars-ts-check","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-ts-check\u002FSKILL.md",[],[71,72,73,74,75,76,77,78,28,79,80,81,82,83,84,85,86,87],"check","write","write special chars ts check","typescript","filters","characters","Existing","type-checking","errors","script","output","type","files","only","template","file","python",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":32},"01M6XCCT7E3J922Q345PBGSHPN","write-special-chars-readback","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of \u002Ftmp helper scripts.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-readback\u002FSKILL.md",[],[95,96,72,86,97,87,98,99,100,101,102,85,103,104,76,28,80],"readback","write special chars readback","helper","post","via","scripts","cleanup","read","verification","with",{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":32},"01M6XCCMQX1R8B6FECWB3P63T7","write-special-chars-heredoc","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) by using a Python heredoc script executed via shell.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-heredoc\u002FSKILL.md",[],[112,72,76,113,80,99,85,86,87,28],"write special chars heredoc","shell",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":125,"publishedAt":32},"01M6XCCG41M994JJEX6VN52PEP","worldmonitor-reference","Curated architecture index of the WorldMonitor open-source dashboard. Reference for extracting patterns — vanilla TypeScript, Panel class hierarchy, service layer, CSS grid, API edge functions, refresh scheduler, and 60+ data source integrations.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fworldmonitor-reference\u002FSKILL.md",[120],{"categoryNo":121,"categoryName":122,"taxonomyType":123,"taxonomyTypeDesc":124},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",[126,127,128,129,21,74,130,18,131,132,133,28,134,135,136,137,138,139,23,22],"reference","worldmonitor","worldmonitor reference","architecture","css","layer","hierarchy","source","extracting","panel","patterns","edge functions","integrations","open",{"skillNo":141,"name":142,"nameZh":6,"description":143,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":144,"categories":145,"keywords":146,"publishedAt":32},"01M6XCCCHWNKG2W4VH9E6A10HF","virtual-list","Implement efficient virtual scrolling for rendering large lists with DOM recycling, chunk-based rendering, and performance optimizations","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fvirtual-list\u002FSKILL.md",[],[147,148,149,150,28,151,104,152,153,154,155],"virtual list","list","virtual","chunk","dom","rendering","recycling","implement","performance",{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":32},"01M6XCC7X8PKMR2DEW91XGHYSV","verify-directory-structure","Diagnose and resolve file access issues by first verifying the directory structure.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fverify-directory-structure\u002FSKILL.md",[],[163,164,165,166,167,168,86,169,170,171],"directory","verify directory structure","structure","verify","access","first","issues","diagnose","file access"]