magic-builder 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,139 @@
+# magic-builder
+
+CLI for Magic Builder (妙笔): publish HTML pages, deploy FaaS functions, upload assets, generate links, and install the Magic Builder Codex skill.
+
+## Install
+
+```bash
+npm install -g magic-builder
+```
+
+With Bun:
+
+```bash
+bun add -g magic-builder
+```
+
+The package provides three equivalent command names:
+
+```bash
+magic-builder --help
+magic-cli --help
+miaobi --help
+```
+
+You can also run it without installing:
+
+```bash
+npx magic-builder help
+bunx magic-builder help
+```
+
+## Authentication
+
+Most write operations need a Magic developer token.
+
+```bash
+magic-builder auth login
+```
+
+Manual token setup:
+
+```bash
+magic-builder auth set <token>
+magic-builder auth show
+```
+
+Token lookup order:
+
+1. `--token`
+2. `MAGIC_TOKEN`
+3. `~/.magic-token`
+4. project `.magic-token`
+
+## Common Commands
+
+Publish an HTML page:
+
+```bash
+magic-builder page publish app.html --title "Dashboard"
+```
+
+List or export pages:
+
+```bash
+magic-builder page list --scope mine
+magic-builder page list --scope public --title demo
+magic-builder page export --id <id> --out app.html
+```
+
+Deploy a FaaS function:
+
+```bash
+magic-builder faas publish handler.js --name report-api
+```
+
+Upload an asset:
+
+```bash
+magic-builder asset upload logo.png
+```
+
+Generate a Magic link:
+
+```bash
+magic-builder link create --title "Weekly Report"
+magic-builder link create --fid <faas-id>
+```
+
+Create or append a Feishu document HTML Box:
+
+```bash
+magic-builder doc create --html app.html --title "Demo"
+magic-builder doc append --html app.html --doc-token <docx-token>
+```
+
+Install or update the Magic Builder Codex skill:
+
+```bash
+magic-builder skill install
+magic-builder skill check-update
+magic-builder skill update
+```
+
+Check local environment:
+
+```bash
+magic-builder doctor
+magic-builder config get
+```
+
+## Help
+
+All of these forms are supported:
+
+```bash
+magic-builder help
+magic-builder help page
+magic-builder page help
+magic-builder page publish help
+magic-builder man
+```
+
+`--help`, `-h`, and `--man` are also supported.
+
+## Global Options
+
+```text
+--base-url, --magic-base-url <url>   Magic service base URL
+--token <token>                      Auth token override
+--format json|table|plain            Output format, default json
+--quiet, -q                          Suppress progress messages
+--version, -v                        Show version
+```
+
+Default Magic service:
+
+```text
+https://magic.solutionsuite.cn
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magic-builder",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CLI for Magic Builder — publish pages, functions, and files",
   "bin": {
     "magic-builder": "./bin/magic-builder.js",