跳到主要内容

Prompts 与 config.yaml

除了 AGENTS.md 和 skills,还有两种定制方式:prompt 文件(额外的 / 命令)和 config.yaml(模型、供应商、上下文、可选的 uses: 引用)。

Prompt 文件当作斜杠命令​

Markdown 文件放在:

路径范围
.knoxcoder/prompts本项目
~/.knoxcoder/prompts本机

它们出现在 / 选择器的 Prompts 下,不在 Commands 下。命令名就是 / 后面你输入的内容。从 Prompts 浮层(Add Prompt)创建,或把文件丢进该文件夹。

Prompt 文件 只有 在你当作斜杠命令调用时才生效。它们不是始终生效的说明(那种请用 AGENTS.md)。

config.yaml​

Knox: Settings → Open Config File,或编辑:

路径作用
~/.knoxcoder/config.yaml用户模型、供应商、部分 Agent 配置、可选 hooks:
.knoxcoder/config.yaml可选的项目覆盖

从 GUI 编辑会保留一次性的 config.yaml.vpre-edit.bak。升级时 Knox 从不改写 该文件。

最小的本地模型示例(登录与模型 也有):

name: Knox
version: "1.0.0"
schema: v1
models:
- name: Local Llama
provider: openai
model: llama3
apiBase: http://127.0.0.1:11434/v1
apiKey: ollama

name 是 composer 和 knoxchat.fallbackModel 里的 标题。

还可以在 YAML 里声明 context: 提供者、prompts:、rules: 和 hooks:。项目 hooks 更建议放 .knoxcoder/hooks.json,这样在仓库里更显眼。

uses: owner/package(仅本地注册表)​

某个块可以写 uses: owner/package(可选 owner/package@version)。Knox 从 本机 加载 YAML:

~/.knoxcoder/registry/owner/package.yaml
~/.knoxcoder/registry/owner/package@version.yaml

(KNOX_GLOBAL_DIR 替换 ~/.knoxcoder。)文件不存在是 错误,不会发起网络请求。

2.2 不支持远程注册表。没有包下载,没有定时 Agent,KnoxCoder 内也没有 MCP 服务器。

把 YAML 片段自己拷到 registry/owner/,或直接写进 config.yaml。

不要放进 config.yaml 的东西​

不要原因
KNOX_API_KEY2.2 不读取 — OAuth 或自带密钥
市场版 ~/.knox 路径另一个产品
Embedding / 向量记忆设置Memory Brain 是本地词法检索

下一步​

登录与模型 · Skills · 设置参考