docs: include JSDoc in website API markers

website/zh-CN/api/harness/web.md

@@ -18,6 +18,13 @@ Selection semantics (resolved at execution time, never order-dependent):
 ### ctx.web.registerSearchProvider(provider)
 
 ```ts website-api
+/**
+ * Register a search provider. Throws {@link WebError} `WEB_DUPLICATE_PROVIDER`
+ * if its id is already registered for search. Returns a disposer; disposed
+ * with the calling fiber.
+ * @param provider - the provider; its `id` is the registry key.
+ * @returns the disposer that unregisters the provider.
+ */
 registerSearchProvider(provider: WebSearchProvider): () => void
 ```
 
@@ -32,6 +39,13 @@ Register a search provider. Throws WebError `WEB_DUPLICATE_PROVIDER` if its id i
 ### ctx.web.registerFetchProvider(provider)
 
 ```ts website-api
+/**
+ * Register a fetch provider. Throws {@link WebError} `WEB_DUPLICATE_PROVIDER`
+ * if its id is already registered for fetch. Returns a disposer; disposed
+ * with the calling fiber.
+ * @param provider - the provider; its `id` is the registry key.
+ * @returns the disposer that unregisters the provider.
+ */
 registerFetchProvider(provider: WebFetchProvider): () => void
 ```
 
@@ -46,6 +60,15 @@ Register a fetch provider. Throws WebError `WEB_DUPLICATE_PROVIDER` if its id is
 ### ctx.web.search(request, signal?)
 
 ```ts website-api
+/**
+ * Run one search through the selected provider. Resolves the provider at call
+ * time with the selection rules above; throws {@link WebError} when the
+ * capability cannot run. The seam enforces `request.maxResults` on the result:
+ * if the provider over-returns, `sources[]` is truncated and `truncated` set.
+ * @param request - the query plus result-shaping options.
+ * @param signal - optional cancellation signal forwarded to the provider.
+ * @returns the provider's results, capped to `request.maxResults`.
+ */
 async search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>
 ```
 
@@ -61,6 +84,14 @@ Run one search through the selected provider. Resolves the provider at call time
 ### ctx.web.fetch(request, signal?)
 
 ```ts website-api
+/**
+ * Retrieve one URL through the selected provider. Resolves the provider at
+ * call time with the selection rules above; throws {@link WebError} when the
+ * capability cannot run. A non-2xx response is a result, not a throw.
+ * @param request - the URL plus retrieval options.
+ * @param signal - optional cancellation signal forwarded to the provider.
+ * @returns the retrieval outcome; non-2xx responses resolve descriptively.
+ */
 async fetch(request: WebFetchRequest, signal?: AbortSignal): Promise<WebFetchResult>
 ```