@302ai/media-studio-cli 0.1.0-beta.5 → 0.1.0-beta.7

package/README.md

@@ -53,7 +53,6 @@ msc chat "hi" --session <id>  # 切换到指定会话并设为默认
 msc sessions                  # 列出所有会话（标记当前默认 `(current)`）
 msc sessions --json           # 机器可读的原始 JSON 数组
 msc sessions use <id>         # 纯本地切换默认会话（零请求、不校验）
-msc sessions rm <id>          # 删除服务端会话（交互确认，或加 -y/--yes 跳过）
 msc skills                    # 列出技能库（--plaza 浏览技能广场）
 msc skills add <slug>          # 从广场安装技能（如 brainstorming，见 --plaza --json 的 slug）
 msc skills rm <command>       # 从技能库移除（-y/--yes 跳过确认）
@@ -61,6 +60,9 @@ msc skills enable <command>   # 启用 / disable 停用
 msc --help                    # all flags
 ```
 
+Session deletion is not available in the CLI. To delete a session, open the
+corresponding session page in the Media Studio web app and delete it manually.
+
 `msc --help` carries an agent-oriented quickstart — the auth prerequisite, the
 three canonical calls, and the `--json` contract. `msc guide` prints the full
 manual: every command, both JSON schemas, the `nextStep` values, exit codes,
@@ -180,6 +182,29 @@ alone triggers nothing.
   flag on your account (a persistent change), is reported as
   `Auto-enabled for this turn: …`, and a failed enable aborts the turn.
 
+### Attachments
+
+Attach local files to a chat turn using `@path` anywhere in the prompt:
+
+```bash
+msc chat "看看 @cover.png 这张图"             # bare path (ends at whitespace)
+msc chat "总结 @/abs/path/notes.pdf"          # absolute path
+msc chat '对比 @"my docs/report.docx" 内容'   # quoted path with spaces
+```
+
+The CLI mirrors the web composer's upload flow:
+
+1. Validates each referenced file locally (exists, readable, supported extension, under 50 MB) before any network call.
+2. Uploads each file via the web app's `POST /api/chat/attachments` endpoint with a terminal spinner (`Uploading attachment 1/2: cover.png`).
+3. Rewrites the prompt to inline the remote URL using the web's `&&<url>&&` marker, which the upstream model and web session history natively understand.
+4. Up to 5 unique attachments per turn (same as the web composer); referencing the same file twice uploads it once.
+5. An unattachable reference (missing file, unsupported format) fails the turn before any session is provisioned.
+6. Prose mentions (`@team 辛苦了`, email addresses) stay literal text — only tokens with a file extension or path slash are treated as attachments.
+7. `@path` is local-filesystem-only: `@https://example.com/a.png` fails with `no such file`. There is no `@url` form — remote URLs are not attachments.
+
+In `--json` mode the uploaded attachments are surfaced under the `attachments` array:
+`[{ name, type, size, remoteUrl }]`.
+
 ### Staging server (expired TLS certificate)
 
 The staging server's certificate is expired (ops declines renewal), so the
@@ -301,7 +326,6 @@ msc chat "刚才的数字是几?"     # answers 42
 msc sessions                  # shows session list with (current) marker
 msc chat "hi" --session <id>  # switch to specific session
 msc sessions use <id>         # switch default pointer locally
-msc sessions rm <id> -y       # delete session upstream (-y skips prompt)
 ```
 
 Without the local server, point at production with