在本地使用 VizChat
云端环境里做不了的事——没装的库、长任务、需要 shell 或 Node.js、要读你电脑上的文件——可以在自己的电脑上对着同一个工作区完成，再把结果同步回去。
网页端的 VizChat 助手，以及在其它聊天应用里使用的 VizChat，都运行在刻意收紧的云端环境里：代码在沙箱里执行，只有 Python 标准库与 numpy、pandas；没有 shell、没有 Node.js，代码不能联网，不能访问你的电脑或公司内网，每次执行最多 20 秒。
这些限制说的是工作在哪里执行，不是 VizChat 能做什么。你的工作区可以作为一个普通文件夹放在自己的电脑上，在那里本地工具——以及装了 VizChat 插件的本地编程 agent——拥有完整的环境。在本地产出的任何东西都会同步回同一个工作区，网页上的 board 立刻就能用。
助手撞上这些限制时会直接告诉你，并指向这一页；下面的做法取决于你已经有什么。
如果你在用本地编程 agent
在你电脑上运行的编程 agent（Claude Code、Codex 等）可以通过 VizChat 插件使用 VizChat，插件里带着 VizChat 的 skill 与云端连接。
-
安装命令行（需要 Node.js）：
npm install -g vizchat vizchat auth loginauth login会打开一个浏览器页面，在上面批准登录。 -
在 agent 的插件目录里安装 VizChat 插件，按提示连接你的 VizChat 账号。
-
把工作区拉到一个文件夹：
vizchat workspace ls vizchat workspace clone <工作区> my-workspace cd my-workspaceworkspace ls列出你可以同步的工作区。目标文件夹必须为空或尚不存在。 -
在这个文件夹里让 agent 干活——它有你的 shell、完整的 Python 与 Node.js，需要什么库就能装什么。
-
把结果同步回去：
vizchat workspace sync改用
vizchat workspace sync --watch可以在工作期间一直保持同步。
如果你装了桌面客户端
桌面客户端会把工作区与你电脑上的一个文件夹保持同步。在客户端的聊天面板里选一个本地 agent（Claude Code、Codex 或内置的 Pi）就能在那个文件夹里干活；也可以在终端里打开它运行任务。你存进文件夹的东西会在后台同步上去。
如果两者都没有
先安装 Node.js，再照「如果你在用本地编程 agent」的步骤做。插件是可选的：没有 agent 也可以 clone 工作区、在文件夹里跑自己的脚本、再把结果同步回去。
让结果回到 board 里
在本地产出的文件——清洗好的数据、图表图片、生成的报告——同步之后就是工作区里的普通文档。像引用上传的文件一样在 board 里引用它们，接着在网页上继续，或让助手在它们的基础上继续做。本地与云端是同一个工作区，不需要手动上传。
完整命令见本地工作区命令行。