{"record":{"id":"59a6ada1d5f3afe3","repo":"OtterMind/Chat2DB","slug":"prepared-qq-notification-message-is-invalid","errorCode":null,"errorMessage":"Prepared QQ notification message is invalid","messagePattern":"Prepared QQ notification message is invalid","errorType":"validation","errorClass":"ConfigurationError","httpStatus":null,"severity":"error","filePath":"script/github/notify_qq.py","lineNumber":261,"sourceCode":"\n\ndef _read_prepared_message(path: Path, repository: str) -> tuple[str, str]:\n    if not path.is_file() or path.stat().st_size > 4096:\n        raise ConfigurationError(\"Prepared QQ notification is missing or too large\")\n    try:\n        envelope = json.loads(path.read_text(encoding=\"utf-8\"))\n    except (OSError, UnicodeError, json.JSONDecodeError) as error:\n        raise ConfigurationError(\"Prepared QQ notification is not valid JSON\") from error\n    if not isinstance(envelope, Mapping) or envelope.get(\"version\") != 1:\n        raise ConfigurationError(\"Prepared QQ notification has an invalid format\")\n    if envelope.get(\"repository\") != repository:\n        raise ConfigurationError(\"Prepared QQ notification repository does not match\")\n    event_name = str(envelope.get(\"event_name\") or \"\")\n    if event_name not in COLLECTED_EVENT_NAMES:\n        raise ConfigurationError(\"Prepared QQ notification event is not allowed\")\n    message = envelope.get(\"message\")\n    if not isinstance(message, str) or not message or len(message) > 900:\n        raise ConfigurationError(\"Prepared QQ notification message is invalid\")\n    if re.search(r\"[\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f\\x7f]\", message):\n        raise ConfigurationError(\"Prepared QQ notification contains control characters\")\n    if re.search(r\"(?i)\\[CQ:\", message):\n        raise ConfigurationError(\"Prepared QQ notification contains a OneBot CQ code\")\n    return event_name, message\n\n\ndef _event_detail(event_name: str, action: str, payload: Mapping[str, Any]) -> str:\n    if action in {\"labeled\", \"unlabeled\"}:\n        label = payload.get(\"label\") or {}\n        return f\"标签：{_clean_text(label.get('name'), 80)}\"\n    if action in {\"assigned\", \"unassigned\"}:\n        return f\"处理人：{_login(payload.get('assignee'))}\"\n    if action in {\"milestoned\", \"demilestoned\"}:\n        milestone = payload.get(\"milestone\") or {}\n        return f\"里程碑：{_clean_text(milestone.get('title'), 100)}\"\n    if action in {\"review_requested\", \"review_request_removed\"}:\n        reviewer = _login(payload.get(\"requested_reviewer\"))","sourceCodeStart":243,"sourceCodeEnd":279,"githubUrl":"https://github.com/OtterMind/Chat2DB/blob/5ee1e990e73fbcae1969dc554be254fedb3ab888/script/github/notify_qq.py#L243-L279","documentation":"Raised by _read_prepared_message (notify_qq.py:261) when the envelope's \"message\" is not a non-empty string of at most 900 characters. The relay and OneBot enforce a 900-char ceiling, so an envelope violating it is rejected before sending.","triggerScenarios":"The \"message\" field is null, a number, an empty string, a JSON array/object, or a string longer than 900 characters. Reaches here only via the QQ_PREPARED_MESSAGE_PATH read path.","commonSituations":"Hand-editing the JSON and omitting or corrupting message; truncating the envelope manually; an envelope from a script version that allowed a different length cap.","solutions":["Regenerate the envelope with the current collect step so message is built and bounded by _join_message_lines (max 900).","If editing by hand, set message to a non-empty string no longer than 900 characters.","Discard the artifact and re-run the collect job."],"exampleFix":null,"handlingStrategy":"type-guard","validationCode":"message = envelope.get(\"message\")\nif not isinstance(message, str) or not message or len(message) > 900:\n    raise SystemExit(\"message must be a non-empty string <= 900 chars\")","typeGuard":"def is_valid_message(envelope: object) -> bool:\n    msg = envelope.get(\"message\") if isinstance(envelope, Mapping) else None\n    return isinstance(msg, str) and 0 < len(msg) <= 900","tryCatchPattern":null,"preventionTips":["Regenerate envelopes through the collect step rather than editing them.","Keep messages short; the builder already truncates via _join_message_lines."],"tags":["config","github-actions","notification","validation","type-check"],"backgroundTag":null,"analyzedSha":"5ee1e990e73fbcae1969dc554be254fedb3ab888","analyzedAt":"2026-08-14T07:05:03.077Z","schemaVersion":2},"datasetVersion":"2026-08-14T10:17:34.591Z"}