不写安装器:点一下就往对话里塞 152 个字符
先说结论。Mac 上检测到缺 dsh 时,设置页那个「让 Andee 帮我安装」按钮里没有安装逻辑。它把一句用户口吻的话塞进对话,当作你亲口说的,剩下交给已有的两套东西:五档风险分类器,和四种命令模式。这个改动一共 32 行,动了 6 个文件,其中一半是文案和测试。
Andee 这个 agent 有两种住处。在 Android 手机上,他靠无障碍服务读屏、自己点,不需要 App 给他开接口;在 Mac 上,他换成用命令行干活。这次动的是 Mac 那一侧。
为什么不写安装函数
安装是个有分支的动作。缺 node 一个分支,缺写权限一个分支,域名不通一个分支,装完要填密钥又是一个分支。写成函数,每个分支都得在界面上有个说法,而我没有穷举完这些分支,硬写出来只会是一个永远差一条的向导。
改成一句话之后,这些分支不用我画。他会照常调命令,失败信息原样回来,然后按那句话里的要求停下来告诉我缺什么。
原话 152 个字符,65 个字,英文版 65 个词。三段:怎么装,装完把网页打开让你填密钥,出问题先报缺什么。
这句话怎么变成一次普通回合
按钮那一侧只有一个回调。SettingsScreen 多了一个 onAskAndee,点下去把字符串抛给 App 层,App 层做两件事:切到对话页,然后 Assistant.say(words)。
say 是用户说话的入口,不是内部调用。这意味着这一轮带着「主人开口」的信任等级进来,跟你在输入框打字完全同一条路。它同时继承了这条路的副作用:新请求进来会先掐掉正在跑的那一轮。
风险判定发生在 run_command 里,跑之前。
RiskClassifier 把命令行按段切开,五档取最高。只读的第一档只放真正只读的命令,ls、cat、git status 这些;写文件至少是低档;改动这台机器以外的任何东西(push、publish、POST)至少是中档。
npm install -g 命中这条:
css
\b(npm|pnpm|yarn)\s+(install|add|i)\s+-g\b
中档。dsh web 不在只读名单里,判为低档,测试里写成 tier("dsh web") > Tier.SAFE,因为这个命令要开一个网页服务,不是看看而已。
谁来决定弹不弹卡
ShellPolicy.decide 的判定顺序是先看这一轮的来源,再看模式,最后看档位。
来源在最前面:通知触发的回合一条命令都不许跑,待办自动跑起来的回合只许只读,都跟模式无关。只有你亲手发起的那一轮,模式才有发言权。
模式四选一。只读拒掉一切非只读。自动放行中档及以下,高档和最高档照样要问。完全开放不进沙箱也不问,除最高档要二次确认。剩下的是「问我」:每条非只读都弹卡,卡上可以勾「总是允许」,记住的是 npm install 这个前缀,不是整条命令。
所以同一句话,四种模式下有四种命运。这不是分支写多了,是按钮刻意不承诺自带确认卡,把决定权留在你已经设好的那一处。
沙箱决定这次安装能不能成
命令默认在沙箱里跑。写权限是白名单:工作文件夹、几个工具缓存、临时目录,别处一律拒绝。可写缓存里有 ~/.nvm,没有 /opt/homebrew,也没有 /usr/local。
这是这次改动最不体面的地方。npm 全局安装要写全局目录,目录落在哪儿取决于你的 node 是怎么装的。nvm 装的写在可写区,能过;Homebrew 装的会撞在写权限上,然后他会按那句话停下来告诉你缺什么。这条我只从白名单推的,没有在 Homebrew 的机器上跑过一遍,不敢当成结论。
出网也一样绕。沙箱只许连本机,命令靠 HTTP_PROXY 找到 Andee 自己的代理。代理默认放行 30 个域名,registry.npmjs.org、registry.npmmirror.com、pypi.org 都在里面,装包不需要额外点一次允许;不认识的域名才弹卡,一次问一个。
另外两条护栏顺手记下:run_command 必须带 why,一句给用户看的话,缺了直接抛错;命令里出现保险箱中任何密钥的值就拒绝执行,防止 key 进进程列表。
三条断言钉住的是什么
新增的测试只做一件事:确认这句话的风险分类不会漂。
less
assertEquals(Tier.MEDIUM, tier("npm install -g @deepseek-ai/dsh"))
assertEquals(Tier.MEDIUM, tier("npm i -g @deepseek-ai/dsh"))
assertTrue(tier("dsh web") > Tier.SAFE)
钉分类而不钉界面,原因是按钮的全部承诺都挂在档位上。某天有人把 npm install -g 挪到高档,「自动」模式下就会突然弹卡,而按钮的文案还写着替你装。测试红在这三条上,比红在一张截图上早得多。
代价
自动和完全开放两种模式下,这次安装没有任何人看一眼。设计如此,但说清楚比较好:按钮不承诺有确认卡,你选了自动,中档以下就是自己发生。
点按钮会打断正在跑的回合。它跟打字同一条路,不是后台排队。
node 本身没装的人,这条路还是走不通。那句话只让它报缺什么,没让它去装 node。
最后一个是我自己的麻烦:一句话没法写进度条。以前装东西失败,用户看到的是「第 3 步失败」;现在他看到的是对话里一段命令输出。读得懂的人觉得清楚,读不懂的人只会觉得怎么突然冒出一堆英文。
所以我留的默认是「问我」。点一次,看清那行命令,点允许。装完他去开网页,我填密钥,回来一句话收尾。