Local Resume Autofill

本地优先、隐私边界明确的 Edge/Chrome 简历自动填写扩展。简历使用口令派生密钥加密，页面适配器是可审查的声明式 JSON，Codex 等 Agent 只能处理脱敏页面结构和合成测试数据。

核心边界

• 生产扩展仅申请 storage、activeTab、scripting。

• 没有 <all_urls>、常驻 content script、遥测、云同步或远程规则。

• 简历使用 PBKDF2-SHA-256（310,000 次）与 AES-256-GCM 加密。

• 口令不保存；会话密钥仅放在 chrome.storage.session，浏览器重启后失效。

• 页面脚本无法通过 window.postMessage 或外部消息读取保险库。

• 每个网站首次填写前按 exact hostname 确认授权。

• 只发送当前页面计划使用的字段，不把完整简历交给 content script。

• 填写结束后由用户检查并手动提交。

完整边界见 SECURITY.md 和 架构说明。

安装开发版

需要 Node.js 20+ 和 Microsoft Edge 或 Google Chrome。

npm ci
npm run check
npm run build

1. 打开 edge://extensions 或 chrome://extensions。

2. 启用“开发人员模式”。

3. 选择“加载解压缩的扩展”，指向 dist/extension。

4. 打开扩展的“简历与权限”，创建保险库并录入资料。

使用

1. 在招聘表单页点击扩展图标。

2. 点击“预览”，检查字段引用，不显示实际简历值。

3. 点击“填写”。新 hostname 会先显示授权确认。

4. 检查页面结果，手动处理附件、验证码和提交。

“捕获”会导出不含输入值、选中项、附件名或截图的 *.capture.json。捕获文件仍可能包含页面标签和结构，默认不会进入 Git。

当前适配器

状态含义和新增适配器流程见 适配器开发。

连接 Codex 或其他 Agent

本项目提供本地 STDIO MCP server。它只能访问仓库中的 adapters、脱敏 captures 和 fixtures，不能读取浏览器保险库。

npm run build
Copy-Item .codex/config.toml.example .codex/config.toml
codex mcp list

项目级 MCP 配置需在受信任仓库中使用。Codex 的 STDIO、项目级配置和客户端共享行为以 OpenAI 官方 MCP 文档 为准。其他支持 MCP 的 Agent 可以连接同一个 dist/mcp/server.js。

详细工具和确认流程见 MCP 联动。

验证

npm run typecheck
npm run test:unit
npm run test:integration
npm run test:e2e
npm run audit:extension

当前回归范围：

• 32 个单元测试：保险库、篡改检测、脱敏、DOM 扫描与驱动、6 个站点 fixture、MCP 路径和两阶段安装。

• 1 个真实 STDIO MCP 集成测试：握手、工具发现、适配器枚举和 fixture 执行。

• 2 个 Edge 扩展端到端测试：MV3 加载、扫描脱敏、页面填写、保险库密文、hostname 授权、无提交和零外部 HTTP(S) 请求。

• 生产包静态审计：权限、常驻注入、页面消息桥、网络 API 和 content-script 存储访问。

开发

• 架构与威胁模型

• v0.3.0 发布前安全自审

• 适配器开发

• MCP 联动

• 贡献说明

• 版本记录

项目采用 MIT License。第三方招聘网站名称仅用于兼容性描述，本项目与这些公司无隶属或背书关系。