Skip to main content
Glama
README.md
# 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

B3.4/5.0

Scored across 15 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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.