resume-grill
# Resume Grill Agent
DSH 原生求职插件,也提供通用 MCP 接口。在对话中读取岗位、核对简历修改、准备邮件并确认投递,资料和记录保存在本机 SQLite。
## 功能
- 保存求职方向、城市、排除条件,读取公开招聘页的真实 JD 和邮箱。
- 导入 PDF/DOCX/TXT/Markdown,结合原简历和 JD 给出逐条建议,用户勾选后另存岗位版本。
- 在 DSH 回答下方核对岗位、修改和实际 PDF,直接编辑收件人、主题和正文,刷新后恢复当前记录。
- 批量准备岗位简历与邮件,保留缺失信息和失败原因,复用已有批次。
- 使用 QQ/163/126 SMTP 投递,发送前由用户确认,保留附件、回执及状态,阻止自动重发结果不明的邮件。
新 PDF 暂为文本排版,**不保留原布局和照片**。官网读取限公开静态页面,每次最多 6 个来源、10 页;不能覆盖所有动态或登录页面。官网填表、定时任务、回复同步、已读追踪和面试尚未接入。简历与 JD 会交给宿主模型。
## 在 DSH 中安装
DSH 官方提供图形安装入口:**插件 → 添加插件 → 安装第三方插件**,支持 npm、Git 仓库和本地包。本项目当前按预构建 `.tgz` 包交付;尚未发布 npm 包,也未上传下载版本,不要把源码仓库链接当成已可用的安装链接。
获得插件包后,在该入口填写 `.tgz` 文件的**绝对路径**,安装并启用“求职助手”;若 DSH 提示需要重启,按提示操作。安装预构建包不需要在用户电脑上编译 TypeScript 或前端。
目前可由仓库维护者或开发者生成包(Node.js 24+):
```bash
npm ci
npm run package:plugin
```
终端会输出 `artifacts/resume-grill-agent-0.1.0.tgz` 的完整路径。安装步骤、开发链接方式和验证方法见 [DSH 说明](docs/dsh.md)。此命令只生成本地文件,不发布或上传。
## 使用
在 DSH 中告诉助手简历路径和目标,例如:“用这份简历找杭州全栈岗位,排除外包,先给我看岗位。”建议生成后在卡片中勾选修改、准备邮件、打开实际附件核对,再决定是否发送。操作按钮直接调用本地服务,不额外请求模型;“请助手分析”会发起正常模型对话。
真实发件须在 DSH 进程环境中配置 `RESUME_SMTP_ADDRESS`、`RESUME_SMTP_CODE`、`RESUME_SMTP_PROVIDER` 和 `RESUME_ALLOW_SEND=1`,然后由用户确认当前邮件。授权码不进入工具参数或浏览器。`sent` 仅表示 SMTP 接受,不代表送达或阅读。
原生版默认资料目录为 `DSH_HOME/storages/resume-grill`,可用 `RESUME_AGENT_HOME` 覆盖。原工作台的浏览器数据不会自动迁移。[MCP 与可选面板](docs/mcp.md)可复用同一资料库,WorkBuddy 尚未实装。
## 开发
```bash
npm run check
npm test
npm run verify:panel
```
测试使用临时资料和替代 SMTP,不发真实邮件。目录约定与构建说明见 [开发说明](docs/development.md),来源和许可见 [THIRD_PARTY.md](THIRD_PARTY.md)。
TDQS
Scored across 15 tools
The tools mostly map to distinct stages of the job-application workflow, but prepare_application vs prepare_application_batch and preview/revise/execute_application can be confused without careful reading. Descriptions help clarify boundaries, but the set still requires the agent to understand the lifecycle order.
All names use snake_case and most follow a verb_noun pattern such as save_search_goal, discover_jobs, and execute_application. A few noun-phrase exceptions like goal_candidates and application_history are readable but slightly less consistent.
15 tools is at the upper end of the typical range but reasonable for a multi-stage resume tailoring and application workflow. There is some redundancy between single and batch application preparation, but most tools earn their place.
The surface covers goal saving, job discovery, resume import and tailoring, application preparation, revision, execution, and history. Minor gaps exist around deleting/archiving jobs or resumes and explicitly updating saved goals, but core workflows are covered.