# 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`。