@jpssff/vanor 0.1.0

package/base/events.js

@@ -0,0 +1,54 @@
+// 全局事件枚举：所有 JSONL 日志的 event 字段唯一定义源。
+// 命名规范 <domain>.<action>，禁止在别处散落字符串字面量。
+
+export const EVENTS = Object.freeze({
+  agent: {
+    turnStart: "agent.turn.start",
+    turnEnd: "agent.turn.end",
+    turnAborted: "agent.turn.aborted",
+    turnMaxIterations: "agent.turn.max_iterations",
+  },
+  llm: {
+    request: "llm.request",
+    response: "llm.response",
+    retry: "llm.retry",
+    error: "llm.error",
+    requestDetail: "llm.request_detail",
+    responseDetail: "llm.response_detail",
+  },
+  tool: {
+    call: "tool.call",
+    result: "tool.result",
+    error: "tool.error",
+    denied: "tool.denied",
+  },
+  memory: {
+    store: "memory.store",
+    retrieve: "memory.retrieve",
+    compress: "memory.compress",
+    promote: "memory.promote",
+  },
+  session: {
+    start: "session.start",
+    resume: "session.resume",
+    reset: "session.reset",
+    compact: "session.compact",
+  },
+  skill: {
+    load: "skill.load",
+    invoke: "skill.invoke",
+    save: "skill.save",
+  },
+  security: {
+    approve: "security.approve",
+    deny: "security.deny",
+  },
+  config: {
+    load: "config.load",
+    change: "config.change",
+  },
+  error: {
+    uncaught: "error.uncaught",
+    generic: "error.generic",
+  },
+});

package/base/i18n/index.js

@@ -0,0 +1,80 @@
+// Lightweight i18n helpers. Keep this dependency-free so Vanor can run anywhere Node.js runs.
+
+import en from "./locales/en.js";
+import zhCN from "./locales/zh-CN.js";
+
+export const SUPPORTED_LANGUAGES = ["en", "zh-CN"];
+export const LANGUAGE_SETTINGS = ["auto", ...SUPPORTED_LANGUAGES];
+
+const LOCALES = {
+  en,
+  "zh-CN": zhCN,
+};
+
+export function normalizeLanguage(value) {
+  const raw = String(value || "").trim();
+  if (!raw) return "en";
+  const first = raw.split(":")[0].split(",")[0];
+  const normalized = first.replace(/_/g, "-").replace(/\..*$/, "").replace(/@.*$/, "").toLowerCase();
+  if (normalized === "zh" || normalized.startsWith("zh-")) return "zh-CN";
+  if (normalized === "en" || normalized.startsWith("en-")) return "en";
+  return "en";
+}
+
+export function isSupportedLanguageSetting(value) {
+  return LANGUAGE_SETTINGS.includes(value);
+}
+
+function intlLocale(intl = globalThis.Intl) {
+  try {
+    return intl?.DateTimeFormat?.().resolvedOptions?.().locale || "";
+  } catch {
+    return "";
+  }
+}
+
+export function detectLanguage(config = {}, env = process.env, intl = globalThis.Intl) {
+  const configured = config.ui?.language || "auto";
+  if (configured && configured !== "auto") {
+    return { language: normalizeLanguage(configured), source: "config", configured };
+  }
+
+  for (const name of ["VANOR_LANG", "LC_ALL", "LC_MESSAGES", "LANGUAGE", "LANG"]) {
+    if (env?.[name]) {
+      return { language: normalizeLanguage(env[name]), source: name, configured: "auto" };
+    }
+  }
+
+  const locale = intlLocale(intl);
+  if (locale) return { language: normalizeLanguage(locale), source: "Intl", configured: "auto" };
+  return { language: "en", source: "fallback", configured: "auto" };
+}
+
+function lookup(dict, key) {
+  let cur = dict;
+  for (const part of key.split(".")) {
+    cur = cur?.[part];
+    if (cur == null) return undefined;
+  }
+  return cur;
+}
+
+function interpolate(text, vars = {}) {
+  return String(text).replace(/\{([a-zA-Z0-9_]+)\}/g, (_, name) => (vars[name] == null ? "" : String(vars[name])));
+}
+
+export function createI18n(languageOrConfig = "en", env = process.env, intl = globalThis.Intl) {
+  const detected =
+    typeof languageOrConfig === "string"
+      ? { language: normalizeLanguage(languageOrConfig), source: "explicit", configured: languageOrConfig }
+      : detectLanguage(languageOrConfig, env, intl);
+  const language = SUPPORTED_LANGUAGES.includes(detected.language) ? detected.language : "en";
+  const dict = LOCALES[language] || en;
+
+  function t(key, vars) {
+    const value = lookup(dict, key) ?? lookup(en, key);
+    return value == null ? key : interpolate(value, vars);
+  }
+
+  return { ...detected, language, t };
+}

