Marvis 第一次只读任务与授权
先让它只读、不写,用一个小文件夹试一次,就能看清它读得准不准、什么时候要权限。
Marvis(中文名「马维斯」)与聊天类工具最大的区别,是它能直接操作你这台电脑——读文件、改设置、执行命令。这意味着第一次交给它的任务,不该是「帮我清理 C 盘」,而该是一次只进不出的读取。原因很直接:读取失败你只是拿到一个不准的答案,写入失败可能连原件都没了。
本节用一个 5 个文件的测试目录走完整流程,并给出逐项复核的方法。
前提与适用
| 项 | 要求 | 说明 |
|---|---|---|
| 客户端状态 | 已安装并登录 | 停在欢迎页或登录页无法进入对话 |
| 版本基线 | 客户端 1.60.3400.35 | 界面与文案随版本变化,其他版本以实际界面为准 |
| 测试目录 | 自建空目录,放 3–5 个小文件 | 建在非系统盘(如 D:\marvis-demo),不要用「文档」「桌面」这类真实目录做首次试验 |
| 文件类型 | 建议混放纯文本、Markdown、CSV、无扩展名文件 | 类型越杂,越容易看出它是否真的读了内容 |
| 磁盘状态 | 目录内文件可复制备份 | 万一发生意外写入,还能还原 |
准备测试目录这一步不要省。用一个已知内容的目录,你才能判断它的输出对不对;用真实工作目录,你连「答错了」都发现不了。
怎么做
先声明一件事:下文的描述文字不能当成固定输出。 表格里的每行措辞、归纳方式,来自客户端 1.60.3400.35 上的一次运行;同一条指令再跑一次,表述可能不同。可稳定复核的只有三类:文件数量、字节数、目录是否被改动。把「它这次怎么措辞」当成标准答案,会让你在第二次运行时误判成出错。
第一步:建目录并放入样本文件。
在非系统盘的空白位置新建目录,本节用的是 D:\marvis-demo,放 5 个文件:一份纯文本日志、一份 Markdown、一份 CSV、一份 txt 周报、一个没有扩展名的文件。最后那个文件很关键——它用来检验客户端遇到「认不出类型」的文件时会怎么处理。
目录名建议用纯英文、不含空格。本节第一轮用的是项目目录下的中文路径,指令长度多出二十多个字符,界面里还会折行,复核时容易看错。
第二步:控制目录体积。 样本文件都写成几十到几百字节即可。总量小,它读完全部内容也不会超时,你复核起来也快。本节的实测样本合计 417 字节。
第三步:点一下输入框,再输入指令。 客户端进入首页后输入框不会自动聚焦,直接按 Ctrl+V 是没有反应的,必须先点一下输入框。这是新手最容易误判成「粘贴坏了」的一步。
指令按四要素写,缺一项就容易跑偏:
| 要素 | 本节写法 | 作用 |
|---|---|---|
| 目标 | 这个文件夹的绝对路径 | 不给路径它会自己猜,猜错就白跑 |
| 动作 | 列出名称与类型,说明每个文件做什么用 | 说清要输出什么,而不是「帮我看看」 |
| 范围 | 只读检查 | 界定边界,避免它顺手整理 |
| 禁止项 | 不要修改、移动、重命名或删除 | 显式否掉破坏性动作 |
完整指令如下,可直接替换路径后使用:
只读检查这个文件夹:<你的测试目录绝对路径>。请列出里面每个文件的名称和类型,并说明每个文件大概是做什么用的。只做只读检查,不要修改、移动、重命名或删除任何文件。
第四步:确认发送按钮状态再发出。 输入框为空时右下角发送按钮是灰色,输入内容后转为黑色。看到按钮还是灰的,说明文字没有真正进入输入框。

图 1:指令填入后,右下角发送按钮由灰转黑;输入区不自动聚焦,需先点一下(客户端 1.60.3400.35,Windows 11 26200)
第五步:读结果,先看结构再看数字。 默认返回的是一张表,列为「# / 文件名 / 类型 / 大小 / 内容说明」,每行一个文件,表格上方有一段总体归纳,写清文件总数、总体类型与最后修改时间。

图 2:默认的表格输出。表头为「# / 文件名 / 类型 / 大小 / 内容说明」,最右的内容列超出卡片宽度被截断,需横向拖动才能读全(客户端 1.60.3400.35,Windows 11 26200)
内容列被截断这件事本身值得留意:不拖到底就下结论,很容易把「没显示」当成「没识别出来」。 但表格里的横向滚动条在本版本几乎占满整条轨道,拖动幅度很小,取证时容易反复试错。
更省事的做法是直接要求换一种输出形态。追加一句「改成纯文本列表,每个文件一行,写清文件名、类型、大小、行数、说明」,就能拿到可一次读全的结果:
把上一条结果改成纯文本列表重新输出,每个文件一行,
写清楚:文件名、类型、大小、行数、一句话说明。不要用表格。

