技能名称：hipc_config_manager HIPC 配置管理\r

\r

技能描述\r

此技能是 HIPC 系列技能的核心前置组件，用于管理 API 密钥（hipc_secret）的生命周期。\r 它具备检查、设置和格式校验三种能力，确保在执行任何业务查询前，系统拥有合法且格式正确的访问凭证。\r \r

⚠️ 强制前置检查 (Critical Pre-check)\r

在调用任何 HIPC 业务技能（如查询电脑列表、统计数据）之前，你必须先调用本技能！\r

1. 第一步：调用 hipc_config_manager，设置参数 action="check"。\r
2. 判断：\r
   • 如果返回 status: "error"（即密钥缺失），立即停止后续业务操作，直接向用户发送一条消息，提示需要配置密钥。\r
   • 严禁在密钥缺失的情况下调用其他 HIPC 技能。\r
   • 严禁陷入死循环检查，检查失败一次后必须反馈给用户。\r
   • 只有当返回 status: "success" 时，才允许继续执行用户请求的业务逻辑。\r \r

核心逻辑与依赖\r

本技能通过读写本地文件 hipc_config.json 来持久化存储密钥。\r

1. 检查模式 (check)：\r
   • 读取 hipc_config.json 文件。\r
   • 验证 hipc_secret 字段是否存在且非空。\r
2. 设置模式 (set)：\r
   • 接收用户提供的 secret 和 env。\r
   • 格式校验：在保存前，脚本会自动校验密钥格式（必须符合 数字_字符串 的格式，例如 35097_y2GX...）。\r
   • 如果格式错误，脚本将返回错误信息，不会写入文件。\r
   • 如果格式正确，将其写入 hipc_config.json 文件，覆盖旧值。\r \r

参数定义\r

• action (String, 必填): \r
  • 操作类型，决定脚本的行为。\r
  • 可选值："check"（检查配置）或 "set"（保存配置）。\r
• secret (String, 可选): \r
  • 仅在 action="set" 时必填。\r
  • 用户提供的 HIPC API 密钥字符串。\r
• env (String, 可选):\r
  • 环境，决定脚本用哪个环境 \r
  • 仅在 action="set" 时使用，指定要配置的环境。\r
  • 默认值为 "prod"。\r
  • 可选值："prod"（生产环境）或 "dev"（开发环境/测试环境）。\r \r

调用示例\r

\r 场景 A：业务前置检查（配置存在）\r

• 用户：“查一下电脑列表”\r
• AI 思考：先检查环境配置是否就绪。\r
• 动作：调用 hipc_config_manager，参数 action="check"。\r
• 结果：返回 status: "success"。\r
• 后续：AI 继续调用 hipc_computer_list 技能。\r \r 场景 B：业务前置检查（配置缺失）\r
• 用户：“昨天的运行时长是多少”\r
• AI 思考：先检查环境配置。\r
• 动作：调用 hipc_config_manager，参数 action="check"。\r
• 结果：返回 status: "error"。\r
• 后续：AI 不调用统计技能，直接回复用户：“检测到您尚未配置 HIPC 密钥，无法查询数据。请提供您的密钥。”\r \r 场景 C：用户主动配置密钥（格式正确）\r
• 用户：“我的密钥是 35097_y2GX52eDGNdgaM，帮我保存一下”\r
• AI 思考：用户提供了密钥，需要调用设置模式。\r
• 动作：调用 hipc_config_manager，参数 action="set", secret="35097_y2GX52eDGNdgaM", env="prod"。\r
• 结果：密钥被写入文件，返回 status: "success"。\r
• 后续：AI 回复用户：“密钥已保存！现在可以开始查询了。”\r \r 场景 D：用户配置密钥（格式错误）\r
• 用户：“帮我保存密钥，是 sk-123456”\r
• AI 思考：用户提供了密钥，调用设置模式。\r
• 动作：调用 hipc_config_manager，参数 action="set", secret="35097_y2GX52eDGNdgaM", env="prod"。\r
• 结果：脚本检测到格式错误（缺少 数字_ 前缀），返回 status: "error"。\r
• 后续：AI 回复用户：“您提供的密钥格式不正确。HIPC 密钥通常以 数字_ 开头（例如 35097_xxxxx），请检查后重新提供。”\r \r

执行命令\r

python scripts/main.py --action={{action}}{{#if secret}} --secret={{secret}}{{/if}}{{#if env}} --env={{env}}{{/if}}\r