package/base/i18n/locales/en.js

@@ -0,0 +1,254 @@
+export default {
+  common: {
+    exists: "exists",
+    missing: "missing",
+  },
+  config: {
+    errors: {
+      noDefaultModel: "llm.defaultModel is not configured",
+      noProviders: "no llm.providers configured",
+      providerMissingBaseURL: 'provider "{name}" is missing baseURL',
+      providerMissingApiKey: 'provider "{name}" is missing apiKey (you can use env:VAR)',
+      approvalInvalid: "security.approval must be ask | auto | deny",
+      languageInvalid: "ui.language must be auto | en | zh-CN",
+      defaultModelFormat: 'llm.defaultModel must use "<provider>/<model>": {model}',
+      defaultProviderMissing: 'default model references missing provider "{name}"',
+      invalidConfig: "Invalid config: {issues}",
+    },
+  },
+  index: {
+    configWizard: {
+      title: "Configure Vanor LLM",
+      hint: "Tip: apiKey can be env:VAR_NAME to avoid storing secrets in config.",
+      providerName: "provider name [default]: ",
+      type: "type openai/anthropic [openai]: ",
+      baseURL: "baseURL [https://api.openai.com/v1]: ",
+      apiKey: "apiKey (or env:VAR): ",
+      modelId: "model id (e.g. deepseek/deepseek-v4-pro / deepseek/deepseek-v4-flash): ",
+      saved: "Saved: {file}",
+      defaultModel: "Default model: {model}",
+      next: "Run vanor to start chatting.",
+    },
+    doctor: {
+      title: "Vanor doctor",
+      configFile: "Config file: {path} [{state}]",
+      workspace: "Workspace: {workspace}",
+      approval: "Approval mode: {approval}",
+      autoRisk: "approval=auto will execute commands automatically; use with care",
+      ok: "No config issues found.",
+      issues: "Found issues:",
+    },
+    chat: {
+      setupIncomplete: "Configuration is incomplete:",
+      runConfig: "Please run: vanor config",
+      sessionNotFound: "Session not found: {id}",
+      sessionListHint: "Run vanor sessions to list resumable sessions.",
+    },
+    skills: {
+      none: "(no skills)",
+    },
+    update: "Update with npm: npm i -g @jpssff/vanor@latest",
+    help: {
+      usage: "Usage: vanor [command]",
+      chat: "(no command)  start interactive chat",
+      config: "config        configure LLM API",
+      doctor: "doctor        diagnose config and environment",
+      sessions: "sessions      list sessions",
+      resume: "resume [id]   resume latest or specified session",
+      skills: "skills        list loaded skills",
+      update: "update        show update hint",
+      version: "version       show version",
+    },
+    unknownCommand: "Unknown command: {cmd} (run vanor help)",
+    fatal: "Fatal error: {error}",
+  },
+  cli: {
+    help: {
+      text:
+        "Commands:\n" +
+        "  /help               show help\n" +
+        "  /new                start a new session\n" +
+        "  /messages           list user messages in the current session\n" +
+        "  /compact            compact context now\n" +
+        "  /retry              retry the last message\n" +
+        "  /model [query]      show or search and switch models\n" +
+        "  /language [lang]    show or switch language (auto | en | zh-CN)\n" +
+        "  /usage              show token usage\n" +
+        "  /skills             list loaded skills\n" +
+        "  /reload             reload config\n" +
+        "  /auto-run [off]     auto-approve actions for this session (off restores)\n" +
+        "  /exit               quit\n" +
+        "Interrupt: press Ctrl+C while a turn is running to interrupt it.",
+    },
+    banner: "Vanor",
+    intro: "A general-purpose CLI agent for developers. Type a message to start, /help for commands.",
+    restored: "Restored session: {id} ({count} context messages)",
+    interruptRequested: "[interrupt requested]",
+    goodbye: "Goodbye.",
+    error: "[Error] {message}",
+    confirmMessage: "Confirm action:",
+    confirmPrompt: "Confirm action [y/N] ",
+    modelMatched: "Found {count} matching models:",
+    chooseModel: "Choose model number [1-{count}] (Enter to cancel) ",
+    invalidChoice: "Invalid choice, cancelled.",
+    newSession: "Started a new session.",
+    compactRunning: "Compacting context...",
+    compactDone: "Context compacted.",
+    modelChanged: "Switched model: {model}",
+    modelSwitchFailed: "Switch failed: {message}",
+    searchableModels: "Searchable models:",
+    currentModel: "Current model: {model}",
+    usage: "prompt {prompt} / completion {completion} / total {total}",
+    messagesNone: "(no user messages)",
+    messagesHeader: "Time                 User message",
+    skillsNone: "(no skills)",
+    skillsTotal: "Total: {count} skills",
+    reloadFailed: "Config reload failed: {error}",
+    reloadDone: "Config reloaded. Current model: {model}",
+    reloadUnchanged: "Config unchanged.",
+    approvalRestored: "Restored approval mode: {approval}",
+    autoRunEnabled: "Auto-run enabled for this session. Denylisted dangerous commands are still blocked.",
+    retryNone: "No message to retry.",
+    unknownSlash: "Unknown command /{cmd}. Use /help.",
+    maxIterations: "[max iterations reached]",
+    aborted: "[interrupted]",
+    runtimeError: "[Runtime error] {message}",
+    sessionsNone: "(no sessions)",
+    sessionRow: "{id}  {count} messages  {model}  {when}",
+    language: {
+      current: "Language: {language} (configured: {configured}, source: {source})",
+      changed: "Language changed to {language} (configured: {configured}, source: {source})",
+      invalid: "Unsupported language: {language}. Use auto, en, or zh-CN.",
+    },
+  },
+  harness: {
+    busy: "Harness is busy (phase={phase})",
+  },
+  skills: {
+    promptIntro:
+      "Available skills (when needed, use read_file or skills.read to read the corresponding SKILL.md and follow it; use skills.write/edit to save new reusable workflows locally):",
+    promptItem: "- {name}: {description} (see {path})",
+    none: "(no skills)",
+    local: "local",
+    shared: "shared",
+    listItem: "- {name} [{scope}]: {description}\n  {path}",
+    total: "Total: {count} skills",
+    dirCount: "- {dir}: {count}",
+    notFound: "Skill not found: {name}",
+    localNotFound: "Local skill not found: {name}",
+    readFailed: "Failed to read skill: {message}",
+    invalidName: "name is required and must be convertible to a safe directory name",
+    writeNeedsContent: "write requires content",
+    saved: "Skill saved: {name}\n{file}",
+    saveFailed: "Failed to save skill: {message}",
+    editNeedsOldText: "edit requires old_text",
+    oldTextNotFound: "old_text not found",
+    oldTextNotUnique: "old_text appears {count} times; it must match uniquely",
+    modified: "Skill updated: {name}",
+    modifyFailed: "Failed to update skill: {message}",
+    deleted: "Skill deleted: {name}",
+    deleteFailed: "Failed to delete skill: {message}",
+    readNeedsName: "read requires name",
+    editNeedsName: "edit requires name",
+    removeNeedsName: "remove requires name",
+    unknownAction: "Unknown action: {action}",
+    toolDescription:
+      "Manage Vanor skills. list/read can inspect loaded skills; write/edit/remove only modify local skills under ~/.vanor/skills.",
+    paramName: "Skill name; converted to a safe directory name when writing",
+    paramDescription: "Optional frontmatter description when writing",
+    paramContent: "SKILL.md body or full Markdown when writing",
+    paramOldText: "Original text to match uniquely when editing",
+    paramNewText: "Replacement text when editing",
+  },
+  schema: {
+    expectedType: "{loc}: expected type {type}",
+    enumValue: "{loc}: value must be one of {values}",
+    required: '{loc}: missing required field "{field}"',
+  },
+  security: {
+    invalidPath: "invalid path",
+    outsideWorkspace: "path is outside workspace {workspace}",
+    pathNotFound: "path does not exist",
+    notDirectory: "not a directory",
+  },
+  tools: {
+    describeExec: "Run command: {command}",
+    describeWriteFile: "Write file: {path}",
+    describeEditFile: "Edit file: {path}",
+    describeSkills: "Manage skills: {action}{name}",
+    describeGeneric: "Call tool {name}",
+    unknownTool: "Unknown tool: {name}",
+    invalidArgs: "Invalid arguments: {errors}",
+    denied: "The operation was denied by the user or policy",
+    exception: "Tool exception: {message}",
+  },
+  builtin: {
+    readFileDescription: "Read text content from a workspace file, optionally by line offset/limit.",
+    pathDescription: "Relative workspace path or absolute path",
+    offsetDescription: "Start line (1-based)",
+    limitDescription: "Number of lines to read",
+    readFailed: "Read failed: {message}",
+    truncatedContent: "[content too long, truncated]",
+    emptyFile: "(empty file)",
+    writeFileDescription: "Write or overwrite a workspace file and create parent directories automatically.",
+    writeFailed: "Write failed: {message}",
+    written: "Wrote {path} ({bytes} bytes)",
+    editFileDescription: "Replace the unique occurrence of old_string with new_string in a file.",
+    oldStringNotFound: "old_string not found",
+    oldStringNotUnique: "old_string appears {count} times; it must match uniquely",
+    edited: "Edited {path}",
+    listDirDescription: "List directory contents.",
+    emptyDir: "(empty directory)",
+    execDescription: "Run a shell command in the workspace and return its output. Subject to allowlist/denylist and approval.",
+    cwdDescription: "Working directory, defaults to workspace root",
+    timeoutDescription: "Timeout in milliseconds, defaults to 60000",
+    spawnFailed: "Could not start command: {message}",
+    commandAborted: "Command aborted",
+    execFailed: "Execution failed: {message}",
+    outputTruncated: "[output truncated]",
+    noOutput: "(no output)",
+    exitCode: "[exit code {code}]",
+  },
+  prompt: {
+    persona:
+      "You are Vanor, a general-purpose agent by Wanyou Intelligence.\n" +
+      "Principles: reason and plan independently, use tools to complete tasks, be concise and considerate, and focus on the user's real intent.\n" +
+      "When you need to read or write files or run commands, call the relevant tool directly instead of describing the action first.\n" +
+      "Tool results may contain errors (isError); use them to correct your approach and continue. Do not dump raw errors to the user.",
+    language: "Default response language: English. If the user explicitly requests another language, follow the user's request.",
+    channelCli: "You are interacting with the user through a command line interface (CLI). Default to terminal-friendly output.",
+    channelDefault: "Adapt your output format to the user's communication channel so it is clear and easy to read.",
+    runtimeTitle: "Runtime environment:",
+    os: "- OS: {name} ({platform}/{arch}, kernel {release})",
+    node: "- Runtime: Node.js {version}; Vanor Agent is built on Node.js and can call node / npm via exec",
+    shell: "- Default shell: {shell}",
+    workspace: "- Workspace: {workspace}",
+    time: "- Current time: {time} ({timezone}, {offset})",
+    contextTitle: "Vanor instance context:",
+    currentModel: "- Current model: {model}",
+    provider: "- Current provider: {provider}",
+    uiLanguage: "- UI language: {language} (configured: {configured}, source: {source})",
+    configPath: "- Config file: {path}",
+    session: "- Current session: {id}{restored}",
+    restored: " (restored from history)",
+    approval: "- Tool approval mode: {approval}",
+    runtimeRoot: "- Runtime root: {path}",
+    sessionsDir: "- Sessions directory: {path}",
+    memoryDir: "- Memory directory: {path}",
+    localSkillsDir: "- Vanor local skills directory: {path}",
+    logsDir: "- Logs directory: {path}",
+    skillDirs: "- Skill scan directories: {dirs}",
+    skillsCount: "- Loaded skills: {count}",
+    answerContext: "- If the user asks about model, config file, session, directories, language, or approval mode, answer directly from this context.",
+    noSecrets: "- Do not reveal API keys, Authorization headers, cookies, tokens, private keys, or other secrets. Only say whether a secret is configured or redacted.",
+    terminal:
+      "Terminal capabilities: TERM={term}, viewport about {cols} columns x {rows} rows, {color}. " +
+      "Fit output to the terminal: keep lines under {cols} columns when practical; avoid code blocks / tables wider than the viewport; {ansi}split long content into sections and avoid flooding the screen.",
+    colorSupported: "supports ANSI colors / styles{trueColor}",
+    colorUnsupported: "does not support color",
+    trueColor: " (true color)",
+    ansiHint: "you may use ANSI colors to emphasize important points; ",
+    historySummary: "# Conversation History Summary\n{summary}",
+    communication: "Communication channel: {guide}",
+  },
+};

