写一款DSH插件的2个方法论和3个案例

业务人员用 DeepSeek Harness(DSH)写插件时卡在两件事:不知道写什么、不知道怎么写。作者用「角色 + 最小场景 + 数据/能力 + 极简页面」解题、用「需求 + 上下文 + 调试」下手,并以假期余额、每日出勤、工资追算器三款 HR 插件示范:一人团队的插件开发,成败不在能不能写出页面,而在调试期如何保证功能完整性与数据准确性。

基本信息

  • 来源类型:网页文章(人人都是产品经理,2026-10-30,16 分钟阅读,约 424 浏览)
  • 原文位置:raw/articles/2026-10-31-102544-tg-f047c6.md
  • 原文 URL:https://www.woshipm.com/ai/6486515.html
  • 作者:产品方法论集散地(公众号同名,176 篇作品,总阅读量约 71 万)
  • 消化日期:2026-10-31
  • 系列位置:上文为《怎么用 DeepSeek Harness 插件解决客户个性化需求?》,本文是该实操的续篇,视角从「解决客户需求」转到「让内部小伙伴和客户自己动手写插件」

核心观点

  1. 「不知道写什么」和「不知道怎么写」是两个问题,必须分开治。前者卡在选题,后者卡在下手。作者把这两件事拆成两句可背的口诀:选题是 角色 +(最小)场景 + 数据/能力 +(极简)页面 = 一款插件,动手是 需求 + 上下文 + 调试 = 写好一款插件。四词/三词都是刻意压到能被非技术人员记住的长度。

  2. 「角色」是起心动念的第一问:这款插件你给谁做的。作者的第一款插件「假期余额」里,角色是考勤 HR,最小场景是核查假期余额,数据从现有 SaaS 系统的开放接口取,页面只呈现 HR 真正关心的那几列。没有「角色」就没有取舍标准,功能会无限膨胀。

  3. 「最小」是新人最大的坑,作者自己踩过。第二款插件他想做「考勤 HR 工作台」——每日出勤、异常考勤、出勤预警、工时统计、报表管理、考勤确认、假期余额、大批量数据处理全塞进去,刚画原型就发现一个人做不完研发与测试、数据缺口越列越大,项目无疾而终。他从中挑出标准产品最缺的一环「每日出勤」单独成插件,只解决「一眼看清今日出勤、每日出勤明细、出勤合规预警」三件事。

  4. “最小”带来的不是缩水,而是速度跃迁。前一个「工作台」项目一事无成,第三个插件「工资追算器」1 小时就写出第一版。作者判断差别不在能力,而在于「把『最小』两个字真正放进去了」。后续他还发现,围绕 HR 做的插件越攒越多,把它们「缝」在一起,那个没做成的工作台反而自己长出来了——最小化不是放弃整体,而是把整体拆成可交付的增量。

  5. 「数据」与「极简页面」是一体两面,都是教人舍弃。数据解决「从哪来」——作者比喻产研团队是「蔬菜运营商」,缺菜直接找他们要;极简页面解决「呈现什么」——工资报表有几十张、几百个字段,日常真正要核查的可能只有 10 项,那就默认给这 10 项,剩下的让用户自己勾选。

  6. 第一句话的目标不是「说对」,是「发出去」。拿到客户端后光标在输入框里闪、半天打不出一个字,是普遍的劝退点。作者的三个首句几乎都不像需求文档:假期余额是「帮我写一个页面插件,核心是显示员工的假期余额,类似附件页面。数据通过我们开放的接口获取,计算逻辑我给你」;工资追算器是一整段口语描述加一句「至于计算公式与逻辑,我稍后给你提供」——没有需求文档、没有原型规范、没有字段清单。

  7. 上下文质量决定输出效果,三样东西就够:长什么样(一张效果草图)、数怎么算(规则和公式)、从哪取数(接口和字段)。作者用「刚毕业的北大实习生」作比方:第一版做成什么样,八成取决于你背景给得够不够。他会把系统里几百个工资项的计算公式直接截图,一条一条,不翻译、不精简。

  8. 调试是「一人团队」模式的核心,没有之一。需求、设计、研发、测试全是一个人,既是运动员又是裁判。工资追算器「描述需求、给上下文、调出一个大致能看的页面」只花 1 小时,但真正调到基本可用花了 2 天多,期间翻了十几次车。

  9. AI 犯的错是成批同构的。作者刚修完一个括号显示的 bug,用户说:「你重新过一遍,看看是否还有哪些字段的公式遗漏?不能我说哪个你改哪个,终究会有遗漏。」由此得出关键转变:调试不是「用户指哪你打哪」,而是一次性把全部规则过一遍。

  10. 数据架构的定盘星只有每天用它的人知道。工资追算器上线前发现「同一账号 2026 年 1 月实际有 65 人,却只能查到 5 个人」,最终由用户一句话定死:「活动月也应该以报表为准,因为我当前登录的人只有对应 60 人的权限。」作者总结:哪个口径才是对的,AI 不知道,我也不知道,只有每天用它的人知道。

  11. 倒挤会把「未知」伪装成「已知」。某类别取不到值时,作者用「报表值减去其余项」倒挤一个数填进去,候选字段里冒出许多名字很像的项、加起来正好等于差额,用户当场质问「你这是瞎凑数,只要凑够 500 即可,是吗?」这个问题改了六版都没解决,最后靠把已归类项合计、候选字段明细、版本号全部摊在页面上,让用户和作者看到同一份数据才收口——「示例」不只是喂给 AI 的素材,也是跟用户对账的方式。

  12. 插件不追求大而全,也不追求完美。它叫插件不叫产品,区别在灵活与专注:假期余额只管余额,每日出勤只管出勤,工资追算器只管核算工资。工资追算器最后停在 0.17.18 版本、65 个测试用例,仍有未解决的问题(平台项来源、万人导出、部门维度),但已经能用:页面上每个数字都能说清来源,或明明白白标注「这部分我还没识别出来」。

  13. 最终结论不在公式里。作者最深的体会是:难的不是写页面、写接口、写分页,而是调试过程中如何确保功能完整性与数据准确性。「插件不是把页面做出来就完了,是要让用户相信页面上的数字,是真正能解决用户的问题。」让每个人都写一款插件,目的不是让人变成程序员,而是让最懂业务的人第一次有了自己动手的资格。

