锦
锦思新知编辑组
发布时间:2026/11/18 16:07:35
来源:锦思新知
阅读:知识向官网定制

如何自定义Zap的系统提示词minijinja模板编辑完整教程【免费下载链接】zapZap is an open, local-first terminal with first-class AI and agent support.项目地址: https://gitcode.com/gh_mirrors/warp50/zapZap 是一款开放、本地优先的 AI 终端其 AI 代理的行为由**系统提示词system prompt**驱动。本文带你快速掌握 Zap 系统提示词的 minijinja 模板体系模板放在哪里、如何按模型自动分发、Jinja2 语法怎么改、改完后如何验证——让你能精确调教Zap 代理的语气、工具策略与全局规则。系统提示词在 Zap 中如何生成当你使用 BYOP自带模型与 Zap 代理对话时发送内容会经历 4 步流水线收集上下文Zap 把当前工作目录、Shell、操作系统、Git 分支、可用技能Skills、项目规则等信息打包成AIAgentContext拍平成模板变量prompt_renderer.rs中的collect_prompt_context把这些信息转成扁平的PromptContext结构含cwd、shell、git、skills、user_rules、available_tools等字段按模型选模板pick_template根据模型 id 子串匹配从 9 个系统模板中挑一个minijinja 渲染最终生成发给上游模型的 system 字符串。 所有模板通过include_str!在编译期打进二进制修改模板需要重新编译才能生效。9个系统模板你的模型命中哪一份模板文件位于 app/src/ai/agent_providers/prompts/system/按模型家族分发模型 id 关键词命中模板claude/sonnet/opus/haikuanthropic.j2gpt-4/o1/o3/o4beast.j2gptcodexcodex.j2其他gptgpt.j2gemini-gemini.j2kimi/trinitykimi.j2 / trinity.j2识别不到如deepseek、qwendefault.j2兜底Ollama 本地模型local.j2精简短模板匹配逻辑见 prompt_renderer.rs 的pick_template_by_model大小写不敏感OpenRouter 的provider/model形式也能正确命中自定义模型名会安全落回default.j2。模板结构用 partials 组合系统提示词各家族模板只写个性部分公共片段全部抽成 partials位于 prompts/partials/由 footer.j2 统一拼装env.j2工作目录、Shell、平台、Git 分支、日期skills.j2可用技能清单含skill_path供模型调用read_skilluser_rules.j2用户在设置中创建的全局规则project_rules.j2项目级规则文件tool_aliases.j2本轮实际可用的工具白名单动态渲染不硬编码thinking_language.j2内部思考语言约束plan_mode.j2/plan只读研究模式注入的约束块以 env.j2 为例你能直观看到 minijinja 的三大语法变量插值{{ cwd | default((unknown)) }}、条件{% if shell %}、过滤器default。改模板时只需熟悉这三个即可覆盖 90% 的场景。动手改模板3个实用场景场景 1调整回复风格。打开 default.j2在# Tone and style一节中默认要求少于 4 行的极简回答。你可以把它改成回答控制在 10 行以内并给出示例适合教学场景。场景 2为特定模型定制开场白。比如 anthropic.j2 第一句是 You are Zap, the best coding agent on the planet.各家族模板的人设不同——想统一人设就只改对应家族文件的第一段。场景 3新增一段全局约束。在任意 system 模板末尾追加一个# Your rules小节即可因为 footer 会把它渲染在环境信息之后。若只想免编译生效推荐下一条零代码方案。零代码方案全局 Rules 注入不想碰模板Zap 支持在设置 → Agents → Rules创建全局规则内容会经 user_rules.j2 自动渲染进 system prompt且对所有模型家族生效。每条规则可带名称渲染为## 名称二级标题例如Rust 代码一律使用 snake_case。这是日常调教最轻量的入口。改完怎么验证单元测试prompt_renderer.rs 内置了 20 个测试覆盖模板分发、环境块渲染、Plan Mode 注入、Rules 渲染与空块省略改模板后跑一遍cargo test即可回归兜底机制任何模板加载或渲染失败都会自动降级为内置的fallback_system短提示见 prompt_renderer.rs 中的fallback_system不会让对话中断缓存提示模板中避免加入每请求都变的动态内容如精确到秒的时间否则会击穿上游供应商的 prompt cache。Zap 因此把current_time只保留到日粒度。常见问题Q改了模板为什么没生效模板是编译期嵌入的需重新编译并重启应用。Q我接的模型不在上表里走哪个模板走 default.j2 兜底Ollama 本地模型固定走 local.j2 短模板避免长系统提示淹没小模型上下文。Q能自己新增一个模型家族的模板吗可以在 system/ 下新建.j2文件在build_env注册、在pick_template_by_model加一条子串匹配最后补一条分发测试即可。Q/plan命令和系统提示词什么关系/plan触发的只读研究模式由 plan_mode.j2 条件注入模板中的Stop and wait引导语即来自这里。小结需求改哪里是否需编译调整某家族模型人设/语气system/{家族}.j2✅改环境变量渲染格式partials/env.j2✅加全局行为规则设置 → Agents → Rules❌加项目专属规则项目规则文件经 project_rules.j2 注入❌掌握 minijinja 模板后Zap 的 AI 代理就不再是出厂设置而是真正贴合你工作流的专属助手。【免费下载链接】zapZap is an open, local-first terminal with first-class AI and agent support.项目地址: https://gitcode.com/gh_mirrors/warp50/zap创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
知识建站
内容驱动
阅读友好版式
SEO 精细化
线索转化
这篇内容对您有启发吗?
预约一次免费方案沟通,我们会根据您的行业给出可落地的站点架构建议。
立即预约沟通