alib8b8/dsh-plugin-aflare
aflare workflow tools for DeepSeek Harness (DSH): generate, validate, run local-first deterministic workflows
已收录
0
Workflow
Bundle 已验证
预览
功能介绍
aflare 工作流工具：通过本地 aflare 二进制生成、校验并执行本地优先的确定性 YAML 工作流 DAG（WAL 崩溃恢复、Saga 补偿），内置 300+ 模板。
适合
- 适合希望 DSH 代理在本地生成、校验并执行确定性 YAML 工作流 DAG 的用户。
- 适合需要 aflare WAL 崩溃恢复、Saga 补偿和内置模板目录的自动化工作流。
- 适合要求以 argv 调用本地进程而非通过 shell 执行工作流的环境。
不适合
- 不适合无法安装本地 `aflare` 二进制文件或无法通过 `AFLARE_BIN` 指定它的环境。
- 不适合需要返回超过 256 KB 输出的工作流，因为插件会在该上限截断输出。
- 不适合寻找托管或远程工作流服务的用户；这些工具会启动本地二进制程序。
README
@alib8b8/dsh-plugin-aflare
DeepSeek Harness (DSH) Cordis plugin that exposes aflare workflow tools as native DSH tools.
Every tool spawns the local aflare binary with execFile (no shell), so
nothing leaves your machine — the same local-first guarantee aflare itself
makes.
Tools
| Tool | What it does |
|---|---|
aflare_version |
Installed aflare version |
aflare_generate |
Create workflow YAML from a description (optional ai: true for LLM generation) |
aflare_validate |
Validate a workflow YAML |
aflare_run |
Execute a workflow YAML and return the output |
aflare_template_list |
List built-in templates |
aflare_template_run |
Run a template by ID |
Install
Prerequisite: the aflare binary
The plugin drives the local aflare CLI, so install it first (one line; see
the aflare README for Windows/source
options):
curl -fsSL https://raw.githubusercontent.com/alib8b8/aflare/main/install.sh | bash
aflare version # sanity check
One-line install into DSH
dsh plugin --profile web add @alib8b8/dsh-plugin-aflare
Published on npm (@alib8b8/dsh-plugin-aflare);
the github:alib8b8/dsh-plugin-aflare spec works too.
The package declares its bundle patch (dsh.bundle.patch in package.json),
so DSH registers the plugin entry automatically — restart dsh web and the
aflare_* tools are live. No profile editing needed.
From a local checkout
git clone https://github.com/alib8b8/dsh-plugin-aflare
cd dsh-plugin-aflare
npm install && npm run build
dsh plugin --profile web add "$PWD"
This repository is the distribution mirror of
aflare/integrations/dsh-plugin; development happens in the aflare monorepo.
Or register the built entry manually with a cordis.yml patch overlay
(absolute path required):
- insert:
- id: aflare-tools
name: /absolute/path/to/aflare/integrations/dsh-plugin/dist/index.js
Start DSH with the overlay:
pnpm dsh web --patch ./aflare-patch.yml
Configuration
| Env var | Default | Description |
|---|---|---|
AFLARE_BIN |
aflare |
Path to the aflare executable |
AFLARE_TIMEOUT_MS |
300000 |
Per-invocation timeout (ms) |
Security
- All invocations use
execFile— arguments are passed as argv, never through a shell, so tool parameters cannot inject commands. - Output is truncated at 256 KB to protect model context.
- aflare’s own protections (path validation, safe mode, policy engine) apply
to every run. Set
AFLARE_SAFE_MODE=1in the DSH process environment for untrusted workflows.
Development
npm install
npm run typecheck # strict TS check
npm test # compiles, then runs integration tests via node --test
The tests execute the real aflare binary, resolved from AFLARE_BIN or
the repo-root build output (make build in the repository root). Without a
binary, the registration checks still run and the binary tests skip.
License
AGPL-3.0-or-later (same as the aflare project).
常见问题常见问题
在启用了 DSH 的终端中执行已验证命令 dsh plugin --profile default add github:alib8b8/dsh-plugin-aflare。命令会解析公开 package 元数据，并保持插件与本页展示的目录身份一致。
兼容性以页面上展示的 bundle 与 profile 状态为准。如果某个 profile 尚未检测到，请先保持禁用，并在生产启用前阅读仓库文档。
GitHub 链接和 activity 元数据是 release 与维护状态的来源。新版本发布后重新查看本页，确认目录已经观察到最新版本。