实操内容保留

方法论模板(原文原样保留)

选题方法论(一句话):

角色 +(最小)场景 + 数据/能力 +(极简)页面 = 一款插件

四个自问(原文顺序):

  1. 你要为谁写(即角色)?
  2. 如果只能替他解决一件事,你选哪件(即最小场景)?
  3. 这件事要的数据和能力,是不是已经现成(即数据/能力)?
  4. 如果只有一个页面,这个页面最该放什么(即极简页面)?

写作方法论(一句话):

需求 + 上下文 + 调试 = 写好一款插件

Prompt 模板(原文三个首句,原样保留,可直接改写复用)

假期余额插件(第一版首句):

帮我写一个页面插件,核心是显示员工的假期余额,类似附件页面。数据通过我们开放的接口获取,计算逻辑我给你。

每日出勤插件(提供 HTML 原型后):

基于我这个HTML的原型,帮我开发一个页面插件,核心是面向xx考勤HR,辅助他们可以完成对自己所负责权限范围内的员工,进行出勤结果的查看、跟进以及统计,快速定位异常员工等。

工资追算器(超长但完整的一句话需求):

你帮我写一个页面插件,名字叫工资追算器,目的是解决用户在使用xx系统的工资模块时,对某个工资项(比如税前工资合计、税后实发、应补(退)税额等)字段有疑问时,可以直接点击某个员工的数字追查它的公式,以及对应公式里的每个数字的值。要求是:我们必须基于xx真实员工数据进行核算,页面设计上,可以每次只看一个月的报表数据,而报表数据我们可通过接口方式直连xx系统的已归档报表(全数据表是最全的逻辑),至于计算公式与逻辑,我稍后给你提供

操作步骤(三步写作路径,原文结构)

  1. 先把需求说出来:能说清最好,说不清也没关系,只是多耗些时间;别因为怕说错就迟迟不开始。
  2. 把上下文喂进去:给三样东西——长什么样(效果草图)、数怎么算(规则和公式)、从哪取数(接口和字段)。公式直接截图、逐条给,不翻译不精简。
  3. 在调试里把它磨出来:按「先初调页面效果 → 再精调数据准确性 → 最后再精调页面效果」的顺序推进;遇到同类错误时一次性全量过规则,而不是逐条打补丁。

