taiwan-logistics-skill 1.1.4 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +190 -190
- package/assets/taiwan-logistics/CLAUDE.md +59 -30
- package/assets/taiwan-logistics/EXAMPLES.md +3183 -3183
- package/assets/taiwan-logistics/README.md +406 -406
- package/assets/taiwan-logistics/SKILL.md +845 -827
- package/assets/taiwan-logistics/data/operations.csv +21 -0
- package/assets/taiwan-logistics/data/providers.csv +4 -0
- package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +774 -774
- package/assets/taiwan-logistics/references/ecpay-logistics-api.md +536 -536
- package/assets/taiwan-logistics/references/hct-logistics-api.md +1102 -0
- package/assets/taiwan-logistics/references/paynow-logistics-api.md +1670 -0
- package/assets/taiwan-logistics/references/payuni-logistics-api.md +712 -712
- package/assets/taiwan-logistics/references/pchomepay-logistics-api.md +1154 -0
- package/assets/taiwan-logistics/references/smilepay-logistics-api.md +1332 -0
- package/assets/templates/base/quick-reference.md +74 -85
- package/assets/templates/base/skill-content.md +845 -361
- package/assets/templates/platforms/agent.json +26 -26
- package/assets/templates/platforms/claude.json +26 -26
- package/assets/templates/platforms/codebuddy.json +25 -25
- package/assets/templates/platforms/codex.json +26 -26
- package/assets/templates/platforms/continue.json +25 -25
- package/assets/templates/platforms/copilot.json +25 -25
- package/assets/templates/platforms/cursor.json +26 -26
- package/assets/templates/platforms/gemini.json +25 -25
- package/assets/templates/platforms/kiro.json +25 -25
- package/assets/templates/platforms/opencode.json +25 -25
- package/assets/templates/platforms/qoder.json +25 -25
- package/assets/templates/platforms/roocode.json +25 -25
- package/assets/templates/platforms/trae.json +25 -25
- package/assets/templates/platforms/windsurf.json +25 -25
- package/dist/index.js +30 -30
- package/package.json +65 -58
- package/assets/taiwan-logistics/scripts/__pycache__/core.cpython-312.pyc +0 -0
package/README.md
CHANGED
|
@@ -1,190 +1,190 @@
|
|
|
1
|
-
<h1 align="center">taiwan-logistics-skill</h1>
|
|
2
|
-
|
|
3
|
-
<p align="center">台灣物流 AI 開發技能包 - 支援綠界 ECPay、藍新 NewebPay、統一 PAYUNi</p>
|
|
4
|
-
|
|
5
|
-
<p align="center">
|
|
6
|
-
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/v/taiwan-logistics-skill.svg" alt="npm version" /></a>
|
|
7
|
-
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/dm/taiwan-logistics-skill.svg" alt="npm downloads" /></a>
|
|
8
|
-
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg" alt="node version" /></a>
|
|
9
|
-
<a href="#支援平台"><img src="https://img.shields.io/badge/platforms-14-blue.svg" alt="platforms" /></a>
|
|
10
|
-
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
|
|
11
|
-
</p>
|
|
12
|
-
|
|
13
|
-
<p align="center">
|
|
14
|
-
<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>
|
|
15
|
-
</p>
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
19
|
-
## 安裝
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
npm install -g taiwan-logistics-skill
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## 使用方式
|
|
28
|
-
|
|
29
|
-
### 基本安裝
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
# 自動偵測 AI 助手
|
|
33
|
-
taiwan-logistics init
|
|
34
|
-
|
|
35
|
-
# 指定 AI 助手類型
|
|
36
|
-
taiwan-logistics init --ai claude
|
|
37
|
-
taiwan-logistics init --ai cursor
|
|
38
|
-
taiwan-logistics init --ai windsurf
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
<details>
|
|
42
|
-
<summary><b>完整平台列表</b></summary>
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
# 主流平台
|
|
46
|
-
taiwan-logistics init --ai claude # Claude Code
|
|
47
|
-
taiwan-logistics init --ai cursor # Cursor
|
|
48
|
-
taiwan-logistics init --ai windsurf # Windsurf (Codeium)
|
|
49
|
-
taiwan-logistics init --ai copilot # GitHub Copilot
|
|
50
|
-
taiwan-logistics init --ai antigravity # Google Antigravity
|
|
51
|
-
|
|
52
|
-
# 其他支援平台
|
|
53
|
-
taiwan-logistics init --ai kiro # AWS Kiro
|
|
54
|
-
taiwan-logistics init --ai codex # OpenAI Codex
|
|
55
|
-
taiwan-logistics init --ai qoder # Qodo
|
|
56
|
-
taiwan-logistics init --ai roocode # Roo Code
|
|
57
|
-
taiwan-logistics init --ai gemini # Google Gemini CLI
|
|
58
|
-
taiwan-logistics init --ai trae # ByteDance Trae
|
|
59
|
-
taiwan-logistics init --ai opencode # OpenCode
|
|
60
|
-
taiwan-logistics init --ai continue # Continue.dev
|
|
61
|
-
taiwan-logistics init --ai codebuddy # Tencent CodeBuddy
|
|
62
|
-
|
|
63
|
-
# 安裝到所有平台
|
|
64
|
-
taiwan-logistics init --ai all
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
</details>
|
|
68
|
-
|
|
69
|
-
---
|
|
70
|
-
|
|
71
|
-
## 其他指令
|
|
72
|
-
|
|
73
|
-
```bash
|
|
74
|
-
# 列出支援的平台
|
|
75
|
-
taiwan-logistics list
|
|
76
|
-
|
|
77
|
-
# 顯示技能資訊
|
|
78
|
-
taiwan-logistics info
|
|
79
|
-
|
|
80
|
-
# 列出可用版本
|
|
81
|
-
taiwan-logistics versions
|
|
82
|
-
|
|
83
|
-
# 檢查更新
|
|
84
|
-
taiwan-logistics update
|
|
85
|
-
```
|
|
86
|
-
|
|
87
|
-
### 選項
|
|
88
|
-
|
|
89
|
-
- `--ai <type>` - 指定 AI 助手類型
|
|
90
|
-
- `--force` - 強制覆蓋現有檔案
|
|
91
|
-
- `--global` - 安裝到使用者全域目錄 (`~/.claude`, `~/.cursor` 等)
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
## 全域安裝
|
|
96
|
-
|
|
97
|
-
安裝到使用者目錄,所有專案共用:
|
|
98
|
-
|
|
99
|
-
```bash
|
|
100
|
-
taiwan-logistics init --ai claude --global
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
全域技能路徑:
|
|
104
|
-
- Claude Code: `~/.claude/skills/taiwan-logistics/`
|
|
105
|
-
- Cursor: `~/.cursor/skills/taiwan-logistics/`
|
|
106
|
-
- Windsurf: 不支援全域安裝
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## 支援平台
|
|
111
|
-
|
|
112
|
-
| 平台 | 資料夾 | 啟動方式 |
|
|
113
|
-
|-----|-------|---------|
|
|
114
|
-
| **Claude Code** | `.claude` | `claude` 或瀏覽器開啟 [claude.ai/code](https://claude.ai/code) |
|
|
115
|
-
| **Cursor** | `.cursor` | `cursor` |
|
|
116
|
-
| **Windsurf** | `.windsurf` | `windsurf` |
|
|
117
|
-
| **GitHub Copilot** | `.github` | VS Code 擴充功能 |
|
|
118
|
-
| **Antigravity** | `.agent` | Google AI Studio |
|
|
119
|
-
| **Kiro** | `.kiro` | AWS Kiro CLI |
|
|
120
|
-
| **Codex** | `.codex` | OpenAI Codex |
|
|
121
|
-
| **Qoder** | `.qoder` | Qodo CLI |
|
|
122
|
-
| **Roo Code** | `.roo` | Roo Code Editor |
|
|
123
|
-
| **Gemini CLI** | `.gemini` | Google Gemini CLI |
|
|
124
|
-
| **Trae** | `.trae` | ByteDance Trae |
|
|
125
|
-
| **OpenCode** | `.opencode` | OpenCode Editor |
|
|
126
|
-
| **Continue** | `.continue` | Continue.dev VS Code 擴充功能 |
|
|
127
|
-
| **CodeBuddy** | `.codebuddy` | Tencent CodeBuddy |
|
|
128
|
-
|
|
129
|
-
---
|
|
130
|
-
|
|
131
|
-
## 物流服務商
|
|
132
|
-
|
|
133
|
-
| 服務商 | 加密方式 | API 風格 | 特色 |
|
|
134
|
-
|--------|---------|---------|------|
|
|
135
|
-
| **綠界 ECPay** | SHA256 | Form POST | 市佔率最高,穩定性佳,完整文檔 |
|
|
136
|
-
| **藍新 NewebPay** | AES-256-CBC + SHA256 | Form POST + AES | 支援多種物流方式 |
|
|
137
|
-
| **統一 PAYUNi** | AES-256-GCM + SHA256 | RESTful JSON | 統一集團,RESTful 設計 |
|
|
138
|
-
|
|
139
|
-
---
|
|
140
|
-
|
|
141
|
-
## 功能特色
|
|
142
|
-
|
|
143
|
-
- **完整 API 文檔** - ECPay、NewebPay、PAYUNi 詳細規格
|
|
144
|
-
- **代碼範例** - TypeScript/Python 完整可執行範例
|
|
145
|
-
- **加密實作指南** - SHA256、AES-256-CBC、AES-256-GCM
|
|
146
|
-
- **14 個 AI 平台** - 支援主流 AI 編程助手
|
|
147
|
-
|
|
148
|
-
---
|
|
149
|
-
|
|
150
|
-
## 物流方式支援
|
|
151
|
-
|
|
152
|
-
### 宅配
|
|
153
|
-
- 宅配到府、宅配貨到付款
|
|
154
|
-
|
|
155
|
-
### 超商取貨
|
|
156
|
-
- 7-ELEVEN 取貨、全家取貨、OK超商取貨、萊爾富取貨
|
|
157
|
-
- 超商取貨付款
|
|
158
|
-
|
|
159
|
-
### 其他
|
|
160
|
-
- 冷鏈宅配、國際物流
|
|
161
|
-
|
|
162
|
-
---
|
|
163
|
-
|
|
164
|
-
## 開發要求
|
|
165
|
-
|
|
166
|
-
- **Node.js** >= 18.0.0 (CLI 工具)
|
|
167
|
-
- **Python** >= 3.x (智能腳本,無外部依賴)
|
|
168
|
-
|
|
169
|
-
---
|
|
170
|
-
|
|
171
|
-
## 授權
|
|
172
|
-
|
|
173
|
-
本專案採用 [MIT License](https://opensource.org/licenses/MIT) 授權。
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## 作者
|
|
178
|
-
|
|
179
|
-
由 [Moksa](https://github.com/Moksa1123) 開發維護。
|
|
180
|
-
|
|
181
|
-
---
|
|
182
|
-
|
|
183
|
-
## 相關專案
|
|
184
|
-
|
|
185
|
-
- [taiwan-
|
|
186
|
-
- [taiwan-payment-skill](https://github.com/Moksa1123/taiwan-payment) - 台灣金流整合
|
|
187
|
-
|
|
188
|
-
---
|
|
189
|
-
|
|
190
|
-
<p align="center">Made for Taiwan developers</p>
|
|
1
|
+
<h1 align="center">taiwan-logistics-skill</h1>
|
|
2
|
+
|
|
3
|
+
<p align="center">台灣物流 AI 開發技能包 - 支援綠界 ECPay、藍新 NewebPay、統一 PAYUNi</p>
|
|
4
|
+
|
|
5
|
+
<p align="center">
|
|
6
|
+
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/v/taiwan-logistics-skill.svg" alt="npm version" /></a>
|
|
7
|
+
<a href="https://www.npmjs.com/package/taiwan-logistics-skill"><img src="https://img.shields.io/npm/dm/taiwan-logistics-skill.svg" alt="npm downloads" /></a>
|
|
8
|
+
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg" alt="node version" /></a>
|
|
9
|
+
<a href="#支援平台"><img src="https://img.shields.io/badge/platforms-14-blue.svg" alt="platforms" /></a>
|
|
10
|
+
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
<p align="center">
|
|
14
|
+
<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>
|
|
15
|
+
</p>
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## 安裝
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install -g taiwan-logistics-skill
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## 使用方式
|
|
28
|
+
|
|
29
|
+
### 基本安裝
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
# 自動偵測 AI 助手
|
|
33
|
+
taiwan-logistics init
|
|
34
|
+
|
|
35
|
+
# 指定 AI 助手類型
|
|
36
|
+
taiwan-logistics init --ai claude
|
|
37
|
+
taiwan-logistics init --ai cursor
|
|
38
|
+
taiwan-logistics init --ai windsurf
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
<details>
|
|
42
|
+
<summary><b>完整平台列表</b></summary>
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
# 主流平台
|
|
46
|
+
taiwan-logistics init --ai claude # Claude Code
|
|
47
|
+
taiwan-logistics init --ai cursor # Cursor
|
|
48
|
+
taiwan-logistics init --ai windsurf # Windsurf (Codeium)
|
|
49
|
+
taiwan-logistics init --ai copilot # GitHub Copilot
|
|
50
|
+
taiwan-logistics init --ai antigravity # Google Antigravity
|
|
51
|
+
|
|
52
|
+
# 其他支援平台
|
|
53
|
+
taiwan-logistics init --ai kiro # AWS Kiro
|
|
54
|
+
taiwan-logistics init --ai codex # OpenAI Codex
|
|
55
|
+
taiwan-logistics init --ai qoder # Qodo
|
|
56
|
+
taiwan-logistics init --ai roocode # Roo Code
|
|
57
|
+
taiwan-logistics init --ai gemini # Google Gemini CLI
|
|
58
|
+
taiwan-logistics init --ai trae # ByteDance Trae
|
|
59
|
+
taiwan-logistics init --ai opencode # OpenCode
|
|
60
|
+
taiwan-logistics init --ai continue # Continue.dev
|
|
61
|
+
taiwan-logistics init --ai codebuddy # Tencent CodeBuddy
|
|
62
|
+
|
|
63
|
+
# 安裝到所有平台
|
|
64
|
+
taiwan-logistics init --ai all
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
</details>
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 其他指令
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
# 列出支援的平台
|
|
75
|
+
taiwan-logistics list
|
|
76
|
+
|
|
77
|
+
# 顯示技能資訊
|
|
78
|
+
taiwan-logistics info
|
|
79
|
+
|
|
80
|
+
# 列出可用版本
|
|
81
|
+
taiwan-logistics versions
|
|
82
|
+
|
|
83
|
+
# 檢查更新
|
|
84
|
+
taiwan-logistics update
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 選項
|
|
88
|
+
|
|
89
|
+
- `--ai <type>` - 指定 AI 助手類型
|
|
90
|
+
- `--force` - 強制覆蓋現有檔案
|
|
91
|
+
- `--global` - 安裝到使用者全域目錄 (`~/.claude`, `~/.cursor` 等)
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 全域安裝
|
|
96
|
+
|
|
97
|
+
安裝到使用者目錄,所有專案共用:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
taiwan-logistics init --ai claude --global
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
全域技能路徑:
|
|
104
|
+
- Claude Code: `~/.claude/skills/taiwan-logistics/`
|
|
105
|
+
- Cursor: `~/.cursor/skills/taiwan-logistics/`
|
|
106
|
+
- Windsurf: 不支援全域安裝
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## 支援平台
|
|
111
|
+
|
|
112
|
+
| 平台 | 資料夾 | 啟動方式 |
|
|
113
|
+
|-----|-------|---------|
|
|
114
|
+
| **Claude Code** | `.claude` | `claude` 或瀏覽器開啟 [claude.ai/code](https://claude.ai/code) |
|
|
115
|
+
| **Cursor** | `.cursor` | `cursor` |
|
|
116
|
+
| **Windsurf** | `.windsurf` | `windsurf` |
|
|
117
|
+
| **GitHub Copilot** | `.github` | VS Code 擴充功能 |
|
|
118
|
+
| **Antigravity** | `.agent` | Google AI Studio |
|
|
119
|
+
| **Kiro** | `.kiro` | AWS Kiro CLI |
|
|
120
|
+
| **Codex** | `.codex` | OpenAI Codex |
|
|
121
|
+
| **Qoder** | `.qoder` | Qodo CLI |
|
|
122
|
+
| **Roo Code** | `.roo` | Roo Code Editor |
|
|
123
|
+
| **Gemini CLI** | `.gemini` | Google Gemini CLI |
|
|
124
|
+
| **Trae** | `.trae` | ByteDance Trae |
|
|
125
|
+
| **OpenCode** | `.opencode` | OpenCode Editor |
|
|
126
|
+
| **Continue** | `.continue` | Continue.dev VS Code 擴充功能 |
|
|
127
|
+
| **CodeBuddy** | `.codebuddy` | Tencent CodeBuddy |
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
## 物流服務商
|
|
132
|
+
|
|
133
|
+
| 服務商 | 加密方式 | API 風格 | 特色 |
|
|
134
|
+
|--------|---------|---------|------|
|
|
135
|
+
| **綠界 ECPay** | SHA256 | Form POST | 市佔率最高,穩定性佳,完整文檔 |
|
|
136
|
+
| **藍新 NewebPay** | AES-256-CBC + SHA256 | Form POST + AES | 支援多種物流方式 |
|
|
137
|
+
| **統一 PAYUNi** | AES-256-GCM + SHA256 | RESTful JSON | 統一集團,RESTful 設計 |
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
## 功能特色
|
|
142
|
+
|
|
143
|
+
- **完整 API 文檔** - ECPay、NewebPay、PAYUNi 詳細規格
|
|
144
|
+
- **代碼範例** - TypeScript/Python 完整可執行範例
|
|
145
|
+
- **加密實作指南** - SHA256、AES-256-CBC、AES-256-GCM
|
|
146
|
+
- **14 個 AI 平台** - 支援主流 AI 編程助手
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## 物流方式支援
|
|
151
|
+
|
|
152
|
+
### 宅配
|
|
153
|
+
- 宅配到府、宅配貨到付款
|
|
154
|
+
|
|
155
|
+
### 超商取貨
|
|
156
|
+
- 7-ELEVEN 取貨、全家取貨、OK超商取貨、萊爾富取貨
|
|
157
|
+
- 超商取貨付款
|
|
158
|
+
|
|
159
|
+
### 其他
|
|
160
|
+
- 冷鏈宅配、國際物流
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 開發要求
|
|
165
|
+
|
|
166
|
+
- **Node.js** >= 18.0.0 (CLI 工具)
|
|
167
|
+
- **Python** >= 3.x (智能腳本,無外部依賴)
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## 授權
|
|
172
|
+
|
|
173
|
+
本專案採用 [MIT License](https://opensource.org/licenses/MIT) 授權。
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
## 作者
|
|
178
|
+
|
|
179
|
+
由 [Moksa](https://github.com/Moksa1123) 開發維護。
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## 相關專案
|
|
184
|
+
|
|
185
|
+
- [taiwan-logistics-skill](https://github.com/Moksa1123/taiwan-ecommerce-toolkit) - 台灣電子發票整合
|
|
186
|
+
- [taiwan-payment-skill](https://github.com/Moksa1123/taiwan-payment) - 台灣金流整合
|
|
187
|
+
|
|
188
|
+
---
|
|
189
|
+
|
|
190
|
+
<p align="center">Made for Taiwan developers</p>
|
|
@@ -4,76 +4,84 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
|
|
4
4
|
|
|
5
5
|
## Project Overview
|
|
6
6
|
|
|
7
|
-
Taiwan
|
|
7
|
+
Taiwan Logistics Skill is an AI-powered toolkit for Taiwan logistics integration, providing API documentation, code examples, and scripts for major logistics platforms. It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.).
|
|
8
|
+
|
|
9
|
+
**Supported Providers:** `ecpay`, `newebpay`, `payuni`, `smilepay`, `pchomepay`, `paynow`, `hct_direct`
|
|
8
10
|
|
|
9
11
|
## Available Scripts
|
|
10
12
|
|
|
11
13
|
```bash
|
|
12
|
-
#
|
|
13
|
-
python3 taiwan-
|
|
14
|
+
# Search API documentation (BM25)
|
|
15
|
+
python3 taiwan-logistics/scripts/search.py "<query>" [--domain <domain>]
|
|
14
16
|
|
|
15
|
-
#
|
|
16
|
-
python3 taiwan-
|
|
17
|
+
# Recommend logistics provider
|
|
18
|
+
python3 taiwan-logistics/scripts/recommend.py "<requirements>"
|
|
17
19
|
|
|
18
|
-
#
|
|
19
|
-
python3 taiwan-
|
|
20
|
-
```
|
|
20
|
+
# Test API connectivity
|
|
21
|
+
python3 taiwan-logistics/scripts/test_logistics.py [--platform <platform>]
|
|
21
22
|
|
|
22
|
-
|
|
23
|
+
# Generate logistics service code
|
|
24
|
+
python3 taiwan-logistics/scripts/generate-logistics-service.py <Platform> --output <ts|py>
|
|
25
|
+
```
|
|
23
26
|
|
|
24
27
|
## Architecture
|
|
25
28
|
|
|
26
29
|
```
|
|
27
|
-
taiwan-
|
|
30
|
+
taiwan-logistics/ # Source of Truth
|
|
28
31
|
├── SKILL.md # Main skill documentation
|
|
29
32
|
├── EXAMPLES.md # Code examples and patterns
|
|
30
33
|
├── references/ # API documentation
|
|
31
|
-
│ ├── ecpay-api.md
|
|
32
|
-
│ ├──
|
|
33
|
-
│
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
34
|
+
│ ├── ecpay-logistics-api.md
|
|
35
|
+
│ ├── NEWEBPAY_LOGISTICS_REFERENCE.md
|
|
36
|
+
│ ├── payuni-logistics-api.md
|
|
37
|
+
│ ├── smilepay-logistics-api.md # NEW (Phase 4): Pay_zg matrix
|
|
38
|
+
│ ├── pchomepay-logistics-api.md # NEW (Phase 4): 金物流二合一
|
|
39
|
+
│ ├── paynow-logistics-api.md # NEW (Phase 4): 11 product lines, 3DES/ECB
|
|
40
|
+
│ └── hct-logistics-api.md # NEW (Phase 4): HCT 直連 carrier API
|
|
41
|
+
├── examples/ # Python examples per provider
|
|
42
|
+
└── data/ # Data-driven CSVs
|
|
43
|
+
├── providers.csv # 7+ providers/carriers
|
|
44
|
+
├── operations.csv # cross-provider API operations
|
|
45
|
+
├── logistics-types.csv # CVS/Home/temp variants
|
|
46
|
+
├── status-codes.csv # vendor-specific status codes
|
|
47
|
+
└── field-mappings.csv # cross-provider field mapping
|
|
48
|
+
|
|
49
|
+
logistics-cli/ # CLI installer (taiwan-logistics-skill on npm)
|
|
40
50
|
├── src/
|
|
41
51
|
│ ├── commands/init.ts # Install command with template generation
|
|
42
52
|
│ ├── utils/template.ts # Template rendering engine
|
|
43
|
-
│ ├── utils/github.ts # GitHub release downloads
|
|
44
|
-
│ └── utils/extract.ts # ZIP extraction utilities
|
|
45
53
|
└── assets/ # Bundled assets
|
|
46
|
-
├── taiwan-
|
|
54
|
+
├── taiwan-logistics/ # Copy of taiwan-logistics/
|
|
47
55
|
└── templates/
|
|
48
|
-
├── base/ # Base templates (skill-content.md)
|
|
56
|
+
├── base/ # Base templates (skill-content.md, quick-reference.md)
|
|
49
57
|
└── platforms/ # Platform configs (14 platforms)
|
|
50
58
|
|
|
51
|
-
.claude/skills/taiwan-
|
|
59
|
+
.claude/skills/taiwan-logistics/ # Claude Code skill (generated by CLI)
|
|
52
60
|
```
|
|
53
61
|
|
|
54
62
|
## Sync Rules
|
|
55
63
|
|
|
56
|
-
**Source of Truth:** `taiwan-
|
|
64
|
+
**Source of Truth:** `taiwan-logistics/`
|
|
57
65
|
|
|
58
66
|
When modifying files:
|
|
59
67
|
|
|
60
|
-
1. **Skill Content** - Edit in `taiwan-
|
|
68
|
+
1. **Skill Content** - Edit in `taiwan-logistics/`:
|
|
61
69
|
- `SKILL.md` - Main documentation
|
|
62
70
|
- `EXAMPLES.md` - Code examples
|
|
63
71
|
- `references/*.md` - API documentation
|
|
64
72
|
- `scripts/*.py` - Utility scripts
|
|
73
|
+
- `data/*.csv` - Data files
|
|
65
74
|
|
|
66
|
-
2. **Templates** - Edit in `cli/assets/templates/`:
|
|
75
|
+
2. **Templates** - Edit in `logistics-cli/assets/templates/`:
|
|
67
76
|
- `base/skill-content.md` - Common skill content
|
|
77
|
+
- `base/quick-reference.md` - Quick reference (Claude only)
|
|
68
78
|
- `platforms/*.json` - Platform-specific configs (14 platforms)
|
|
69
79
|
|
|
70
80
|
3. **CLI Assets** - Run sync before publishing:
|
|
71
81
|
```bash
|
|
72
|
-
cp -r taiwan-
|
|
82
|
+
cp -r taiwan-logistics/* logistics-cli/assets/taiwan-logistics/
|
|
73
83
|
```
|
|
74
84
|
|
|
75
|
-
4. **Reference Folders** - No manual sync needed. The CLI generates these from templates during `taiwan-invoice init`.
|
|
76
|
-
|
|
77
85
|
## Supported AI Platforms
|
|
78
86
|
|
|
79
87
|
| Platform | Folder | Install Type |
|
|
@@ -98,6 +106,18 @@ When modifying files:
|
|
|
98
106
|
- Node.js 18+ (for CLI)
|
|
99
107
|
- Python 3.x (for scripts, no external dependencies)
|
|
100
108
|
|
|
109
|
+
## Encryption Methods
|
|
110
|
+
|
|
111
|
+
| Provider | Encryption | Notes |
|
|
112
|
+
|---|---|---|
|
|
113
|
+
| ECPay 綠界 | MD5 CheckMacValue | Sort params + HashKey/HashIV |
|
|
114
|
+
| NewebPay 藍新 | AES-256-CBC + SHA256 | Same as MPG payment |
|
|
115
|
+
| PAYUNi 統一 | AES-256-GCM + SHA256 | Append 16-byte tag |
|
|
116
|
+
| SmilePay 速買配 | Verify_key + Mid_smilepay 加權檢核碼 | No AES; shared secret |
|
|
117
|
+
| PChomePay 拍錢包 | HTTP Basic Auth → 8h pcpay-token | Same as payment side |
|
|
118
|
+
| PayNow 立吉富 | **3DES (TripleDES) / ECB / Zero-Padding** | 24-byte Key + 8-byte IV; **不同於金流端的動態 AES-256** |
|
|
119
|
+
| HCT 直連 | 自訂加密(金鑰申請後提供) | C# sample code only |
|
|
120
|
+
|
|
101
121
|
## Git Workflow
|
|
102
122
|
|
|
103
123
|
Never push directly to `main`. Always:
|
|
@@ -106,3 +126,12 @@ Never push directly to `main`. Always:
|
|
|
106
126
|
2. Commit changes
|
|
107
127
|
3. Push branch: `git push -u origin <branch>`
|
|
108
128
|
4. Create PR: `gh pr create`
|
|
129
|
+
|
|
130
|
+
## Related Projects
|
|
131
|
+
|
|
132
|
+
- **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego, ezPay, PayNow)
|
|
133
|
+
- **Taiwan Payment Skill** - Payment integration (10 providers including ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, TapPay)
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
**Last Updated**: 2026-05-07 (Phase 4: +4 logistics providers — SmilePay, PChomePay, PayNow, HCT direct)
|