提示词档案

Mework 自己加进对话的话，从环境信息块到工具描述、工具结果和通知，几乎每一句都是一个带内置英文文本的键。提示词档案是一个 JSON 文件，覆盖你写出的那些键；其余的键保持内置措辞。

档案能改什么

档案可以改写或去掉：

• 环境信息块，以及系统提示词里技能、MCP 服务器和钩子的说明段；
• 内置工具和 MCP 工具的描述；
• 工具成功后返回的话，例如记忆和交接的确认、后台任务的状态；
• Mework 在对话中途送达的通知，例如计划模式引导和交接请求；
• 记忆、项目指令、子代理、工作流和联网搜索相关的文字。

档案只改变模型读到的内容。它改不了：

• 对话自己的系统提示词卡片。那张卡片在时间线上直接编辑，或在预设的对话模板里编辑；
• 有哪些工具、工具的参数（少数有对应键的参数描述除外）、哪些操作需要审批；
• 工具的错误信息，它们固定为英文；
• Mework 会回读的标记，例如 [Image #N] 和 <task-notification>，以及 MEMORY.md 的标题行；
• 应用界面，包括审批卡和对话框：无论选哪个档案，它们都使用应用的语言。

内置档案叫 Mework 内置。它是英文的，属于应用本身，随每个版本更新，不能编辑。不选任何档案就等于选它。

档案文件放在哪里

Mework 会列出以下文件夹里直接存放的每个 .json 文件：

• ~/.mework/tool-descriptions/
• 你添加过的每个本地工作区里的 .mework/tool-descriptions/，不限于当前对话的工作区

子文件夹和符号链接会被忽略，SSH 机器或 WSL 上的工作区不会扫描。Mework 从不创建、修改或删除这些文件。

选择档案

1. 打开 更多选项 → 对话设置 → 高级工具。
2. 在 工具描述 里选择档案。Mework 内置 排在最前，后面是你的文件。

预设的设置里也有同一行，新对话会沿用预设的选择（参见预设）。打开对话设置时列表会刷新，在其中的 技能、MCP 或 钩子 页按 重新扫描 也会刷新。

选择绑定的是文件所在的位置。改文件里的 name 不影响选择；给文件改名、移动文件或移动它所在的工作区文件夹，选择就会失效。

改动何时生效

• 每次运行开始时都会重新读取选中的文件：改好、保存，发出下一条消息即可。
• 新文字从下一次运行起生效。对话里已有的工具结果和通知保留原来的措辞。
• 子代理和工作流步骤使用它们启动时对话所用的档案。
• 在对话中途换档案或修改选中的文件，会改变请求的开头，下一个请求就用不上提供商的提示缓存。对话发出第一个请求之后，工具描述 这一行会像其他会让缓存失效的设置一样标成橘色，切换前 Mework 会先问一次。

文件格式

{
  "name": "Terse",
  "prompts": {
    "task.wait_idle": "Nothing is running.",
    "system.environment.date": "Date: {date}",
    "project_memory.untrusted_banner": ""
  },
  "tools": [
    {
      "toolName": "grep",
      "schemaNotes": "",
      "usageGuidance": "Prefer grep to reading whole files."
    }
  ]
}

同一个工具有多行时，第一行有文字的生效。

• 回退。 每个键先用选中文件里的文本，文件里没有这个键时用内置英文文本。选中的文件丢失或不是有效的 JSON 时，整体按内置档案处理。
• 空字符串。 "" 的意思是「这里什么都不说」。system.environment_section 为空会去掉整个环境信息块；project_memory.untrusted_banner 为空会去掉项目指令里的那段横幅。
• 默认为空的键。 web.findings_notice、web.results_notice（联网搜索与抓取结果里的 notice）和 web.untrusted_marker（加在检索内容中像指令的行前面的前缀），在你填写之前不会加入任何内容。
• 占位符。 花括号里的词，例如 {date}，会在使用时填入实际内容；键参考里列出了每个键的占位符。占位符可以不写；写了键没有声明的占位符，会原样留在文字里。
• 列表。 Mework 把多个名字拼成列表时，用 format.list_separator 分隔（默认是 , ）。
• 大小。 文件必须是 UTF-8 编码的 JSON，最大 64 KiB。

自己写一份

从内置档案开始，它包含每个键及其当前文本；键清单则列出每个键的占位符和出现位置：

• prompt-profile.en-US.json — 内置档案
• prompt-profile-keys.json — 键清单

1. 下载 prompt-profile.en-US.json，另存一份为 ~/.mework/tool-descriptions/<name>.json，或放到某个工作区的 .mework/tool-descriptions/ 里。
2. 设置 name，然后删掉所有你不打算改的键。删掉的键会继续跟随 Mework 的更新；留下的键则固定为你写的文字。
3. 修改留下的文字，保留每个键用到的占位符。
4. 打开 更多选项 → 对话设置 → 高级工具，在 工具描述 里选中这个文件。列表里没有的话，关掉对话设置再重新打开。
5. 发一条消息，然后打开 更多选项 → 历史记录。system 行是 Mework 发出的系统提示词，tools 行是工具描述。

想让模型用中文或其他语言工作，就要翻译每一个键并保留整个文件：文件里缺少的键会回退到英文。

键参考

下面按前缀分组列出每个键、它接受的占位符以及文字出现的位置。点开一组即可查看其中的键。