调试三经验(原文)

  • 经验一:先初调页面效果,再精调数据准确性,最后再精调页面效果。先易后难——「你要让一只猴子站上 5 米高的台子演讲,你下意识的动作是先搭台子,而不是先教猴子说话」。这样排是因为如果过早抠样式,「65 人只查到 5 人」这类数据口径问题根本浮不出来。
  • 经验二:一图胜千言,示例胜千言。说不清楚就上图:草图、截图、原型都可以。做不出「年份和月份一起选」的筛选组件,就截现有系统的图给它;不方便把手册公式敲给它,就截图。
  • 经验三:不要追求大而全,也不要追求完美。一人团队追大而全基本等于失败——需求越做越多,时间越拖越长,最后要么放弃,要么交不出来。

关键概念

  • DeepSeek Harness — 本文的插件运行环境,作者团队用它把客户个性化需求做成内部可复用的插件
  • DSH 插件开发方法论 — 本文提炼的两套方法论与三条调试经验,已建实体页
  • Vibe Coding — 业务人员用自然语言驱动 AI 生成可运行插件,是 Vibe Coding 在 B 端内部工具上的具体形态
  • 最小场景 — 只解决一个角色的一件具体事,是本文防止需求膨胀的第一道闸
  • 极简页面 — 只呈现最小场景真正需要的那几列/那 10 项字段,其余交给用户勾选
  • 一人团队 — 需求、设计、研发、测试全由一个人承担的插件开发模式,调试成本占总成本的大头
  • 倒挤凑数 — 用「总额减去其余项」填补未知字段,本文中作为反面案例出现,会让页面上的数字失去可解释性

与其他素材的关联

  • 与 2026-10-12-133252-deepseek-harness-desktop 的关系:叶小钗那篇讲 DSH 的插件机制与宿主架构(Everything is a Plugin、Cordis 生命周期、Host/Client 插件),是「插件为什么能写」;本文讲业务人员该怎么写、写了之后怎么调,是「插件怎么写才有人用」。两篇合起来才覆盖 DSH 插件从机制到方法的完整链路。
  • 与 2026-10-06-woshipm-deepseek-harness-desktop 的关系:杨森那篇用「公开反馈评审」插件实测创造模式,结论是插件装上不等于生效、工具通过不等于任务做对;本文用三款真实 HR 插件补上业务侧的证据——插件代码能跑之后,真正的成本在数据口径与规则完整性上,且这些判断只能由每天用它的业务人员提供。
  • 与 2026-10-31-woshipm-vibe-coding-ui-component-terms 的关系:那篇强调「说不清」是 AI 时代的新门槛,解决方案是把模糊感受翻译成精确术语;本文的「一图胜千言」是同一命题的另一半——当术语也说不清时,用截图和原型代替语言,让 AI 和用户看到同一份事实。
  • 与 2026-09-16-woshipm-enterprise-agent-harness 的关系:那篇论证企业不必自研运行底座,真正省不掉的是内部工具、业务规则与流程梳理;本文正是这套判断的落地样本——底座由 DSH 提供,业务人员只需把「角色 + 最小场景 + 数据 + 极简页面」填进去。

原文精彩摘录

我从里面挑出标准产品目前最缺的一环——「每日出勤」,单独做成一个插件,只解决一件事:让考勤 HR 一眼看清员工的今日出勤情况、每日出勤明细,以及出勤合规预警。……前一个项目一事无成,这一个 1 小时出版本。差别不在能力,在于我把「最小」两个字真正放进去了。

这 2 天翻了十几次车,但真正改变我打法的只有一句话。有一回我刚修完一个括号显示的 bug,用户说:「你重新过一遍,看看是否还有哪些字段的公式遗漏?不能我说哪个你改哪个,终究会有遗漏。」AI 犯的错是成批同构的——你修好一个括号,后面还排着十个。所以调试不是「用户指哪你打哪」,是一次性把全部规则过一遍。

倒挤会把「未知」伪装成「已知」——页面上漂漂亮亮一个数字,背后其实是凑出来的。……最后不是靠又改一条规则,而是把东西摊开:已归类项合计打出来,候选字段明细打出来,版本号放在页面上。让用户和我看到同一份数据。从那以后我才明白:「示例」不只是喂给 AI 的素材,也是你跟用户对账的方式。

工资追算器最后停在 0.17.18,65 个测试用例,仍然有没解决的问题:平台项来源、万人导出、部门维度。但它已经能用——页面上每个数字都能说清楚是怎么来的,或者明明白白告诉你「这部分我还没识别出来」。……插件不是把页面做出来就完了,是要让用户相信页面上的数字,是真正能解决用户的问题。

相关页面