DocsProduct guide产品指南

Review signal in. Source context out.审稿信号进入,源码上下文输出。

A compact guide to the Visual Feedback Studio loop: where feedback is captured, how decisions are made, and what reaches the agent.一份紧凑指南:视觉反馈在哪里被捕捉,决策如何形成,什么内容会交给 agent。

BoundaryVFS is a visual review tool for implemented interfaces, not an automatic taste replacement.VFS 是面向已实现界面的视觉审稿工具,不是自动替代审美判断的工具。
01Overview概览

Visual review for implemented interfaces.面向已实现界面的视觉审稿。

Visual Feedback Studio keeps the page target, reviewer intent, decision state, and source clues in one review object. It is built for the moment when an interface is close, but still needs precise human judgment before an agent edits source.Visual Feedback Studio 把页面目标、审稿意图、裁决状态和源码线索保存在同一个 review object 里。它服务的是界面已经接近正确,但还需要人的精准判断,agent 才能修改源码的时刻。

Core rule:核心规则: feedback does not become implementation context until a human accepts it.反馈只有被人接受后,才会变成实现上下文。
02Quickstart快速开始

Start with one real page and one real decision.从一个真实页面和一个真实决策开始。

01

Open Studio打开 Studio

Start a review round from the hosted workspace when the work needs shared state or team decisions.当工作需要共享状态或团队裁决时,从 hosted workspace 开始一轮审稿。

02

Choose the page选择页面

Use a page that already needs visual judgment: a live route, a preview, or a private interface you can review.选择一个已经需要视觉判断的页面:线上路由、预览页面,或你可以审查的私有界面。

03

Accept the signal接受有效信号

Select the target, name the intent, and keep only the feedback that should reach implementation.选择目标,命名意图,只保留应该进入实现的反馈。

03Review object审稿对象

One object holds what screenshots and chat lose.一个对象保存截图和聊天会丢掉的信息。

Target
The element, region, selector, or screen location where the issue exists.问题所在的元素、区域、选择器或屏幕位置。
Intent
The reviewer’s desired change, written beside the thing being reviewed.审稿人希望发生的改动,和被审对象一起保存。
Decision
Accepted, deferred, rejected, merged, or unresolved before handoff.交接前的接受、暂缓、拒绝、合并或未决状态。
Source clues
Available DOM, selector, copy, style, measurement, and source hints.可用的 DOM、选择器、文案、样式、测量和源码线索。
04Surfaces入口

Three surfaces, one review loop.三个表面,一条审稿闭环。

Local

Free Local

No account. Runs on your machine for solo review and localhost pages.无需账号,跑在本机,适合个人审稿与 localhost 页面。

Browser

Companion浏览器 companion

Captures selection, note, measure, copy, and style intent on the running page.在运行页面上捕捉选择、备注、测量、文案和样式意图。

Hosted

Studio App

Shared rounds, decisions, grouping, reports, and team preview flows.共享轮次、裁决、分组、报告和 Team Preview 流程。

05Handoff交接

Your eyes decide. The agent receives usable context.你的眼睛做判断,agent 拿到可执行上下文。

H

Human

Notices mismatch, names the intended change, resolves conflicts, and accepts what should move forward.发现不协调,命名修改意图,处理冲突,并接受应该进入下一步的反馈。

A

AgentAgent

Receives target context, accepted actions, source clues, and a review trail instead of guessing from a screenshot.接收目标上下文、已接受动作、源码线索和审稿轨迹,而不是从截图里猜。

V

Verify验证

The result returns to the original page so the fix can be checked against the feedback.结果回到原页面,对照原始反馈检查修复是否成立。

06Trust边界

Control what leaves the page.控制什么离开页面。

Free Local keeps the review loop on your machine. Team Preview is for shared review context and accepted decisions. Source code, receiver tokens, local paths, and environment variables should not sync.Free Local 将审稿闭环留在你的机器上。Team Preview 面向共享审稿上下文与已接受决策。源码、receiver token、本地路径和环境变量不应同步。

Important:重要: Visual Feedback Studio captures review intent. It is not the execution gate and does not automatically edit every issue it sees.Visual Feedback Studio 捕捉审稿意图。它不是执行闸门,也不会自动修改它看到的所有问题。
FAQSetup questions接入问题

Short answers before the first round.第一轮之前的短答案。

Does it work with localhost?支持 localhost 吗?
Yes. The local workflow is designed for pages running on your machine or preview server.支持。本地工作流就是为本机页面或预览服务器设计的。
Does VFS edit source code?VFS 会编辑源码吗?
No. It captures review intent. Your agent applies accepted context, and you verify the result.不会。它捕捉审稿意图。你的 agent 应用已接受上下文,然后你验证结果。
What gets sent to the agent?会发送什么给 agent?
Accepted feedback, target context, source clues when available, and the review trail needed for a safer change.已接受反馈、目标上下文、可用源码线索,以及安全修改所需的审稿轨迹。
StartRun a review开始审稿

Open the studio. Run one real review loop.打开 Studio,跑一轮真实审稿。

Start with a page that already needs visual decisions, then hand accepted context to the agent.从一个已经需要视觉判断的页面开始,再把已接受上下文交给 agent。