fix(ostool): interpret legacy bare IP addresses as http for board server

Author: ZCShou

README.en.md

@@ -317,7 +317,7 @@ Use the TUI editor to update it:
 ostool board config
 ```
 
-`server` must be a complete URL including `http://` or `https://`; the optional `port` overrides the URL port. Project-local `.board.toml` `server` / `port` fields still apply to `ostool board run`, with precedence lower than CLI flags and higher than the global config.
+`server` should be a complete URL including `http://` or `https://`; the optional `port` overrides the URL port. For legacy LAN configurations, a bare IPv4 or IPv6 address is interpreted as `http://`; bare host names are not supported, and the removed `server_ip` field is not restored. Project-local `.board.toml` `server` / `port` fields still apply to `ostool board run`, with precedence lower than CLI flags and higher than the global config.
 
 ### Public board authentication
 

README.md

@@ -314,7 +314,7 @@ auth_mode = "disabled"
 ostool board config
 ```
 
-`server` 必须是包含 `http://` 或 `https://` 的完整 URL；可选的 `port` 会覆盖 URL 中的端口。项目级 `.board.toml` 中的 `server` / `port` 仍可用于 `ostool board run`，其优先级低于命令行参数，高于全局配置。
+`server` 应使用包含 `http://` 或 `https://` 的完整 URL；可选的 `port` 会覆盖 URL 中的端口。为兼容旧的局域网配置，裸 IPv4 或 IPv6 地址会自动补为 `http://`；不支持无 scheme 的主机名，也不恢复已移除的 `server_ip` 字段。项目级 `.board.toml` 中的 `server` / `port` 仍可用于 `ostool board run`，其优先级低于命令行参数，高于全局配置。
 
 ### 公网开发板认证
 

docs/api.md

@@ -2,7 +2,7 @@
 
 本文根据当前 `ostool` 客户端实现整理认证网关和开发板服务的调用接口；不包含 `ostool-server` 管理后台的 `/api/v1/admin/...` 接口。
 
-服务地址来自全局或项目配置中的 `board.server`（完整 URL），可被命令行 `--server` 覆盖；可选的 `board.port` 或 `--port` 用于覆盖 URL 中的端口。认证网关和 board API 使用同一个 Base URL。
+服务地址来自全局或项目配置中的 `board.server`（完整 URL），可被命令行 `--server` 覆盖；可选的 `board.port` 或 `--port` 用于覆盖 URL 中的端口。为兼容旧的局域网配置，`board.server` 为裸 IPv4 或 IPv6 地址时客户端自动补为 `http://`；无 scheme 的主机名不支持，已移除的 `server_ip` 字段也不会恢复。认证网关和 board API 使用同一个 Base URL。
 
 - `auth_mode = "required"` 时，`board.server` 必须使用 HTTPS，所有请求携带下文描述的 Bearer Token；
 - `auth_mode = "disabled"`（默认）时通常使用 HTTP，不会发送认证 Header，适合局域网直连 `ostool-server`。

ostool/src/board/global_config.rs

@@ -1,5 +1,6 @@
 use std::{
     env, fs,
+    net::IpAddr,
     path::{Path, PathBuf},
 };
 
@@ -26,8 +27,17 @@ pub struct BoardEndpoint {
 
 impl BoardEndpoint {
     pub fn new(server: &str, port: Option<u16>, auth_mode: AuthMode) -> anyhow::Result<Self> {
-        let mut base_url =
-            Url::parse(server).with_context(|| format!("invalid board server URL `{server}`"))?;
+        let server = server.trim();
+        // Before `board.server` became a complete URL, LAN configurations used a
+        // bare IP address. Keep that specific legacy form working by treating it
+        // as HTTP; host names and all new configurations must include a scheme.
+        let server_url = match server.parse::<IpAddr>() {
+            Ok(IpAddr::V4(_)) => format!("http://{server}"),
+            Ok(IpAddr::V6(_)) => format!("http://[{server}]"),
+            Err(_) => server.to_string(),
+        };
+        let mut base_url = Url::parse(&server_url)
+            .with_context(|| format!("invalid board server URL `{server}`"))?;
         if !matches!(base_url.scheme(), "http" | "https") {
             bail!("board server URL must use http or https");
         }
@@ -244,6 +254,35 @@ mod tests {
         );
     }
 
+    #[test]
+    fn resolve_endpoint_accepts_legacy_bare_ip_as_http() {
+        let config = BoardGlobalConfig {
+            server: "192.0.2.10".into(),
+            port: Some(9000),
+            auth_mode: AuthMode::Disabled,
+        };
+
+        assert_eq!(
+            config
+                .resolve_endpoint(None, None)
+                .unwrap()
+                .base_url
+                .as_str(),
+            "http://192.0.2.10:9000/"
+        );
+    }
+
+    #[test]
+    fn endpoint_wraps_legacy_bare_ipv6_address() {
+        assert_eq!(
+            super::BoardEndpoint::new("2001:db8::10", Some(9000), AuthMode::Disabled)
+                .unwrap()
+                .base_url
+                .as_str(),
+            "http://[2001:db8::10]:9000/"
+        );
+    }
+
     #[test]
     fn required_authentication_requires_https() {
         let config = BoardGlobalConfig {