Skip to content

fix: clarify 24h window reminder behavior#223

Open
awsl233777 wants to merge 1 commit intomainfrom
fix/issue-221-renewal-copy
Open

fix: clarify 24h window reminder behavior#223
awsl233777 wants to merge 1 commit intomainfrom
fix/issue-221-renewal-copy

Conversation

@awsl233777
Copy link
Copy Markdown

@awsl233777 awsl233777 commented Apr 13, 2026

Summary

  • close the misleading gap behind 24 小时窗口自动续期怎么操作的? #221 by renaming the bot setting from 自动续期 to 到期提醒
  • clarify in README and bot detail tooltip that Hub currently sends reminder messages before expiry, but cannot silently auto-renew the 24h WeChat window in the background
  • update the reminder copy to tell users to reply with any message instead of implying a special "OK" command

Why

Issue #221 was caused by product copy overstating the current capability. The code only supports reminder-before-expiry, while the docs/UI claimed automatic renewal. That mismatch led users to expect hands-free renewal and treat the later 409 conflict as a bug in the renew flow.

Validation

  •  ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND  No package.json (or package.yaml, or package.json5) was found in "/home/moltbot/clawd-wechat/_work/openilink-hub".
  •  ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND  No package.json (or package.yaml, or package.json5) was found in "/home/moltbot/clawd-wechat/_work/openilink-hub".
  • ok github.com/openilink/openilink-hub/internal/api (cached)
    ok github.com/openilink/openilink-hub/internal/bot (cached)

Closes #221

Summary by CodeRabbit

  • Documentation

    • Updated README to clarify the 24-hour window reminder system and its behavior.
  • Bug Fixes

    • Corrected UI labels and messaging from "auto-renewal" to "expiry reminder" to accurately reflect feature behavior.
    • Updated reminder notification instruction to request "any message" instead of "OK" reply to refresh the WeChat 24-hour window.
    • Enhanced tooltip with clarification about WeChat window limitations and renewal process.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 13, 2026

📝 Walkthrough

Walkthrough

This PR updates the 24-hour WeChat window feature documentation and user-facing text to clarify that the system provides expiry reminders rather than automatic renewal. Users are reminded shortly before the window expires and can manually reply with any message to refresh the window. Message text in reminders and UI labels have been updated accordingly across documentation, backend messaging, and frontend components.

Changes

Cohort / File(s) Summary
Documentation
README.md
Updated feature descriptions replacing "24-hour auto-renewal" (自动续期) with "pre-expiry reminders" (到期前提醒). Added clarification block explaining that Hub reminds users before window expiry rather than auto-renewing, and users must reply to restart the timing.
Backend Reminder Logic
internal/bot/manager.go
Modified inactivity reminder message instruction from "reply OK" to "reply any message" to clarify users can send any message to refresh the 24-hour window.
Frontend UI and Tests
web/src/pages/bot-detail.tsx, web/src/pages/bot-detail.test.tsx
Updated UI section labels and select option text from "自动续期" to "到期提醒"; enhanced tooltip with additional explanatory paragraphs about WeChat window limitations. Added test case verifying new terminology presence and absence of old terminology.
Bot Instance Display
web/src/pages/bots.tsx
Updated reminder display label from 提前 {24 - bot.reminder_hours}h 提醒 to 到期前 {24 - bot.reminder_hours}h 提醒; refactored WebSocket error handling and component formatting without behavioral changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Poem

🐰 A rabbit's whisper on the window pane,
"No magic auto-refresh, but a gentle chain—
Reply before the dawn breaks through,
And twenty-four hours bloom anew!" 📬

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'fix: clarify 24h window reminder behavior' directly addresses the main objective: clarifying misleading wording about auto-renewal and explaining the actual reminder-before-expiry behavior.
Linked Issues check ✅ Passed All coding changes in this PR directly address #221's concerns: renaming '自动续期' to '到期提醒', updating UI/docs to clarify that Hub sends reminders but cannot auto-renew silently, and updating copy to instruct users to reply with any message.
Out of Scope Changes check ✅ Passed All changes are scoped to clarifying the 24-hour window reminder behavior: documentation updates, UI label/copy changes, test updates, and WebSocket formatting adjustments are all directly related to addressing the misleading auto-renewal claims.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/issue-221-renewal-copy

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 142-145: The English README still claims "auto session renewal"
which contradicts the Chinese clarification about reminder-only behavior; find
the English section that mentions "auto session renewal" (e.g., the "Multiple
Bot Management" / "Multi-Bot management" paragraph) and update the wording to
match the Chinese note — replace claims of automatic background renewal with a
clear statement that Hub only provides "pre-expiry reminders" and that users
must reply to the message to restart the 24-hour window; ensure the English text
mirrors the Chinese explanation and removes any implication of silent/automatic
renewal.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 164166cb-d77a-4f09-8092-9fab17e805de

📥 Commits

Reviewing files that changed from the base of the PR and between 0fcaacb and 6403e31.

📒 Files selected for processing (5)
  • README.md
  • internal/bot/manager.go
  • web/src/pages/bot-detail.test.tsx
  • web/src/pages/bot-detail.tsx
  • web/src/pages/bots.tsx

Comment thread README.md
Comment on lines +142 to 145
**多 Bot 管理** · 扫码绑定多个微信号,统一面板看状态,到期前提醒防掉线。

> 说明:微信 24 小时窗口目前不能由 Hub 在后台静默自动续期。Hub 现在支持的是“到期前提醒”,会在窗口快到期时提醒你回一条消息,收到回复后窗口会重新开始计时。

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

English section still contradicts the new reminder-only behavior.

The Chinese clarification is good, but README.md Line 472 still says “auto session renewal,” which conflicts with this PR’s corrected behavior and can mislead English users.

📝 Proposed doc fix
-- **Multi-bot management** — Bind and manage multiple WeChat accounts, auto session renewal
+- **Multi-bot management** — Bind and manage multiple WeChat accounts, expiry reminders before the 24-hour window ends
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 142 - 145, The English README still claims "auto
session renewal" which contradicts the Chinese clarification about reminder-only
behavior; find the English section that mentions "auto session renewal" (e.g.,
the "Multiple Bot Management" / "Multi-Bot management" paragraph) and update the
wording to match the Chinese note — replace claims of automatic background
renewal with a clear statement that Hub only provides "pre-expiry reminders" and
that users must reply to the message to restart the 24-hour window; ensure the
English text mirrors the Chinese explanation and removes any implication of
silent/automatic renewal.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

24 小时窗口自动续期怎么操作的?

1 participant