编程与代码辅助

语言与版本：【Python 3.12 / Node.js 22 等】
目标：【输入什么，期望输出什么】
约束：【依赖、兼容性、性能、安全或不能联网等】
输入输出示例：【】
相关代码与完整报错：【】
先说明你需要的最少假设；然后给出小范围修改、验证步骤和 2 个本地测试用例。不要改无关部分。

用【语言与版本】实现【功能】。
要求：给完整可运行代码，包含必要 import；关键步骤加简短注释；非法输入要有明确处理。
输入：【】；期望输出：【】；边界条件：【】
不要引入未说明的依赖。代码后给运行命令和至少 2 个本地测试例。

请在现有代码中增加【功能】，尽量小改，不重写无关部分。
先指出涉及的函数和边界，再提供补丁或修改后的完整函数；说明兼容性影响和测试方式。
现有代码：【粘贴最小相关部分】
项目约束：【框架、版本、测试命令】

先不要写代码。针对需求【】比较 2 种实现思路：复杂度、依赖、可维护性、风险和测试难点。
遵守约束：【】。推荐一个最小可行方案，并列出尚需确认的假设。

为以下函数补【测试框架】测试。覆盖：正常路径、空值或非法输入、一个边界条件。
测试应只断言可观察行为，不 mock 无关实现细节；给出运行命令。
函数与现有测试约定：【】

请帮我调试。
期望行为：【】；实际行为：【】
最小相关代码：【】
完整错误信息 / 堆栈：【】
请先用一句话指出最可能原因，再给最小修复建议和验证步骤。标出不确定假设，不要顺带重构。

帮我把这个故障缩成最小可复现例：指出必现输入、必要依赖和最少代码；建议哪些部分可安全移除。
先不要修改项目。区分你从材料确认的事实与推测；如果还缺信息，先问最关键的一项。

代码能运行，但结果不符合预期。
输入：【】；期望：【】；实际：【】
请沿执行流程跟踪关键变量，指出第一个偏离预期的位置。说明判断依据，先不要重写整段代码。

按“整体用途 → 执行流程 → 关键函数 → 输入输出与副作用 → 风险点”解释以下代码。
受众：【有基础的初学者 / 接手维护的工程师】。不要逐行翻译；指出无法从片段确认的部分。

只解释下列代码在整体流程中的作用，以及删除它可能造成的行为变化。
关注范围：【函数 / 行号 / 调用关系】
代码：【】

把下列逻辑整理成步骤列表；分支用“如果……则……”表达。说明输入、输出和错误路径，不新增代码中不存在的行为。
代码：【】

评审以下改动，按严重程度列出具体问题：正确性 / 安全 / 兼容性 / 可读性 / 性能。
每条包含：位置、触发条件、影响、建议修法或测试。只报告有依据的问题；没有发现时明确说明审查范围与测试缺口，不要只写泛泛赞美。

在外部行为不变的前提下重构这段代码，只做【提取函数 / 改善命名】。
先列出应保持不变的行为和可验证测试，再给补丁。不要引入新依赖，不要同时修复未要求的功能问题。
代码：【】

数据库与版本：【PostgreSQL】
表结构及索引：【】
需求：【】
请给出参数化 SQL，说明空值处理、可能的全表扫描与需要验证的执行计划。不要假设表中存在未列出的字段。

为【Python re / JavaScript】写正则，匹配：【】；不匹配：【】。
给出表达式、边界说明和至少 3 组正反测试。若正则不适合处理该输入，说明更稳妥的解析方法。

写一个 Bash 脚本完成【任务】，路径范围：【】。
失败时非零退出并给出原因；先说明会创建、覆盖或删除哪些文件。默认采用不破坏现有数据的方式，危险操作需给 dry-run 或确认步骤。

下列内容可能包含敏感值。请把密钥、Token、个人信息一律视为占位符，不要复述或猜测真实值。
回答只讨论代码逻辑；若需要示例，使用 YOUR_API_KEY 等虚构占位符，并提醒我检查日志、提交历史和配置文件中的真实密钥。