mstar-harness
btspoony/mstar-harness
技能驱动的 harness/loop 工程化工作流插件。
安装
把 mstar-harness 装进 DeepSeek Harness
GitHub 方式 · GitHub 源码
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 2 天前.
安装前须知
装 mstar-harness 之前,先看这几条
- 源码在这里: btspoony/mstar-harness——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
- 自动识别到:安装脚本、终端执行。授权之前请先读一遍源码。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — Morning Star Harness 是一个 TypeScript Harness Workflow Engine 的 Agent Plugin,提供 deterministic workflow gates 和 mstar-* judgment skills。
谁该装 — 当需要在 DeepSeek Harness 下执行 iteration 或 codebase audit,进行 multi-agent code delivery 时,它适合使用。 如果任务不需要 judgment skills 驱动的 engineering workflow,不必安装。
注意 — 从源码装时需要先手动放行它的构建脚本。安装时会自动执行脚本,会执行 shell 命令。沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile,没发现明显的坑。
锐评 — 我会装它,因为它是 portable across hosts 的 Agent Plugin。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
mstar-harness 是做什么的

mstar-harness 是一个面向工作流工程的 DeepSeek Harness 插件,用技能和 TypeScript 引擎组织代码交付。它把角色判断、计划编排和流程决策放在 mstar-* skills 中,再由 @mstar-harness/engine 执行路径、状态、lease、dispatch、SDD、iteration 和 lint 等确定性 gate,而不是只把规则写成提示词。插件包根目录的 plugin.json 与 skills/ 可供 Agent Plugins v1.0.0 客户端使用。
DeepSeek Harness 插件还提供 @mstar-harness/cli,可通过 mstar-harness 或短别名 mstar 运行校验。支持单计划的 Prepare → Execute → QC → QA gate → Done、Phase 1–5 iteration,以及只读的 /codebase-audit;审计结果写入 {PLAN_DIR}/audit-<date>/。在 iteration compass 中设置 enforcement: hard 后,dispatch 预检会失败即停,否则引擎检查仍是 advisory。
它适合需要固定交付节奏、多 agent 协作和跨主机工作流的开发团队。不需要计划与 gate 的轻量会话不一定适合使用。安装流程和 CLI 涉及 install script 及终端操作,会在 agent 当前权限下安装组件、执行命令;mstar 还会与 npm 中同名的第三方包争用可执行文件名。若不希望引入这些终端与命令名风险,应避免安装或使用完整 CLI。
mstar-harness 的文档
mstar-harness 的配置
DeepSeek Harness 从仓库根目录的 plugin.json 和 skills/ 加载 Agent Plugins v1.0.0 包。dsh 方案使用 @mstar-harness/dsh,也可以独立安装 dsh-llm-fallbacks。可选的 @mstar-harness/cli 提供 mstar-harness,mstar 是短别名。
| 配置 | 作用 |
|---|---|
enforcement: hard |
使 dispatch 预检失败即停,而不是保持 advisory |
该配置写在 iteration compass 中。README 没有说明 enforcement 的默认值。
mstar-harness 的命令
技能引用的引擎检查包括 mstar status validate、mstar dispatch validate 和 mstar iteration gate。命名冲突时使用 mstar-harness。npx @mstar-harness/cli doctor --target <opencode|cursor|codex|zcode|omp|dsh> 检查主机配置,npx @mstar-harness/cli plugin validate 校验可移植包。
工作流入口包括 /iteration-start [direction] [pause]、/iteration-drive、/iteration-loop [direction] [scale] 和 /codebase-audit [keywords]。scale 可用 S、M、L、XL,默认 M;审计 effort 可用 quick、deep,默认 standard。审计只读,并把结果写入 {PLAN_DIR}/audit-<date>/。
mstar-harness 的行为
DeepSeek Harness 可通过 pm skill 进入项目管理流程,但 dsh 不会自动加载它。iteration 覆盖 Phase 1 至 Phase 5,可交互执行,也可自主执行。引擎负责确定性 gate,mstar-* skills 负责角色和流程判断。README 列出的主机包括 dsh、omp、OpenCode、Cursor、Kimi Code、ZCode 和 Codex。
mstar-harness 的限制与权限
运行引擎检查需要把 @mstar-harness/cli 放入 PATH;否则检查仍可使用,但属于 advisory。安装存在 install script 风险,并提供终端操作面,相关行为使用 agent 当前权限。mstar 与 npm 中同名第三方包共享 bin namespace,可能互相覆盖 shim。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
mstar-harness 的同类插件
agent_team_gui
toolclub
可复用 Agent 小队:每个成员独立配置 provider/model 路由与工具策略,支持串行/并行派单、spawn/fork/chain 上下文模式和 Web 管理面板。
装得上,但要先放行构建脚本
dsh-agent-team-gui
toolclub
全局持久 Agent 小队:每个成员独立配置模型与工具策略;在 Settings 中管理、按对话选择并开关协作,普通发送按固定顺序或由模型规划执行。
装得上,但要先放行构建脚本