FormFilla README

项目的 README,来自 github.com/AhmadHassan-BTed/FormFilla。合并为一个 markdown 文件:README.md。

FormFilla promo tile

FormFilla

Ingenious Local-First Form Filler
Deterministic, zero-network autofill powered by bipartite graph matching.

License: MIT Chrome Web Store TypeScript Zero AI Kuhn-Munkres Privacy

Install from Chrome Web Store • Key Features • Architecture • Quickstart • Extending Rules • Issues & Feedback


The Philosophy

Job hunting in the modern era is exhausting and repetitive. Candidates spend hours copying and pasting identical professional records into applicant tracking systems (ATS) like Workday, Greenhouse, and Lever—systems whose built-in resume parsers frequently misalign dates, drop job titles, and scramble contact details.

FormFilla was created to restore candidate dignity and reclaim time.

Unlike cloud-based or LLM-driven autofill plugins that transmit your personal credentials, resume texts, and references to third-party AI endpoints, FormFilla is 100% local-first and deterministic. Everything runs directly inside your browser in sub-100ms. Your sensitive career data never leaves your computer.


Key Features


Technical Architecture

FormFilla executes a robust three-stage pipeline to analyze and populate complex application forms:

Active DOM  ──►  1. Scanner & Normalizer  ──►  2. Hungarian Solver  ──►  3. Framework Setter  ──►  Filled Form

1. Element Scanning & Normalization

Recursively traverses active DOM subtrees (including same-origin iframe roots) to detect inputs, selects, textareas, and comboboxes. Raw signals (labels, placeholders, IDs, names, ARIA attributes) are tokenized and normalized against abbreviation dictionaries.

flowchart TD
    DOM["Active DOM Subtree"] --> Scan["Scanner: Inputs, Selects, & Textareas"]
    Scan --> Blocks["Repeated Block Detector: Identify School & Work Cards"]
    Blocks --> Extract["Signal Extractor: Read Label, Placeholder, ID, Name"]
    Extract --> Normalizer["Normalizer: Tokenize & Expand Abbreviations"]
    Normalizer --> Tokens["Normalized Field Tokens"]

2. Kuhn-Munkres Bipartite Matching

Models the pairing between scanned form inputs and candidate profile fields as a weighted bipartite graph. FormFilla builds a global cost matrix and executes the Kuhn-Munkres (Hungarian) algorithm to guarantee the mathematically optimal assignment.

flowchart TD
    Tokens["Normalized Field Tokens"] --> Scorer["Signal Scorer: Fuzzy Sim + Regex Signatures"]
    Profile["Candidate Profile JSON"] --> Scorer
    Scorer --> CostMatrix["Build Cost Matrix: 100 - Score"]
    CostMatrix --> Hungarian["Hungarian Minimization Algorithm"]
    Hungarian --> GlobalMatching["Globally Optimal Field-to-Key Mapping"]

3. Framework-Safe DOM Writing

Standard .value = ... mutations fail on modern reactive web apps (React, Vue, Angular) because virtual DOM wrappers ignore raw property writes. FormFilla extracts browser-native property descriptors and dispatches bubbling lifecycle events.

sequenceDiagram
    participant E as Core Orchestrator
    participant D as Target DOM Element
    participant F as Web Framework (React/Vue/JS)

    E->>D: Resolve Value Assignment
    E->>D: Invoke Native Prototype Setter (bypass wrapper)
    D-->>F: Update element value
    E->>D: Dispatch event: 'input' (bubbles: true)
    E->>D: Dispatch event: 'change' (bubbles: true)
    F-->>F: Synchronize reactive state store
    Note over D,F: Element highlighted green/amber for review

Repository Structure

FormFilla/
├── src/                   # Extension source code
│   ├── background/        # Service Worker & offline lifecycle
│   ├── content/           # Scanners, Kuhn-Munkres matcher, platform adapters & DOM setters
│   ├── options/           # Dashboard settings panel & profile management
│   ├── popup/             # Extension toolbar popup interface
│   ├── shared/            # Matching dictionaries, schemas, types & storage client
│   └── themes/            # Built-in CSS themes (Light, Dark, Brutalist)
├── tests/                 # Vitest test runner suites & HTML form fixtures
├── store_assets/          # Chrome Web Store graphics, banners, and screenshots
├── scripts/               # esbuild bundling, packaging, and icon build utilities
├── docs/                  # Architecture specifications and documentation
├── icons/                 # Extension icons (16, 32, 48, 128px)
├── manifest.json          # Chrome Manifest V3 configuration
├── LICENSE                # MIT License
└── package.json           # Node dependencies and build scripts

