06. 会话

本地导出

把会话的 Markdown 记录拿到这台机器上——文件、剪贴板，或 stdout。这是把对话带出 Matcha CLI 的受支持做法。

在 TUI 里：`/export`

/export
/export [filename]

需要活动会话。不带文件名时，Matcha CLI 把完整记录复制到剪贴板。带文件名时，写出 UTF-8 的 .md 文件。

/export
/export notes/auth-session.md
/export ~/exports/my convo with spaces.md

路径可以使用 ~、空格和嵌套目录。父目录不存在时会创建。输入路径时，/export 会提供目录补全。

对话为空时，TUI 会提示 **No conversation content to export**。

送到剪贴板的规则与 /copy 相同。若剪贴板不可达（SSH 或某些终端里常见），Matcha CLI 会写一份备份文件并告诉你路径，而不会声称复制成功。

/export 写出的是你在本会话滚动记录里看到的内容。它不会上传任何东西。

在终端里：`matcha export`

不在 TUI 里时用这条，或你已有来自 matcha sessions list 的 session ID。

matcha export <session-id>
matcha export <session-id> path/to/out.md
matcha export <session-id> --clipboard
参数Markdown 写到哪里
只有 session IDstdout
session ID + 路径该文件（会展开 ~；会创建父目录）
session ID + -c / --clipboard剪贴板，并在 stderr 打出行数

ID 必填。会话必须在磁盘上，且必须有对话内容；否则命令报错（Session '…' not found 或 has no conversation content to export）。

matcha export 从已保存的会话日志重建记录，因此可以导出当前并未打开的会话。

matcha sessions list
matcha export 01936c2a-… ~/Desktop/session.md

`/share` 与 `matcha share` 不可用

Matcha CLI 不提供分享链接。没有产品级的会话分享服务。

入口会发生什么
/share不出现在 / 菜单里。若仍输入：*Session sharing is unavailable in this Matcha build (Mode A).*
matcha share不出现在 matcha --help 里。若仍调用：*Session sharing is temporarily disabled.*

/copy 只复制一条回复，不是整份记录。

你应该看到

你执行了结果
/export记录到剪贴板（或一个具名备份路径）
/export ~/out.mdConversation exported to …/out.md
matcha export <id> out.md文件已写出；状态在 stderr
matcha export <id>Markdown 打到 stdout
/share 或 matcha share不可用；请改用导出