图 3:追加一句要求后,同一目录改以纯文本输出,5 个文件、字节数、行数、合计一次读全(客户端 1.60.3400.35,Windows 11 26200)
这不是排版偏好问题。表格适合扫读,纯文本适合逐项核对——验收阶段要的是后者,因为你要拿每一行的数字去和文件本身比对,而不是看整体像不像。
第六步:处理授权提示,不必当场同意。 首轮未授权时,结果下方会出现一张授权卡,原文是:
授权读取本地文件,可搜索文件内容、图片内容、图片文字,获得更全面的结果。相关功能均基于本地模型,在您的设备上运行,更好保障您的个人隐私。
按钮是「去授权」。

图 4:结果下方的授权提示卡与「去授权」按钮,此时任务已出结果(客户端 1.60.3400.35,Windows 11 26200)
这次任务在未授权状态下已经跑完并给出了结果,说明授权卡是能力增强提示,不是本次任务的前置条件。第一次可以先不点,等确认它的输出可信、确实需要检索更大范围时再决定。
Note:同一台设备上第二次执行同类任务时,这张卡没有再出现。是「已授权」还是「本轮未触发」,本节未逐一验证,不做结论。点击「去授权」之后的实际授权范围与界面变化,同样待补。
参数与边界
「只读」是它对你的承诺,不是技术隔离。 指令里写了「不要修改」,实质是让它自己约束自己,客户端并不会因此把写权限摘掉。真正的约束来自你给的路径范围——所以第一条边界是:首次任务只指向自己建的测试目录。
但没有技术隔离,不等于没有保护。 官方文档写明:删除、修改文件与系统核心配置这类操作,会先给出计划、再请求用户确认。于是这里有三层,分工不同,不要混成一句「它很安全」或「它毫无约束」:
| 层 | 由谁执行 | 管什么 | 谁负责 |
|---|---|---|---|
| 自然语言禁止项(「不要删」) | 模型自己遵守 | 它对任务的理解边界 | 你写清楚 |
| L2 确认机制(先计划再确认) | 客户端强制 | 有副作用的动作 | 客户端拦,你负责看清计划再点 |
| 路径范围(只给测试目录) | 你 | 它能触达哪些文件 | 你 |
三层里只有中间那层是软件强制的。指令写得再好,也不能替代你缩小路径范围。
授权卡的措辞值得逐句拆开看。
| 措辞 | 能推出什么 | 不能推出什么 |
|---|---|---|
| 「授权读取本地文件」 | 这是一个读权限,范围是本地文件 | 不包含写权限,也不等于能读整块磁盘 |
| 「可搜索文件内容、图片内容、图片文字」 | 授权后能做的检索类型 | 不代表默认已索引全盘 |
| 「相关功能均基于本地模型,在您的设备上运行」 | 该功能声称在本地推理 | 不能推出「所有数据都不上云」,其余能力仍可能联网 |
第三行是本节最需要留意的边界。「均基于本地模型」限定的是相关功能,不是整款产品。同一句话不能改写成「Marvis 全程离线运行」。
它的数字精确度是分层的,而且跨运行不稳定。 本次运行(纯文本输出)的逐项复核:
| 文件 | 字节(真实 / 报值) | 行数(真实 / 报值) | 判定 |
|---|---|---|---|
| app.log | 101 / 101 B | 3 / 3 | 对 |
| README | 30 / 30 B | 1 / 1 | 对 |
| 会议纪要.md | 82 / 82 B | 4 / 4 | 对 |
| 周报-2026W46.txt | 96 / 96 B | 3 / 3 | 对 |
| 报销明细_11月.csv | 108 / 108 B | 4 / 4(表头 1 + 记录 3) | 对 |
| 合计 | 417 / 417 B | 15 / 15 | 对 |
本次全部正确。但同一份内容在上一轮运行(表格输出)里,app.log 被报成「4 行」,而文件实际是 3 行,多报 1 行。当时那一格被视口截断,只露出半句,单独放大才读得清:

