Qwen 本地编码调度jiafeimao1990/qwen-worker-orchestrator

Qwen Worker Orchestrator

一套面向本地小模型编码 Agent 的独立执行方案：在 DeepSeek Harness 上提供精简的 qwen-worker Profile，并通过 Codex Skill 实现“强模型负责设计与审查，本地 Qwen 负责短步骤执行”。

本项目的 Profile 结构、约束提示词、低频调度策略、日志脚本和验收流程均为我们自主设计与实现。DeepSeek Harness、Qwen、llama.cpp/llama-swap 与 Codex 是外部项目或产品，不属于本仓库原创范围，本仓库也不包含其源码或模型权重。

为什么做这个项目

直接把长任务交给 27B 本地模型时，我们观察到几类常见问题：

- 隐藏思考耗尽输出预算，真正的工具调用反而没有发生；
- 上下文不断膨胀，模型开始重解释需求或扩展无关功能；
- 实时查看执行过程会把大量低价值日志重新带入审查模型的上下文；
- 模型口头声称成功，但代码、失败路径或原子性并未真正满足要求。

qwen-worker 将本地模型限制为一个“有验收标准的实现工人”：任务必须短、边界明确、可独立测试；设计、拆解和最终验收仍由上层 Codex 完成。

核心设计

- 独立 Profile，不修改 DeepSeek Harness 的原版 web/headless Profile 或全局设置；
- 默认关闭隐藏思考，把预算用于工具调用、实现和测试反馈；
- 单工具并发，减少小模型在并行调用中的状态漂移；
- 49,152 token 上下文、4,096 token 输出上限；
- 精简无关工具、子 Agent、联网、计划和遥测组件；
- 验收测试视为不可修改规格，禁止削弱测试、全局 monkeypatch 和测试特判；
- 详细执行输出落盘，调度方只接收启动、结束和退出码；
- 按任务大小设置首次审查窗口，期间不轮询 token 流或半成品。

默认等待策略：

| 任务规模 | 典型范围 | 首次检查 |
| --- | --- | ---: |
| Tiny | 一个局部修改，最多两个聚焦文件 | 90 秒 |
| Small | 一个功能/修复，已有聚焦测试 | 3 分钟 |
| Medium | 数个相关文件或一组新验收测试 | 6 分钟 |
| Large | 预计超过 10 分钟 | 继续拆分，不整块下发 |

若到期仍在运行，只做一次精简状态检查；再经过一个同等窗口仍未完成，才诊断或缩小任务，不无限轮询，也不启动重复 Worker。

仓库结构

profile/qwen-worker/             DeepSeek Harness 独立 Profile
skill/qwen-worker-orchestrator/  Codex 调度 Skill
examples/llama-swap-model.yaml   本地模型服务示例
install.ps1                      Windows 安装脚本

前置条件

- Windows PowerShell 5.1 或 PowerShell 7；
- 已安装并可运行 DeepSeek Harness，命令为 dsh；
- 本地 OpenAI 兼容端点，默认 http://127.0.0.1:1234/v1；
- 端点中存在模型 ID qwen3.8-27b-original；
- 如需 Codex 自动调度，需已安装 Codex。

模型权重不随仓库分发。示例配置基于 Qwen3.8-27B Q6_K、双 GPU Tensor Split、Flash Attention、KV Q8_0 和 MTP=2，可按自己的硬件修改。

安装

在 PowerShell 中运行：

git clone https://github.com/jiafeimao1990/qwen-worker-orchestrator.git
cd qwen-worker-orchestrator
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

安装脚本会：

1. 将 Profile 安装到 %USERPROFILE%\.dsh\profiles\qwen-worker；
2. 自动写入当前用户的 Profile 设置绝对路径；
3. 将 Skill 安装到 %USERPROFILE%\.codex\skills\qwen-worker-orchestrator；
4. 若目标已存在，先保存带时间戳的备份。

它不会安装模型、修改原版 Profile、改变全局默认模型或重启电脑。

单独使用 Profile

$env:QWEN_WORKER_API_KEY = "local"
$env:DSH_PERMISSION_MODE = "workspace-write"
cd D:\your-project
dsh --profile qwen-worker "实现一个边界明确且有测试的步骤"

可先检查最终合成配置：

dsh --profile qwen-worker --dump-config

使用调度 Skill

Skill 会在适合的编码任务中自动被 Codex 发现，也可明确要求使用 $qwen-worker-orchestrator。它会要求 Codex：

1. 先设计任务并给出不可变的验收条件；
2. 每次只下发一个边界清晰的实现步骤；
3. 静默等待预设窗口，不读取实时 token 流；
4. 完成后检查真实 diff，并独立运行测试；
5. 失败时只发送具体失败证据，不重发整个聊天历史。

本机验证结果

在原版 Qwen3.8-27B Q6_K 上完成一个三阶段任务队列实验：

- 三个实现阶段均在首次执行后通过；
- 单阶段约 46–53 秒；
- 最终 14/14 项独立验收测试通过；
- 最终上下文约 13.4K / 49K；
- 未出现修改验收测试、全局 monkeypatch、虚假原子写入或无关功能扩展。

旧的通用 headless 实验曾增长到约 47K 上下文，并需要多轮纠正。该对比同时改变了模型版本与执行 Profile，因此不能将全部提升只归因于 Profile；仓库只陈述实际测得的组合结果。

原创与依赖声明

本仓库原创内容：

- qwen-worker Profile 的裁剪与参数组合；
- Worker 约束提示词与验收策略；
- Codex 调度 Skill；
- 任务分级、低频等待与停止规则；
- 紧凑日志和状态检查脚本；
- 安装脚本与本文档。
外部依赖保留各自名称、商标与许可证。使用前请分别遵守 DeepSeek Harness、Qwen、Codex、llama.cpp/llama-swap 以及所选模型权重的许可条款。

License

本仓库原创代码与文档采用 MIT License。第三方依赖不因本许可证而重新授权。