taiwan-payment-skill 1.0.0 → 1.0.2

package/README.md

@@ -11,7 +11,7 @@
   <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/dm/taiwan-payment-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
   <img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js">
   <img src="https://img.shields.io/badge/platforms-14-blue?style=flat-square" alt="14 Platforms">
-  <a href="https://github.com/Moksa1123/taiwan-payment/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-payment?style=flat-square" alt="License"></a>
+  <a href="https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-invoice?style=flat-square" alt="License"></a>
 </p>
 
 <p align="center">

package/assets/taiwan-payment/README.md

@@ -1,306 +1,197 @@
-# Taiwan Payment Gateway Integration Toolkit
-
-**Professional payment gateway integration solution for Taiwan market**
-
-Supporting ECPay (綠界科技), NewebPay (藍新金流), and PAYUNi (統一金流) with comprehensive API documentation, intelligent tools, and production-ready code examples.
-
----
-
-## Overview
-
-This toolkit provides enterprise-grade integration capabilities for Taiwan's major payment gateways, featuring:
-
-- **Complete API Documentation**: Detailed specifications for all three providers
-- **Intelligent Search Engine**: BM25-powered search across 7 domains (API docs, error codes, field mappings, payment methods)
-- **Smart Recommendation System**: AI-driven provider selection based on business requirements
-- **Production-Ready Examples**: 9 comprehensive TypeScript/Python implementations
-- **Data-Driven Architecture**: 7 CSV datasets for easy maintenance and updates
-- **Multi-Platform Support**: Compatible with 14 AI coding assistants
-
----
-
-## Supported Payment Gateways
-
-| Provider | Encryption | API Style | Market Share | Status |
-|----------|-----------|-----------|--------------|--------|
-| **ECPay (綠界科技)** | SHA256 | Form POST | High | ✅ Full Support |
-| **NewebPay (藍新金流)** | AES-256-CBC + SHA256 | Form POST + AES | High | ✅ Full Support |
-| **PAYUNi (統一金流)** | AES-256-GCM + SHA256 | RESTful JSON | Medium | ✅ Full Support |
-
-### Technical Comparison
-
-| Feature | ECPay | NewebPay | PAYUNi |
-|---------|-------|----------|---------|
-| **Encryption Method** | URL Encode + SHA256 | Dual-layer (AES-256-CBC + SHA256) | AES-256-GCM + SHA256 |
-| **Content Type** | application/x-www-form-urlencoded | application/x-www-form-urlencoded | application/json |
-| **Payment Methods** | 11 types (including BNPL, TWQR) | 13 types (including LINE Pay, Apple Pay) | 8 types (including AFTEE, iCash) |
-| **API Design** | Traditional Form POST | MPG Integration, Form POST | Modern RESTful JSON |
-| **Best For** | High-volume e-commerce, Traditional industries | Multi-payment scenarios, Mobile apps | API-first startups, Modern tech stacks |
-
----
-
-## Installation
-
-### NPM Global Installation
-
-```bash
-npm install -g taiwan-payment-skill
-```
-
-### Initialize in Project
-
-```bash
-# Auto-detect AI assistant
-taiwan-payment init
-
-# Specify AI assistant type
-taiwan-payment init --ai claude      # Claude Code
-taiwan-payment init --ai cursor      # Cursor
-taiwan-payment init --ai windsurf    # Windsurf
-```
-
-### Supported AI Platforms (14)
-
-Claude Code · Cursor · Windsurf · GitHub Copilot · Antigravity · Kiro · Codex · Qoder · Roo Code · Gemini CLI · Trae · OpenCode · Continue · CodeBuddy
-
----
-
-## Intelligent Tools
-
-### 1. BM25 Search Engine
-
-Fast semantic search across payment gateway documentation and error codes.
-
-```bash
-# Search error codes
-python scripts/search.py "10100058" --domain error
-
-# Search payment methods
-python scripts/search.py "信用卡" --domain payment_method
-
-# Search field mappings
-python scripts/search.py "MerchantTradeNo" --domain field
-
-# JSON output
-python scripts/search.py "ATM" --format json
-```
-
-**Search Domains:**
-- `provider` - Provider comparison
-- `operation` - API endpoints
-- `error` - Error code lookup
-- `field` - Field name mappings
-- `payment_method` - Payment method specifications
-- `troubleshoot` - Troubleshooting guides
-- `reasoning` - Recommendation logic
-
-### 2. Smart Recommendation System
-
-AI-powered provider recommendation based on business requirements.
-
-```bash
-# High-volume e-commerce
-python scripts/recommend.py "高交易量 電商 穩定"
-# → Recommends ECPay (highest market share, proven stability)
-
-# Multi-payment requirements
-python scripts/recommend.py "多元支付 LINE Pay Apple Pay"
-# → Recommends NewebPay (supports 13 payment methods)
-
-# API-first design
-python scripts/recommend.py "API RESTful JSON"
-# → Recommends PAYUNi (modern RESTful design)
-```
-
-### 3. Connection Testing Tool
-
-Verify API connectivity and credentials.
-
-```bash
-# Test specific provider
-python scripts/test_payment.py ecpay
-python scripts/test_payment.py newebpay
-python scripts/test_payment.py payuni
-
-# Test all providers
-python scripts/test_payment.py all
-```
-
----
-
-## Architecture
-
-```
-taiwan-payment/
-├── SKILL.md                        # Main documentation (857 lines)
-├── EXAMPLES.md                     # Code examples (1425 lines)
-├── references/                     # API specifications
-│   ├── ECPAY_PAYMENT_REFERENCE.md
-│   ├── NEWEBPAY_PAYMENT_REFERENCE.md
-│   └── PAYUNI_PAYMENT_REFERENCE.md
-├── scripts/                        # Python intelligent tools
-│   ├── core.py                     # BM25 search engine (311 lines)
-│   ├── recommend.py                # Recommendation system (373 lines)
-│   ├── search.py                   # Search CLI (150+ lines)
-│   └── test_payment.py             # Connection testing (359 lines)
-└── data/                           # Data-driven architecture (7 CSV files)
-    ├── providers.csv               # Provider details
-    ├── operations.csv              # API operations
-    ├── error-codes.csv             # Error code mappings
-    ├── field-mappings.csv          # Field name mappings
-    ├── payment-methods.csv         # Payment method specs
-    ├── reasoning.csv               # Recommendation rules (30+ scenarios)
-    └── troubleshooting.csv         # Common issues (16 cases)
-```
-
----
-
-## Payment Methods
-
-### Credit Card
-- One-time payment, Installments (3/6/12/18/24/30 periods)
-- Recurring billing, Credit card tokenization
-
-### E-Wallets
-- Apple Pay, Google Pay, Samsung Pay
-- LINE Pay, Taiwan Pay
-
-### Bank Transfer
-- WebATM, Virtual account (ATM)
-
-### Convenience Store
-- CVS payment code, CVS barcode
-
-### Others
-- TWQR, BNPL (Buy Now Pay Later), AFTEE, iCash
-
----
-
-## Code Examples
-
-### ECPay Credit Card Payment
-
-```typescript
-import { createPayment } from './ecpay-service';
-
-const order = {
-  merchantId: '3002607',
-  orderId: `ORDER${Date.now()}`,
-  amount: 1050,
-  description: 'Product Purchase',
-  returnUrl: 'https://example.com/callback',
-  paymentMethod: 'Credit'
-};
-
-const form = await createPayment(order);
-// Returns HTML form ready for submission
-```
-
-### NewebPay MPG Integration
-
-```typescript
-import { createPayment } from './newebpay-service';
-
-const order = {
-  merchantId: 'YOUR_MERCHANT_ID',
-  orderId: `ORDER${Date.now()}`,
-  amount: 2500,
-  description: 'E-commerce Order',
-  returnUrl: 'https://example.com/notify',
-  paymentMethod: 'CREDIT,VACC,CVS' // Multiple methods
-};
-
-const form = await createPayment(order);
-```
-
-### PAYUNi RESTful API
-
-```typescript
-import axios from 'axios';
-import { encryptPayUni } from './encryption';
-
-const order = {
-  MerID: 'YOUR_MERCHANT_ID',
-  MerTradeNo: `ORDER${Date.now()}`,
-  TradeAmt: 3000,
-  ProdDesc: 'Subscription Service',
-  ReturnURL: 'https://example.com/callback',
-  PayType: 'Credit'
-};
-
-const { encryptInfo, hashInfo } = encryptPayUni(order);
-const response = await axios.post('https://sandbox-api.payuni.com.tw/api/upp', {
-  MerID: order.MerID,
-  EncryptInfo: encryptInfo,
-  HashInfo: hashInfo
-});
-```
-
----
-
-## Data-Driven Architecture
-
-All business logic is stored in CSV files for easy maintenance:
-
-- **providers.csv**: Provider configurations (encryption, test accounts, API endpoints)
-- **operations.csv**: API operations (create, query, refund, recurring)
-- **error-codes.csv**: Error code mappings with solutions
-- **field-mappings.csv**: Field name translations across providers
-- **payment-methods.csv**: Payment method specifications
-- **reasoning.csv**: Recommendation rules (30+ business scenarios)
-- **troubleshooting.csv**: Common issues and solutions (16 cases)
-
----
-
-## Development Requirements
-
-- **Node.js** >= 18.0.0 (CLI tool)
-- **Python** >= 3.x (intelligent scripts, no external dependencies)
-
----
-
-## Documentation
-
-- [SKILL.md](./SKILL.md) - Complete skill documentation (857 lines)
-- [EXAMPLES.md](./EXAMPLES.md) - 9 production-ready code examples (1425 lines)
-- [CLAUDE.md](./CLAUDE.md) - Development guide for Claude Code
-
-### API References
-
-- [ECPay Payment API](./references/ECPAY_PAYMENT_REFERENCE.md)
-- [NewebPay Payment API](./references/NEWEBPAY_PAYMENT_REFERENCE.md)
-- [PAYUNi Payment API](./references/PAYUNI_PAYMENT_REFERENCE.md)
-
----
-
-## License
-
-[MIT License](https://opensource.org/licenses/MIT)
-
----
-
-## Related Projects
-
-- [taiwan-invoice-skill](https://github.com/Moksa1123/taiwan-invoice) - Taiwan E-Invoice integration
-- [taiwan-logistics-skill](https://github.com/Moksa1123/taiwan-logistics) - Taiwan logistics integration
-
----
-
-## Support
-
-- **Official Documentation**: See `references/` directory
-- **Technical Support**:
-  - ECPay: techsupport@ecpay.com.tw
-  - NewebPay: 02-2655-8938
-  - PAYUNi: 02-2747-5100
-
----
-
-<p align="center">
-  <sub>Professional toolkit by <strong>Moksa</strong></sub><br>
-  <sub>service@moksaweb.com</sub>
-</p>
-
-<p align="center">
-  <sub>Last updated: 2026-01-29</sub>
-</p>
+<h1 align="center">taiwan-payment-skill</h1>
+
+<h3 align="center">台灣金流 AI 開發技能包</h3>
+
+<p align="center">
+  <strong>支援 ECPay 綠界 · NewebPay 藍新 · PAYUNi 統一</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/v/taiwan-payment-skill?style=flat-square&logo=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/dm/taiwan-payment-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js">
+  <img src="https://img.shields.io/badge/platforms-14-blue?style=flat-square" alt="14 Platforms">
+  <a href="https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-invoice?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://paypal.me/cccsubcom"><img src="https://img.shields.io/badge/PayPal-支持開發-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
+</p>
+
+---
+
+## 安裝
+
+```bash
+npm install -g taiwan-payment-skill
+```
+
+---
+
+## 使用方式
+
+```bash
+# 進入專案目錄
+cd /path/to/your/project
+
+# 選擇你的 AI 助手
+taiwan-payment init --ai claude        # Claude Code
+taiwan-payment init --ai cursor        # Cursor
+taiwan-payment init --ai windsurf      # Windsurf
+taiwan-payment init --ai copilot       # GitHub Copilot
+taiwan-payment init --ai antigravity   # Antigravity
+taiwan-payment init --ai all           # 全部安裝
+```
+
+<details>
+<summary>完整平台列表</summary>
+
+```bash
+taiwan-payment init --ai kiro          # Kiro (AWS)
+taiwan-payment init --ai codex         # Codex CLI (OpenAI)
+taiwan-payment init --ai qoder         # Qoder
+taiwan-payment init --ai roocode       # Roo Code
+taiwan-payment init --ai gemini        # Gemini CLI
+taiwan-payment init --ai trae          # Trae (ByteDance)
+taiwan-payment init --ai opencode      # OpenCode
+taiwan-payment init --ai continue      # Continue
+taiwan-payment init --ai codebuddy     # CodeBuddy (Tencent)
+```
+
+</details>
+
+---
+
+## 其他指令
+
+```bash
+taiwan-payment list         # 列出支援平台
+taiwan-payment info         # 顯示技能資訊
+taiwan-payment versions     # 列出可用版本
+taiwan-payment update       # 檢查更新
+```
+
+### 選項
+
+```bash
+taiwan-payment init --force     # 覆蓋現有檔案
+taiwan-payment init --global    # 安裝到全域目錄（所有專案共用）
+```
+
+### 全域安裝
+
+使用 `--global` 可將技能安裝到使用者目錄，讓所有專案都能使用：
+
+```bash
+taiwan-payment init --ai cursor --global       # ~/.cursor/skills/taiwan-payment/
+taiwan-payment init --ai claude --global       # ~/.claude/skills/taiwan-payment/
+taiwan-payment init --ai antigravity --global  # ~/.gemini/antigravity/global_skills/taiwan-payment/
+```
+
+---
+
+## 支援平台
+
+| 平台 | 說明 | 啟動方式 |
+|------|------|----------|
+| **Claude Code** | Anthropic 官方 CLI | `/taiwan-payment` |
+| **Cursor** | AI 程式編輯器 | `/taiwan-payment` |
+| **Windsurf** | Codeium 編輯器 | 自動 |
+| **Copilot** | GitHub Copilot | `/taiwan-payment` |
+| **Antigravity** | Google AI 助手 | `/taiwan-payment` |
+| **Kiro** | AWS AI 助手 | `/taiwan-payment` |
+| **Codex** | OpenAI CLI | 自動 |
+| **Qoder** | Qodo AI 助手 | 自動 |
+| **RooCode** | VSCode 擴充 | `/taiwan-payment` |
+| **Gemini CLI** | Google Gemini | 自動 |
+| **Trae** | ByteDance AI | 自動 |
+| **OpenCode** | 開源 AI 助手 | 自動 |
+| **Continue** | 開源 AI 助手 | 自動 |
+| **CodeBuddy** | Tencent AI | 自動 |
+
+---
+
+## 金流服務商
+
+| 服務商 | 加密方式 | API 風格 | 特點 |
+|--------|---------|---------|------|
+| **ECPay 綠界** | URL Encode + SHA256 | Form POST | 市佔率最高，穩定性佳 |
+| **NewebPay 藍新** | AES-256-CBC + SHA256 | Form POST + AES | 支援最多支付方式 (13 種) |
+| **PAYUNi 統一** | AES-256-GCM + SHA256 | RESTful JSON | RESTful 設計，API 現代化 |
+
+---
+
+## 付款方式支援
+
+### 信用卡支付
+- 一次付清、分期付款 (3/6/12/18/24 期)
+- 信用卡定期定額、信用卡記憶
+
+### 電子錢包
+- Apple Pay、Google Pay、Samsung Pay
+- LINE Pay、台灣 Pay
+
+### 轉帳支付
+- 網路 ATM、ATM 虛擬帳號
+
+### 超商支付
+- 超商代碼、超商條碼
+
+### 其他
+- TWQR、BNPL 無卡分期、AFTEE 先享後付
+
+---
+
+## 智能工具
+
+安裝後包含以下 Python 工具（純 Python，無需外部依賴）：
+
+```bash
+# BM25 搜索引擎 - 搜索錯誤碼、欄位映射、付款方式
+python scripts/search.py "10100058" --domain error
+python scripts/search.py "信用卡" --domain payment_method
+python scripts/search.py "CheckMacValue" --domain troubleshoot
+
+# 智能推薦系統 - 根據需求推薦金流服務商
+python scripts/recommend.py "高交易量 電商 穩定"
+python scripts/recommend.py "多元支付 LINE Pay Apple Pay"
+
+# 連線測試工具 - 測試 API 連線
+python scripts/test_payment.py ecpay
+python scripts/test_payment.py all
+```
+
+### 搜索域
+
+- `provider` - 服務商比較
+- `operation` - API 操作端點
+- `error` - 錯誤碼查詢
+- `field` - 欄位映射
+- `payment_method` - 付款方式
+- `troubleshoot` - 疑難排解
+- `reasoning` - 推薦決策規則
+
+---
+
+## 功能特色
+
+- 完整 API 文檔 (ECPay, NewebPay, PAYUNi)
+- BM25 搜索引擎 (311 行)
+- 智能推薦系統 (373 行)
+- 9 組完整代碼範例 (TypeScript/Python)
+- 7 個 CSV 數據檔 (易於維護)
+- 加密實作指南 (SHA256, AES-CBC, AES-GCM)
+- 16 個疑難排解案例
+
+---
+
+## 授權
+
+[MIT License](https://github.com/Moksa1123/taiwan-payment/blob/main/LICENSE)
+
+---
+
+<p align="center">
+  <sub>Made by <strong>Moksa</strong></sub><br>
+  <sub>service@moksaweb.com</sub>
+</p>