https://github.com/Erfan817/prompt-spark 我应该做每个harness的原生插件还是一个通用的程序

来自夹夹 QQ 群讨论,审核后公开 · 。查看原始讨论

提问

https://github.com/Erfan817/prompt-spark 我应该做每个harness的原生插件还是一个通用的程序

回答

回复 群友 8780

先说结论:做通用程序,不要做九个原生插件。

理由得从这两种形态的成本结构说起。

原生插件的问题是它的接口是你无法控制的第三方契约。每个 harness(Claude Code、Codex、Cursor、Gemini CLI 等)的插件机制、生命周期钩子、配置格式、允许做的事都不一样,而且都在快速变。你为每个写一份适配,等于维护 N 份会自己烂掉的东西。更麻烦的是,插件通常被限在一个很窄的沙箱里:能扩的命令有限、能改的输出有限、拿不到完整的会话上下文。你想做的事情如果是要干预 prompt 的生成过程,插件层往往够不着,最后写出来的是九个各残一半的版本。

通用程序则是你自己定接口。它是个独立进程或者本地服务,通过一个稳定协议跟 harness 打交道,形态通常是 MCP server、CLI 加 hook、或者干脆 parasitize 那层最通用、几乎所有 harness 都有的东西:stdin/stdout、文件系统、HTTP。这样你的核心逻辑只有一份,harness 差异全部下沉到薄薄的一层适配器里。

但这里有个关键判断,取决于你产品形态到底是什么:

如果你的产品是“给用户的 prompt 加一层能力”(重写、补上下文、做检查),那必须走通用路线,因为这类能力天然是横切的,而插件机制恰恰是最不横切的那层。推荐的落地形态是 MCP server 加一个极薄的 hook:hook 负责在提交前拦一下,把请求转给你的常驻进程,进程里跑你的核心逻辑,返回改写结果。MCP 现在是事实上的通用接入标准,绝大多数 harness 都支持,这条最省力。

如果你的产品想深度嵌进某一个 harness 的 UX(比如在编辑器里出侧栏、接管某类命令),那可以给那一个做原生插件,把它当成旗舰体验,其余全部走通用接口。也就是一条主干加一个特例,而不是平摊九份精力。

在接口设计上,有三件事我想提醒你,因为这些是通用程序最容易翻车的地方:

一是版本协商。你必须在握手时就知道对面是谁、什么版本、支持哪些能力,不支持就优雅降级,而不是报错。否则一个 harness 升级,你的程序全线挂。

二是超时和幂等。prompt 处理是在人的操作路径上的,超过一两秒人就会感觉卡,超时必须有兜底:拿不到你的结果就用原始 prompt 继续,绝不阻塞用户提交。这一条决定产品的可用性上限。

三是别依赖只有某一个 harness 才有的富上下文。你从 A 家能拿到完整对话历史、工具调用记录,B 家可能只给你最后一句。核心算法要能在最贫瘠的输入下也跑出结果,富上下文只作为加分项。

还有一个反面意见,公平说一说:如果你现在只是在验证想法,九份插件都不该写,一份都不写。先用最小成本验证“有没有人愿意为这层能力付出代价”,比如做一个只支持一个 harness 的原型,两周内让人用上。等确认了价值,再把它重构为通用核心加适配器,这个重构成本远低于你一开始就摊开维护九个插件。过早地追求跨 harness 兼容,是这类项目最常见的死法。

总结成一句:核心逻辑写一次、可独立运行、通过 MCP 或最通用的进程接口暴露;harness 差异做成薄适配器;先把一个跑通,再扩到多个。九个原生插件不是九倍工作量,是九份持续消耗你注意力的债。

所属话题:编程工具与选型