workbuddy通过ask、craft、plan等模式，实现从技术选型、代码生成、自动装依赖、读源码修bug到批量重构的全流程编程辅助，全程支持人话交互与本地文件操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用WorkBuddy辅助写代码，不是让你背语法、记命令、查文档，而是把你脑子里“想让程序干什么”的那句话，直接变成能跑通的代码——它读你本地文件、写Python/JS/HTML、自动装依赖、报错后自己修，整个过程你只管说人话、点确认、看结果。
第一步：用Ask模式快速确认技术方案
刚想到一个功能但不确定该用什么技术实现？别急着写，先用Ask模式问清楚。
在WorkBuddy对话框顶部切换到【Ask模式】，输入：“我要把微信公众号文章链接转成Markdown并提取摘要，Python里用哪个库最稳？要不要装额外依赖？”
它会立刻对比requests+BeautifulSoup、feedparser、或者专用SDK的适用场景，告诉你选哪个、为什么、有没有坑。这一步不做任何文件操作，纯信息判断，省得你选错路重来。
第二步：用Craft模式写第一段可运行代码
需求明确后，切回Craft模式，直接下达执行指令：
“帮我用Python写一个脚本：输入公众号文章URL，用requests获取网页，用lxml解析正文，提取标题、发布时间和前300字正文，保存为同名.md文件。要求加异常处理，网络失败时打印‘获取失败’。”
WorkBuddy会自动生成完整代码、创建.py文件、并在内置终端里运行测试。如果报错——比如没装lxml，它会自动执行pip install lxml，再重试。
【注意】首次运行前，确保已授权WorkBuddy访问你的项目文件夹，否则它无法创建或读取本地文件。】
第三步：让AI直接读源码帮你改bug
方法一：精准定位函数问题
在编辑器里打开src/parser.py，把光标停在parse_article()函数开头，右键选择“WorkBuddy → 分析当前函数”。它会读取上下文，指出“第17行正则匹配可能漏掉带空格的发布时间格式”，并给出修复建议。
方法二：结合报错堆栈诊断
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
终端弹出红色报错：“AttributeError: 'NoneType' object has no attribute 'text'”，你不用手动翻代码。直接复制整段报错信息，粘贴进WorkBuddy对话框，加一句：“请结合src/parser.py里的parse_article函数分析这个错误”。它会定位到具体哪一行、为什么返回None、怎么加if判断防崩。
第四步：批量重构已有代码提升质量
第一步：选中整个utils/目录下的所有.py文件 → 右键 → “WorkBuddy → 启动批量重构”
第二步：在弹窗中勾选三项：
① 自动补全类型提示（str→Optional[str]）
② 将魔法数字转为命名常量（如把404改成HTTP_NOT_FOUND）
③ 为每个函数生成Google风格docstring
第三步：预览变更列表，重点检查【__init__.py和测试文件未被误改】，确认后点击“全部应用”。
这一步完成后，你的代码立刻符合PEP 8规范，类型安全增强，新人接手时一眼看懂每个函数干啥、参数啥类型、返回啥。
第五步：用Plan模式做多文件协同开发
当你需要从零搭一个带前端页面的简易资讯聚合工具时，不要一次性让AI输出全部代码——容易混乱、难调试。
输入：“用Flask搭一个本地资讯聚合服务，包含后端API返回JSON、前端HTML展示列表、支持按关键词搜索。”
WorkBuddy进入Plan模式，自动拆解为：
① 创建项目结构：app.py、templates/index.html、static/style.css
② 写Flask路由：/api/list 返回硬编码资讯数组
③ 做HTML页面：用fetch调用API，渲染ul列表
④ 加搜索框：前端过滤，不走后端
⑤ 启动服务并验证localhost:5000能打开
每步完成后打✔，你可以在第③步卡住时说“把HTML改成用Vue重写”，它不会推倒重来，只改对应部分。
