@moredrive/cli 1.4.0 → 1.5.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 +4 -2
- package/ai-tooling.md +60 -0
- package/bin/moredrive.mjs +48 -49
- package/build-info.json +3 -3
- package/commands.md +107 -7
- package/docs/ai-tooling.md +60 -0
- package/docs/commands.md +107 -7
- package/docs/json-contract.md +6 -2
- package/docs/release-notes.md +27 -2
- package/docs/schemas/moredrive-cli-config-v1.schema.json +22 -0
- package/docs/schemas/moredrive-cli-jsonl-v2.1.schema.json +334 -0
- package/docs/schemas/moredrive-cli-output-v2.1.schema.json +334 -0
- package/docs/security.md +13 -3
- package/json-contract.md +6 -2
- package/package.json +1 -1
- package/release-notes.md +27 -2
- package/schemas/moredrive-cli-config-v1.schema.json +22 -0
- package/schemas/moredrive-cli-jsonl-v2.1.schema.json +334 -0
- package/schemas/moredrive-cli-output-v2.1.schema.json +334 -0
- package/security.md +13 -3
- package/skills/moredrive-cli/SKILL.md +19 -4
- package/skills/moredrive-cli/agents/openai.yaml +2 -2
|
@@ -1500,6 +1500,28 @@
|
|
|
1500
1500
|
"required": [],
|
|
1501
1501
|
"additionalProperties": false
|
|
1502
1502
|
},
|
|
1503
|
+
"media": {
|
|
1504
|
+
"type": "object",
|
|
1505
|
+
"properties": {
|
|
1506
|
+
"mode": {
|
|
1507
|
+
"enum": [
|
|
1508
|
+
"auto",
|
|
1509
|
+
"raw"
|
|
1510
|
+
]
|
|
1511
|
+
},
|
|
1512
|
+
"thumbnails": {
|
|
1513
|
+
"enum": [
|
|
1514
|
+
"auto",
|
|
1515
|
+
"off"
|
|
1516
|
+
]
|
|
1517
|
+
},
|
|
1518
|
+
"decoderPath": {
|
|
1519
|
+
"type": "string"
|
|
1520
|
+
}
|
|
1521
|
+
},
|
|
1522
|
+
"required": [],
|
|
1523
|
+
"additionalProperties": false
|
|
1524
|
+
},
|
|
1503
1525
|
"createdAt": {
|
|
1504
1526
|
"type": "string"
|
|
1505
1527
|
},
|
|
@@ -4394,6 +4416,57 @@
|
|
|
4394
4416
|
{
|
|
4395
4417
|
"type": "object",
|
|
4396
4418
|
"properties": {
|
|
4419
|
+
"media": {
|
|
4420
|
+
"type": "object",
|
|
4421
|
+
"properties": {
|
|
4422
|
+
"mediaMode": {
|
|
4423
|
+
"enum": [
|
|
4424
|
+
"auto",
|
|
4425
|
+
"raw"
|
|
4426
|
+
]
|
|
4427
|
+
},
|
|
4428
|
+
"sourceName": {
|
|
4429
|
+
"type": "string"
|
|
4430
|
+
},
|
|
4431
|
+
"targetName": {
|
|
4432
|
+
"type": "string"
|
|
4433
|
+
},
|
|
4434
|
+
"sourceForm": {
|
|
4435
|
+
"enum": [
|
|
4436
|
+
"plain",
|
|
4437
|
+
"media_xor_v1",
|
|
4438
|
+
"unknown"
|
|
4439
|
+
]
|
|
4440
|
+
},
|
|
4441
|
+
"targetForm": {
|
|
4442
|
+
"enum": [
|
|
4443
|
+
"plain",
|
|
4444
|
+
"media_xor_v1",
|
|
4445
|
+
"unknown"
|
|
4446
|
+
]
|
|
4447
|
+
},
|
|
4448
|
+
"transform": {
|
|
4449
|
+
"enum": [
|
|
4450
|
+
"none",
|
|
4451
|
+
"encrypt",
|
|
4452
|
+
"decrypt"
|
|
4453
|
+
]
|
|
4454
|
+
},
|
|
4455
|
+
"reason": {
|
|
4456
|
+
"type": "string"
|
|
4457
|
+
}
|
|
4458
|
+
},
|
|
4459
|
+
"required": [
|
|
4460
|
+
"mediaMode",
|
|
4461
|
+
"sourceName",
|
|
4462
|
+
"targetName",
|
|
4463
|
+
"sourceForm",
|
|
4464
|
+
"targetForm",
|
|
4465
|
+
"transform",
|
|
4466
|
+
"reason"
|
|
4467
|
+
],
|
|
4468
|
+
"additionalProperties": false
|
|
4469
|
+
},
|
|
4397
4470
|
"remotePath": {
|
|
4398
4471
|
"type": "string"
|
|
4399
4472
|
},
|
|
@@ -5157,6 +5230,94 @@
|
|
|
5157
5230
|
{
|
|
5158
5231
|
"type": "object",
|
|
5159
5232
|
"properties": {
|
|
5233
|
+
"media": {
|
|
5234
|
+
"type": "object",
|
|
5235
|
+
"properties": {
|
|
5236
|
+
"mediaMode": {
|
|
5237
|
+
"enum": [
|
|
5238
|
+
"auto",
|
|
5239
|
+
"raw"
|
|
5240
|
+
]
|
|
5241
|
+
},
|
|
5242
|
+
"sourceName": {
|
|
5243
|
+
"type": "string"
|
|
5244
|
+
},
|
|
5245
|
+
"targetName": {
|
|
5246
|
+
"type": "string"
|
|
5247
|
+
},
|
|
5248
|
+
"sourceForm": {
|
|
5249
|
+
"enum": [
|
|
5250
|
+
"plain",
|
|
5251
|
+
"media_xor_v1",
|
|
5252
|
+
"unknown"
|
|
5253
|
+
]
|
|
5254
|
+
},
|
|
5255
|
+
"targetForm": {
|
|
5256
|
+
"enum": [
|
|
5257
|
+
"plain",
|
|
5258
|
+
"media_xor_v1",
|
|
5259
|
+
"unknown"
|
|
5260
|
+
]
|
|
5261
|
+
},
|
|
5262
|
+
"transform": {
|
|
5263
|
+
"enum": [
|
|
5264
|
+
"none",
|
|
5265
|
+
"encrypt",
|
|
5266
|
+
"decrypt"
|
|
5267
|
+
]
|
|
5268
|
+
},
|
|
5269
|
+
"reason": {
|
|
5270
|
+
"type": "string"
|
|
5271
|
+
}
|
|
5272
|
+
},
|
|
5273
|
+
"required": [
|
|
5274
|
+
"mediaMode",
|
|
5275
|
+
"sourceName",
|
|
5276
|
+
"targetName",
|
|
5277
|
+
"sourceForm",
|
|
5278
|
+
"targetForm",
|
|
5279
|
+
"transform",
|
|
5280
|
+
"reason"
|
|
5281
|
+
],
|
|
5282
|
+
"additionalProperties": false
|
|
5283
|
+
},
|
|
5284
|
+
"thumbnail": {
|
|
5285
|
+
"type": "object",
|
|
5286
|
+
"properties": {
|
|
5287
|
+
"status": {
|
|
5288
|
+
"type": "string"
|
|
5289
|
+
},
|
|
5290
|
+
"reason": {
|
|
5291
|
+
"type": "string"
|
|
5292
|
+
},
|
|
5293
|
+
"nextStep": {
|
|
5294
|
+
"type": "string"
|
|
5295
|
+
},
|
|
5296
|
+
"generated": {
|
|
5297
|
+
"type": "integer",
|
|
5298
|
+
"minimum": 0
|
|
5299
|
+
},
|
|
5300
|
+
"reused": {
|
|
5301
|
+
"type": "integer",
|
|
5302
|
+
"minimum": 0
|
|
5303
|
+
},
|
|
5304
|
+
"bytesRead": {
|
|
5305
|
+
"type": "integer",
|
|
5306
|
+
"minimum": 0
|
|
5307
|
+
},
|
|
5308
|
+
"packBytesRead": {
|
|
5309
|
+
"type": "integer",
|
|
5310
|
+
"minimum": 0
|
|
5311
|
+
}
|
|
5312
|
+
},
|
|
5313
|
+
"required": [
|
|
5314
|
+
"status"
|
|
5315
|
+
],
|
|
5316
|
+
"additionalProperties": true
|
|
5317
|
+
},
|
|
5318
|
+
"replayed": {
|
|
5319
|
+
"type": "boolean"
|
|
5320
|
+
},
|
|
5160
5321
|
"remotePath": {
|
|
5161
5322
|
"type": "string"
|
|
5162
5323
|
},
|
|
@@ -5197,6 +5358,91 @@
|
|
|
5197
5358
|
{
|
|
5198
5359
|
"type": "object",
|
|
5199
5360
|
"properties": {
|
|
5361
|
+
"media": {
|
|
5362
|
+
"type": "object",
|
|
5363
|
+
"properties": {
|
|
5364
|
+
"mediaMode": {
|
|
5365
|
+
"enum": [
|
|
5366
|
+
"auto",
|
|
5367
|
+
"raw"
|
|
5368
|
+
]
|
|
5369
|
+
},
|
|
5370
|
+
"sourceName": {
|
|
5371
|
+
"type": "string"
|
|
5372
|
+
},
|
|
5373
|
+
"targetName": {
|
|
5374
|
+
"type": "string"
|
|
5375
|
+
},
|
|
5376
|
+
"sourceForm": {
|
|
5377
|
+
"enum": [
|
|
5378
|
+
"plain",
|
|
5379
|
+
"media_xor_v1",
|
|
5380
|
+
"unknown"
|
|
5381
|
+
]
|
|
5382
|
+
},
|
|
5383
|
+
"targetForm": {
|
|
5384
|
+
"enum": [
|
|
5385
|
+
"plain",
|
|
5386
|
+
"media_xor_v1",
|
|
5387
|
+
"unknown"
|
|
5388
|
+
]
|
|
5389
|
+
},
|
|
5390
|
+
"transform": {
|
|
5391
|
+
"enum": [
|
|
5392
|
+
"none",
|
|
5393
|
+
"encrypt",
|
|
5394
|
+
"decrypt"
|
|
5395
|
+
]
|
|
5396
|
+
},
|
|
5397
|
+
"reason": {
|
|
5398
|
+
"type": "string"
|
|
5399
|
+
}
|
|
5400
|
+
},
|
|
5401
|
+
"required": [
|
|
5402
|
+
"mediaMode",
|
|
5403
|
+
"sourceName",
|
|
5404
|
+
"targetName",
|
|
5405
|
+
"sourceForm",
|
|
5406
|
+
"targetForm",
|
|
5407
|
+
"transform",
|
|
5408
|
+
"reason"
|
|
5409
|
+
],
|
|
5410
|
+
"additionalProperties": false
|
|
5411
|
+
},
|
|
5412
|
+
"thumbnail": {
|
|
5413
|
+
"type": "object",
|
|
5414
|
+
"properties": {
|
|
5415
|
+
"status": {
|
|
5416
|
+
"type": "string"
|
|
5417
|
+
},
|
|
5418
|
+
"reason": {
|
|
5419
|
+
"type": "string"
|
|
5420
|
+
},
|
|
5421
|
+
"nextStep": {
|
|
5422
|
+
"type": "string"
|
|
5423
|
+
},
|
|
5424
|
+
"generated": {
|
|
5425
|
+
"type": "integer",
|
|
5426
|
+
"minimum": 0
|
|
5427
|
+
},
|
|
5428
|
+
"reused": {
|
|
5429
|
+
"type": "integer",
|
|
5430
|
+
"minimum": 0
|
|
5431
|
+
},
|
|
5432
|
+
"bytesRead": {
|
|
5433
|
+
"type": "integer",
|
|
5434
|
+
"minimum": 0
|
|
5435
|
+
},
|
|
5436
|
+
"packBytesRead": {
|
|
5437
|
+
"type": "integer",
|
|
5438
|
+
"minimum": 0
|
|
5439
|
+
}
|
|
5440
|
+
},
|
|
5441
|
+
"required": [
|
|
5442
|
+
"status"
|
|
5443
|
+
],
|
|
5444
|
+
"additionalProperties": true
|
|
5445
|
+
},
|
|
5200
5446
|
"remotePath": {
|
|
5201
5447
|
"type": "string"
|
|
5202
5448
|
},
|
|
@@ -5339,6 +5585,94 @@
|
|
|
5339
5585
|
"data": {
|
|
5340
5586
|
"type": "object",
|
|
5341
5587
|
"properties": {
|
|
5588
|
+
"media": {
|
|
5589
|
+
"type": "object",
|
|
5590
|
+
"properties": {
|
|
5591
|
+
"mediaMode": {
|
|
5592
|
+
"enum": [
|
|
5593
|
+
"auto",
|
|
5594
|
+
"raw"
|
|
5595
|
+
]
|
|
5596
|
+
},
|
|
5597
|
+
"sourceName": {
|
|
5598
|
+
"type": "string"
|
|
5599
|
+
},
|
|
5600
|
+
"targetName": {
|
|
5601
|
+
"type": "string"
|
|
5602
|
+
},
|
|
5603
|
+
"sourceForm": {
|
|
5604
|
+
"enum": [
|
|
5605
|
+
"plain",
|
|
5606
|
+
"media_xor_v1",
|
|
5607
|
+
"unknown"
|
|
5608
|
+
]
|
|
5609
|
+
},
|
|
5610
|
+
"targetForm": {
|
|
5611
|
+
"enum": [
|
|
5612
|
+
"plain",
|
|
5613
|
+
"media_xor_v1",
|
|
5614
|
+
"unknown"
|
|
5615
|
+
]
|
|
5616
|
+
},
|
|
5617
|
+
"transform": {
|
|
5618
|
+
"enum": [
|
|
5619
|
+
"none",
|
|
5620
|
+
"encrypt",
|
|
5621
|
+
"decrypt"
|
|
5622
|
+
]
|
|
5623
|
+
},
|
|
5624
|
+
"reason": {
|
|
5625
|
+
"type": "string"
|
|
5626
|
+
}
|
|
5627
|
+
},
|
|
5628
|
+
"required": [
|
|
5629
|
+
"mediaMode",
|
|
5630
|
+
"sourceName",
|
|
5631
|
+
"targetName",
|
|
5632
|
+
"sourceForm",
|
|
5633
|
+
"targetForm",
|
|
5634
|
+
"transform",
|
|
5635
|
+
"reason"
|
|
5636
|
+
],
|
|
5637
|
+
"additionalProperties": false
|
|
5638
|
+
},
|
|
5639
|
+
"thumbnail": {
|
|
5640
|
+
"type": "object",
|
|
5641
|
+
"properties": {
|
|
5642
|
+
"status": {
|
|
5643
|
+
"type": "string"
|
|
5644
|
+
},
|
|
5645
|
+
"reason": {
|
|
5646
|
+
"type": "string"
|
|
5647
|
+
},
|
|
5648
|
+
"nextStep": {
|
|
5649
|
+
"type": "string"
|
|
5650
|
+
},
|
|
5651
|
+
"generated": {
|
|
5652
|
+
"type": "integer",
|
|
5653
|
+
"minimum": 0
|
|
5654
|
+
},
|
|
5655
|
+
"reused": {
|
|
5656
|
+
"type": "integer",
|
|
5657
|
+
"minimum": 0
|
|
5658
|
+
},
|
|
5659
|
+
"bytesRead": {
|
|
5660
|
+
"type": "integer",
|
|
5661
|
+
"minimum": 0
|
|
5662
|
+
},
|
|
5663
|
+
"packBytesRead": {
|
|
5664
|
+
"type": "integer",
|
|
5665
|
+
"minimum": 0
|
|
5666
|
+
}
|
|
5667
|
+
},
|
|
5668
|
+
"required": [
|
|
5669
|
+
"status"
|
|
5670
|
+
],
|
|
5671
|
+
"additionalProperties": true
|
|
5672
|
+
},
|
|
5673
|
+
"replayed": {
|
|
5674
|
+
"type": "boolean"
|
|
5675
|
+
},
|
|
5342
5676
|
"remotePath": {
|
|
5343
5677
|
"type": "string"
|
|
5344
5678
|
},
|
package/security.md
CHANGED
|
@@ -3,23 +3,27 @@
|
|
|
3
3
|
Sensitive values:
|
|
4
4
|
|
|
5
5
|
- MoreDrive JWT
|
|
6
|
+
- refresh token
|
|
6
7
|
- share token
|
|
7
8
|
- password
|
|
8
9
|
- cookie
|
|
9
10
|
- `Authorization`
|
|
10
11
|
- Baidu dlink query values such as `access_token`
|
|
12
|
+
- local player `stream` session URL
|
|
11
13
|
|
|
12
|
-
Prefer `MOREDRIVE_TOKEN`, `--password-stdin`, `MOREDRIVE_SHARE_TOKEN`, `--share-token-file`, and `config set token --stdin`. Credential argv may be visible in process lists and shell history.
|
|
14
|
+
Prefer `MOREDRIVE_TOKEN`, `--password-stdin`, `MOREDRIVE_SHARE_TOKEN`, `--share-token-file`, and `config set token --stdin`. Credential argv may be visible in process lists and shell history. App tokens use the first non-empty value from argv, environment, profile access token, then legacy profile token; conflicting app-token sources are accepted with that precedence. Password flags, share-token sources and `config set token` value sources are mutually exclusive within each group. `share access --save-token-to` creates a new 0600 handoff file, refuses existing files and symbolic links, and omits the token from JSON; otherwise its token output is explicitly sensitive.
|
|
13
15
|
|
|
14
|
-
The CLI and client redact
|
|
16
|
+
The CLI and client redact credentials and provider dlinks from errors and default command outputs. `moredrive link --raw --json` intentionally returns a full provider dlink. `share access` without a handoff file returns the share token, and `stream` emits its local session URL in `ready`; handle those outputs as secrets.
|
|
15
17
|
|
|
16
18
|
Config storage:
|
|
17
19
|
|
|
18
|
-
-
|
|
20
|
+
- Access and refresh tokens are stored in the local JSON config file, not encrypted at rest.
|
|
19
21
|
- POSIX writes attempt `0600` permissions.
|
|
20
22
|
- Windows ACL hardening is deferred.
|
|
21
23
|
- Token storage is isolated behind config helpers so a future keychain store can replace plaintext storage.
|
|
22
24
|
|
|
25
|
+
Saved sessions refresh automatically. Explicit token/base-URL overrides disable profile refresh for that invocation to avoid sending the saved refresh token to an override endpoint. `logout` attempts server revocation and always clears local credentials; `serverRevocation: "unavailable"` or `"not-attempted"` must not be reported as confirmed revocation.
|
|
26
|
+
|
|
23
27
|
Destructive operations:
|
|
24
28
|
|
|
25
29
|
- `rm` requires `--yes` or `MOREDRIVE_ASSUME_YES=1`.
|
|
@@ -37,3 +41,9 @@ Transfer safety:
|
|
|
37
41
|
- If a dlink host ignores `Range`, CLI falls back to single-stream instead of combining unsafe byte ranges.
|
|
38
42
|
- Upload requires `slice_upload_ticket`; Worker proxy slice upload is not used by CLI MVP.
|
|
39
43
|
- If the Worker does not issue a ticket, CLI returns `unsupported`.
|
|
44
|
+
|
|
45
|
+
Local media and playback:
|
|
46
|
+
|
|
47
|
+
- `stream` binds only to `127.0.0.1`, checks Host and the random session path, and rejects browser Origin requests. Its URL grants local access; do not publish it or forward the port. Stop the CLI after playback to invalidate it.
|
|
48
|
+
- Ordinary upload/download preserves bytes. `media encrypt`/`media decrypt` and `stream --decrypt` require explicit conversion intent. The supported weak-media XOR format is obfuscation, not protection for secrets.
|
|
49
|
+
- `media thumbnails` reads remote media and writes a new local pack; generation does not upload it. FFmpeg must be explicitly selected by absolute path and is never automatically installed. Publishing or replacing the cloud pack is a separate upload subject to normal conflict rules.
|
|
@@ -1,18 +1,21 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: moredrive-cli
|
|
3
|
-
description:
|
|
3
|
+
description: Use the MoreDrive CLI to inspect or transfer Personal Drive files, access public shares, save Baidu shares, stream to a local player, or explicitly convert weak-media files and generate thumbnail packs. Includes JSON/JSONL automation and interrupted-operation recovery.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# MoreDrive CLI
|
|
7
7
|
|
|
8
8
|
Use `moredrive --help` and command-specific `--help` as the argument contract. Resolve release documentation from this discovered `SKILL.md` path: the installed files are `../../docs/commands.md`, `../../docs/json-contract.md`, and `../../docs/security.md` relative to this file.
|
|
9
9
|
|
|
10
|
+
|
|
11
|
+
Inspect current schemas offline with `moredrive schema output --revision 2.1` and `moredrive schema jsonl --revision 2.1`; revision `2` is an immutable legacy artifact and does not describe recursive batches or newer media/stream commands.
|
|
12
|
+
|
|
10
13
|
## Choose Machine Output
|
|
11
14
|
|
|
12
15
|
- Use `--json --quiet` for one final object.
|
|
13
16
|
- Use `--jsonl --quiet` for progress streams. Parse one JSON object per line and require exactly one final top-level `result` or `failed` event.
|
|
14
17
|
- Never combine `--json` and `--jsonl`.
|
|
15
|
-
- Branch on `ok`, `error.code`, `error.retriable`, and the process exit code. Do not parse human prose.
|
|
18
|
+
- Branch on `ok`, `error.code`, `error.retriable`, and the process exit code. For operations and media batches, also inspect `data.status` and item outcomes: `ok: true` alone does not imply completion. Do not parse human prose.
|
|
16
19
|
|
|
17
20
|
## Drive The Process Without Deadlocks
|
|
18
21
|
|
|
@@ -27,7 +30,9 @@ Use `moredrive --help` and command-specific `--help` as the argument contract. R
|
|
|
27
30
|
- For login, pipe the password to `moredrive login --username <name> --password-stdin --save --json`.
|
|
28
31
|
- Avoid `--token`, `--password`, and `--share-token`; argv may appear in process lists or shell history.
|
|
29
32
|
- For public shares, use `MOREDRIVE_SHARE_TOKEN` or `--share-token-file <path>`.
|
|
30
|
-
-
|
|
33
|
+
- App token resolution uses the first non-empty value: `--token`, `MOREDRIVE_TOKEN`, profile `accessToken`, then legacy profile `token`. Prefer one intentional source; multiple app-token sources are accepted, not rejected.
|
|
34
|
+
- Password flags, share-token sources (argv/file/environment), and `config set token` value sources (literal/stdin/file) are mutually exclusive within each group.
|
|
35
|
+
- Saved login sessions refresh automatically. Explicit token or base-URL overrides disable use of the profile refresh token for that invocation. `logout` clears local credentials even if server revocation fails; inspect `serverRevocation` before claiming the remote session was revoked.
|
|
31
36
|
- Treat the token returned by `share access --json` as secret output. Prefer `--save-token-to <new-path>` for a 0600 handoff file; it refuses to overwrite an existing file or symbolic link.
|
|
32
37
|
|
|
33
38
|
## Read Before Writing
|
|
@@ -73,8 +78,18 @@ For a folder download, use one root with `download <path> --to <directory> --rec
|
|
|
73
78
|
|
|
74
79
|
Use `link` only for a redacted URL. `link --raw` intentionally emits a sensitive provider URL and requires explicit need and secret-safe handling.
|
|
75
80
|
|
|
81
|
+
## Transfer limits
|
|
82
|
+
|
|
83
|
+
Use `--upload-limit '512 KiB/s'` or `--download-limit '2 MiB/s'` for a per-invocation override; `0` is unlimited. Persistent defaults are `transfer.uploadSpeedLimit` and `transfer.downloadSpeedLimit` via `moredrive config set`. Upload and download each share one process-wide budget across files, connections and retries; separate CLI processes do not share a budget. See the command guide for accepted units and limits.
|
|
84
|
+
|
|
85
|
+
## Explicit media tools
|
|
86
|
+
|
|
87
|
+
Ordinary upload/download defaults to `--media-mode auto`: supported media follows the destination directory policy on upload and marked media is decrypted on download. Use `--media-mode raw` for exact names/bytes; raw still obeys server policy. Configure defaults with `moredrive config set media.mode auto`, `moredrive config set media.thumbnails auto`, and `moredrive config set media.decoderPath /absolute/path/to/ffmpeg`. Command options override profile defaults. Upload/write can use `--thumbnails off` or `--decoder <absolute-path>`. New successful encrypted uploads generate covers from this task’s local source and publish a compatible pack. Thumbnail failure does not undo the original: inspect `data.thumbnail.status` and its recovery guidance. No automatic retry on a replayed upload. FFmpeg is optional, user-provided, and never searched on PATH or installed automatically. Use `moredrive media encrypt <input> --out <output> --json` or `moredrive media decrypt <input> --out <output> --json` only when conversion is requested. These work offline without login, preserve the input and refuse existing outputs. A single encrypted output needs the supported `.__md1x` marker before its extension (for example `photo.__md1x.png`); decrypted output uses the plain extension. Directories require `--recursive`. Inspect item results for skipped or failed files. Weak encryption does not protect sensitive information.
|
|
88
|
+
|
|
89
|
+
For thumbnails, first read the media section in the command guide. Use `moredrive media thumbnails <remote-directory> --out <new-local-pack.mdtp> --decoder <absolute-ffmpeg-path> --json`. This requires login and an explicitly provided compatible FFmpeg; it reads the current account's remote Personal Drive files with bounded source reads and creates a local pack only. It does not upload or replace the cloud pack. Publishing to `.__moredrive_thumbnails.__md1x.mdtp` is a separate authorized upload; preserve normal create-only/overwrite rules.
|
|
90
|
+
|
|
76
91
|
## Local player streaming
|
|
77
92
|
|
|
78
93
|
Use `moredrive stream <Personal Drive path|fs_id:ID> --jsonl` to serve one file to VLC/mpv without downloading the complete file. Wait for the `ready` event before using its random `http://127.0.0.1:PORT/SESSION` URL. Keep the child process alive and drain stdout/stderr while the player runs. Default lifetime is until Ctrl+C/SIGTERM; long pauses do not expire the service. Stop it after playback; the old address then fails. It does not launch a player or open a LAN listener. Do not expose the session URL to others.
|
|
79
94
|
|
|
80
|
-
`--port 0` is the default.
|
|
95
|
+
`--port 0` is the default. `--media-mode auto` decrypts supported marked media by default; `--media-mode raw` serves stored bytes. The explicit `--decrypt` option remains available. A reliable content identity is required; content change or lost access stops the service. GET/HEAD and one byte Range are supported; multiple ranges are rejected. `--download-limit` shares the configured client bandwidth budget. `--json` is rejected because this is a long-running command; `--jsonl` emits `ready` followed by exactly one `result` or `failed` terminal event.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "MoreDrive CLI"
|
|
3
|
-
short_description: "
|
|
4
|
-
default_prompt: "Use
|
|
3
|
+
short_description: "Automate MoreDrive files, shares, playback and media tools"
|
|
4
|
+
default_prompt: "Use $moredrive-cli to complete the requested file, share, playback or media workflow with machine-readable output."
|