安全扫描（ClawHub）

• VirusTotal ：可疑
• OpenClaw ：可疑

OpenClaw 评估

The skill mostly matches its stated EMR structuring purpose but contains self-evolution and upload scripts, inconsistencies about required credentials, and code patterns that could enable code-modification or data exfiltration — review before use.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Medical Record Structurer」。简介：Medical record structuring and standardization tool. Converts doctor's oral or …。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/andyxcg/medical-record-structurer/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: medical-record-structurer
description: Medical record structuring and standardization tool. Converts doctor's oral or handwritten medical records into standardized electronic medical records (EMR). Supports voice/text input, automatic field recognition, and structured output. Use when processing medical records, clinical notes, patient histories, or converting unstructured medical data into standardized formats. Includes skillpay.me payment integration for pay-per-use monetization.
version: 1.2.129
---

# Medical Record Structurer

> **Version**: 1.1.0  
> **Category**: Healthcare / Medical  
> **Billing**: SkillPay (0.001 USDT per call)  
> **Free Trial**: 10 free calls per user  
> **Demo Mode**: ✅ Available (no API key required)

A professional medical record processing tool that transforms unstructured medical notes (voice or text) into standardized electronic medical records.

## Features

1. **Voice/Text Input Processing** - Accepts doctor's口述 or handwritten notes
2. **AI-Powered Field Extraction** - Automatically identifies and extracts medical fields
3. **Standardized EMR Output** - Generates structured electronic medical records
4. **Payment Integration** - skillpay.me integration for monetization (0.001 USDT per use)
5. **Free Trial** - 10 free calls for every new user
6. **Demo Mode** - Try without API key, returns simulated data
7. **Batch Processing** - Process multiple records at once
8. **File Input Support** - Read medical records from files
9. **Multi-language Support** - Chinese and English output

## Support / 支持

If you find this skill helpful, you can support the developer:

**EVM Address**: `0xf8ea28c182245d9f66f63749c9bbfb3cfc7d4815`

Your support helps maintain and improve this skill!

## Demo Mode

Try the skill without any API key:

```bash
python scripts/process_record.py --demo
```

Or simply don't set any API key - the skill will automatically enter demo mode.

Demo mode returns realistic simulated medical records to demonstrate the output format.

## Free Trial

Each user gets **10 free calls** before billing begins. During the trial:
- No payment required
- Full feature access
- Trial status returned in API response

```python
{
    "success": True,
    "trial_mode": True,      # Currently in free trial
    "trial_remaining": 5,    # 5 free calls left
    "balance": None,         # No balance needed in trial
    "structured_record": {...}
}
```

After 10 free calls, normal billing applies.

## Quick Start

### Demo Mode (No API Key):

```bash
python scripts/process_record.py --demo --input "患者张三，男，45岁，主诉头痛3天..."
```

### Process a Single Record:

```python
from scripts.process_record import process_medical_record
import os

# Set API key via environment variable (only needed after trial)
os.environ["SKILLPAY_API_KEY"] = "your-api-key"
os.environ["SKILLPAY_SKILL_ID"] = "your-skill-id"

# Process with user_id for billing/trial tracking
result = process_medical_record(
    input_text="患者张三，男，45岁，主诉头痛3天...",
    user_id="user_123"
)

# Check result
if result["success"]:
    print("结构化病历:", result["structured_record"])
    if result.get("trial_mode"):
        print(f"免费试用剩余: {result['trial_remaining']} 次")
    else:
        print("剩余余额:", result["balance"])
else:
    print("错误:", result["error"])
    if "paymentUrl" in result:
        print("充值链接:", result["paymentUrl"])
```

### Batch Processing:

```bash
# Process multiple files
python scripts/process_record.py --batch file1.txt file2.txt file3.txt --user-id "user_123"
```

```python
from scripts.process_record import process_medical_records_batch

results = process_medical_records_batch(
    input_texts=["记录1...", "记录2...", "记录3..."],
    user_id="user_123"
)
```

### File Input:

```bash
python scripts/process_record.py --file record.txt --user-id "user_123"
```

### Language Selection:

