{"record":{"id":"c1ccf6e6db3952c6","repo":"jackwener/OpenCLI","slug":"replies-limit-must-be-an-integer-between-0-and","errorCode":null,"errorMessage":"--replies-limit must be an integer between 0 and ${MAX_REPLIES_LIMIT}","messagePattern":"--replies-limit must be an integer between 0 and (.+?)","errorType":"validation","errorClass":"ArgumentError","httpStatus":null,"severity":"error","filePath":"clis/zhihu/answer-comments.js","lineNumber":49,"sourceCode":"        { name: 'replies-limit', type: 'int', default: 3, help: 'Number of replies to include per top-level comment (max 100)' },\n        { name: 'order', default: 'score', choices: ['score', 'latest'], help: 'Root comment order' },\n    ],\n    columns: ['rank', 'comment_rank', 'reply_rank', 'depth', 'id', 'parent_id', 'author', 'reply_to', 'likes', 'created_at', 'url', 'content'],\n    func: async (page, kwargs) => {\n        const target = parseAnswerTarget(kwargs.id);\n        if (!target) {\n            throw new ArgumentError(\n                'Answer ID must be a numeric id, a Zhihu answer URL, or answer:<qid>:<aid>',\n                'Example: opencli zhihu answer-comments 1937205528846655537',\n            );\n        }\n        const topLevelLimit = Number(kwargs.limit ?? 20);\n        if (!Number.isInteger(topLevelLimit) || topLevelLimit <= 0 || topLevelLimit > MAX_LIMIT) {\n            throw new ArgumentError(`--limit must be a positive integer no greater than ${MAX_LIMIT}`);\n        }\n        const repliesLimit = Number(kwargs['replies-limit'] ?? 3);\n        if (!Number.isInteger(repliesLimit) || repliesLimit < 0 || repliesLimit > MAX_REPLIES_LIMIT) {\n            throw new ArgumentError(`--replies-limit must be an integer between 0 and ${MAX_REPLIES_LIMIT}`);\n        }\n        const order = String(kwargs.order ?? 'score');\n        if (order !== 'score' && order !== 'latest') {\n            throw new ArgumentError('--order must be score or latest');\n        }\n\n        const { answerId } = target;\n        try {\n            await page.goto(`https://www.zhihu.com/answer/${answerId}`);\n        } catch (err) {\n            throw new CommandExecutionError(\n                `Failed to open Zhihu answer ${answerId}: ${err instanceof Error ? err.message : String(err)}`,\n                'Open the answer URL in Chrome and retry after the page is reachable.',\n            );\n        }\n        const currentQuestionId = page.getCurrentUrl\n            ? extractQuestionIdFromAnswerUrl(await page.getCurrentUrl().catch(() => ''))\n            : '';","sourceCodeStart":31,"sourceCodeEnd":67,"githubUrl":"https://github.com/jackwener/OpenCLI/blob/49907e53dc3ade5c223ff0c4c2c2785687cec4e6/clis/zhihu/answer-comments.js#L31-L67","documentation":"--replies-limit caps how many replies per root comment are fetched; it must be an integer between 0 and MAX_REPLIES_LIMIT (0 legitimately means 'no replies'). Values outside this range, non-integers, or negatives throw this ArgumentError.","triggerScenarios":"--replies-limit -1 (to mean 'unlimited'), a value above MAX_REPLIES_LIMIT, or a non-numeric value.","commonSituations":"Users expecting -1 or 'all' to fetch every reply; scripts interpolating undefined into the flag; confusion between --limit and --replies-limit semantics.","solutions":["Use an integer in [0, MAX_REPLIES_LIMIT], e.g. --replies-limit 10","Use 0 when you want no replies fetched","Omit the flag to use the default of 3"],"exampleFix":"// before\nopencli zhihu answer-comments 123 --replies-limit -1\n// after\nopencli zhihu answer-comments 123 --replies-limit 10","handlingStrategy":"validation","validationCode":"const rl = Number(rawRepliesLimit ?? 3);\nif (!Number.isInteger(rl) || rl < 0 || rl > MAX_REPLIES_LIMIT) throw new Error(`--replies-limit must be 0..${MAX_REPLIES_LIMIT}`);","typeGuard":"const isValidRepliesLimit = (v) => Number.isInteger(v) && v >= 0 && v <= MAX_REPLIES_LIMIT;","tryCatchPattern":"try { await answerComments({ 'replies-limit': rl }); }\ncatch (err) {\n  if (String(err.message).startsWith('--replies-limit')) { await answerComments({ 'replies-limit': 3 }); }\n  else throw err;\n}","preventionTips":["Remember 0 is valid (no replies); negatives are not 'unlimited'","Clamp values into [0, MAX_REPLIES_LIMIT] in wrapper scripts","Validate before invoking the CLI to fail fast"],"tags":["zhihu","argument-validation","cli-input"],"backgroundTag":"invalid-limit-value","analyzedSha":"49907e53dc3ade5c223ff0c4c2c2785687cec4e6","analyzedAt":"2026-08-29T08:14:47.543Z","schemaVersion":2},"datasetVersion":"2026-08-29T12:17:43.993Z"}