Setup & Development

Prerequisites

1. Clone & Install Dependencies

git clone https://github.com/AhmadHassan-BTed/FormFilla.git
cd FormFilla
npm install

2. Build the Extension

Compile the TypeScript code and static assets into the dist/ directory:

# Single build
npm run build

# Watch mode for real-time development
npm run watch

3. Load Unpacked in Chrome

  1. Open Google Chrome and navigate to chrome://extensions/.
  2. Enable Developer mode via the toggle switch in the upper-right corner.
  3. Click Load unpacked in the top-left corner.
  4. Select the dist/ directory inside this repository.
  5. FormFilla is now active in your browser toolbar!

4. Running Tests

Run the Vitest unit and integration test suite:

npm run test

AI-Driven Dictionary Expansion

FormFilla’s matching logic is completely decoupled from its code through four externalized JSON dictionaries. You can easily expand matching accuracy for specialized portals, regional formats, or regional application styles:

File Purpose How to Extend
rules.json Field Selectors & Signatures Add new target keys, exactPhrases, and regexPatterns for custom portal inputs.
profile-template.json Profile Schema Layout Define user-facing fields and defaults matching any newly introduced rules.
abbreviations.json Acronym Normalization Map domain acronyms (e.g. exp → experience, inst → institution).
degrees.json Education Ranking Matrix Define degree equivalence tiers for international and regional qualifications.

Pro Tip: Each dictionary contains an embedded __meta__ prompt. You can supply these JSON files directly to any AI model (Gemini, Claude, GPT) with sample forms to generate accurate new mapping entries!


Platform Support

FormFilla contains dedicated platform adapters and generic fallback handling for:


Installation via Chrome Web Store

If you prefer installing pre-packaged releases with automated updates, install FormFilla directly from the Google Chrome Web Store:

👉 Install FormFilla from the Chrome Web Store


Contributing & Bug Reports

Contributions, issues, and feature suggestions are warmly welcomed!

Please open an issue on our central tracker:
👉 Open an Issue or Suggestion


License

This project is licensed under the MIT License © 2026 Ahmad Hassan (B-Ted). Free to use, modify, and distribute.

FormFilla (AhmadHassan-BTed/FormFilla)

正在搜索数据库…

这是什么?FormFilla 是一款优先在本地运行的浏览器扩展,它会利用你的个人资料数据以及保存在自己设备上的文件,自动填写求职申请表,省得你在每个 ATS 申请表中重复复制粘贴相同的信息。
这个扩展的源代码包含在本仓库中吗?不包含。本仓库只提供公开文档、问题追踪和发布说明。驱动该扩展的信息提取引擎和 DOM 操作逻辑是闭源的。
社会安全号码这类敏感字段会被自动填写吗?不会。社会安全号码等关键字段从不自动填写;页面上会出现一个悬浮的金色标记,需要你手动点击确认。EEO 字段默认禁用,除非你主动选择启用。
我的个人资料数据会离开我的浏览器吗?不会。数据使用 chrome.storage.local 和 IndexedDB 在本地存储和处理,不涉及任何网络请求或追踪脚本。
我可以使用或修改 FormFilla 的源代码吗?不可以。本仓库中的文档和素材可以查看,但 FormFilla 软件本身是专有的闭源软件。
重复区块指纹识别是做什么的?它通过分析元素布局,检测并分组重复出现的表单区段,比如多段工作经历或多个学位信息,从而确保每条个人资料记录都填入正确的重复区块,而不是覆盖同一个位置。
它还能自动上传我的简历文件吗?可以。FormFilla 使用合成的 DataTransfer 数据流模拟拖放上传文件,能够把本地保存的简历和求职信注入文件上传字段,无需手动拖拽。
在不常见的招聘网站上,我能调整它的字段匹配方式吗?可以。匹配器会读取外部 JSON 词典(rules.json、abbreviations.json、degrees.json、profile-template.json),开发者或 AI 模型可以扩充这些词典,以提高在新招聘门户上的匹配准确率。
路线图上有哪些计划?计划中的功能包括自定义字段选择覆盖、针对 Taleo、Workable 和 Breezy HR 的平台适配器,以及加密的 AES-GCM 个人资料备份导出。
大小
6.1 MB
星标
4.7K
更新
提交Nov 03
时长
4个月
提交 · 90 天