Feature request: 截图工具返回本地文件路径(当前 URL 本机不可下载)
Nobody has claimed this yet.
- 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)——结果是"模型在上下文里看得到图,本地却拿不到字节"。
实际可行的两条取图路都是非正式的:
screencapture——需要用户已授予屏幕录制权限并重启进程(生效条件无提示,靠踩坑发现);- 会话工件目录
~/.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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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