169 lines
16 KiB
JSON
169 lines
16 KiB
JSON
{
|
||
"config": {
|
||
"step": {
|
||
"user": {
|
||
"title": "HA-MCP 自定义组件",
|
||
"description": "选择要添加的内容。**HA-MCP Server** 在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant webhook 将其暴露——这是大多数人想要的安装方式。它是一个独立的服务器，可完全替代所有其他安装方法：App (add-on)、Docker、uvx/PyPI、stdio；如果您运行了它，请勿同时运行其他安装方式。**HA-MCP File & YAML Tools** 有两个作用。如果您的 ha-mcp server 运行在 Home Assistant 外部（app、Docker、uvx/PyPI、stdio），此条目还可为该服务器提供其无法从外部访问的进程内组件功能（快速进程内搜索、配置条目元数据、注册表支持的读取），因此非常值得添加到每个外部安装中，并且它还是 ha-mcp 的可选文件/YAML 工具所使用的特权文件与 YAML 编辑服务的访问控制关卡。如果您改为添加 HA-MCP Server 条目，该条目已提供这些共享功能，因此该第二个条目此时仅用作可选文件/YAML 工具的访问控制关卡。它适用于所有服务器类型，并且可以随时在以后添加。",
|
||
"menu_options": {
|
||
"server": "HA-MCP 服务器（推荐）",
|
||
"tools": "HA-MCP 文件与 YAML 工具（可选）"
|
||
}
|
||
},
|
||
"tools": {
|
||
"title": "HA-MCP 文件与 YAML 工具",
|
||
"description": "设置特权文件和 YAML 配置服务，这些服务受控于 ha-mcp 的可选文件/YAML 编辑工具（功能标志，默认关闭）——这适用于所有服务器类型，包括进程内的 HA-MCP Server。如果您的 ha-mcp server 运行在 Home Assistant 外部，此条目还会为其提供无法从外部访问的进程内组件功能（快速进程内搜索、配置条目元数据、注册表支持的读取），即使关闭文件/YAML 工具，这些功能也非常值得拥有。您可以随时添加或删除此条目。"
|
||
},
|
||
"server": {
|
||
"title": "HA-MCP 服务器",
|
||
"description": "这会在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant Webhook 将其远程公开（可通过 Nabu Casa 或任何反向代理访问）。这是一个独立的服务器，可完全替代 app (add-on)、Docker、uvx/PyPI 和 stdio 安装方式——请勿将其与其他 ha-mcp 服务器同时运行。选择**提交**以启动它；您随后可以在集成选项中更改端口、绑定和身份验证。"
|
||
}
|
||
},
|
||
"abort": {
|
||
"already_configured": "此条目已配置。",
|
||
"unsupported_home_assistant": "进程内的 HA-MCP Server 需要 Home Assistant {required} 或更高版本，但此实例运行的是 {installed}。您仍然可以将此组件的 HA-MCP File & YAML Tools 条目与作为 app (add-on) 或 Docker 容器运行的外部 ha-mcp 服务器配合使用。"
|
||
}
|
||
},
|
||
"options": {
|
||
"step": {
|
||
"tools_info": {
|
||
"title": "HA-MCP 文件与 YAML 工具",
|
||
"description": "配置 ha-mcp 可选文件/YAML 工具所使用的特权文件和 YAML 编辑服务。这些设置也会出现在 ha-mcp 服务器自身的设置界面中，并实时生效，无需重启。不可覆盖的拒绝底线仍会阻止敏感路径（例如 .storage）和信任边界键（homeassistant、http、frontend、lovelace）。",
|
||
"data": {
|
||
"allowed_dirs": "额外文件路径",
|
||
"extra_yaml_keys": "额外的 YAML 可写键"
|
||
},
|
||
"data_description": {
|
||
"allowed_dirs": "相对于 config 目录的路径，包括诸如 sensor.yaml 的准确文件名，或 /share、/media、/ssl 和 /backup 下的路径。每个条目都会被授予对该路径及其中任何内容的读写权限；请输入每个路径作为单独的列表项。条目按字面量匹配，不支持诸如 * 的通配符。路径遍历和其他不允许的路径将被丢弃。",
|
||
"extra_yaml_keys": "除内置键外，ha_config_set_yaml 还可写入的顶层键，适用于本安装中以 YAML 为主的集成（例如 alert2）。信任边界键会被丢弃。"
|
||
}
|
||
},
|
||
"init": {
|
||
"title": "HA-MCP 服务器",
|
||
"description": "配置 HA-MCP 服务器。{panel_hint}此处的更改在保存时应用。\n\n{versions}\n\n{connect_url}\n\n{oauth_creds}",
|
||
"data": {
|
||
"channel": "发布通道",
|
||
"auto_update": "服务器自动更新",
|
||
"server_port": "MCP 服务器监听端口",
|
||
"bind_host": "网络访问",
|
||
"webhook_auth": "身份验证模式",
|
||
"oauth_client_id_override": "旧版 OAuth：自定义 Client ID（可选）",
|
||
"oauth_client_secret_override": "旧版 OAuth：自定义 Client Secret（可选）",
|
||
"oauth_regenerate": "旧版 OAuth：立即重新生成 Client ID/Secret",
|
||
"pip_spec": "开发者：ha-mcp 软件包覆盖",
|
||
"server_url": "Home Assistant URL（高级）",
|
||
"external_url": "外部 URL（可选）",
|
||
"webhook_id_override": "自定义 Webhook 密钥（可选）",
|
||
"secret_path_override": "自定义直连路径（可选）",
|
||
"regenerate_secrets": "立即重新生成连接密钥",
|
||
"enable_webhook": "通过 Webhook 远程访问",
|
||
"enable_llm_api": "对话智能体 LLM API",
|
||
"llm_api_exposure": "对话智能体工具暴露方式",
|
||
"enable_startup_notification": "启动通知",
|
||
"enable_sidebar_panel": "侧边栏设置面板"
|
||
},
|
||
"data_description": {
|
||
"channel": "稳定版安装最新的稳定发行版；开发版安装最新的开发构建。启用自动更新后，重新加载或重启以及定期检查都会安装所选通道的最新构建。下方的开发者软件包覆盖优先级更高，并会禁用自动更新。",
|
||
"auto_update": "启用时，所选通道的最新发行版会自动安装——在重新加载或重启时，以及通过定期检查。关闭时，服务器会保持当前已安装的版本，直到您重新启用此项。它仅控制 ha-mcp 服务器软件包；HA-MCP 自定义组件自身的更新仍通过 HACS 进行。",
|
||
"server_port": "此服务器监听的端口。ha-mcp app (add-on) 使用 9583，因此默认设置为 9584 以允许两者并存——如果您不运行该 app (add-on)，任何空闲端口均可。",
|
||
"bind_host": "谁可以直接连接到 MCP 服务器端口。默认值与 app (add-on) 匹配：可在本地网络上访问，以机密路径作为凭据。选择 loopback 仅允许来自 Home Assistant 本机本身的连接——无论哪种方式，Webhook URL 和侧边栏面板都可以正常工作。",
|
||
"webhook_auth": "MCP 客户端如何在 Webhook URL 处验证身份。使用秘密 URL 时，链接本身就是唯一的凭据——OAuth 仍会为使用它的客户端运行，但每次登录都会自动批准：无需登录，也无需客户端 ID 或密钥。使用 Home Assistant 登录时，claude.ai 等客户端会使用 Home Assistant 管理员账户登录 (OAuth)。使用旧版 OAuth 时，此集成会运行自己的登录服务，并颁发客户端 ID 和密钥以粘贴到需要它们的客户端中——可能需要重启 Home Assistant 才能完全启用或禁用它。",
|
||
"oauth_client_id_override": "替换自动生成的旧版 OAuth Client ID。留空则保留当前值。仅在身份验证模式设为旧版 OAuth 时使用。",
|
||
"oauth_client_secret_override": "替换自动生成的旧版 OAuth Client Secret。留空则保留当前值。仅在身份验证模式设为旧版 OAuth 时使用。",
|
||
"oauth_regenerate": "一次性操作：为旧版 OAuth 模式生成新的 Client ID 和 Secret。它只有在修复提示所要求的 Home Assistant 重启之后才会生效——在您重启之前，原有的 Client ID 和 Secret 仍然有效，新的尚未启用。同时会清空上面两个覆盖字段。",
|
||
"pip_spec": "请留空。仅用于测试特定的 ha-mcp 构建（例如固定到某个预发行版）；它会覆盖发布通道，并在清空之前禁用自动更新。",
|
||
"server_url": "进程内服务器用于访问您的 Home Assistant 的 URL（通常就是此实例本身）。留空则根据此实例的端口和 SSL 设置推导；仅在服务器需要走其他路由时才设置。",
|
||
"external_url": "作为主要连接 URL 显示——当 Home Assistant 位于您自己的域名或反向代理之后时使用。请输入包含协议在内的完整基础地址。它必须直接指向 Home Assistant——在浏览器中打开它应能到达您的 HA 登录页面——并且不能包含 :8123 之类的端口（任何端口都不行），否则远程 MCP 客户端将无法访问。留空则自动使用 Nabu Casa / 本地地址。",
|
||
"webhook_id_override": "替换连接 URL（/api/webhook/...）中随机生成的 Webhook 密钥。该 URL 就是凭据——请使用足够长、难以猜测的值。留空则保留当前值。",
|
||
"secret_path_override": "替换在服务器端口上用于直连的随机路径。规则相同：该路径就是凭据。留空则保留当前值。",
|
||
"regenerate_secrets": "一次性操作：生成新的随机 Webhook 密钥和直连路径，并立即使旧的连接 URL 失效。同时会清空上面两个覆盖字段。",
|
||
"enable_webhook": "关闭以进入仅本地模式：完全不注册 Home Assistant Webhook，因此任何一方——包括 Nabu Casa——都无法通过 Home Assistant 访问服务器。服务器端口直连和侧边栏面板仍可继续使用。",
|
||
"enable_llm_api": "向 Home Assistant 对话智能体（OpenAI、Google、Ollama 等）提供完整工具集：启用后，智能体可在“控制 Home Assistant”下选择“HA-MCP Server”，并在 Assist 聊天和语音中使用这些工具。启用只是让它可供选择——在您为某个智能体选中它之前，不会暴露任何内容。使用指南：{llm_api_docs_url}",
|
||
"llm_api_exposure": "提供给对话智能体的工具集形态。工具搜索（默认）可让智能体的上下文保持精简：一个包含固定工具以及搜索/执行元工具的紧凑 API。完整目录会直接列出每个已暴露的工具——更适合大上下文模型。两者会将二者并列注册，让每个智能体在“控制 Home Assistant”下各自选择。按工具的暴露设置在 HA-MCP 设置面板中管理；详情：{llm_api_docs_url}",
|
||
"enable_startup_notification": "每次服务器启动时显示通知，指向仅管理员可见的设置界面。关闭则静默启动——连接 URL 仍会出现在 Home Assistant 日志中。",
|
||
"enable_sidebar_panel": "在侧边栏中显示 HA-MCP 设置面板（仅管理员）。关闭则移除侧边栏条目——服务器选项仍可在此界面中使用。"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"issues": {
|
||
"server_start_failed": {
|
||
"title": "HA-MCP 进程内服务器启动失败",
|
||
"description": "无法在 Home Assistant 内部启动 HA-MCP 进程内服务器：\n\n{detail}\n\n请检查 Home Assistant 日志，然后重新加载该集成（或先修复根本问题再重新加载）以重试。"
|
||
},
|
||
"server_package_install_failed": {
|
||
"title": "无法安装 HA-MCP 进程内服务器软件包",
|
||
"description": "为进程内服务器安装 ha-mcp 软件包失败：\n\n{detail}\n\n请解决上述兼容性或安装问题，然后重新加载该集成以重试。"
|
||
},
|
||
"component_outdated": {
|
||
"title": "请通过 HACS 更新 HA-MCP 自定义组件",
|
||
"description": "已安装的 ha-mcp 服务器需要 HA-MCP 自定义组件 {required} 或更高版本，但您的版本是 {installed}。请通过 HACS 更新组件（打开 HA-MCP 自定义组件条目；如果尚未显示更新，请使用“Update information”），然后重启 Home Assistant。在此期间服务器仍会继续运行，但在组件更新之前，某些较新的功能可能无法使用。"
|
||
},
|
||
"server_update_held": {
|
||
"title": "HA-MCP 服务器更新正在等待组件更新",
|
||
"description": "ha-mcp 服务器 {latest} 已可用，但该发行版同时更新了 HA-MCP 自定义组件（更新至 {shipped}；您正在运行 {running}）。为避免启动一个当前组件从未测试过的服务器版本，服务器自动更新将暂缓，直到组件完成更新。\n\n请通过 HACS 更新组件（打开 HA-MCP 自定义组件条目；如果尚未显示更新，请使用“Update information”），然后重启 Home Assistant——之后服务器更新会自动安装。若仍要立即安装服务器更新，请在 HA-MCP 服务器更新实体上点击“安装”。"
|
||
},
|
||
"legacy_hacs_source": {
|
||
"title": "组件安装自旧版仓库",
|
||
"description": "HACS 正在跟踪此组件的主 ha-mcp 服务器仓库，因此 HACS 在此处显示的是服务器的版本号和发布说明，而非组件自身的 (2.x)。更新仍可正常工作，但会一直显示错误的标签。修复方法：从 HACS 中移除此仓库（您的集成设置和配置条目将保留），将 homeassistant-ai/ha-mcp-integration 添加为自定义仓库，从中重新安装组件，然后重启 Home Assistant。"
|
||
},
|
||
"legacy_oauth_restart": {
|
||
"title": "重启 Home Assistant 以应用旧版 OAuth 设置",
|
||
"fix_flow": {
|
||
"step": {
|
||
"confirm": {
|
||
"title": "重启 Home Assistant？",
|
||
"description": "提交此表单将重启 Home Assistant 并应用旧版 OAuth 设置。\n\n点击 <strong>提交</strong> 立即重启。"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"selector": {
|
||
"server_channel": {
|
||
"options": {
|
||
"stable": "稳定版（推荐）",
|
||
"dev": "开发版（最新构建）"
|
||
}
|
||
},
|
||
"server_webhook_auth": {
|
||
"options": {
|
||
"none": "密钥 Webhook URL（默认）",
|
||
"ha_auth": "使用 Home Assistant 登录（OAuth）",
|
||
"legacy": "旧版 OAuth（此集成颁发客户端 ID/密钥供粘贴）"
|
||
}
|
||
},
|
||
"llm_api_exposure": {
|
||
"options": {
|
||
"tool_search": "工具搜索（紧凑，默认）",
|
||
"full": "完整目录",
|
||
"both": "两者（按智能体选择）"
|
||
}
|
||
}
|
||
},
|
||
"entity": {
|
||
"update": {
|
||
"server_update": {
|
||
"name": "更新"
|
||
}
|
||
}
|
||
},
|
||
"common": {
|
||
"connect_direct_access": "从 Home Assistant 所在主机直接访问：{url}",
|
||
"connect_local_lan": "本地/局域网（当网络访问为“Local network”时）：{url}",
|
||
"connect_remote_url": "远程连接 URL：{url}",
|
||
"connect_urls_label": "连接 URL：",
|
||
"connect_urls_pending": "服务器启动后，连接 URL 将显示在此处（以及 Home Assistant 日志中）。",
|
||
"connect_webhook_disabled": "通过 Webhook 远程访问已关闭（仅本地模式）。",
|
||
"oauth_creds_pending": "服务器启动后，Client ID 和 Client Secret 将显示在此处。",
|
||
"oauth_not_serving": "旧版 OAuth 尚未启用这些凭据——请在 Home Assistant 提示时重启以激活它们。",
|
||
"oauth_select_legacy_mode": "将上面的身份验证模式设为旧版 OAuth 并保存，以生成 Client ID 和 Client Secret。",
|
||
"panel_hint": "打开 [HA-MCP 设置面板](/ha-mcp) 以管理工具和服务器设置。",
|
||
"tools_module_installed": "Beta/高级文件与 YAML 工具模块（可选）：已安装",
|
||
"tools_module_not_installed": "Beta/高级文件与 YAML 工具模块（可选）：未安装——请在此集成页面上点击“添加条目”并选择“HA-MCP File & YAML Tools”",
|
||
"tools_module_not_loaded": "Beta/高级文件与 YAML 工具模块（可选）：已安装但未加载——请在此集成页面上启用或重新加载“HA-MCP File & YAML Tools”条目",
|
||
"version_line": "组件 {component_version} - 服务器 ha-mcp {server_version}（{channel} 通道）",
|
||
"version_not_installed": "尚未安装",
|
||
"version_unknown": "未知"
|
||
}
|
||
}
|