taiwan-logistics-skill 1.0.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.
Files changed (19) hide show
  1. package/README.md +186 -0
  2. package/assets/taiwan-logistics/EXAMPLES.md +3183 -0
  3. package/assets/taiwan-logistics/README.md +33 -0
  4. package/assets/taiwan-logistics/SKILL.md +827 -0
  5. package/assets/taiwan-logistics/data/field-mappings.csv +27 -0
  6. package/assets/taiwan-logistics/data/logistics-types.csv +11 -0
  7. package/assets/taiwan-logistics/data/operations.csv +8 -0
  8. package/assets/taiwan-logistics/data/providers.csv +9 -0
  9. package/assets/taiwan-logistics/data/status-codes.csv +14 -0
  10. package/assets/taiwan-logistics/examples/newebpay-logistics-cvs-example.py +524 -0
  11. package/assets/taiwan-logistics/examples/payuni-logistics-cvs-example.py +605 -0
  12. package/assets/taiwan-logistics/references/NEWEBPAY_LOGISTICS_REFERENCE.md +774 -0
  13. package/assets/taiwan-logistics/references/ecpay-logistics-api.md +536 -0
  14. package/assets/taiwan-logistics/references/payuni-logistics-api.md +712 -0
  15. package/assets/taiwan-logistics/scripts/core.py +276 -0
  16. package/assets/taiwan-logistics/scripts/search.py +127 -0
  17. package/assets/taiwan-logistics/scripts/test_logistics.py +236 -0
  18. package/dist/index.js +16377 -0
  19. package/package.json +58 -0
