# Myagents Anydoc
> 当用户要读取、解析、提取或转换本地 Office、PDF、扫描件、图片、OpenDocument、RTF、EPUB 或 CSV，尤其需要离线 OCR、文档转 Markdown、处理加密文档或追踪转换任务时使用。通过 MyAgents 内置 `myagents anydoc` CLI 提交和管理本地异步转换；不用于 URL 抓取、目录批量处理、云 OCR、GPT/VLM 识别或文档索引。
- Skill: `hacklyc/myagents-anydoc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hacklyc/myagents-anydoc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hacklyc/myagents-anydoc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: hAcKlyc (https://skillmd.com/u/hacklyc)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/hacklyc/myagents-anydoc
---
# myagents-anydoc — 本地文档转 Markdown
这是 MyAgents 随 App 发布的全离线文档转换能力。底层任务由 Desktop App 持有；CLI 退出、当前会话结束或切换 Runtime 都不会转移任务 owner。
## 使用顺序
1. 先运行 `myagents anydoc --help` 选择命令。
2. 调用前读取 exact leaf help，例如 `myagents anydoc convert --help`；参数和格式支持以当前安装版本的 help 为准，不凭记忆补参数。
3. 需要机器读取结果时加 `--json`。不要为这个命令组添加 `--dry-run`。
## 核心命令
```bash
myagents anydoc convert --file [--output ] [--password ] [--wait] [--json]
myagents anydoc status [--json]
myagents anydoc wait [--json]
myagents anydoc cancel [--json]
myagents anydoc list [--limit <1..100>] [--json]
```
`convert` 每次只接收一个本地文件。`--output` 始终是输出根目录，不是 `document.md` 的文件地址；省略时使用当前 Workspace 的默认转换目录。没有可确认 Workspace 时，按错误提示显式传目录。
所有转换都是异步 job。默认提交后立即返回；只有用户或后续工作必须拿到结果时才用 `--wait` 或独立 `wait`。Ctrl-C 只停止本次等待，不会取消 App 持有的 job；要真正停止处理必须显式调用 `cancel`。
成功产物位于 `//document.md`，并可能包含被 Markdown 相对引用的 `assets/`。后续读取时使用返回的实际 `documentPath`，不要猜 job 目录。
## 安全与边界
- 只传本地普通文件；不传 URL、目录、stdin、glob 或特殊设备。
- 密码只在用户明确提供时通过 `--password` 传入；不要在回复、日志或恢复命令中复述真实密码。
- 不需要 GPT、API key、Hugging Face token、系统 Python/Node、Docker、GPU 或运行时联网。
- 遇到失败，保留 `code`、`suggestion` 和 recovery command；按提示继续，不把 partial 目录当作成功产物。
- 需要网页抓取、批量目录摄取、知识库索引或生成式视觉理解时，选择对应工具；AnyDoc 不承担这些能力。
## 常见流程
立即提交，让 Agent 稍后查询：
```bash
myagents anydoc convert --file ./proposal.docx --json
myagents anydoc status --json
```
当前工作必须等待结果：
```bash
myagents anydoc convert --file ./scan.pdf --output ./converted --wait --json
```
恢复一个遗忘的任务 ID：
```bash
myagents anydoc list --limit 20 --json
```
任何不确定项都回到 exact help：`myagents anydoc --help`。