7.4 KiB
配置操作与易用性
左侧菜单与资源切换
侧栏顶部的“菜单 / 资源”是互斥视图：菜单显示搜索和功能入口，资源显示完整资源树，两者不再上下分摊高度。切换只改变侧栏，不关闭当前页面或未保存表单；两个组件保持挂载，因此菜单搜索和资源展开状态不会因切换丢失。浏览器会记住最近选择的视图，未知或不可读偏好回退菜单。
桌面默认宽度为 280px，可拖拽到 240–480px；旧的较窄宽度偏好至少提升到 240px。菜单字号 14px、最小行高 44px，资源行最小 38px。调整分隔线支持左右键和 Home 恢复 280px；菜单/资源切换支持方向键、Home/End、Tab 与读屏语义。
平板保持 224px 侧栏，手机保持紧凑图标栏并垂直排列两个切换按钮，资源视图通过“展开”打开完整资源树子页面，避免挤压正文。仅新增本地界面偏好，不改变服务端数据、导航权限、项目/环境过滤或未保存更改保护。
先测试连接，再保存目标
新建和编辑目标都可以选择账号直接测试当前填写的地址、集群、代理、TLS 和凭据，不再要求先保存；已有账号凭据留空时按账号 ID 保留。结果保留草稿且不修改网关路由。此调整用于减少连接排错时反复保存配置的步骤，适用于全部协议。SSH/SFTP 新地址会核对仅本次有效的主机指纹。详见 未保存配置的连接测试。
网关账号单独编辑
原先所有账号的表单纵向排列，添加或切换账号需要反复下拉。因此账号页改为一次编辑一个账号：顶部可搜索、选择、添加及删除账号，新增后直接聚焦用户名。登录、目标、权限、公钥（SSH/SFTP）及更多设置分别显示，账号 ID 和到期设置位于“更多”。公共网关配置在“网关与访问”页编辑，账号页不再重复占用空间。
切换账号或分组保留草稿，点击“保存配置”才统一提交。校验失败时自动选择对应账号和分组，再聚焦错误字段。已用 12 个已有账号验证桌面、375×812 及 320×568 下各分组无需滚动；更小窗口、软键盘、放大字体或较长错误清单仍允许必要滚动，避免裁切内容。设计取舍及相关改动原因见 变更原因与设计记录。
就地创建资产
目标 CA、SSH 账号私钥/证书、网关公钥和代理 Kubeconfig 的资产选择框均提供新建入口。上传并保存后自动选中新资产，原配置草稿仍保留；还需保存原配置才能建立引用。取消上传或返回上层页面不会替换已保存文件。
未保存提醒与字段错误
目标、网关、连接资产和文件资产编辑器在取消、返回或离开页面时打开确认页，选择放弃更改或继续编辑。刷新和关闭浏览器使用浏览器原生提醒。草稿及密码只保存在内存，不写入浏览器存储。
保存前校验名称、地址、端口、账号、密码、来源白名单和代理必填项。错误清单可点击跳转字段，目标与网关会切换到对应页签并聚焦账号。常见服务端错误显示中文；网络或服务端异常仍保留诊断详情。保存成功后不再提示未保存。
管理 API 报错保留错误原因，并将请求地址（协议、主机及端口）、请求路径、请求方法分行显示，方便区分保存失败与保存后的其他接口刷新失败。HTTP 错误、网络失败及响应解析失败均附带请求信息；中文翻译不会丢失定位信息。诊断不追加查询参数、请求体、Cookie 或认证头。例如：
网络请求失败，请检查连接
请求地址：http://127.0.0.1:1828
请求路径：/api/v1/assets/asset-id
请求方法：PUT
连接示例与启动检查
网关「更多操作 → 连接示例」可选择可用网关账号、填写客户端可访问地址，并切换 Linux/macOS 或 PowerShell 命令。通配监听地址需要填写实际地址。复制命令不会包含密码，禁用或到期账号不能选择。
「更多操作 → 启动检查」列出缺失目标、账号映射、资产引用、SSH 指纹等问题，点击修复入口可跳转到对应配置或指纹探测。检查通过后可启动；启动仍会检查端口占用等实际运行条件。配置检查不会连接真实目标。
Kubernetes 辅助填写
选择 Kubeconfig 资产后读取 Context 列表并自动查询命名空间，命名空间仅从下拉框选择，失败时可点击「查询命名空间」重试。切换 Context 后自动刷新命名空间列表；切换命名空间后清空旧资源选择，再查询并选择 pod/service/deployment/statefulset。查询只执行读取请求，命名空间自动分页读取，资源每类最多返回 200 项，单次查询期限为 8 秒。权限不足或集群不可达时显示错误并支持重试，命名空间和资源不提供手动输入。
自动发现暂不支持 Kubeconfig 代理，显示原因后允许手工输入。上传成资产或内联保存的 Kubeconfig 必须自包含，不能引用 linkport 主机上的 CA、客户端证书/密钥或 Token 文件，也不能使用 exec/auth-provider 登录插件；该校验同样作用于正式连接，避免绕过发现步骤执行本机命令。显式本地 Kubeconfig 文件路径及其中的登录插件仍保留。测试采用隔离的 Kubernetes API 模拟服务，不代表已验证真实集群。
资产识别与引用跳转
资产显示上传文件名、更新时间及适用的摘要：指纹、证书主体、有效期。旧资产没有可靠的上传历史时显示未知，不推测历史时间。证书到期检查纳入监控告警。摘要不包含私钥或令牌内容。
新建、编辑及就地创建资产时可填写多行备注（可选，最多 2000 个字符），资产列表中可查看。仅修改备注不会改变文件或上传时间；备注随加密配置备份和多端同步保存。
资产引用的代理、目标和网关名称可点击，你可直接打开相应配置。目标和网关自身可在运行中保存；共享文件资产和连接资产仍按完整引用影响范围限制运行中修改及删除。
记住列表筛选
项目与环境以及当前页面的列表条件统一显示在页面顶部筛选区。目标名称/主机/账号备注或用户名搜索、分组与协议，网关搜索与全部 11 种协议，拖拽连线协议，代理名称与类型，以及审计条件不再散落在内容卡片或画板工具栏中。筛选状态按原有边界保存在当前浏览器，重置筛选可清除条件；仅保存非敏感筛选值，不同浏览器之间不同步。窄屏筛选控件按整行排列，避免文字或输入框相互遮挡。
2026-09-21 工作区与小屏回归修正
资源搜索输入框使用正确的 combobox 语义，Ctrl/⌘ K 后可用方向键和 Enter 打开资源。小屏编辑子页面顶部的工作区标签选择器可收缩，返回按钮保持同行，避免占用账号表单高度；来源白名单说明精简但仍明确账号与网关限制须同时满足。
回归覆盖 320×568 账号登录、目标、权限、更多页，以及添加和跨账号错误聚焦；URL 参数自动测试/保存、资源导航和列设置也纳入验证。复选框测试操作可见标签，保留最终选中状态断言；表头检查使用组件实际 DOM。原因及实际验证见 变更记录 和 测试记录。