KVS Factor 列表指南
介绍如何浏览项目中记录的 KVS（键值存储）factor 条目，并直接跳转到各 factor 的历史记录或最新值。
📋 概述
KVS Factor 列表页面让您在单一屏幕上浏览所选项目（CSN）中记录的 factor 条目。您可以查看代理收集的各类 factor——指标、清单、进程列表等——并直接跳转到各条目的历史记录页面或最新值页面。访问此页面需要登录。
🔍 界面构成
1. 项目选择（CSN）
在顶部的下拉框中选择要查询的项目。列表会自动填入当前登录账号可访问的项目，若会话中已保存某个项目，则默认选中该项目。
2. 执行（Run）
点击 [Run] 按钮会针对所选项目执行命令 KVSFactorList * <csn>。* 表示不限定特定 kType，而是查询所有类型的 factor。加载期间按钮显示为 Loading... 状态。
3. 结果列表
结果以表格（桌面端）或卡片（移动端）形式显示，通常包含 kType（键类型）、kKey（服务器 LSSN 或数据库 ID）、kFactor（数据分类名）等列。如果数据无法解析为表格，则按原样显示原始响应文本。
4. 行跳转按钮
factor 列会在值旁边显示两个跳转按钮。
- [List]：将该行的 kType、kKey、kFactor 保存到会话，然后跳转到 **KVS 列表页面（
/zh-CN/kvslist）**查看历史记录列表。 - [Last]：将 kType、kKey、kFactor 作为查询参数传递，跳转到 最新值页面（
/zh-CN/kvslast）。
🛠️ 使用技巧
- 更改项目后，所选值会保存到会话，因此在其他 KVS 页面中也会保持。
- 对于缺少 kType/kKey 信息的旧数据，系统在处理跳转时会将
lssn视为默认类型。
💡 注意事项
- 如果结果为空，可能是所选项目尚无已记录的 factor，或项目指定有误。
- 本页面仅供查询。关于 factor 数据的记录（KVSPut），请参阅下方的 API 参考。
API 参考
有关此功能背后的 KVS API 详细规范，请参阅专门指南。
故障排除
| 症状 | 原因 | 解决方法 |
|---|---|---|
| 被跳转回登录界面 | 会话已过期或未认证 | 重新登录后再打开页面。 |
| 项目下拉框为空 | 未检索到可访问的项目 | 检查登录状态与账号权限，然后刷新页面。 |
结果显示 No results. | 所选项目没有已记录的 factor | 确认是否选对项目，并先用 KVSPut 记录数据。 |
| 结果显示原始文本而非表格 | 响应无法解析为表格 | 检查响应内容，确认数据格式是否正确。 |
| [List]/[Last] 跳转后数据为空 | 旧数据缺少 kType/kKey，按默认值处理 | 重新记录目标 factor 或确认 kKey 值。 |
版本: 1.0
最后更新: 2026-07-22
源文件: giipv3/public/help/kvsfactorlist.zh-CN.md