deepseek-harness/website/zh-CN/api/harness/workflows.md

<!-- Generated by scripts/gen-website-api.ts — do not edit by hand. Run `pnpm run gen-website-api` to regenerate. -->

# ctx.workflows

`WorkflowService` (abstract seam) — provided by `@deepseek-ai/dsh-workflow`.

Workflow execution seam. Invalid requests throw before publication; a live run is holder-owned, its result never rejects, cancellation and disposal are bounded, and disposal waits for child cleanup within that bound. Lifecycle listener failures are contained, and `workflow/end` fires exactly once as the result settles.

[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/workflow/workflow/src/index.ts#L159)

### ctx.workflows.start(request)

```ts website-api
abstract start(request: WorkflowStartRequest): WorkflowRun
```

Parse and execute a workflow script.

- `request` — the script, its `args`, the parent agent, and an optional cancel signal.

**Returns** the live run; its `result` resolves when the script settles.

[Source](https://github.com/deepseek-harness/deepseek-harness/blob/master/packages/workflow/workflow/src/index.ts#L170)