用途：Mira 把本地文件变成 Agent 可见的上下文，适合需要同时查看文件的场景，例如预览 Markdown、HTML、图片或视频，对比文档、截图、生成的 HTML 或媒体素材，在多轮任务中保留视觉上下文，起草引用本地文件的提示词，审阅 Markdown 评论并关联原文，以及保存可复用的媒体描述。
主要能力：支持预览 Markdown（.md .mdx .markdown）、HTML（.html .htm）、图片（.png .jpg .jpeg .gif .webp .svg .avif）和视频（.mp4 .webm .mov .m4v）。提供画板（board）隔离不同任务，支持导入、链接文件夹、添加节点、创建 Markdown 提示笔记、读取与写回源文件、记录资产元数据与时间线、保存媒体描述。
使用方式：先执行 mira status --json；若缺失则安装 npm install -g https://github.com/oil-oil/mira/archive/refs/heads/main.tar.gz 后重试。安装或大版本升级后运行 mira migrate --json。默认使用端口 3020：mira init 与 mira serve --port 3020，界面为 http://localhost:3020。每个任务创建一个画板：mira board create "<short task name>" --json。批量或多步操作显式传 --board <board-id>，如 mira add、mira import、mira markdown、mira list、mira context。获取上下文可用 mira board current --json、mira list、mira comments list、mira timeline、mira context、mira read。编辑源文件用 mira read 与 mira write。
限制：Mira 目前仅预览 Markdown、HTML、图片和视频，PDF、表格、压缩包或未知文件需先转换或提取内容。全局主目录固定为 ~/.mira，不应创建独立 Mira 主目录或依赖项目派生会话。删除画板需用户明确要求并使用 --confirm，且至少保留一个画板。移除节点应使用 CLI 而非手改画板 JSON。图片和视频除非用户明确要求覆盖，否则应保留原文件。大画板建议先列出节点再逐个获取上下文，避免使用 context all。