package/README.md ADDED
@@ -0,0 +1,186 @@
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
+ ---
14
+
15
+ ## 安裝
16
+
17
+ ```bash
18
+ npm install -g taiwan-logistics-skill
19
+ ```
20
+
21
+ ---
22
+
23
+ ## 使用方式
24
+
25
+ ### 基本安裝
26
+
27
+ ```bash
28
+ # 自動偵測 AI 助手
29
+ taiwan-logistics init
30
+
31
+ # 指定 AI 助手類型
32
+ taiwan-logistics init --ai claude
33
+ taiwan-logistics init --ai cursor
34
+ taiwan-logistics init --ai windsurf
35
+ ```
36
+
37
+ <details>
38
+ <summary><b>完整平台列表</b></summary>
39
+
40
+ ```bash
41
+ # 主流平台
42
+ taiwan-logistics init --ai claude # Claude Code
43
+ taiwan-logistics init --ai cursor # Cursor
44
+ taiwan-logistics init --ai windsurf # Windsurf (Codeium)
45
+ taiwan-logistics init --ai copilot # GitHub Copilot
46
+ taiwan-logistics init --ai antigravity # Google Antigravity
47
+
48
+ # 其他支援平台
49
+ taiwan-logistics init --ai kiro # AWS Kiro
50
+ taiwan-logistics init --ai codex # OpenAI Codex
51
+ taiwan-logistics init --ai qoder # Qodo
52
+ taiwan-logistics init --ai roocode # Roo Code
53
+ taiwan-logistics init --ai gemini # Google Gemini CLI
54
+ taiwan-logistics init --ai trae # ByteDance Trae
55
+ taiwan-logistics init --ai opencode # OpenCode
56
+ taiwan-logistics init --ai continue # Continue.dev
57
+ taiwan-logistics init --ai codebuddy # Tencent CodeBuddy
58
+
59
+ # 安裝到所有平台
60
+ taiwan-logistics init --ai all
61
+ ```
62
+
63
+ </details>
64
+
65
+ ---
66
+
67
+ ## 其他指令
68
+
69
+ ```bash
70
+ # 列出支援的平台
71
+ taiwan-logistics list
72
+
73
+ # 顯示技能資訊
74
+ taiwan-logistics info
75
+
76
+ # 列出可用版本
77
+ taiwan-logistics versions
78
+
79
+ # 檢查更新
80
+ taiwan-logistics update
81
+ ```
82
+
83
+ ### 選項
84
+
85
+ - `--ai <type>` - 指定 AI 助手類型
86
+ - `--force` - 強制覆蓋現有檔案
87
+ - `--global` - 安裝到使用者全域目錄 (`~/.claude`, `~/.cursor` 等)
88
+
89
+ ---
90
+
91
+ ## 全域安裝
92
+
93
+ 安裝到使用者目錄，所有專案共用：
94
+
95
+ ```bash
96
+ taiwan-logistics init --ai claude --global
97
+ ```
98
+
99
+ 全域技能路徑：
100
+ - Claude Code: `~/.claude/skills/taiwan-logistics/`
101
+ - Cursor: `~/.cursor/skills/taiwan-logistics/`
102
+ - Windsurf: 不支援全域安裝
103
+
104
+ ---
105
+
106
+ ## 支援平台
107
+
108
+ | 平台 | 資料夾 | 啟動方式 |
109
+ |-----|-------|---------|
110
+ | **Claude Code** | `.claude` | `claude` 或瀏覽器開啟 [claude.ai/code](https://claude.ai/code) |
111
+ | **Cursor** | `.cursor` | `cursor` |
112
+ | **Windsurf** | `.windsurf` | `windsurf` |
113
+ | **GitHub Copilot** | `.github` | VS Code 擴充功能 |
114
+ | **Antigravity** | `.agent` | Google AI Studio |
115
+ | **Kiro** | `.kiro` | AWS Kiro CLI |
116
+ | **Codex** | `.codex` | OpenAI Codex |
117
+ | **Qoder** | `.qoder` | Qodo CLI |
118
+ | **Roo Code** | `.roo` | Roo Code Editor |
119
+ | **Gemini CLI** | `.gemini` | Google Gemini CLI |
120
+ | **Trae** | `.trae` | ByteDance Trae |
121
+ | **OpenCode** | `.opencode` | OpenCode Editor |
122
+ | **Continue** | `.continue` | Continue.dev VS Code 擴充功能 |
123
+ | **CodeBuddy** | `.codebuddy` | Tencent CodeBuddy |
124
+
125
+ ---
126
+
127
+ ## 物流服務商
128
+
129
+ | 服務商 | 加密方式 | API 風格 | 特色 |
130
+ |--------|---------|---------|------|
131
+ | **綠界 ECPay** | SHA256 | Form POST | 市佔率最高，穩定性佳，完整文檔 |
132
+ | **藍新 NewebPay** | AES-256-CBC + SHA256 | Form POST + AES | 支援多種物流方式 |
133
+ | **統一 PAYUNi** | AES-256-GCM + SHA256 | RESTful JSON | 統一集團，RESTful 設計 |
134
+
135
+ ---
136
+
137
+ ## 功能特色
138
+
139
+ - ✅ **完整 API 文檔** - ECPay、NewebPay、PAYUNi 詳細規格
140
+ - ✅ **代碼範例** - TypeScript/Python 完整可執行範例
141
+ - ✅ **加密實作指南** - SHA256、AES-256-CBC、AES-256-GCM
142
+ - ✅ **14 個 AI 平台** - 支援主流 AI 編程助手
143
+
144
+ ---
145
+
146
+ ## 物流方式支援
147
+
148
+ ### 宅配
149
+ - 宅配到府、宅配貨到付款
150
+
151
+ ### 超商取貨
152
+ - 7-ELEVEN 取貨、全家取貨、OK超商取貨、萊爾富取貨
153
+ - 超商取貨付款
154
+
155
+ ### 其他
156
+ - 冷鏈宅配、國際物流
157
+
158
+ ---
159
+
160
+ ## 開發要求
161
+
162
+ - **Node.js** >= 18.0.0 (CLI 工具)
163
+ - **Python** >= 3.x (智能腳本，無外部依賴)
164
+
165
+ ---
166
+
167
+ ## 授權
168
+
169
+ 本專案採用 [MIT License](https://opensource.org/licenses/MIT) 授權。
170
+
171
+ ---
172
+
173
+ ## 作者
174
+
175
+ 由 [Moksa](https://github.com/Moksa1123) 開發維護。
176
+
177
+ ---
178
+
179
+ ## 相關專案
180
+
181
+ - [taiwan-invoice-skill](https://github.com/Moksa1123/taiwan-invoice) - 台灣電子發票整合
182
+ - [taiwan-payment-skill](https://github.com/Moksa1123/taiwan-payment) - 台灣金流整合
183
+
184
+ ---
185
+
186
+ <p align="center">Made with ❤️ for Taiwan developers</p>