[add] Lark AI recognition API: OCR, Bank Card, Resume & Contract by Copilot · Pull Request #28 · idea2app/MobX-Lark

Copilot · 2026-04-15T21:35:47Z

Wraps four Feishu intelligent document parsing APIs that fall outside the existing invoice/certificate category.

New types (`DocumentAI/type.ts`)

OcrText — recognized text block with bounding box corner positions
BankCard — bank_card_number | bank_card_date_of_expiry entity
ResumeEntity — structured resume fields (name, gender, DOB, contact, education/work history, etc.)
ContractEntity — extracted contract fields (parties, dates, amount, payment terms, etc.)

New methods (`DocumentAIModel`)

Method	API endpoint
`recognizeText(image: string)`	`optical_char_recognition/v1/image/basic_recognize`
`recognizeBankCard(file: File)`	`document_ai/v1/bank_card/recognize`
`parseResume(file: File)`	`document_ai/v1/resume/parse`
`extractContractFields(file: File)`	`document_ai/v1/contract/field_extraction`

Note: recognizeText accepts a base64-encoded image string (not a file upload), matching the OCR API's JSON body contract — unlike the other three which use multipart form data.

// OCR — base64 input
const texts = await documentAIStore.recognizeText(base64Image);
// texts: OcrText[] — each with .text and .positions (bounding box corners)

// File-upload APIs
const cards    = await documentAIStore.recognizeBankCard(file);
const resumes  = await documentAIStore.parseResume(file);
const contracts = await documentAIStore.extractContractFields(file);

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

open.feishu.cn
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (dns block)
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/MobX-Lark/MobX-Lark/node_modules/.bin/ts-node test/index.spec.ts (dns block)
- Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/MobX-Lark/MobX-Lark/node_modules/.bin/ts-node test/index.spec.ts git conf�� it} --global rgo/bin/bash gpg.program (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Human changes

[migrate] upgrade to PNPM 11, Lint-Staged 17 & other latest Upstream packages/actions
[fix] many Copilot type bugs

…ocumentAIModel

…packages/actions [fix] many Copilot type bugs

Copilot

Pull request overview

This PR adds new Feishu/Lark “Document AI” wrappers (OCR, bank card recognition, resume parsing, contract field extraction) and updates repo/tooling configuration (pnpm workspace + dependency bumps) plus a few GitHub workflow/script improvements.

Changes:

Added new DocumentAI types and methods for bank cards, resumes, contracts, and OCR.
Updated reward-automation scripts/workflows to carry a source field and to push tags more narrowly.
Introduced pnpm-workspace.yaml, bumped dependencies, and updated CI to pnpm v11.

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
src/module/DocumentAI/type.ts	Adds new document-AI response types (bank card, resume, contract); includes a typo + several doc/code naming mismatches.
src/module/DocumentAI/index.ts	Adds new DocumentAIModel API methods (OCR/bank card/resume/contract); several signatures/names diverge from the PR description.
src/module/BITable/index.ts	Refines `BiSearch` generics to improve type inference for the wrapped model.
src/Lark.ts	Changes `LarkAppOption` from interface inheritance to a type intersection.
pnpm-workspace.yaml	Adds pnpm workspace manifest and build-allowlist configuration.
pnpm-lock.yaml	Updates lockfile for dependency bumps.
package.json	Bumps version to 2.9.0, updates dependencies, and removes `pnpm.onlyBuiltDependencies` block.
.github/workflows/main.yml	Updates CI to use pnpm v11.
.github/workflows/Lark-notification.yml	Refactors message serialization to pass GitHub context via env + `printf` piping.
.github/workflows/claim-issue-reward.yml	Passes an additional `source` argument into the reward-sharing script.
.github/scripts/type.ts	Adds optional `source` field to the `Reward` type.
.github/scripts/share-reward.ts	Accepts/persists `source`, and pushes only the created tag (not all tags).
.github/scripts/count-reward.ts	Refactors last-month range filtering and pushes only the created tag.
.github/ISSUE_TEMPLATE/reward-task.yml	Adds a “Task source” input field to the reward task issue form.

Files not reviewed (1)

pnpm-lock.yaml: Generated file

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

+    @toggle('uploading')
+    async recognizeText(image: File) {
+        const URI = (await readAs(image, 'dataURL').result) as string;
+
+        const [, base64] = URI.split(',');
+
+        const { body } = await this.client.post<LarkData<{ text_list: string[] }>>(
+            'optical_char_recognition/v1/image/basic_recognize',
+            { image: base64 }
+        );
+        return body!.data!.text_list;
+    }


@@ -1,8 +1,16 @@
-import { makeFormData } from 'koajax';
+import { makeFormData, readAs } from 'koajax';


+     * @see {@link https://open.feishu.cn/document/server-docs/ai/document_ai-v1/contract/field_extraction}
+     */
+    @toggle('uploading')
+    async extractContract(


+export interface BankCardEntity {
+    type: 'card_number' | 'date_of_expiry';
+    value: string;
+}


+        file: File,
+        ocr_mode: 'unused' | 'force' | 'auto' = 'auto',
+        pdf_page_limit = 100
+    ) {


+export interface Resume
+    extends
+        Record<


+export interface BankCardEntity {
+    type: 'card_number' | 'date_of_expiry';
+    value: string;
+}
+
+export type ResumePeriod = Record<'start_date' | 'start_time' | 'end_date' | 'end_time', string>;


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Initial plan

b264d1f

Copilot AI assigned Copilot and TechQuery Apr 15, 2026

Copilot started work on behalf of TechQuery April 15, 2026 21:35 View session

Copilot AI linked an issue Apr 15, 2026 that may be closed by this pull request

封装飞书【智能文档解析】非证照、票据类接口 #27

Closed

[add] OCR, bank card, resume, and contract field extraction APIs to D…

24a4ad9

…ocumentAIModel

Copilot AI changed the title ~~[WIP] Add encapsulation for 飞书智能文档解析 non-licensed interfaces~~ Add Feishu AI document analysis APIs: OCR, bank card, resume, contract Apr 15, 2026

Copilot AI requested a review from TechQuery April 15, 2026 21:41

Copilot finished work on behalf of TechQuery April 15, 2026 21:41

[migrate] upgrade to PNPM 11, Lint-Staged 17 & other latest Upstream …

08d36b3

…packages/actions [fix] many Copilot type bugs

TechQuery added the feature New feature or request label Jun 19, 2026

TechQuery marked this pull request as ready for review June 19, 2026 00:22

Copilot AI review requested due to automatic review settings June 19, 2026 00:22

Copilot started reviewing on behalf of TechQuery June 19, 2026 00:22 View session

Copilot AI reviewed Jun 19, 2026

View reviewed changes

TechQuery and others added 2 commits June 19, 2026 08:37

Potential fix for pull request finding

fb713bf

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

[optimize] Document AI types

9033a1a

TechQuery approved these changes Jun 19, 2026

View reviewed changes

TechQuery changed the title ~~Add Feishu AI document analysis APIs: OCR, bank card, resume, contract~~ [add] Lark AI recognition API: OCR, Bank Card, Resume & Contract Jun 19, 2026

TechQuery merged commit 420a1c4 into main Jun 19, 2026
2 checks passed

TechQuery deleted the copilot/fix-47602664-470670876-5b34ad0a-bdd7-4abb-b4ed-f64f26d7cb63 branch June 19, 2026 21:42

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[add] Lark AI recognition API: OCR, Bank Card, Resume & Contract#28

[add] Lark AI recognition API: OCR, Bank Card, Resume & Contract#28
TechQuery merged 5 commits into
mainfrom
copilot/fix-47602664-470670876-5b34ad0a-bdd7-4abb-b4ed-f64f26d7cb63

Copilot AI commented Apr 15, 2026 •

edited by TechQuery

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -1,8 +1,16 @@
		import { makeFormData } from 'koajax';
		import { makeFormData, readAs } from 'koajax';

Conversation

Copilot AI commented Apr 15, 2026 • edited by TechQuery Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New types (DocumentAI/type.ts)

New methods (DocumentAIModel)

I tried to connect to the following addresses, but was blocked by firewall rules:

Human changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Apr 15, 2026 •

edited by TechQuery

Loading

New types (`DocumentAI/type.ts`)

New methods (`DocumentAIModel`)