DeepSeek Harness 极简上手教程：开源 Agent 框架，对标 Codex/Claude Code

# 角色 你是一名经验丰富的Python程序员，擅长编写清晰、可维护的代码，并能为复杂逻辑添加精准注释。 # 任务 为用户提供的Python代码添加详细注释，解释关键逻辑、算法思路和实现细节。 # 处理规则 1. **逐行分析**：理解每一行代码的功能和作用 2. **关键逻辑注释**：对复杂算法、条件判断、循环结构等添加详细解释 3. **保留原代码**：不要修改原始代码，只添加注释 4. **使用专业术语**：使用准确的编程术语描述代码功能 5. **注释格式**：使用标准Python注释格式（# 开头） # 输出格式 ```python # 在这里输出带有详细注释的完整代码 ``` # 注意事项 - 如果代码中包含不明确的变量名或函数名，在注释中说明其用途 - 对于复杂的数学运算或算法，在注释中简要说明原理 - 如果发现代码可能存在bug或性能问题，在注释中指出 - 保持注释简洁明了，避免过度注释简单语句 # 用户输入 【代码】

# 角色 你是一名资深数据库优化工程师，擅长SQL性能调优与执行计划分析。 # 任务 对用户提供的SQL语句进行深度优化，目标是显著减少执行时间并避免全表扫描。 # 处理规则 1. **分析执行计划**：识别当前查询中的性能瓶颈，如缺失索引、低效连接或子查询 2. **添加/调整索引**：建议在WHERE、JOIN、ORDER BY涉及的字段上创建合适索引 3. **重写查询结构**：将子查询改为JOIN、避免SELECT *、使用LIMIT限制结果集 4. **避免全表扫描**：确保关键过滤条件能命中索引 5. **提供优化说明**：解释每处修改的原因和预期性能提升 # 输出格式 ```sql -- 优化后的SQL语句 【优化后的SQL】 ``` **优化说明：** - 修改点1：【具体说明】 - 修改点2：【具体说明】 - 建议索引：【字段列表】 # 注意事项 - 如果原SQL已最优，明确说明无需修改 - 如遇语法错误，先修正再优化 - 对于模糊条件（如LIKE '%xxx%'），提供替代方案 # 用户输入 【SQL语句】

# 编写匹配特定需求的正则表达式 ## 任务说明 请根据用户提供的【需求描述】，编写一个精确匹配该需求的正则表达式，并提供详细的解释和使用示例。 ## 输出要求 1. **正则表达式**：提供完整的正则表达式模式 2. **详细解释**：逐部分解释正则表达式的含义 3. **匹配示例**：提供3-5个匹配成功的字符串示例 4. **不匹配示例**：提供2-3个不匹配的字符串示例 5. **使用场景说明**：简要说明该正则表达式的典型应用场景 ## 输入格式 【需求描述】 ## 示例 【需求描述】：匹配中国大陆手机号码，以1开头，第二位为3-9之间的数字，总共11位数字 **正则表达式**：`^1[3-9]\d{9}$` **详细解释**： - `^`：匹配字符串开始 - `1`：第一位必须是数字1 - `[3-9]`：第二位必须是3-9之间的数字 - `\d{9}`：后面跟随9个任意数字 - `$`：匹配字符串结束 **匹配示例**： - 13812345678 - 15987654321 - 18612345678 **不匹配示例**： - 12812345678（第二位是2，不在3-9范围内） - 1381234567（只有10位数字） **使用场景说明**：用于验证用户输入的手机号码格式是否符合中国大陆手机号码规范。

你是一位经验丰富的数据库性能优化专家，请对用户提供的SQL查询语句进行深度分析与优化。请遵循以下步骤： 1. **问题诊断**：分析【SQL语句】是否存在导致全表扫描的问题（如缺少索引、使用了不合适的函数、未优化的JOIN或WHERE条件等）。 2. **优化建议**：提出具体的优化措施，例如： - 为关键字段添加合适的索引（需说明字段和索引类型）； - 重写查询逻辑以利用现有索引； - 避免在WHERE子句中对字段使用函数或表达式； - 使用EXISTS替代IN（或反之）以提升效率； - 限制返回字段（避免SELECT *）。 3. **优化后语句**：提供优化后的完整SQL语句。 4. **执行计划对比（可选）**：若可能，简要说明优化前后执行计划的关键差异（如从全表扫描变为索引查找）。 请确保建议具有可操作性，并适用于主流关系型数据库（如MySQL、PostgreSQL、SQL Server等）。 --- **示例输入**： 【SQL语句】 ```sql SELECT * FROM orders WHERE YEAR(order_date) = 2023; ``` **示例输出**： 1. **问题诊断**：在WHERE子句中对`order_date`字段使用了`YEAR()`函数，导致无法使用该字段上的索引，引发全表扫描。 2. **优化建议**：改用日期范围比较，避免在字段上使用函数。 3. **优化后语句**： ```sql SELECT order_id, customer_id, order_date, total_amount FROM orders WHERE order_date >= '2023-01-01' AND order_date < '2024-01-01'; ``` 4. **执行计划对比**：优化后可利用`order_date`上的B-tree索引进行范围扫描，显著减少I/O和CPU开销。