图 5:上一轮运行中 app.log 那一行的局部放大,客户端报「4 行应用运行日志」,文件实际只有 3 行(客户端 1.60.3400.35,Windows 11 26200)
两次运行、同一份内容、两个不同的行数,其中一次是错的。这个对比比任何提醒都直接:字节数与文件数稳定,行数与文字描述不稳定。 复核拿文件本身做基准,不要跨运行复用上一次看到的数字。
这张放大图还给出第二条判据:凡是必须靠放大才能验证的结论,说明这个界面不适合当唯一证据。 复核行数时打开文件本身对照,不要只信表格里的描述。
这个版本做不到的部分。 输入框不自动聚焦;表格需横向滚动才能读全;复制、点赞等消息操作图标只在鼠标悬停时出现,静止截图里看不到;客户端屏蔽了 Ctrl 加减号缩放,不能靠缩小界面看全内容。
验收清单
做完一次只读任务,按下表逐项核对。任一项不通过,先别扩大授权范围。
| 核对项 | 通过标准 | 不合格怎么办 |
|---|---|---|
| 文件数量 | 与目录实际文件数一致 | 少报说明有文件被跳过,先查是否被占用或隐藏 |
| 文件名 | 逐个与目录实际名称一致 | 出现不存在的文件名,说明它在推测而非读取 |
| 字节数 | 抽查 2–3 个与资源管理器一致 | 全部偏差,说明读的是缓存或旧索引 |
| 行数/记录数 | 抽查 1–2 个与文本编辑器一致 | 偏差属常见现象,正文引用具体数字时须自己核 |
| 目录未被改动 | 修改时间、文件数量与操作前一致 | 有任何变化立即从备份还原,并复核指令禁止项 |
| 授权状态 | 未授权时任务仍能完成 | 必须先授权才能跑,说明该任务并非纯读取 |
| 产物位置 | 结果在对话里,未在目录内生成新文件 | 目录内多出文件,说明产生了写入 |
失败与回滚
只读任务失败,多数不是「它不会做」,而是「指令没落地」或「结果读不全」。下表按现象查,先判断卡在哪一环,再决定重试还是换做法。
| 现象 | 原因判据 | 重试 / 撤销 / 恢复 | 手动兜底 |
|---|---|---|---|
| 点过输入框后 Ctrl+V 仍无反应 | 输入框里没有光标、占位提示语还在,说明焦点没进去 | 点在占位文字那一行(输入区上部)再粘贴;点在下方按钮行拿不到焦点 | 直接把指令打字输入;或先点「选择文件」旁的空白再回到输入区 |
| 输入了文字但发送按钮还是灰的 | 文字没有真正进入输入框,粘贴被别处接收 | 清空后重新点输入区再粘贴一次 | 改用逐字键入;确认没有在对话正文里选中文字(选中时 Ctrl+A 会选中整页) |
| 结果里的目录不是给定的那个 | 回答开头的路径与你给的不一致,说明它自己猜了路径 | 重发,把绝对路径放在句中做宾语,并写明「只读检查这个文件夹」 | 用输入框的「选择文件」指定目标,减少路径歧义 |
| 表格内容列读不全、看不出关键数字 | 内容列被卡片边缘截断,横向滚动条几乎不可拖 | 追加一句要求改纯文本列表输出,重跑一次只读 | 打开文件本身逐项核对,把表格只当索引用 |
| 行数/记录数与文件实际不符 | 用文本编辑器数行数对比;注意末行无换行符时计数会差 1 | 再跑一次(本机两次运行结果不同,一次对一次错) | 以文件本身为准;正文引用具体行数时必须自己数 |
| 目录里多出文件、修改时间变了 | 对比操作前的文件清单与时间戳 | 立即从备份还原,并检查指令里是否漏了禁止项 | 用回收站恢复被删文件;确认写权限边界后重试 |
| 授权卡没有出现,或点了「去授权」没反应 | 卡只在未授权时出现在结果下方;已授权后不再弹 | 到「本地资料」里查看授权状态 | 重启客户端后再试;授权范围与后续界面变化本节未验证,属待核项 |
自检题
| 问题 | 参考答案要点 |
|---|---|
| 授权卡出现,说明这个任务被拦住了吗? | 没有。本次任务在未授权状态下已完整返回结果,授权卡是「授权后能检索得更全」的能力增强提示,不是前置条件 |
| 指令里写了「不要修改」,是不是就有了技术隔离? | 不是。那是自然语言约束,靠模型自己遵守。强制保护来自客户端的 L2 确认机制,范围保护来自你只给一个测试目录 |
| 同一目录两次运行,为什么行数会不一样? | 生成有随机性。字节数与文件数稳定,行数与文字描述不稳定;所以复核要用文件本身做基准,不能跨运行复用上一次的数字 |
注意与相关
Note:授权卡出现不等于任务被阻断。本节的只读任务在未授权状态下已完整返回结果,授权卡的作用是提示「授权后能检索得更全」,把它当成必须跨过的门会误导判断。
Warning:不要在真实工作目录上做第一次试验。指令中的「不要修改」是自然语言约束,不是权限隔离;一旦它理解偏了,损失的是你的原件。测试目录里的文件请先复制一份备份。
Tip:想让结果更好复核,可以在指令里直接要求输出纯文本列表而不是表格。表格能横向滚动、内容列容易被截断,纯文本按段落换行,逐项核对更快。
相关章节:2.1 下载与安装、2.2 配置门槛的两处口径、10.1 三层隐私设计的边界、11.2 如何为一个任务写验收判据。

TRAE-AI编程


更多建议: