zai-org / zai-org/feedback

Feature request: 截图工具返回本地文件路径(当前 URL 本机不可下载)

Open
#544 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

使用场景

智能体会话中截图后需要把图当文件用(保存 PR 演示图、交给本地工具处理),而不只是给视觉模型看。

现状问题

computer-use 的 screenshot / zoom 返回对象存储签名 URL(ufileos.com),该 URL 只能被云端视觉服务端拉取,本机下载被签名校验拒绝(curl 直连报 invalid publickey、走代理 403)——结果是"模型在上下文里看得到图,本地却拿不到字节"。

实际可行的两条取图路都是非正式的:

  1. screencapture——需要用户已授予屏幕录制权限并重启进程(生效条件无提示,靠踩坑发现);
  2. 会话工件目录 ~/.zcode/cli/artifacts/<session>/call_*-media-*.txt 的 base64 落盘——无任何文档,靠考古内部机制发现。

请求

截图类工具在返回 URL 的同时返回本地文件路径(内部已有落盘,只差暴露);或让返回的 URL 可稳定下载。若 artifacts 目录属正式机制,请在文档中说明。

环境

  • ZCode 3.11.2(macOS),computer-use 插件 0.5.14
  • 实证于 2026-09-05/06:多轮 curl 直连/代理下载测试

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the computer-use screenshot and zoom tool responses, then inspect the existing artifacts under ~/.zcode/cli/artifacts//call_-media-.txt. Confirm how the internally persisted image bytes are exposed and whether the intended result is a local path, a reliably downloadable URL, or documented artifact access; done means the chosen interface works for local tools without relying on undocumented behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos
Domain
desktop, tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.