fix(pc-list): surface custom HTTP/HTTPS ports in UI

entry/src/main/ets/components/ComputerCard.ets

@@ -9,6 +9,7 @@
  */
 
 import { ObservableComputer } from '../viewmodel/ComputerViewModel';
+import { formatDisplayAddress } from '../model/ComputerInfo';
 import { AppColors, AppSizes, AppSpacing, AppAnimation, AppShadows, StatusColors } from '../common/Theme';
 import { LengthMetrics, ColorMetrics } from '@kit.ArkUI';
 
@@ -299,8 +300,8 @@ export struct ComputerCard {
         .textOverflow({ overflow: TextOverflow.Ellipsis })
         .width('100%')
 
-      // 第二行：IP 地址（优先显示手动地址，保持稳定；否则显示轮询活跃地址）
-      Text(this.computer.manualAddress || this.computer.address)
+      // 第二行：IP 地址（优先显示手动地址，保持稳定；否则显示轮询活跃地址；自定义端口时附带 :port）
+      Text(formatDisplayAddress(this.computer))
         .fontSize(AppSizes.FontBody)
         .fontColor(AppColors.TextSecondary)
         .fontFamily('monospace')

entry/src/main/ets/model/ComputerInfo.ets

@@ -8,7 +8,8 @@
  * (at your option) any later version.
  */
 
-import { isLanIPv4Address, isLanAddress, isIPv6Address, isPublicAddress, detectAddressType, AddressType, getAddressTypeLabel } from '../utils/NetHelper';
+import { DEFAULT_HTTP_PORT, MAX_PORT } from '../common/NetworkConstants';
+import { isLanIPv4Address, isLanAddress, isIPv6Address, isPublicAddress, detectAddressType, AddressType, getAddressTypeLabel, parseAddressAndPort, formatAddressForUrl } from '../utils/NetHelper';
 
 /**
  * 电脑信息模型
@@ -134,6 +135,25 @@ export function getAddressNetworkLabel(address: string | undefined): string {
   return getAddressTypeLabel(address);
 }
 
+/**
+ * 展示用地址：自定义 HTTP 端口时附加 :port，默认端口（47989）不附加
+ * 端口实际存储在 httpPort 字段，地址字段只存主机名，直接展示会让用户
+ * 以为自定义端口没生效
+ */
+export function formatDisplayAddress(computer: NvHttpHost): string {
+  const selected = parseAddressAndPort(computer.manualAddress || computer.address);
+  if (!selected.host) {
+    return '';
+  }
+  // 与 NvHttp 构造器同一优先级：地址内嵌端口优先，其次 httpPort 字段
+  const port = selected.port || computer.httpPort;
+  if (port && port !== DEFAULT_HTTP_PORT && port > 0 && port <= MAX_PORT) {
+    // 裸 IPv6 附端口前必须加方括号，否则 "fe80::1:30000" 有歧义
+    return `${formatAddressForUrl(selected.host)}:${port}`;
+  }
+  return selected.host;
+}
+
 /**
  * 判断计算机是否有可用的 LAN 地址
  */

entry/src/main/ets/utils/NetworkErrorClassifierSelfCheck.ets

@@ -24,7 +24,7 @@ import {
   parseAddressAndPort,
   parseRtspSessionHost,
 } from './NetHelper';
-import { selectBestAddress } from '../model/ComputerInfo';
+import { formatDisplayAddress, selectBestAddress } from '../model/ComputerInfo';
 import { ConnectionPath, ConnectionPathService } from '../service/network/ConnectionPathService';
 
 const TAG = 'NetworkSelfCheck';
@@ -132,6 +132,7 @@ export class NetworkErrorClassifierSelfCheck {
     failed += NetworkErrorClassifierSelfCheck.runConnectionPathCases();
     failed += NetworkErrorClassifierSelfCheck.runWakeOnLanCases();
     failed += NetworkErrorClassifierSelfCheck.runAddressSelectionCases();
+    failed += NetworkErrorClassifierSelfCheck.runDisplayAddressCases();
 
     if (failed === 0) {
       hilog.info(DOMAIN, TAG, 'network self-check passed');
@@ -402,6 +403,120 @@ export class NetworkErrorClassifierSelfCheck {
     return failed;
   }
 
+  private static runDisplayAddressCases(): number {
+    let failed = 0;
+    const cases: StringCase[] = [
+      {
+        name: 'custom port appended to manual address',
+        actual: formatDisplayAddress({
+          address: '192.168.1.5',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: 'ddns.example.com',
+          serverCert: '',
+          httpPort: 47990,
+        }),
+        expected: 'ddns.example.com:47990',
+        reason: '自定义端口必须可见，否则用户以为端口没生效',
+      },
+      {
+        name: 'custom port appended to active address',
+        actual: formatDisplayAddress({
+          address: '192.168.1.5',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+          httpPort: 30000,
+        }),
+        expected: '192.168.1.5:30000',
+        reason: '无手动地址时回落到活跃地址仍要带端口',
+      },
+      {
+        name: 'default port omitted',
+        actual: formatDisplayAddress({
+          address: '192.168.1.5',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+          httpPort: 47989,
+        }),
+        expected: '192.168.1.5',
+        reason: '默认端口不显示，避免噪音',
+      },
+      {
+        name: 'no port',
+        actual: formatDisplayAddress({
+          address: 'sunshine.local',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+        }),
+        expected: 'sunshine.local',
+        reason: '自动发现的主机没有自定义端口',
+      },
+      {
+        name: 'address embedded port wins over httpPort',
+        actual: formatDisplayAddress({
+          address: '192.168.1.5:30000',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+          httpPort: 47990,
+        }),
+        expected: '192.168.1.5:30000',
+        reason: '对齐 NvHttp 构造器：地址内嵌端口优先，不重复拼接',
+      },
+      {
+        name: 'bare IPv6 host bracketed when port appended',
+        actual: formatDisplayAddress({
+          address: 'fe80::1',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+          httpPort: 30000,
+        }),
+        expected: '[fe80::1]:30000',
+        reason: '裸 IPv6 附端口必须加方括号，避免歧义',
+      },
+      {
+        name: 'invalid port ignored',
+        actual: formatDisplayAddress({
+          address: '192.168.1.5',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+          httpPort: 99999,
+        }),
+        expected: '192.168.1.5',
+        reason: '超出范围的端口不拼接',
+      },
+      {
+        name: 'empty fallback',
+        actual: formatDisplayAddress({
+          address: '',
+          localAddress: '',
+          remoteAddress: '',
+          manualAddress: '',
+          serverCert: '',
+        }),
+        expected: '',
+        reason: '无任何地址时返回空字符串',
+      },
+    ];
+
+    for (const c of cases) {
+      failed += NetworkErrorClassifierSelfCheck.expectEqual('formatDisplayAddress', c.name, c.actual, c.expected, c.reason);
+    }
+    NetworkErrorClassifierSelfCheck.logGroupResult('formatDisplayAddress', failed);
+    return failed;
+  }
+
   private static expectEqual(scope: string, name: string, actual: Comparable, expected: Comparable, reason: string): number {
     if (actual === expected) {
       return 0;

entry/src/main/ets/viewmodel/PcListActions.ets

@@ -610,7 +610,7 @@ export class PcListActions {
       `UUID: ${computer.uuid}`,
       ...addressLines,
       `MAC 地址: ${computer.macAddress || '未知'}`,
-      `HTTPS 端口: ${NvHttp.DEFAULT_HTTPS_PORT}`,
+      `HTTPS 端口: ${info.httpsPort || NvHttp.DEFAULT_HTTPS_PORT}`,
       `HTTP 端口: ${info.httpPort || NvHttp.DEFAULT_HTTP_PORT}`,
     ].join('\n');