Remove embedded docsite, always use live docs.waveterm.dev (#2503)

Removes the embedded Docusaurus build from the application. The help
view now always loads from https://docs.waveterm.dev/ instead of serving
a locally bundled copy. This eliminates package size constraints on
documentation content (e.g., videos) and removes unnecessary
build/packaging overhead.

**Backend changes:**
- Deleted `pkg/docsite` package entirely
- Removed docsite handler from `pkg/web/web.go`
- Simplified `emain/docsite.ts` to return constant URL instead of
probing for embedded docs

**Frontend changes:**
- Removed embedded URL translation logic from `helpview.tsx`
- Homepage URL now uses constant instead of IPC call

**Build configuration:**
- Removed `docsite:build:embedded` task and all references
- Removed `dist/docsite/**/*` from electron-builder asarUnpack
- Removed `build-embedded` script from docs package.json

Net result: -141 lines, +9 lines across 8 files.

<!-- START COPILOT CODING AGENT SUFFIX -->



<details>

<summary>Original prompt</summary>

> right now we build a docusaurus project to run both the online docs at
docs.waveterm.dev AND to embed into the application. but this limits
what we can show in the docs (especially large things like videos etc.)
> 
> the internal docs already fall back to the website when it cannot find
the embedded docs.
> 
> i'd like to update the build and packaging etc to no longer build the
embedded doc site. i'd also like to have the "help" view always render
the live doc site at https://docs.waveterm.dev.


</details>



<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions,
customizing its development environment and configuring Model Context
Protocol (MCP) servers. Learn more [Copilot coding agent
tips](https://gh.io/copilot-coding-agent-tips) in the docs.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: sawka <2722291+sawka@users.noreply.github.com>

Author: Copilot

Taskfile.yml

@@ -23,7 +23,6 @@ tasks:
             - dev
         deps:
             - npm:install
-            - docsite:build:embedded
             - build:backend
         env:
             WAVETERM_ENVFILE: "{{.ROOT_DIR}}/.env"
@@ -37,7 +36,6 @@ tasks:
             - start
         deps:
             - npm:install
-            - docsite:build:embedded
             - build:backend
         env:
             WAVETERM_ENVFILE: "{{.ROOT_DIR}}/.env"
@@ -109,32 +107,13 @@ tasks:
             - docs:npm:install
             - storybook:build
 
-    docsite:build:embedded:
-        desc: Build the embedded docsite and copy it to dist/docsite
-        sources:
-            - "docs/*"
-            - "docs/src/**/*"
-            - "docs/docs/**/*"
-            - "docs/static/**/*"
-        generates:
-            - "dist/docsite/**/*"
-        cmds:
-            - cd docs && npm run build-embedded
-            - task: copyfiles:'docs/build/':'dist/docsite'
-        env:
-            EMBEDDED: "true"
-            USE_SIMPLE_CSS_MINIFIER: "true"
-        deps:
-            - docs:npm:install
-
     package:
         desc: Package the application for the current platform.
         cmds:
             - npm run build:prod && npm exec electron-builder -- -c electron-builder.config.cjs -p never {{.CLI_ARGS}}
         deps:
             - clean
             - npm:install
-            - docsite:build:embedded
             - build:backend
 
     build:frontend:dev:

docs/package.json

@@ -5,7 +5,6 @@
         "docusaurus": "docusaurus",
         "start": "docusaurus start",
         "build": "docusaurus build",
-        "build-embedded": "npm run build",
         "swizzle": "docusaurus swizzle",
         "deploy": "docusaurus deploy",
         "clear": "docusaurus clear",

electron-builder.config.cjs

@@ -36,7 +36,6 @@ const config = {
     },
     asarUnpack: [
         "dist/bin/**/*", // wavesrv and wsh binaries
-        "dist/docsite/**/*", // the static docsite
         "dist/schema/**/*", // schema files for Monaco editor
     ],
     mac: {

emain/docsite.ts

@@ -10,8 +10,6 @@ import * as services from "../frontend/app/store/services";
 import { initElectronWshrpc, shutdownWshrpc } from "../frontend/app/store/wshrpcutil-base";
 import { fireAndForget, sleep } from "../frontend/util/util";
 import { AuthKey, configureAuthKeyRequestInjection } from "./authkey";
-import { initDocsite } from "./docsite";
-import { initIpcHandlers } from "./emain-ipc";
 import {
     getActivityState,
     getForceQuit,
@@ -22,6 +20,7 @@ import {
     setWasActive,
     setWasInFg,
 } from "./emain-activity";
+import { initIpcHandlers } from "./emain-ipc";
 import { log } from "./emain-log";
 import { makeAppMenu, makeDockTaskbar } from "./emain-menu";
 import {
@@ -350,7 +349,6 @@ async function appMain() {
     checkIfRunningUnderARM64Translation(fullConfig);
     ensureHotSpareTab(fullConfig);
     await relaunchBrowserWindows();
-    await initDocsite();
     setTimeout(runActiveTimer, 5000); // start active timer, wait 5s just to be safe
     setTimeout(sendDisplaysTDataEvent, 5000);
 

emain/emain.ts

@@ -14,7 +14,6 @@ contextBridge.exposeInMainWorld("api", {
     getConfigDir: () => ipcRenderer.sendSync("get-config-dir"),
     getHomeDir: () => ipcRenderer.sendSync("get-home-dir"),
     getAboutModalDetails: () => ipcRenderer.sendSync("get-about-modal-details"),
-    getDocsiteUrl: () => ipcRenderer.sendSync("get-docsite-url"),
     getWebviewPreload: () => ipcRenderer.sendSync("get-webview-preload"),
     getZoomFactor: () => ipcRenderer.sendSync("get-zoom-factor"),
     openNewWindow: () => ipcRenderer.send("open-new-window"),

emain/preload.ts

@@ -2,16 +2,13 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import { BlockNodeModel } from "@/app/block/blocktypes";
-import { getApi, globalStore, WOS } from "@/app/store/global";
+import { globalStore, WOS } from "@/app/store/global";
 import { RpcApi } from "@/app/store/wshclientapi";
 import { TabRpcClient } from "@/app/store/wshrpcutil";
 import { WebView, WebViewModel } from "@/app/view/webview/webview";
-import { fireAndForget } from "@/util/util";
-import { atom, useAtomValue } from "jotai";
-import { useCallback } from "react";
+import { atom } from "jotai";
 
-const docsiteWebUrl = "https://docs.waveterm.dev/";
-const baseUrlRegex = /http[s]?:\/\/([^:\/])+(:\d+)?/;
+const docsiteUrl = "https://docs.waveterm.dev/?ref=app";
 
 class HelpViewModel extends WebViewModel {
     get viewComponent(): ViewComponent {
@@ -44,24 +41,10 @@ class HelpViewModel extends WebViewModel {
                 },
             ];
         });
-        this.homepageUrl = atom(getApi().getDocsiteUrl());
+        this.homepageUrl = atom(docsiteUrl);
         this.viewType = "help";
         this.viewIcon = atom("circle-question");
         this.viewName = atom("Help");
-
-        /* 
-        Add callback to take the current embedded docsite url and return the equivalent page in the public docsite.
-        The port used by the embedded docsite changes every time the app runs and the current page may be cached from a previous run so we can't trust that it matches the current embedded url.
-        We have a regex at the top of this file that can extract the base part of the url (i.e. http://127.0.0.1:53288). We'll use this regex to strip the base part of the url from both the current
-        page and the embedded docsite url. Because we host the embedded docsite at a subdirectory, we also need to strip that (hence the second replace). Then, we can build the public url from whatever's left.
-        */
-        this.modifyExternalUrl = (url: string) => {
-            const strippedDocsiteUrl = getApi().getDocsiteUrl().replace(baseUrlRegex, "");
-            const strippedCurUrl = url.replace(baseUrlRegex, "").replace(strippedDocsiteUrl, "");
-            const newUrl = docsiteWebUrl + strippedCurUrl;
-            console.log("modify-external-url", url, newUrl);
-            return newUrl;
-        };
     }
 
     setZoomFactor(factor: number | null) {
@@ -141,32 +124,9 @@ class HelpViewModel extends WebViewModel {
 }
 
 function HelpView(props: ViewComponentProps<HelpViewModel>) {
-    const model = props.model;
-    const homepageUrl = useAtomValue(model.homepageUrl);
-
-    // Effect to update the docsite base url when the app restarts, since the webserver port is dynamic
-    const onFailLoad = useCallback(
-        (url: string) =>
-            fireAndForget(async () => {
-                const newDocsiteUrl = getApi().getDocsiteUrl();
-
-                // Correct the homepage URL, if necessary
-                if (newDocsiteUrl !== homepageUrl) {
-                    await model.setHomepageUrl(newDocsiteUrl, "block");
-                }
-
-                // Correct the base URL of the current page, if necessary
-                const newBaseUrl = baseUrlRegex.exec(newDocsiteUrl)?.[0];
-                const curBaseUrl = baseUrlRegex.exec(url)?.[0];
-                if (curBaseUrl && newBaseUrl && curBaseUrl !== newBaseUrl) {
-                    model.loadUrl(url.replace(curBaseUrl, newBaseUrl), "fix-fail-load");
-                }
-            }),
-        [homepageUrl]
-    );
     return (
         <div className="w-full h-full">
-            <WebView {...props} onFailLoad={onFailLoad} />
+            <WebView {...props} />
         </div>
     );
 }

frontend/app/view/helpview/helpview.tsx

@@ -86,7 +86,6 @@ declare global {
         getHomeDir: () => string; // get-home-dir
         getWebviewPreload: () => string; // get-webview-preload
         getAboutModalDetails: () => AboutModalDetails; // get-about-modal-details
-        getDocsiteUrl: () => string; // get-docsite-url
         getZoomFactor: () => number; // get-zoom-factor
         showContextMenu: (workspaceId: string, menu?: ElectronContextMenuItem[]) => void; // contextmenu-show
         onContextMenuClick: (callback: (id: string) => void) => void; // contextmenu-click

frontend/types/custom.d.ts

@@ -22,7 +22,6 @@ import (
 	"github.com/gorilla/mux"
 	"github.com/wavetermdev/waveterm/pkg/aiusechat"
 	"github.com/wavetermdev/waveterm/pkg/authkey"
-	"github.com/wavetermdev/waveterm/pkg/docsite"
 	"github.com/wavetermdev/waveterm/pkg/filestore"
 	"github.com/wavetermdev/waveterm/pkg/panichandler"
 	"github.com/wavetermdev/waveterm/pkg/remote/fileshare"
@@ -443,7 +442,6 @@ func MakeUnixListener() (net.Listener, error) {
 	return rtn, nil
 }
 
-const docsitePrefix = "/docsite/"
 const schemaPrefix = "/schema/"
 
 // blocking
@@ -470,7 +468,6 @@ func RunWebServer(listener net.Listener) {
 	gr.HandleFunc("/api/post-chat-message", WebFnWrap(WebFnOpts{AllowCaching: false}, aiusechat.WaveAIPostMessageHandler))
 
 	// Other routes without timeout
-	gr.PathPrefix(docsitePrefix).Handler(http.StripPrefix(docsitePrefix, docsite.GetDocsiteHandler()))
 	gr.PathPrefix(schemaPrefix).Handler(http.StripPrefix(schemaPrefix, schema.GetSchemaHandler()))
 
 	handler := http.Handler(gr)