```bash
# Chinese output (default)
python scripts/process_record.py --input "..." --user-id "user_123" --language zh

# English output
python scripts/process_record.py --input "..." --user-id "user_123" --language en
```

## Environment Variables

This skill requires the following environment variables:

### Required Variables (After Trial)

| Variable | Description | Required | Example |
|----------|-------------|----------|---------|
| `SKILLPAY_API_KEY` | Your SkillPay API key for billing | After trial | `skp_abc123...` |
| `SKILLPAY_SKILL_ID` | Your Skill ID from SkillPay dashboard | After trial | `skill_def456...` |

### Optional Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `OCR_API_KEY` | API key for OCR services (image processing) | - |
| `OCR_PROVIDER` | OCR provider (google, azure, aws, tesseract) | `google` |
| `STT_API_KEY` | API key for speech-to-text services | - |
| `STT_PROVIDER` | STT provider (google, azure, aws, whisper) | `whisper` |
| `PHI_ENCRYPTION_KEY` | Encryption key for PHI protection | - |
| `DATA_RETENTION_DAYS` | Days to retain processed records | `30` |
| `AUDIT_LOGGING_ENABLED` | Enable audit logging | `true` |

See `.env.example` for a complete list of environment variables.

## Configuration

The skill uses SkillPay billing integration:
- Provider: skillpay.me
- Price: 0.001 USDT per request
- Chain: BNB Chain
- Free Trial: 10 calls per user
- Demo Mode: Available without API key
- API Key: Set via `SKILLPAY_API_KEY` environment variable
- Skill ID: Set via `SKILLPAY_SKILL_ID` environment variable

## Output Format

Structured medical record includes:
- Patient demographics (name, age, gender)
- Chief complaint
- History of present illness
- Past medical history
- Physical examination
- Diagnosis
- Treatment plan
- Medications
- Follow-up instructions

### Response Format

```python
{
    "success": True,
    "demo_mode": False,         # True if in demo mode
    "trial_mode": False,        # True during free trial
    "trial_remaining": 0,       # Remaining free calls
    "balance": 95.5,            # User balance (None during trial/demo)
    "structured_record": {
        "emr_version": "1.0",
        "record_id": "EMR_20240306120000",
        "record_date": "2024-03-06T12:00:00",
        "patient_demographics": {...},
        "clinical_information": {...},
        "assessment_and_plan": {...},
        "metadata": {...}
    }
}
```

## PHI and Privacy Handling

This skill processes Protected Health Information (PHI). The following safeguards are implemented:

### Data Protection
- **Encryption**: All data is encrypted at rest and in transit
- **Access Control**: User authentication required for all operations
- **Audit Logging**: All access to PHI is logged
- **Data Minimization**: Only necessary fields are extracted and stored

### Compliance
- **HIPAA Considerations**: Designed with HIPAA safeguards in mind
- **GDPR**: Supports data deletion requests
- **Retention**: Configurable data retention policies (default: 30 days)

### Best Practices
1. Always use environment variables for sensitive configuration
2. Enable audit logging in production
3. Implement proper access controls
4. Regular security reviews recommended

## OCR/STT Support

This skill supports external OCR and STT services:

### OCR (Optical Character Recognition)
For processing handwritten or scanned medical records:
- Google Vision API
- Azure Computer Vision
- AWS Textract
- Tesseract (open source)

### STT (Speech-to-Text)
For processing voice-recorded medical notes:
- Google Speech-to-Text
- Azure Speech Services
- AWS Transcribe
- OpenAI Whisper (open source)

Configure the respective API keys in your `.env` file to enable these features.

## References

- For detailed field specifications: see [references/emr-schema.md](references/emr-schema.md)
- For payment API details: see [references/skillpay-api.md](references/skillpay-api.md)
- For full documentation: see [README.md](README.md)

## Changelog

### v1.1.0
- Added demo mode (no API key required)
- Added batch processing support
- Added file input support
- Added multi-language support (zh/en)
- Unified environment variable naming to `SKILLPAY_API_KEY` and `SKILLPAY_SKILL_ID`
- Improved error messages with bilingual support

### v1.0.4
- Initial stable release
- SkillPay billing integration
- Free trial support