Skip to content

侧边栏列表的变化检测轮询 #16

Closed

Description

@lw396

Parent

#3

What to build

侧边栏显示时,每 60 秒对当前仓库的 issue 列表(state=all&sort=updated&per_page=1)发带 ETag 的条件请求:没变(304)就什么都不做,变了才重新搜索已展开的组(ADR 0006)。侧边栏看不见时不轮询,重新显示时立刻刷新一次。

Acceptance criteria

  • 先实测 gh 遇到 304 时的退出码和输出,结论写进 ticket 评论;gh 不行就退回每 60 秒重新搜索已展开的组
  • io 模块的"变化检测"返回"没变 / 变了 + 新 ETag",io 测试用真实回复覆盖
  • 确认侧边栏怎么知道自己在显示,结论写进 ticket 评论
  • 在 app 里:别人新开的 issue 约一分钟内出现;隐藏侧边栏时不发请求
  • bun run verify 通过

Activity

  1. self-assigned this
    on Nov 7, 2026
  2. lw396 commented on Nov 7, 2026

    @lw396
    OwnerAuthor

    实测 gh 2.96.0:gh api repos/lw396/herdr-plugin-github/issues?state=all\&sort=updated\&per_page=1 --include 首次 200,退出码 0,stdout 包含 HTTP 状态、ETag 和正文。携带同一个 If-None-Match 后返回 304,退出码 1,stdout 仍包含 HTTP/2.0 304 Not Modified 和响应头,stderr 为 gh: HTTP 304。可可靠识别 304,无需退回无条件重新搜索;真实回复已录作 IO 测试 fixture。

    可见性:Herdr layout() 返回当前实时布局树;与现有 tabs-github 一样检查祖先 hidden 和 stack.active。随附布局的 GitHub 侧边栏槽位 id 为 github;panel 隐藏或 panel-body 选中 Files/Changes 时不可见。隐藏副本的 timer 会继续运行,所以 timer 回调也检查可见性;布局变化重绘时检测重新显示并立即刷新。App 实际交互仍需在 Mac 上验证。

  3. lw396 commented on Nov 7, 2026

    @lw396
    OwnerAuthor

    实现已提交:6d9a90b。加入条件 GET 的 200/304/404 真实回复 IO 测试;可见时每 60 秒检测,变化后只刷新展开组;隐藏时跳过轮询,重新显示立即刷新;仓库/机器切换丢弃过期结果,分组刷新失败后下次重试。bun run verify 通过(197 tests、typecheck、两个 mod check、QuickJS smoke),bun run check:built 通过。

    尚未完成验收:需要在 Mac Herdr 内验证别人新建 issue 约一分钟内出现、切到 Files/Changes 或隐藏 panel 后无轮询请求、再次显示立即刷新。此服务器无显示,loading check 不代表交互验收。暂不关闭 ticket。

  4. lw396 commented on Nov 7, 2026

    @lw396
    OwnerAuthor

    Spec review 发现轮询失败后下一次 304 虽清除了内部错误、却未触发重绘,旧错误可能留在界面;已在 f97113a 修复。再次运行 bun run verify(197 tests)及 bun run check:built 全通过。Mac 验收请特别测试:隐藏后不足 60 秒就重新打开仍应立即刷新,以及多 space 切换。Standards review 首次运行无活动,已停止并重试一次。

  5. lw396 commented on Nov 7, 2026

    @lw396
    OwnerAuthor

    两轴 review 已完成。Spec 复审确认 f97113a 修复了 304 恢复后未重绘的问题,结论 OK;撤回多 space 重复轮询的判断(layout slot 副本并非每个 space 各一个)。Standards 结论 OK with notes:无 hard violation;建议未来抽取可测轮询状态逻辑、减少 304 响应头重复解析及改善命名。这些为非阻断建议;本次保留与既有 view 生命周期一致的调度方式,未扩展未经约定的 core 测试接缝。

    最终提交 6d9a90b + f97113a,verify 和 check:built 均通过,working tree clean。仍需 Mac 验证显示/隐藏及快速重新显示的交互,故 ticket 保持 open。

  6. lw396 commented on Nov 7, 2026

    @lw396
    OwnerAuthor

    按用户要求关闭。实现和修复已提交:6d9a90b、f97113a;verify(197 tests)和 check:built 通过,双轴 review 完成。此前记录的 Mac 显示/隐藏和快速重新显示交互未在本开发服务器验证。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions