Operation Guide: Lark Base (Feishu) Data Synchronization

Function Overview

This feature enables two-way synchronization between your local data and Lark Base (Feishu Bitable), covering both "Website Management" and "Backlink Management" data.

Supported Modes:

1. Sync Mode (Recommended): Binds the current local group to a specific Lark Base table for continuous two-way synchronization (Sync to Local / Sync to Cloud).
2. Import/Export Mode: A one-time operation to transfer data between local storage and Lark Base (or Google Sheets).

Auto-Sync: When enabled, any Add, Edit, or Delete actions performed locally are automatically reflected in Lark Base, eliminating the need for manual updates.

---

🛠 Prerequisites

1. Account Permissions:

• The Sync feature requires PRO status. (Users not logged in or on a free plan will be prompted to upgrade).

2. Lark Credentials:

• Navigate to "Settings > Lark Base Authorization".
• App ID & App Secret: Required to obtain the tenant_access_token. You can get these from the Lark Open Platform.
• App Token: The default identifier for your specific Base file (can be temporarily modified in the Sync pop-up).
• Privacy Note: Your App Secret is stored securely in your local browser and is never uploaded to our servers.

---

How to Use

1. Enable Authorization

1. Go to the "Settings" page and find "Lark Base Authorization".
2. Toggle the "Auto Sync" switch to ON.
3. Fill in your App ID, App Secret, and App Token.

2. Group Binding & Sync (Recommended)

Best for: Long-term two-way synchronization and keeping records linked.

• Entry Points:

• Website Management: Top-right "More" menu -> "Feishu Sync".

• Backlink Management: Top-right "More" menu -> "Feishu Sync".

• Operations:

1. Enter the App Token in the pop-up (defaults to the value in Settings).
2. Click "Load Table": You can select an existing data table or enter a name for a new one.
3. Click "Sync to Cloud" (Local -> Cloud):

• If the table does not exist, it will be automatically created with the necessary fields.
• Binds the current local group to this table.

4. Click "Sync to Local" (Cloud -> Local):

• Pulls data from Lark and writes it to the current local group.

• If discrepancies are found, you will be asked whether to overwrite local data.

• ** Important Notes:**

• Binding Rule: To bind an existing Lark table, your current local group must be empty. (Otherwise, you will see the error: "Can only bind existing data table when the group is empty").

• Limit: Maximum 1,000 records per group.

• Tracking: Once bound, a record_id is saved locally to handle future updates or deletions.

• Unbinding: Click "Unbind" in the sync pop-up to break the connection. This clears all record_id data for that group.

3. Import / Export (One-Time)

Best for: Temporary data transfer without binding groups.

• Entry Points:

• Website/Backlink Management -> Import/Export -> Feishu-Bitable / Google Sheet.

• Import:

1. Enter App Token and select/enter the table name.
2. Click "Import from Lark".
3. System parses records and adds them to the current group.

• Export:

1. Enter App Token and select/enter the table name.
2. Click "Sync to Cloud".
3. System writes current group data to the table and fills in necessary fields.

---

Auto-Sync Behavior

Once "Auto Sync" is enabled in Settings:

• Add/Edit Record: Automatically creates or updates the corresponding record in Lark.
• Delete Record: Automatically deletes the record in Lark.
• Move Group: If a record is moved to a different group, it will be created in the new group's table and deleted from the old table.
• Conflict Handling:
• If the record was already deleted in Lark, the system will ask: "Record not found. Create a new one?"
• If the local record lacks a record_id, the system will prompt you to run a manual sync to repair the association.

---

Common Troubleshooting

• "Please fill in Feishu App ID and App Secret in settings panel":

• You have not configured your API credentials yet.

• "Please fill in Base App Token":

• The App Token field is empty.

• "Each group can sync up to 1000 records":

• You have exceeded the synchronization limit for this group.

• "Can only bind existing data table when the group is empty":

• You are trying to download data from an existing Lark table into a local group that already contains data. Please create a new, empty group first.