Usage Guide

First Use: Configure Credentials

Two credentials need to be configured before use:

Field	Description	How to Obtain
userid	Current user ID, used for 1:1 comparison	View personal info after logging into the developer console
token	API authentication JWT	Apply at https://palm.tencent.com/developer/api-keys

Simply tell the AI in the conversation, for example:

"Help me configure palm-kyc-community credentials, userid is xxx, token is xxx"

The AI will securely write to local credential storage and will not write values to shell history or logs.

Credentials are preferentially stored in the system Keychain; when unavailable, they fall back to local encrypted files.

Palm Recognition Usage Steps

1. User initiates a dangerous operation in the conversation (e.g., "Delete all user data").
2. AI automatically detects dangerous keywords and triggers the palm recognition flow.
3. System pops up an independent Chrome window; user completes palm scan in front of the camera.
4. AI decides the next action based on verification results:
   • ✅ Passed: Continue executing the original operation.
   • ❌ Failed: Terminate the original operation, no retry.
   • ⚠️ Timeout/Exception: Prompt user to re-initiate.

Palm Registration Usage Steps

1. User proactively speaks a registration keyword (e.g., "I want to register my palm").
2. AI triggers the palm registration flow, pops up an independent Chrome window.
3. User follows the instructions to complete palm print enrollment in front of the camera.
4. AI provides registration feedback:
   • ✅ Success: Returns PalmId.
   • ❌ Failed: Returns error message and error code, can retry.
   • ⚠️ Timeout/Exception: Prompt user to re-initiate.