Quantum Programming Guide

Overview

This chapter covers workspace management in the quantum programming module and the flow for entering a code space. It fits these scenarios:

• You are signed in and ready to use quantum-programming features.
• You want to create a new workspace or pick one from the existing list to keep working in.
• You have entered a code space but are not familiar with loading states and error prompts.

Topics: Workspace List, Create Workspace, Rename & Delete, Enter Code Space, Load Failure & Retry.

Page Overview

After signing in, you can enter the workspace page. Its structure is shown below:

Numbers in the figure correspond to:

1. Create workspace entry: open a new, isolated development space.
2. Workspace list item: click to enter the matching code space.
3. Left navigation: switch among workspaces, the algorithm library, and the PDE solver.

Workspace List

The list shows at least:

• Workspace name
• Last edited time
• Created time
• Actions column (···)

Some workspaces carry an “Official” tag to distinguish built-in content from self-created ones. When the list fails to load, an error prompt is displayed directly instead of a blank page.

Create Workspace

Each account can create up to 3 workspaces. After reaching the limit, the creation entry becomes unavailable; delete an existing workspace first and then create a new one.

The creation entry is the Create Workspace button in the top-right corner. Flow:

1. Click the Create Workspace button.
2. A dialog for entering the name pops up.
3. Enter the workspace name and click Create.
4. On success, the page shows a success prompt.
5. On failure, the page shows an error prompt.

Naming tips:

• Reflect the purpose directly, for example the project name, experiment topic, or task stage.
• Avoid overly generic names so you can identify items quickly in the list later.

Rename & Delete

Each workspace has an action-menu entry (··· button) on the right. Hover on the button to expand the menu:

Numbers in the figure correspond to:

1. Action menu: supports renaming and deleting the current workspace.

• Rename: Opens an input dialog; type the new name and click Save to finish.
• Delete: Deletes the current workspace; a confirmation dialog pops up before the action is executed.

A deleted workspace cannot be restored. Proceed with caution.

Enter Code Space

Click an item in the workspace list to enter the code space page of that workspace. For advanced development features of the code space and AI-assisted programming, see the Code Space Guide.

Numbers in the figure correspond to:

1. Top return area: go back to the workspace list and confirm the current workspace name.
2. Main editing area: shows the full cloud IDE environment after loading completes.

The top of the code space page usually shows:

• Back button
• Current workspace name

If the workspace can start normally, the main area loads an embedded development environment. On the first visit you typically see a loading state before the workspace content appears.

Loading & Error Handling

The code space page has several common built-in states:

• Loading: The page shows a loading placeholder and a progress bar.
• Timeout: When the workspace address does not load successfully in time, the page indicates a timeout and provides a Retry button.
• No available address: When the current workspace has no available IDE address, the page indicates that no code-space address can be provided.

Suggestions

• Know which workspace to enter: check the name and last edited time first.
• Starting a new task: use the creation entry in the top-right corner directly.
• Your main goal is the cloud IDE: the workspace page is only an entry point; continue with the Code Space Guide after you get in.