ARTICLE · 1302510
让 Agent 自己写插件?先避开这三个坑
让 Agent 自己写插件?先避开这三个坑DeepSeek 的 Harness，上线了一个 Creator Mode。 你在对话框里说一句需求，它自己写插件、装插件、自检修错。 官方演示里，一个悬浮番茄钟，写了 600 多行前端代码，5 分 24 秒跑起来。 听着像魔法。 但官方也补了一句。 部分演示经过多轮调整，一条提示词不一定能复现。 Harness 还是开发者预览版，没做安全审计，能运行模型生成的代码。 所以，这东西能玩，但不能乱玩。 今天讲三个坑。 踩一个，轻则插件装不上，重则把工作区搞乱。 再举个真实的担心。 你让它写一个导出插件，它写完了，也装上了。 结果把原来的导出按钮搞坏了。 你还没备份。 这就是为什么，今天要先讲坑，再讲好处。 
Harness 是 DeepSeek 的开源智能体应用，基于 Cordis。 它的核心理念，是一切皆插件。 工具、技能，甚至界面组件，都能替换。 目前有四种模式：Standard、PTC、极简，还有 Creator。 Standard、PTC、极简，还有 Creator，四种模式各有分工。 Creator 是今天的主角，专门用来造插件。 官方还给了 7 组中英文提示词。 覆盖 3D 展厅、Transformer 可视化、视频编辑工作台、论文阅读器这些场景。 你会发现，它想做的，是一个能自己长工具的工坊。 Creator Mode 干的事，是一整条流程。 先看开发接口和可用插槽。 再按内置说明写插件代码。 然后调用插件管理器安装。 最后自检，发现错误，在同一个插件里修。 装好的插件，下次打开还在。 它还能给 Agent 增加原本没有的工具。 比如你常做竞品截图，就可以让它写一个截图归档插件。 比如你常改字幕，就可以让它写一个字幕清洗插件。 这些插件都是你可以继续改的代码。 那它为什么值得试。 以前做插件，要懂框架、看文档、调接口。 现在这些活，Agent 先替你跑一遍。 其实，Creator Mode 替你搭的是工具，写代码只是其中一步。 说白了，这是一个插件工厂。 但你要记住一件事。 插件是代码，代码会运行，运行就有权限。 所以三个坑，分别对应环境、预期和验收。 第一个坑，最常见。 常见的做法是，直接在放满项目文件的主目录里试。 Agent 生成的插件，直接给全权限。 为什么错。 因为生成的代码，没经过安全审计。 它可能读你的文件，可能删你的文件，也可能往外发请求。 后果不用我多说。 假设插件为了读配置，把整个项目目录扫了一遍。 里面正好有 .env。 密钥就可能进了模型的上下文。 它未必恶意，可能只是想找配置文件。 但风险已经发生了。 轻则工作区被改乱，重则密钥、客户资料一起漏。 正确做法，是先给它一间可以弄脏的屋子。 放在虚拟机里，或者容器里。 权限给最小。 先只给一个空目录，不给网络，不给凭据。 具体怎么做。 第一，开一台虚拟机，或者一个容器。 第二，新建一个空目录，只放一个测试文件。 第三，关掉网络，或者只放行必要的域名。 第四，不给账号凭据，不给主工作区路径。 这四步做完，再让 Agent 动手。 那什么时候可以放到主工作区。 等你连续跑通几次，确认它只读该读的、只写该写的，再考虑。 举个例子。 你想做一个格式转换插件。 它只需要读一个输入文件，写一个输出文件。 那就不用给它整个硬盘的权限。 你会发现，权限越小，试错成本越低。 很多事故，不是模型坏，是权限给大了。 先给它一间可以弄脏的屋子。 第二个坑，是预期错了。 看到官方演示，一句话写出番茄钟。 自己照着说一遍，没跑起来，就觉得工具不行。 其实，官方说得很清楚。 部分演示，经过多轮调整。 一条提示词，不一定能复现。 演示本来就挑过，挑的是最顺的一条。 演示多半会挑最顺的一条。 它可能调了接口，改了插槽名，修了两轮报错。 这些过程，不会出现在 5 分钟的视频里。 番茄钟看着简单，其实涉及计时、悬浮窗、开始暂停三个状态。 第一版大概率少一个状态。 正确做法，是从小插件起步。 先做番茄钟、格式转换、文本替换这种单功能插件。 描述需求时，写清三件事。 输入是什么。 输出是什么。 什么时候触发。 举个例子。 不要只说，帮我做个文本处理插件。 要说，读取剪贴板文本，把全角标点换成半角，再写回剪贴板。 再给你一个模板。 这个插件做什么。 输入从哪里来。 输出到哪里去。 什么时候触发。 失败的时候怎么提示。 五行写清楚，比一句「帮我做个好用的插件」强十倍。 前者是许愿，后者是需求文档。 然后，允许它改两到三轮。 每一轮，记下你改了什么。 下次再写插件，这些记录就是模板。 其实，写插件和带新人一样。 你需求写得越清楚，它返工越少。 你只丢一句「你看着办」，它就只能猜。 提示词不是许愿，是需求文档。 第三个坑，最隐蔽。 看到代码生成完，就以为成功了。 可插件要装得上，要调得动，要下次打开还在。 这三件事，缺一件都不算成。 为什么要重启。 因为有些插件只在当前会话里生效，重启就没了。 为什么要调用。 因为装上了不等于能用，接口可能对不上。 为什么要看原功能。 因为新插件可能改了共用的插槽，把老功能带崩。 所以验收要看三项。 第一，装上了没有，插件有没有出现在列表里。 第二，能不能真正调用，比如点开始、暂停，看它有没有反应。 第三，重启 Harness，插件还在不在；原来的对话和工具，还正不正常。 有一项不对，就回滚，别硬撑。 其实，验收比生成更重要。 生成只要几分钟，验收决定它能不能留在你的工作流里。 回滚怎么做。 记录三样东西：插件名、用途、回滚目录。 装之前，先备份原来的插件目录。 出问题，把目录换回去，重启。 别在原目录里一层层改，越改越乱。 我自己做内容流水线，也是这个习惯。 每一步都落盘，关键动作都留回滚点。 我这么做，跟谨慎没关系。我知道自动化一定会出错。 区别只在于，出错之后，你能不能退回去。 写完不算完。装上、重启、还在，才算完。 
把今天说的收一下。 那三个坑，对应三个动作。 坑一，环境。别在主工作区跑，去虚拟机或容器，给最小权限。 坑二，预期。别指望一条提示词复现演示，从小插件起步，写清输入、输出、触发，允许两到三轮。 坑三，验收。重启后还在，能真正调用，不破坏原功能。 那到底值不值得试呢。 值得，但先小后大。 先小后大，是给自己留退路。 今天就做一件小事。 挑一个最小需求，比如全角转半角。 在一个空目录里，让 Agent 写、装、自检。 然后重启，看它还在不在。 你会发现，真正难的是让它写出来的东西，能安全地用下去。 插件可以自动生成，权限不能自动放开。 你最先想让它写什么呢，发评论区，我看看哪个最适合先试。 
我是张胡侃，关注我，持续分享 AI 圈的真话，不聊虚的。
一、先搞懂：Creator Mode 到底在干什么
二、坑一：直接在主工作区跑
三、坑二：以为一条提示词就复现
四、坑三：只看写完，不看装上和下次还在
五、最后：三个坑，三步做法
