42md CLI 主命令与架构大升级：三类命令一目了然

42md <文件 / URL>          ← 主命令：格式转换（非 md → md）
42md tools <name> ...      ← tools 子命令：加工 / 导出 / 效率 / 整理
42md kb <动作> ...         ← kb 子命令：云端知识库（检索 / 取用 / 同步）
42md auth / upgrade / help ← 辅助命令：账户 / 升级 / 帮助

42md report.pdf            # PDF → Markdown
42md slides.pptx           # PPT → Markdown
42md invoice.ofd           # OFD 电子发票 → Markdown
42md lecture.mp3           # 音频 → Markdown（按段落 + 时间戳）
42md scan.pdf --ocr        # 扫描件 PDF + AI OCR
42md https://example.com   # 网页 → Markdown

# 第一组：二次处理（md → md）
42md tools lint         # 版式优化（免费）
42md tools translate    # AI 翻译（33 种语言）
42md tools improve      # AI 文本优化（多种内置模板）
42md tools hotwords     # AI 热词（webapp 即将上线，CLI 已可用）

# 第二组：知识导出（md → 任意格式，全部免费）
42md tools md2pdf       # 转 PDF（数学公式 / 中英混排）
42md tools md2docx      # 转 Word（可继续批注）
42md tools md2epub      # 转 EPUB 电子书
42md tools md2html      # 转独立单文件 HTML
42md tools md2wechat    # 转微信公众号 HTML

# 第三组：知识效率（URL → 文件，CLI 仅，免费）
42md tools download     # 整站资源批量下载
42md tools screenshot   # 网页全页截图

# 第四组：文件整理（文件 → 文件，CLI 仅，免费、纯本地）
42md tools merge        # 合并成一份（Markdown 多份拼一份 / PDF 顺序合并）
42md tools split        # 拆成多份（Markdown 按标题 / 分页拆；PDF 按页区间 / 每 N 页 / 书签拆）
42md tools inspect      # 体检源文件（体积构成 / 可压空间）
42md tools compress     # 瘦身源文件（PDF / 图片）

# 探索 / 帮助
42md tools list         # 列出全部工具
42md tools info <name>  # 查看某个工具详细元数据

$ 42md tools translate --help
Markdown 翻译（消耗 AI 生成额度）

Usage: 42md tools translate [OPTIONS] [INPUTS]...

Options:
      --target <TARGET>  目标语言（默认中文）
  -y, --yes              非交互模式跳过 Y/n 确认
  -h, --help             Print help

# 按需取用（单条）
42md kb search "执行意图"               # 全文检索，返回 id + 预览
42md kb list --layer cards --kind term  # 按结构浏览：卡片 / 专题 / 素材
42md kb get <id> --type card -o card.md # 取一条到本地 Markdown
42md kb put draft.md                    # 把本地内容新增进素材库

# 整库同步（markdown vault）
42md kb export ./42md-kb                 # 整库克隆成本地可编辑 Markdown 文件夹
42md kb check ./42md-kb                  # 离线校验（零网络、零配额）
42md kb push ./42md-kb                   # 改动回流云端，存成新版本

# 账户
42md auth login         # 登录拿到 access token
42md auth logout        # 注销
42md auth status        # 查看当前账号 + 余额

# 升级
42md upgrade            # 显式升级到最新版（不等自动更新）
42md upgrade --check    # 只检查不下载

# 帮助
42md --help             # 全局帮助
42md <command> --help   # 子命令帮助

# 工作流 1：会议纪要全链路
42md meeting.mp3                          # 主命令：音频 → Markdown
42md tools lint meeting.md --fix          # tools 加工：版式优化
42md tools md2docx meeting.md             # tools 导出：转 Word 给同事批注

# 工作流 2：博客投稿 + 公众号发布
42md tools improve draft.md --prompt writing_master   # AI 改写
42md tools md2pdf article.md              # PDF 投稿
42md tools md2wechat article.md           # 公众号粘贴版

# 工作流 3：超大 PDF 拆开处理再瘦身
42md tools split big.pdf --every 50 -o parts/   # 文件整理：按页拆成多段
42md parts/*.pdf --ocr                    # 主命令批量 OCR
42md tools compress big.pdf               # 文件整理：发出前先瘦身

# 工作流 4：先查云端知识，再落笔
42md kb search "执行意图" --json                       # 先看库里有没有相关旧卡
42md kb get <卡片id> --type card -o cue.md             # 取一张卡到本地
42md tools improve draft.md --prompt writing_master   # 结合它写稿、AI 润色

# 安装或升级（CLI 自动更新已内置）
curl -fsSL https://42md.cc/mac | bash
irm https://42md.cc/win | iex

# 探索三类命令
42md --help
42md tools list
42md auth status