Skip to content

feat(web-shell): Add standalone chats #10514

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
doudouOUC merged 13 commits into from
Sep 1, 2026
Merged

feat(web-shell): Add standalone chats #10514

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
df9ec83
docs(plans): Add standalone PR6 WebShell UI plan
doudouOUC Aug 29, 2026
0779a40
docs(plans): Address PR6 plan review feedback
doudouOUC Aug 30, 2026
afd5c74
docs(plans): Address second round of PR6 plan review
doudouOUC Aug 30, 2026
7fa7076
docs(plans): Address third round of PR6 plan review
doudouOUC Aug 30, 2026
aeb1715
docs(plans): Address archived-summary, composer-isolation, and split-…
doudouOUC Aug 30, 2026
b538722
docs(plans): Close remaining context-isolation paths in PR6 plan
doudouOUC Aug 30, 2026
3a2057c
docs(plans): Close transcript-branching and legacy dialog ingress gaps
doudouOUC Aug 30, 2026
31cf609
docs(plans): Gate the workspace Web Terminal in non-workspace contexts
doudouOUC Aug 30, 2026
ea3db98
feat(web-shell): add standalone chats
doudouOUC Aug 30, 2026
1ca1cca
fix(web-shell): address PR review feedback (#10514)
doudouOUC Aug 31, 2026
8165107
fix(web-shell): address PR review feedback (#10514)
doudouOUC Aug 31, 2026
9b4cd0a
fix(web-shell): address PR review feedback (#10514)
doudouOUC Aug 31, 2026
bdfffc2
fix(web-shell): address PR review feedback (#10514)
doudouOUC Sep 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
615 changes: 615 additions & 0 deletions docs/plans/2026-08-29-standalone-pr6-webshell-ui.md
View file
Open in desktop

Large diffs are not rendered by default.

42 changes: 22 additions & 20 deletions packages/web-shell/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -134,8 +134,9 @@ export function QwenCodePanel() {
baseUrl="http://127.0.0.1:4170"
token="your-bearer-token"
sessionId="838e1811-9f84-4848-9915-d9a7f01ff5c6"
onSessionIdChange={(sessionId) => {
console.log('current session:', sessionId);
sessionContext={{ kind: 'standalone' }}
onSessionIdChange={(sessionId, _workspaceId, _workspaceCwd, context) => {
console.log('current session:', sessionId, context);
}}
onSessionCreated={async (sessionId) => {
await registerSession(sessionId);
Expand Down Expand Up @@ -212,27 +213,28 @@ const projection = projectChatRecordsToDaemonTranscript(records);

包含 `WebShell` 的所有 Props，加上 Provider 配置：

| 属性 | 类型 | 说明 |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------------- |
| `baseUrl` | `string` | daemon API 地址，未传时使用 `window.location.origin` |
| `token` | `string` | daemon API Bearer token |
| `sessionId` | `string` | 要连接的 session id；未传或 `undefined` 时保持空页面 |
| `workspaceId` | `string` | 已注册工作区 id，主要用于定位已有 session；不会注册或锁定工作区 |
| `workspaceCwd` | `string` | 已注册工作区路径，语义同 `workspaceId`；不会注册或锁定工作区，且优先于 `workspaceId` |
| `lockWorkspaceCwd` | `string` | 锁定到指定工作区路径；未注册时自动持久注册，并隐藏其他工作区及添加、移除和选择入口 |
| `restartSseOnPrompt` | `boolean` | 每次 prompt 被 daemon 接收后重建存活 SSE 流；流断开时提交 prompt 总会立即重建（与此开关无关）；默认关闭 |
| 属性 | 类型 | 说明 |
| -------------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------- |
| `baseUrl` | `string` | daemon API 地址，未传时使用 `window.location.origin` |
| `token` | `string` | daemon API Bearer token |
| `sessionId` | `string` | 要连接的 session id；未传或 `undefined` 时保持空页面 |
| `workspaceId` | `string` | 已注册工作区 id，主要用于定位已有 session；不会注册或锁定工作区 |
| `workspaceCwd` | `string` | 已注册工作区路径，语义同 `workspaceId`；不会注册或锁定工作区，且优先于 `workspaceId` |
| `sessionContext` | `DaemonProductSessionContext` | 显式产品上下文；standalone 或 Live 上下文不能同时传 `workspaceId`、`workspaceCwd` 或 `lockWorkspaceCwd` |
| `lockWorkspaceCwd` | `string` | 锁定到指定工作区路径；未注册时自动持久注册，并隐藏其他工作区及添加、移除和选择入口 |
| `restartSseOnPrompt` | `boolean` | 每次 prompt 被 daemon 接收后重建存活 SSE 流；流断开时提交 prompt 总会立即重建（与此开关无关）；默认关闭 |

### WebShell

| 属性 | 类型 | 说明 |
| ------------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `onSessionIdChange` | `(sessionId: string \| undefined, workspaceId?: string, workspaceCwd?: string) => void` | 当前 session 或工作区变化时触发 |
| `onSessionCreated` | `(sessionId: string) => Promise<void> \| void` | 新 session 创建后触发；完成前会阻塞 session 初始化和 prompt 提交，最长等待 30 秒 |
| `theme` | `'dark' \| 'light'` | UI 主题，默认 `dark` |
| `onThemeChange` | `(theme: WebShellTheme) => void` | `/theme` 命令切换主题后触发 |
| `language` | `'en' \| 'zh-CN' \| 'zh' \| 'zh-cn'` | UI 语言 |
| `onLanguageChange` | `(language: WebShellLanguage) => void` | `/language ui` 切换 UI 语言后触发 |
| `onSlashCommand` | `(command: WebShellSlashCommand) => boolean \| void` | 斜杠命令进入默认处理前触发；返回 `true` 时由宿主接管并跳过默认行为 |
| 属性 | 类型 | 说明 |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `onSessionIdChange` | `(sessionId: string \| undefined, workspaceId?: string, workspaceCwd?: string, sessionContext?: DaemonProductSessionContext) => void` | 当前 session、工作区或显式产品上下文变化时触发；standalone 和 Live 通过第四个参数上报 |
| `onSessionCreated` | `(sessionId: string) => Promise<void> \| void` | 新 session 创建后触发；完成前会阻塞 session 初始化和 prompt 提交，最长等待 30 秒 |
| `theme` | `'dark' \| 'light'` | UI 主题，默认 `dark` |
| `onThemeChange` | `(theme: WebShellTheme) => void` | `/theme` 命令切换主题后触发 |
| `language` | `'en' \| 'zh-CN' \| 'zh' \| 'zh-cn'` | UI 语言 |
| `onLanguageChange` | `(language: WebShellLanguage) => void` | `/language ui` 切换 UI 语言后触发 |
| `onSlashCommand` | `(command: WebShellSlashCommand) => boolean \| void` | 斜杠命令进入默认处理前触发；返回 `true` 时由宿主接管并跳过默认行为 |

宿主可以监听命令，也可以返回 `true` 接管对应操作：

Expand Down
Loading
Loading