Marvis 三条读法与按任务速查
不必从头读到尾,先认领一个目的,再按目的选入口。
这本教程的节序是按「认清工具—装好授权—选模式—看清谁在干活—守隐私—怎么验收」编排的,适合顺序读。但多数人打开一本手册时心里只有一个具体问题:能不能用、怎么装、出事了怎么办。这一节把那三个问题各配一条路线,最后给一张按任务查的表。
三条路怎么选
| 你的目的 | 建议路线 | 花的时间 | 读完能做的判断 |
|---|---|---|---|
| 只想把它用起来 | 1.1 → 2.1 → 2.3 → 2.4 | 短 | 能装上、能跑完第一个只读任务 |
| 要判断风险、决定给多少权限 | 1.2 → 3.1 → 3.3 → 10.1 → 10.2 | 中 | 能划出哪些目录不给、哪些任务不走云端 |
| 已经在用,出问题了 | 11.1 → 11.2 → 12.1 | 短 | 能判断失败类型并选对回滚动作 |
三条路不冲突,交叉点在 2.3。那一节同时是「用起来」的起点和「判断风险」的样本——它用一个五文件的小目录,让你在自己机器上看到「它读了什么、什么时候要权限、结果怎么核」。
只想用起来:这条路上读什么
这条路只回答一个问题:怎么在半小时内跑完第一个任务,并且不留下风险。
顺序是这样:
- 1.1 认清它是什么。 至少要知道它和聊天类工具的区别在于能碰你的系统和文件。不理解这一条,后面的「为什么不能直接让它清理 C 盘」就没有依据。
- 2.1 安装并核对。 重点是核对三处:安装包多大、装完占多少、版本号是哪一串。这三处对不上,后面的界面可能和你读到的不一样。
- 2.3 跑第一个只读任务。 自己建一个放三到五个小文件的目录,让它读取、报大小和行数,然后你逐个核对。这一步是整个教程里性价比最高的动作。
- 2.4 确认账号与额度。 知道额度跟着账号走、不跟着设备走,就不会因为换机器而误判「额度丢了」。
这条路上最容易跳过的是第 3 步。跳过它的人通常在第一次让它「整理一下下载文件夹」时才会遇到问题,而那时已经有东西被移动了。
要判断风险:这条路上读什么
这条路回答的是「我能给它多大权限」,答案由三件事共同决定。
第一件是能力的性质。 1.2 把动作分成可逆与不可逆两类:读文件、列目录、报大小是可逆的,删文件、改系统设置、覆盖写入不是。不可逆动作不是不能用,而是必须先看到执行计划再点确认。
第二件是数据去哪里。 3.1 讲清「用哪个模型」和「数据在哪处理」是两条线,不是同一个开关;3.3 给一个能自己动手复现的验证方法——断网之后再试一次本地任务,看它还跑不跑得动。这个验证只能证明「这次没走网络」,证明不了更多,边界在哪一节里写清了。
第三件是目录给不给。 10.1 把隐私设计拆成三层:处理位置、访问范围、授权前提。三层里只有「访问范围」是你能直接设的,10.2 给的是具体做法——把不该被索引的目录排除出去,而不是等它读完再删。
这三件事判断完,你会得到一个很具体的结论:哪几个目录不给,哪类任务强制走本地,哪些动作必须先看计划。
要排查故障:这条路上读什么
故障排查的顺序不该是「从最可能的原因开始猜」,而该是「从最容易验证的一项开始核」。
| 现象 | 先核这一项 | 再读 |
|---|---|---|
| 结果数量对不上 | 文件实际数量与它报的数量,哪个更可信 | 11.1 |
| 结果里有一条明显不符 | 那一条的原文是否真的如它所述 | 11.1 |
| 产物打不开或为空 | 产物路径是否存在、大小是否为零 | 11.2 |
| 任务中途停住、没有结果 | 是否有待确认的授权或执行计划在等你 | 11.2 |
| 上次能用这次不行 | 版本号是否变过、模式是否被切过 | 12.1 |
第 5 行的顺序很重要:先看版本和模式,再谈其他。客户端更新会改界面文案,模式切换会改数据去向,这两项没排除之前,任何结论都可能建在错的前提上。
按任务速查
下表按「你想干的事」索引,只列已经写进本教程的节。跨端远控与远程接管这类依赖手机端联动的操作章节,随后续版本补齐;当前可先读 1.3 的平台矩阵,弄清哪些能力落在哪一端。
| 我想…… | 先读 | 再读 |
|---|---|---|
| 判断这台电脑能不能装、装了有没有用 | 2.2 | 1.1 |
| 装完确认没装错、装坏了好卸 | 2.1 | 12.1 |
| 第一次用它,又怕它动我的文件 | 2.3 | 1.2 |
| 搞清楚「省心组合」和「本地模式」是不是一回事 | 3.1 | 3.2 |
| 证明敏感文件真的没出本机 | 3.3 | 10.3 |
| 不让它读某个目录 | 10.2 | 10.1 |
| 弄明白它派活时我该盯什么 | 4.2 | 4.3 |
| 判断某个任务该不该让它自己拆 | 4.3 | 1.2 |
| 结果不对,想退回上一步 | 11.2 | 11.1 |
| 核对一个数字该不该信 | 11.3 | 12.2 |
注意与相关
Note:这张速查表只覆盖已经成稿的章节。教程按「先写不依赖实机的部分、再补需要实机复现的部分」推进,所以文件检索、批量整理、自动任务、跨端远控这几块暂时没有对应节号,别把「查不到」读成「没有这个功能」。
Tip:如果你只打算读三节,建议是 2.3(第一次只读任务)、10.2(目录划黑)、11.2(失败怎么回滚)。三节分别对应「怎么开始」「怎么防」「怎么退」,读完就能独立用起来。
相关:0.1 这本教程写给谁、不写什么(本书的边界)、0.3 版本基线、证据口径与术语约定(怎么读本书的标注)、1.3 平台×功能×模式该怎么读(能力分布的第一张图)。