## ๐Ÿ”ง **CLI ๆŠ€ๆœฏๅŽŸ็†่ฏฆ่งฃ** ### **1. CLI ็š„ๆœฌ่ดจ** CLI ไธๆ˜ฏๅ•ไธ€ๆŠ€ๆœฏ๏ผŒ่€Œๆ˜ฏ**ๅคš็งๆจกๅผ็š„็ปŸ็งฐ**๏ผš ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ CLI ็š„ไธ‰็งๅฝขๆ€ โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ ๆœฌๅœฐ็›ดๆŽฅๆ‰ง่กŒ โ”‚ ๆœฌๅœฐClient โ”‚ Web APIๅฐ่ฃ… โ”‚ โ”‚ โ”‚ + Remote Server โ”‚ โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ ls, cat, grep โ”‚ mysql, redis โ”‚ xhs, gh, aws โ”‚ โ”‚ markitdown โ”‚ -cli, ssh โ”‚ -cli โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ``` --- ### **2. ไธ‰็งCLIๆจกๅผ็š„ๅŽŸ็†** #### **ๆจกๅผไธ€๏ผšๆœฌๅœฐ็›ดๆŽฅๆ‰ง่กŒ๏ผˆๅฆ‚ `ls`, `markitdown`๏ผ‰** ```bash ็”จๆˆท่พ“ๅ…ฅ โ†’ Shell่งฃๆž โ†’ fork/exec็ณป็ปŸ่ฐƒ็”จ โ†’ ็จ‹ๅบๆ‰ง่กŒ โ†’ stdout่พ“ๅ‡บ ``` ```python # Python็คบไพ‹ import subprocess # ็›ดๆŽฅๆ‰ง่กŒๆœฌๅœฐ็จ‹ๅบ result = subprocess.run( ["markitdown", "file.pdf"], # ๅ‘ฝไปค + ๅ‚ๆ•ฐ capture_output=True, # ๆ•่Žท่พ“ๅ‡บ text=True # ๆ–‡ๆœฌๆ ผๅผ ) print(result.stdout) # ่พ“ๅ‡บ็ป“ๆžœ ``` **ๆ•ฐๆฎไผ ่พ“**๏ผš่ฟ›็จ‹้—ด้€šไฟก๏ผˆ็ฎก้“pipe๏ผ‰ **ๅ่ฎฎ**๏ผšๆ— ๏ผˆๆœฌๅœฐ่ฟ›็จ‹๏ผ‰ **ๆ ผๅผ**๏ผš็บฏๆ–‡ๆœฌ / ไบŒ่ฟ›ๅˆถ --- #### **ๆจกๅผไบŒ๏ผšClient-Server ๆจกๅผ๏ผˆๅฆ‚ `mysql`, `redis-cli`๏ผ‰** ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” TCP/Unix Socket โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Client โ”‚ โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ–ถ โ”‚ Server โ”‚ โ”‚ (CLIๅทฅๅ…ท) โ”‚ โ—€โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• โ”‚ (ๅฎˆๆŠค่ฟ›็จ‹)โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ไธ“็”จๅ่ฎฎ/RESP/MySQLๅ่ฎฎ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ``` **ไปฅ Redis ไธบไพ‹๏ผš** ```bash ็”จๆˆท: SET name "Tom" โ†“ CLI: ็ผ–็ ไธบ RESP ๅ่ฎฎ: *3\r\n$3\r\nSET\r\n$4\r\nname\r\n$3\r\nTom\r\n โ†“ Server: ๆ‰ง่กŒๅ‘ฝไปค๏ผŒ่ฟ”ๅ›ž: +OK\r\n โ†“ CLI: ่งฃ็ ๅนถๆ˜พ็คบ: OK ``` **RESPๅ่ฎฎๆ ผๅผ**๏ผˆRedisๅบๅˆ—ๅŒ–ๅ่ฎฎ๏ผ‰๏ผš ``` *3 # 3ไธชๅ…ƒ็ด ๆ•ฐ็ป„ $3 # ็ฌฌ1ไธชๅ…ƒ็ด ้•ฟๅบฆ3 SET # ๅ‘ฝไปค $4 # ็ฌฌ2ไธชๅ…ƒ็ด ้•ฟๅบฆ4 name # key $3 # ็ฌฌ3ไธชๅ…ƒ็ด ้•ฟๅบฆ3 Tom # value ``` --- #### **ๆจกๅผไธ‰๏ผšHTTP API ๅฐ่ฃ…๏ผˆๅฆ‚ `xhs`, `gh`, `aws-cli`๏ผ‰** ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” HTTPS/HTTP โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Client โ”‚ โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ–ถ โ”‚ API โ”‚ โ”‚ (CLIๅทฅๅ…ท) โ”‚ โ—€โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• โ”‚ Server โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ REST/GraphQL โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ JSONๆ ผๅผ ``` **ไปฅ `xhs search` ไธบไพ‹๏ผš** ```bash # ็”จๆˆท่พ“ๅ…ฅ xhs search "ๅฎ ็‰ฉ่พ…้…ถ" --json # CLIๅ†…้ƒจๅฎž้™…ๅš็š„HTTP่ฏทๆฑ‚: GET https://edith.xiaohongshu.com/api/sns/web/v1/search/notes Headers: - Cookie: web_session=xxx - X-Sign: ๅŠ ๅฏ†็ญพๅ - User-Agent: xhs/0.6.4 # ๆœๅŠกๅ™จ่ฟ”ๅ›ž (JSON): { "ok": true, "data": { "items": [ {"id": "xxx", "title": "...", "liked_count": "5872"} ] } } # CLIๆ ผๅผๅŒ–่พ“ๅ‡บ็ป™็”จๆˆท ``` --- ### **3. ๆ•ฐๆฎไผ ่พ“ๆ ผๅผๅฏนๆฏ”** | ็ฑปๅž‹ | ๆ•ฐๆฎๆ ผๅผ | ๅ่ฎฎ | ็คบไพ‹ | |------|---------|------|------| | **ๆœฌๅœฐๆ‰ง่กŒ** | ็บฏๆ–‡ๆœฌ/ไบŒ่ฟ›ๅˆถ | ๆ— ๏ผˆ่ฟ›็จ‹็ฎก้“๏ผ‰ | `ls`, `markitdown` | | **ๆ•ฐๆฎๅบ“ๅญ˜ๅ‚จ** | RESP/่‡ชๅฎšไน‰ | TCP | `redis-cli`, `mysql` | | **็ŽฐไปฃAPI CLI** | JSON/YAML | HTTPS | `xhs`, `gh`, `aws` | | **RPCๆœๅŠก** | Protobuf/gRPC | HTTP/2 | `kubectl` | --- ### **4. CLI Client-Server ่ฏฆ่งฃ** #### **ๆœ‰ Server ็š„ๆƒ…ๅ†ต** ```python # ไปฅ xhs-cli ไธบไพ‹็š„ๆžถๆž„ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ xhs-cli (Client) โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ 1. ๅ‘ฝไปค่งฃๆž (Click/Argparse) โ”‚ โ”‚ - ่งฃๆžๅญๅ‘ฝไปค: search/post/read โ”‚ โ”‚ - ่งฃๆžๅ‚ๆ•ฐ: --json, --sort โ”‚ โ”‚ โ”‚ โ”‚ 2. HTTP Client (requests) โ”‚ โ”‚ - ๆž„ๅปบ่ฏทๆฑ‚ๅคด (Cookie, Sign) โ”‚ โ”‚ - ๅ‘้€ HTTPS ่ฏทๆฑ‚ โ”‚ โ”‚ - ๅค„็†ๅ“ๅบ” โ”‚ โ”‚ โ”‚ โ”‚ 3. ่พ“ๅ‡บๆ ผๅผๅŒ– โ”‚ โ”‚ - JSON โ†’ ไบบ็ฑปๅฏ่ฏปๆ ผๅผ โ”‚ โ”‚ - ่กจๆ ผ/้ขœ่‰ฒ่พ“ๅ‡บ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ–ผ HTTPS โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ ๅฐ็บขไนฆ API Server โ”‚ โ”‚ (https://edith.xiaohongshu.com) โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ``` #### **ๆ—  Server ็š„ๆƒ…ๅ†ต๏ผˆ็บฏๆœฌๅœฐ๏ผ‰** ```python # ไปฅ markitdown ไธบไพ‹ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ markitdown (็บฏๆœฌๅœฐ) โ”‚ โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”‚ 1. ๆ–‡ไปถ่ฏปๅ– โ†’ PDFMiner/pptx็ญ‰ๅบ“่งฃๆž โ”‚ โ”‚ 2. ๅ†…ๅฎนๆๅ– โ†’ Markdownๆ ผๅผ่ฝฌๆข โ”‚ โ”‚ 3. ็›ดๆŽฅ่พ“ๅ‡บๅˆฐ stdout/ๆ–‡ไปถ โ”‚ โ”‚ โ”‚ โ”‚ ๆ— ็ฝ‘็ปœ้€šไฟก๏ผ็บฏๆœฌๅœฐ่ฎก็ฎ— โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ``` --- ### **5. ้€š่ฎฏๅ่ฎฎๆ€ป็ป“** | CLIๅทฅๅ…ท | ๅ่ฎฎ | ๆ ผๅผ | ๆžถๆž„ | |---------|------|------|------| | `ls/cat` | ๆ—  | ๆ–‡ๆœฌ | ๆœฌๅœฐ | | `ssh` | SSHๅ่ฎฎ | ๅŠ ๅฏ†ๆ–‡ๆœฌ | C/S | | `redis-cli` | RESP | ่‡ชๅฎšไน‰ | C/S | | `mysql` | MySQLๅ่ฎฎ | ไบŒ่ฟ›ๅˆถ | C/S | | `xhs` | HTTPS | JSON | C/S (API) | | `gh` | HTTPS | JSON | C/S (API) | | `aws-cli` | HTTPS | JSON/XML | C/S (API) | | `kubectl` | HTTPS/gRPC | JSON/YAML | C/S (K8s API) | --- ### **6. ไธบไป€ไนˆ็ŽฐไปฃCLIๅๅฅฝHTTP+JSON๏ผŸ** ``` ไผ˜ๅŠฟ: 1. ่ทจๅนณๅฐ - HTTPๅˆฐๅค„ๅฏ็”จ 2. ๆ˜“่ฐƒ่ฏ• - curl็›ดๆŽฅๆต‹่ฏ•API 3. ๅผบ็ฑปๅž‹ - JSON Schemaๅฎšไน‰ 4. ็‰ˆๆœฌๅ…ผๅฎน - API็‰ˆๆœฌๆŽงๅˆถ 5. ็”Ÿๆ€ไธฐๅฏŒ - ่‡ชๅŠจๆ–‡ๆกฃ(Swagger) ๅŠฃๅŠฟ: 1. ้œ€่ฆ่”็ฝ‘ 2. ๅปถ่ฟŸ่พƒ้ซ˜ 3. ่ฎค่ฏๅคๆ‚ (OAuth/Token) ``` --- ### **7. ็ป™ๆˆ‘ไปฌ็š„ๅฏ็คบ** | ๆˆ‘ไปฌๅทฒๆœ‰ๅทฅๅ…ท | ๆžถๆž„็ฑปๅž‹ | ๅ่ฎฎ | ้€‚็”จๅœบๆ™ฏ | |-------------|---------|------|---------| | `xhs-cli` | HTTP Client | HTTPS+JSON | APIๅฐ่ฃ… | | `markitdown` | ๆœฌๅœฐๅค„็† | ๆ—  | ๆ–‡ๆกฃ่ฝฌๆข | | `sqlite3` | ๆœฌๅœฐ+Server | SQL | ๆ•ฐๆฎๅบ“ | | `nanobot` | HTTP Client | HTTPS+JSON | AI API | **ๅฆ‚ๆžœๆˆ‘ไปฌ่‡ชๅทฑๅผ€ๅ‘CLIๅทฅๅ…ท๏ผš** ```python # ๆŽจ่ๆžถๆž„: ๆœฌๅœฐCLI + ๅฏ้€‰HTTP Server # 1. ็บฏๆœฌๅœฐCLI (็ฑปไผผ markitdown) cli-tool process input.pdf โ†’ output.md # ๆœฌๅœฐๅฎŒๆˆ # 2. Client-Serverๆจกๅผ (็ฑปไผผ xhs) cli-tool search "ๅ…ณ้”ฎ่ฏ" โ†’ HTTPS โ†’ API โ†’ JSONๅ“ๅบ” # 3. ๆททๅˆๆจกๅผ (ๆœฌๅœฐๅค„็† + ๅฏ้€‰่ฟœ็จ‹) cli-tool process input.pdf --local # ๆœฌๅœฐๅค„็† cli-tool process input.pdf --cloud # ่ฐƒ็”จ่ฟœ็จ‹API ``` **่”กๅ”ๅ”ๆƒณๆทฑๅ…ฅไบ†่งฃๅ“ช็งๆจกๅผ๏ผŸๆˆ–่€…ๆƒณ็ป™ๅ“ชไธชๅทฅๅ…ทๅšCLIๅฐ่ฃ…๏ผŸ** ๐Ÿˆ