package/base/i18n/locales/zh-CN.js

@@ -0,0 +1,252 @@
+export default {
+  common: {
+    exists: "存在",
+    missing: "缺失",
+  },
+  config: {
+    errors: {
+      noDefaultModel: "未配置 llm.defaultModel",
+      noProviders: "未配置任何 llm.providers",
+      providerMissingBaseURL: 'provider "{name}" 缺少 baseURL',
+      providerMissingApiKey: 'provider "{name}" 缺少 apiKey（可用 env: 引用环境变量）',
+      approvalInvalid: "security.approval 必须为 ask | auto | deny",
+      languageInvalid: "ui.language 必须为 auto | en | zh-CN",
+      defaultModelFormat: 'llm.defaultModel 需为 "<provider>/<model>" 形式：{model}',
+      defaultProviderMissing: '默认模型引用的 provider "{name}" 不存在',
+      invalidConfig: "配置无效：{issues}",
+    },
+  },
+  index: {
+    configWizard: {
+      title: "配置 Vanor 大模型",
+      hint: "提示：apiKey 可填 env:VAR_NAME 以引用环境变量，避免明文入库。",
+      providerName: "provider 名称 [default]: ",
+      type: "类型 openai/anthropic [openai]: ",
+      baseURL: "baseURL [https://api.openai.com/v1]: ",
+      apiKey: "apiKey（或 env:VAR）: ",
+      modelId: "模型 id（如 deepseek/deepseek-v4-pro / deepseek/deepseek-v4-flash）: ",
+      saved: "已保存：{file}",
+      defaultModel: "默认模型：{model}",
+      next: "运行 vanor 开始对话。",
+    },
+    doctor: {
+      title: "Vanor doctor",
+      configFile: "配置文件: {path} [{state}]",
+      workspace: "工作区: {workspace}",
+      approval: "审批模式: {approval}",
+      autoRisk: "approval=auto 将自动执行命令，注意风险",
+      ok: "未发现配置问题。",
+      issues: "发现以下问题：",
+    },
+    chat: {
+      setupIncomplete: "尚未完成配置：",
+      runConfig: "请先运行： vanor config",
+      sessionNotFound: "未找到会话：{id}",
+      sessionListHint: "可运行 vanor sessions 查看可恢复的会话。",
+    },
+    skills: {
+      none: "（无技能）",
+    },
+    update: "通过 npm 更新： npm i -g @jpssff/vanor@latest",
+    help: {
+      usage: "用法： vanor [命令]",
+      chat: "(无命令)    启动交互对话",
+      config: "config      配置大模型 API",
+      doctor: "doctor      诊断配置与环境",
+      sessions: "sessions    列出历史会话",
+      resume: "resume [id] 恢复最近或指定会话",
+      skills: "skills      列出已加载技能",
+      update: "update      更新提示",
+      version: "version     显示版本",
+    },
+    unknownCommand: "未知命令：{cmd}（vanor help 查看用法）",
+    fatal: "致命错误：{error}",
+  },
+  cli: {
+    help: {
+      text:
+        "命令：\n" +
+        "  /help            显示帮助\n" +
+        "  /new             开启新会话\n" +
+        "  /messages        查看当前会话的历史用户消息\n" +
+        "  /compact         立即压缩上下文\n" +
+        "  /retry           重发上一条消息\n" +
+        "  /model [关键词]  查看或搜索切换模型\n" +
+        "  /language [语言] 查看或切换语言（auto | en | zh-CN）\n" +
+        "  /usage           查看本会话 token 用量\n" +
+        "  /skills          列出已加载技能\n" +
+        "  /reload          立即重载配置文件\n" +
+        "  /auto-run [off]  本次对话自动执行操作，不再逐次确认（off 恢复）\n" +
+        "  /exit            退出\n" +
+        "中断：对话进行中按 Ctrl+C 可中断当前任务。",
+    },
+    banner: "Vanor 万佑",
+    intro: "一个面向开发者的通用 CLI 智能体。输入消息开始对话，/help 查看命令。",
+    restored: "已恢复会话：{id}（{count} 条上下文消息）",
+    interruptRequested: "[已请求中断]",
+    goodbye: "再见。",
+    error: "[错误] {message}",
+    confirmMessage: "确认操作：",
+    confirmPrompt: "确认操作 [y/N] ",
+    modelMatched: "匹配到 {count} 个模型：",
+    chooseModel: "选择模型编号 [1-{count}]（回车取消） ",
+    invalidChoice: "选择无效，已取消。",
+    newSession: "已开启新会话。",
+    compactRunning: "正在压缩上下文…",
+    compactDone: "已压缩上下文。",
+    modelChanged: "已切换模型：{model}",
+    modelSwitchFailed: "切换失败：{message}",
+    searchableModels: "可搜索的模型：",
+    currentModel: "当前模型：{model}",
+    usage: "prompt {prompt} / completion {completion} / total {total}",
+    messagesNone: "（暂无用户消息）",
+    messagesHeader: "时间                 用户内容",
+    skillsNone: "（无技能）",
+    skillsTotal: "总计：{count} 个技能",
+    reloadFailed: "配置重载失败：{error}",
+    reloadDone: "配置已重载。当前模型：{model}",
+    reloadUnchanged: "配置未变化。",
+    approvalRestored: "已恢复审批模式：{approval}",
+    autoRunEnabled: "已开启自动执行：本次对话不再逐次确认操作（denylist 危险命令仍会拦截）。",
+    retryNone: "无可重发的消息。",
+    unknownSlash: "未知命令 /{cmd}，/help 查看帮助。",
+    maxIterations: "[达到最大迭代次数]",
+    aborted: "[已中断]",
+    runtimeError: "[运行错误] {message}",
+    sessionsNone: "（暂无会话）",
+    sessionRow: "{id}  {count} 条  {model}  {when}",
+    language: {
+      current: "语言：{language}（配置：{configured}，来源：{source}）",
+      changed: "语言已切换为 {language}（配置：{configured}，来源：{source}）",
+      invalid: "不支持的语言：{language}。请使用 auto、en 或 zh-CN。",
+    },
+  },
+  harness: {
+    busy: "Harness 忙碌中（phase={phase}）",
+  },
+  skills: {
+    promptIntro: "可用技能（需要时用 read_file 或 skills.read 读取对应 SKILL.md 后按说明执行；如需沉淀新流程，可用 skills.write/edit 保存到本地）：",
+    promptItem: "- {name}：{description}（详见 {path}）",
+    none: "（无技能）",
+    local: "local",
+    shared: "shared",
+    listItem: "- {name} [{scope}]：{description}\n  {path}",
+    total: "总计：{count} 个技能",
+    dirCount: "- {dir}：{count}",
+    notFound: "未找到技能：{name}",
+    localNotFound: "未找到本地技能：{name}",
+    readFailed: "读取技能失败：{message}",
+    invalidName: "name 不能为空，且需能转换为安全目录名",
+    writeNeedsContent: "write 需要 content",
+    saved: "技能已保存：{name}\n{file}",
+    saveFailed: "保存技能失败：{message}",
+    editNeedsOldText: "edit 需要 old_text",
+    oldTextNotFound: "未找到 old_text",
+    oldTextNotUnique: "old_text 出现 {count} 次，需唯一匹配",
+    modified: "技能已修改：{name}",
+    modifyFailed: "修改技能失败：{message}",
+    deleted: "技能已删除：{name}",
+    deleteFailed: "删除技能失败：{message}",
+    readNeedsName: "read 需要 name",
+    editNeedsName: "edit 需要 name",
+    removeNeedsName: "remove 需要 name",
+    unknownAction: "未知 action：{action}",
+    toolDescription: "管理 Vanor 技能。list/read 可查看已加载技能；write/edit/remove 只修改 ~/.vanor/skills 下的本地技能。",
+    paramName: "技能名；写入时会转换为安全目录名",
+    paramDescription: "write 时可写入 frontmatter description",
+    paramContent: "write 时的 SKILL.md 正文或完整 Markdown",
+    paramOldText: "edit 时用于唯一匹配的原文",
+    paramNewText: "edit 时替换为的新文本",
+  },
+  schema: {
+    expectedType: "{loc}: 期望类型 {type}",
+    enumValue: "{loc}: 取值须为 {values} 之一",
+    required: '{loc}: 缺少必填字段 "{field}"',
+  },
+  security: {
+    invalidPath: "路径无效",
+    outsideWorkspace: "路径超出工作区 {workspace}",
+    pathNotFound: "路径不存在",
+    notDirectory: "不是目录",
+  },
+  tools: {
+    describeExec: "运行命令：{command}",
+    describeWriteFile: "写入文件：{path}",
+    describeEditFile: "编辑文件：{path}",
+    describeSkills: "管理技能：{action}{name}",
+    describeGeneric: "调用工具 {name}",
+    unknownTool: "未知工具：{name}",
+    invalidArgs: "参数错误：{errors}",
+    denied: "用户或策略拒绝了该操作",
+    exception: "工具异常：{message}",
+  },
+  builtin: {
+    readFileDescription: "读取工作区内文件的文本内容，可选按行 offset/limit 截取。",
+    pathDescription: "相对工作区或绝对路径",
+    offsetDescription: "起始行（从 1 开始）",
+    limitDescription: "读取行数",
+    readFailed: "读取失败：{message}",
+    truncatedContent: "[内容过长，已截断]",
+    emptyFile: "(空文件)",
+    writeFileDescription: "写入/覆盖工作区内文件，自动创建父目录。",
+    writeFailed: "写入失败：{message}",
+    written: "已写入 {path}（{bytes} 字节）",
+    editFileDescription: "在文件中将唯一出现的 old_string 替换为 new_string。",
+    oldStringNotFound: "未找到 old_string",
+    oldStringNotUnique: "old_string 出现 {count} 次，需唯一匹配",
+    edited: "已编辑 {path}",
+    listDirDescription: "列出目录内容。",
+    emptyDir: "(空目录)",
+    execDescription: "在工作区执行 shell 命令并返回输出。受 allowlist/denylist 与审批约束。",
+    cwdDescription: "工作目录，默认工作区根",
+    timeoutDescription: "超时毫秒，默认 60000",
+    spawnFailed: "无法启动命令：{message}",
+    commandAborted: "命令被中断",
+    execFailed: "执行失败：{message}",
+    outputTruncated: "[输出已截断]",
+    noOutput: "(无输出)",
+    exitCode: "[退出码 {code}]",
+  },
+  prompt: {
+    persona:
+      "你是 Vanor（万佑），万佑智算的通用智能体。\n" +
+      "原则：自主推理与规划，调用工具完成任务；输出简洁、高情商，始终从用户真实意图出发，不啰嗦、不复述。\n" +
+      "当需要读写文件或执行命令时，直接调用相应工具，不要先用文字描述将要做的操作。\n" +
+      "工具结果可能含错误（isError），据此自行纠正后继续，不要把原始错误直接抛给用户。",
+    language: "默认回复语言：简体中文。如果用户明确要求其它语言，请遵循用户请求。",
+    channelCli: "你正通过命令行（CLI）与用户交互：默认输出适合终端的内容格式。",
+    channelDefault: "请根据用户所在的通讯渠道调整输出格式，使其在该渠道上清晰、易读。",
+    runtimeTitle: "运行环境：",
+    os: "- 操作系统：{name}（{platform}/{arch}，内核 {release}）",
+    node: "- 运行时：Node.js {version}；Vanor Agent 基于 Node.js 构建，可通过 exec 调用 node / npm 等工具",
+    shell: "- 默认 Shell：{shell}",
+    workspace: "- 工作区：{workspace}",
+    time: "- 当前时间：{time}（{timezone}，{offset}）",
+    contextTitle: "Vanor 实例上下文：",
+    currentModel: "- 当前模型：{model}",
+    provider: "- 当前 provider：{provider}",
+    uiLanguage: "- UI 语言：{language}（配置：{configured}，来源：{source}）",
+    configPath: "- 配置文件：{path}",
+    session: "- 当前会话：{id}{restored}",
+    restored: "（从历史恢复）",
+    approval: "- 工具审批模式：{approval}",
+    runtimeRoot: "- 运行时根目录：{path}",
+    sessionsDir: "- 会话目录：{path}",
+    memoryDir: "- 记忆目录：{path}",
+    localSkillsDir: "- Vanor 本地技能目录：{path}",
+    logsDir: "- 日志目录：{path}",
+    skillDirs: "- 技能扫描目录：{dirs}",
+    skillsCount: "- 已加载技能数：{count}",
+    answerContext: "- 如果用户询问模型、配置文件、会话、目录、语言或审批模式，可直接依据本上下文回答。",
+    noSecrets: "- 不要输出 API Key、Authorization、Cookie、token、私钥等敏感配置；涉及密钥时只说明是否已配置或已脱敏。",
+    terminal:
+      "终端能力：TERM={term}，可视区约 {cols} 列 × {rows} 行，{color}。" +
+      "输出请适应终端：单行尽量不超过 {cols} 列，代码块 / 表格不要超出宽度；{ansi}较长内容分段，避免一次性刷屏。",
+    colorSupported: "支持 ANSI 颜色 / 样式{trueColor}",
+    colorUnsupported: "不支持颜色",
+    trueColor: "（真彩色）",
+    ansiHint: "可用 ANSI 颜色强调重点；",
+    historySummary: "# 对话历史摘要\n{summary}",
+    communication: "通讯方式：{guide}",
+  },
+};