Punky971210/dsh-punky-swarm

README 摘要

dsh-punky-swarm — 蟛蜞模式（Punky Swarm 集群治理） dsh（DeepSeek Harness） 单机多子 agent 集群治理 插件：wavePlan 三层 DAG（固定语义，建批后不重算）+ 引擎级门禁（Entry / Plan 契约 / Exit / Complete）+ 状态机 + 锁/mailbox + 会话隔离 + 任务难度路由门禁 + 国标 AIP 兼容 + 治理能力增强（心跳/watchdog、worktree 物理隔离、验收证据、mailbox 环防护、诊断桥接、日志导出）。附蟛蜞模式预设与 jiufeng-team 角色指引。 English: README.en.md 边界（Scope） - 目标 ：dsh 单机多子 agent 治理 ——在同一 dsh 进程内治理一批 worker（批次 / 门禁 / 通信 / 恢复重置派发）； - 范围外 ：分布式集群同步、成本控制、模型分层路由；续跑仅提供 checkpoint 保全与恢复审计（失败 lane 仍终态、重做仍开新批次）。 设计目的与由来 目的 ：门禁（Entry/Plan 契约/Exit/Complete）与批次、锁、mailbox 等机制的核心目的，是 保障流水线与集群的稳定运行 ，而非限制 Agent 自由度——工具层对 Agent 全量开放，模式层只给指引，团队装配可插拔；任务按规模分级（Leader 指派 → 单 Agent 降级）。 由来 ：本项目源于单 Agent 全流程与图式编排之间的取舍： - 单 Agent 全流程（设计→执行→测试）：人工介入重，人成为流程瓶颈； - 图式编排（LangGraph 方向）：尝试后放弃——流程写死成图，改动成本高，Agent 自由度被压死； - 折中：按「九峰」工作模式（Leader 拆解 → 多角色协作 → 门禁裁决）在早期 Swarm 集群运行时上落地，随后迁移到 dsh 成为本插件。 三件套 件 位置 内容 插件 packages/dsh-punky-swarm 引擎： 20 治理工具 + Tier3 门禁 + 会话隔离 v2 + 只读 API（含 AIP /tools 端点）+ 任务难度门禁 + 蟛蜞集群监控面板 模式 packages/dsh-punky-swarm/presets/jiufeng 蟛蜞模式预设：Leader persona + 治理纪律 + tool-bootstrap 指引 packages/dsh-punky-swarm/skills/jiufeng-team 3 层 8 角色 × 操作手册装配表 + constitution + 模板 安装 以下指引面向 Agent / 自动化执行，命令可直接运行； web 为示例 profile，可替换。 插件启动时 自动同步 模式预设…

分类