mirror of
https://github.com/NanmiCoder/claude-code-haha.git
synced 2026-10-10 20:03:13 +08:00
程序员阿江(Relakkes)
6bab6fbe97
Documents the agent writes open in the workspace panel instead of another application, and local images the agent mentions show up in the conversation. Workspace preview - PDF (pdf.js with its own layout and text layer), Word (docx-preview inside a scripts-disabled sandboxed iframe) and Excel (SheetJS; .xlsx, .xlsm, .xls) open in the side panel with zoom and fit, per-file scroll/zoom/sheet memory, and a refresh when the agent rewrites the file. The engines load lazily. - Bytes come from a new GET /api/sessions/:id/workspace/raw route, with an extension allowlist, size caps, the workspace boundary and canonical-path checks. The file endpoint returns metadata and a version for documents. The client fetches with the bearer credential, so it works in Electron, LAN H5 and remote access alike. - Chat links, output cards and the change card open pdf/docx/xlsx in the workspace; documents outside the workdir still go to the system application. - Image viewer with fit, zoom and pan, and "open in system app". Chat images - Markdown images outside the workdir, at ~/, C:\ and file:// paths render, open in the viewer, and offer "open original" (pictures only). - Images returned by tools such as Read appear as thumbnails under the call. Hardening found in review - previewFsUrl escapes each path segment; a double-escaped %2e%2e used to leave /preview-fs/<session>/. - The CORS, API timing and remote-access header decorators set headers in place. Rebuilding the response buffered whole files in memory and dropped Content-Length. - The engine owns the pdf.js worker, so closing one document no longer fails the next open. - Office archives are inflated in steps to check their real sizes, not the sizes they declare. - A viewer that fails to load stays in its panel instead of taking the window down. Adds pdfjs-dist, docx-preview, xlsx (SheetJS 0.20.3 tarball) and fflate as renderer dev dependencies; Vite bundles them. Refs #1397
93 lines
6.2 KiB
Markdown
93 lines
6.2 KiB
Markdown
---
|
|
title: Workspace
|
|
nav_title: Workspace
|
|
description: The right-hand panel — see what changed, review the diff line by line, preview a page in-app.
|
|
order: 2
|
|
---
|
|
|
|
# Workspace
|
|
|
|
The conversation tells you what Claude said. The workspace tells you what it actually changed. It's a panel on the right that you can pull out next to the conversation, so you never have to switch windows.
|
|
|
|
## Opening it
|
|
|
|
Click **Show Workspace** on the right of the tab bar. Click it again to collapse. Drag the panel's left edge to resize.
|
|
|
|
The empty panel offers **Side chat**, **Review**, **Terminal**, **Browser**, and **Files**. Each opens in its own tab. Use the `+` at the top to add more tabs and switch between tools.
|
|
|
|
## Review: choose a comparison
|
|
|
|
|
|
|
|
Open **Review** and use **Comparison** in the toolbar to choose the changes you want to inspect:
|
|
|
|
- **Unstaged / Staged / All uncommitted** — the corresponding changes in the current working directory.
|
|
- **Branch / Compare branch…** — differences against the selected branch.
|
|
- **View commit…** — enter a commit reference to inspect that commit's changes.
|
|
|
|
Use **Toggle file tree** to show the files changed in the selected comparison. Each row includes a status and line counts; select a file to see its diff. The Review screenshots on this page use **View commit…** to inspect the existing `HEAD` commit in read-only mode.
|
|
|
|
If the folder is not a Git repository, the **Review** entry explains why it is unavailable.
|
|
|
|
## Files tabs
|
|
|
|
**Files** is a separate tab for browsing the project directory and previewing individual files. Use its search box to filter file names, or choose **Open file in tab** from a review. Open tabs work like editor tabs: switch between them as needed.
|
|
|
|
Any file can have its path copied, or be pushed back into the composer as context with **Add to chat**.
|
|
|
|
### Previewing PDFs, Word, Excel, and images
|
|
|
|
Reports, papers, and spreadsheets Claude produces no longer need another app to read. Select one in a Files tab, or click a link or file card that points at it in the conversation, and it opens right in the workspace:
|
|
|
|
- **PDF** — scrolls continuously and zooms, with selectable text. It opens fitted to the panel width.
|
|
- **Word (`.docx`)** — shows the text and basic layout. Equations and some shapes do not appear, and a note above the preview says so; when you need the exact layout, use **Open in system app** to open the original.
|
|
- **Excel (`.xlsx`, `.xlsm`, `.xls`)** — one tab per worksheet, with each cell shown as Excel formats it. Charts, images, and formulas are not shown. A sheet shows at most its first 5,000 rows and 100 columns, and says so when it is cut off.
|
|
- **Images** — fitted to the window, with zoom and drag. Hold `⌘` / `Ctrl` and scroll, or pinch on a trackpad, to zoom; double-click to switch between **Fit to window** and 100%.
|
|
|
|
**Open in system app** at the top of the preview hands the original file to your system's default program. Files that are too large (PDFs over 100 MB, Word or Excel over 30 MB) and password-protected PDFs are not previewed; open them with the system app the same way. So are documents outside the workspace.
|
|
|
|
When Claude rewrites a file you are previewing, the preview refreshes in place. If the file is caught half-written and cannot be read, the last good version stays on screen with a note that the refresh failed.
|
|
|
|
## Diff review: leaving a note on a line
|
|
|
|
|
|
|
|
The diff keeps old and new lines with syntax highlighting. The toolbar lets you switch between **Unified diff** and **Split diff** and enable word wrap. When you finish a file, use **Mark as viewed**. To leave feedback, use line-level comments:
|
|
|
|
1. Click a line — a comment box opens beside it.
|
|
2. To comment on a range, hold `Shift` and click the first and last line. The selection must stay on one side of the diff and inside one hunk.
|
|
3. Describe what you want changed there and click **Submit**.
|
|
4. The comment goes back into the composer along with the file path, line numbers, and the code itself, ready to send.
|
|
|
|
This is far more precise than describing "the null check in that one function" in prose.
|
|
|
|
If Claude changes the file while you're writing a comment, the panel tells you the diff has updated and asks you to reselect — that's there to stop a comment from landing on the wrong lines.
|
|
|
|
:::tip
|
|
Denied tool calls never reach disk, so they do not create file changes to review. Even so, give `git diff` one last read before you ship.
|
|
:::
|
|
|
|
## Isolated worktree: keeping experiments caged
|
|
|
|
The **Location** control in the composer offers **Isolated worktree**. Turn it on and the session gets its own Git worktree; everything Claude does happens there, and your current branch and working directory are untouched.
|
|
|
|
When it earns its keep:
|
|
|
|
- You want Claude to attempt a big rewrite you may not keep.
|
|
- Your working directory has uncommitted changes, so Git would block a branch switch.
|
|
- The branch you want is already checked out in another worktree.
|
|
|
|
The temporary worktree is cleaned up when you're done. History stays readable, but to continue you'll need a new session in the original project — the app tells you when that's the case.
|
|
|
|
## Built-in browser
|
|
|
|
|
|
|
|
Open a **Browser** tab from the empty workspace panel or the `+` menu at the top, then type a local dev address or any URL. It stays in its own tab alongside **Files** and **Review**. Three buttons here exist specifically so Claude can see what you see:
|
|
|
|
- **Capture** — send the current rendering back into the conversation.
|
|
- **Pick element** — click an element on the page; its selector, position, and a screenshot go to Claude as context. This saves an enormous amount of back-and-forth on styling.
|
|
- **Zoom** — change the preview scale to check responsive layouts.
|
|
|
|
Logins and cookies in this browser are real, same as any browser. Before you demo or screenshot anything publicly, switch to a page that doesn't require signing in.
|