162 lines
16 KiB
JSON
162 lines
16 KiB
JSON
{
|
||
"config": {
|
||
"step": {
|
||
"user": {
|
||
"title": "HA-MCP 自定义组件",
|
||
"description": "选择要添加的内容。**HA-MCP 服务器**在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant Webhook 对外提供服务——这是大多数用户需要的安装方式。它是一个独立的服务器，可完全取代其他所有安装方式（插件、Docker、uvx/PyPI、stdio）；如果运行它，就不要再同时运行其中任何一种。**HA-MCP 文件与 YAML 工具**添加特权文件和 YAML 编辑服务，仅在你启用 ha-mcp 的可选文件/YAML 工具时才需要。如果你的 ha-mcp 服务器已在别处运行（插件、Docker、uvx），则不需要服务器条目——只添加这个文件与 YAML 条目，并且仅在你使用这些工具时才添加。它适用于所有服务器类型，随时可以后续添加。",
|
||
"menu_options": {
|
||
"server": "HA-MCP 服务器（推荐）",
|
||
"tools": "HA-MCP 文件与 YAML 工具（可选）"
|
||
}
|
||
},
|
||
"tools": {
|
||
"title": "HA-MCP 文件与 YAML 工具",
|
||
"description": "设置特权文件和 YAML 配置服务。仅在你启用 ha-mcp 的可选文件/YAML 编辑工具（功能开关，默认关闭）时才需要——这适用于所有服务器类型，包括进程内的 HA-MCP 服务器。你可以随时添加或移除此条目。"
|
||
},
|
||
"server": {
|
||
"title": "HA-MCP 服务器",
|
||
"description": "这会在 Home Assistant 内部运行完整的 ha-mcp 服务器，并通过 Home Assistant Webhook 远程提供服务（可经由 Nabu Casa 或任意反向代理访问）。它是一个独立的服务器，可完全取代插件、Docker、uvx/PyPI 和 stdio 安装方式——不要与其他 ha-mcp 服务器同时运行。选择**提交**以启动它；启动后可在集成选项中更改端口、绑定方式和身份验证。"
|
||
}
|
||
},
|
||
"abort": {
|
||
"already_configured": "此条目已配置。",
|
||
"unsupported_home_assistant": "进程内 HA-MCP 服务器需要 Home Assistant {required} 或更高版本，但此实例运行的是 {installed}。你仍可将本组件的 HA-MCP File & YAML Tools 条目与以插件或 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": "相对于配置目录的目录，每个目录都授予读写权限（例如 pyscript）。路径穿越以及配置目录之外的条目会被丢弃。",
|
||
"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 插件使用 9583，因此这里默认为 9584，以便两者并存——如果你不运行该插件，任何空闲端口都可以。",
|
||
"bind_host": "谁可以直接连接到 MCP 服务器端口。默认值与插件一致：可在本地网络中访问，并以密钥路径作为凭据。选择 loopback 则仅允许来自 Home Assistant 所在主机的连接——无论哪种方式，Webhook URL 和侧边栏面板都能正常工作。",
|
||
"webhook_auth": "MCP 客户端在 Webhook URL 上如何证明自己的身份。使用密钥 URL 时，链接本身就是凭据。使用 Home Assistant 登录时，claude.ai 等客户端会以 Home Assistant 管理员账户登录（OAuth）。使用旧版 OAuth 时，此集成会签发自己的 Client ID 和 Secret，供需要它们的客户端（例如 Google Gemini Spark）粘贴使用——开启或关闭该模式需要重启 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 在此显示的是服务器的版本号（7.x）和服务器的发行说明，而不是组件自身的（1.x）。更新仍然可用，但会一直被这样错误标注。修复方法：从 HACS 中移除此仓库（你的集成设置和配置项会保留），将 homeassistant-ai/ha-mcp-integration 添加为自定义仓库，从中重新安装组件，然后重启 Home Assistant。"
|
||
},
|
||
"legacy_oauth_restart": {
|
||
"title": "请重启 Home Assistant 以应用旧版 OAuth 更改",
|
||
"description": "旧版 OAuth 身份验证模式会注册自己的 /authorize 和 /token 网页端点，而 Home Assistant 只有在完全重启时才能绑定或释放它们——无论你是刚刚开启该模式、关闭它，还是更改了它的 Client ID/Secret。请重启 Home Assistant（设置 - 系统 - 重启）以应用更改；在此之前仍保持先前的行为。"
|
||
}
|
||
},
|
||
"selector": {
|
||
"server_channel": {
|
||
"options": {
|
||
"stable": "稳定版（推荐）",
|
||
"dev": "开发版（最新构建）"
|
||
}
|
||
},
|
||
"server_webhook_auth": {
|
||
"options": {
|
||
"none": "密钥 Webhook URL（默认）",
|
||
"ha_auth": "使用 Home Assistant 登录（OAuth）",
|
||
"legacy": "旧版 OAuth（Client ID/Secret，适用于 Google Gemini Spark）"
|
||
}
|
||
},
|
||
"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": "未知"
|
||
}
|
||
}
|