用途：面向外部智能体首次搭建 SearchCLI 时使用，或用于检查认证、配置档案（profile）与本地就绪状态。
前提条件：已安装 Node.js 20 或更高版本；仓库已克隆，或已通过 scripts/install.sh 安装 CLI。
主要能力（命令）： 认证：auth import-env 将当前 shell 的 VIKING_AK / VIKING_SK 导入本地安全存储；auth login 在真实终端交互采集 AK/SK；auth status 查看当前 profile、凭据来源与区域；auth use 切换 profile；auth list 列出已保存 profile。 LLM：llm login 交互采集 OpenAI 兼容的 base URL、模型与 API key，密钥存入本地安全存储；llm import-env 导入 VIKING_LLM_BASE_URL / VIKING_LLM_API_KEY / VIKING_LLM_MODEL；llm status 查看当前 LLM 提供方、模型、base URL 与密钥来源（不显示密钥）；llm logout 删除某 profile 的 LLM key。 诊断与验证：doctor 检查本地依赖、认证与配置；skill list 查看已发布技能；skill install 从本地检出安装；app status / app diagnose 检查应用就绪状态；search run / chat run 执行最小验证请求。
区域（--region 与 auth profile）：北京 cn-beijing；柔佛 ap-southeast-1。
工作流：确认 CLI 已安装后运行 auth status；当前 shell 已有 VIKING_AK / VIKING_SK 时优先 auth import-env，否则在可保持交互真实终端时运行 auth login，无法交互则让用户在当前 shell 设置变量后再 import-env；随后运行 doctor 验证环境。外部智能体安装技能用 npx skills add "<repo-url>" -y -g；仓库维护者可用 skill install all 或安装指定技能；深入调试前先用 app status 或 search/chat run 做最小运行检查。
LLM 配置：搜索调优查询生成与 LLM 相关性判定需要 OpenAI 兼容 API。不要让用户在聊天中粘贴 LLM API key。优先顺序：终端已有三个 VIKING_LLM_* 变量则运行 vs llm import-env；可保持交互终端则运行 vs llm login 并等待用户在该终端输入；无法交互则让用户在终端设置三个变量后运行 vs llm import-env。第一版仅支持 openai-compatible 协议；非密钥 LLM 元数据写入 ~/.viking/config.json，API key 存入本地安全凭据存储。
客户环境原则：假定无法获取仓库源码，仅使用已安装技能、已打包的 vs CLI（--help、命令输出、观察到的运行时行为）与用户明确提供的信息；不依赖读取本地源码或实现细节决定运行时操作；已安装 CLI 行为与技能冲突时，以 CLI 行为为准；信息不足时停止并询问用户，而非查找源码。
限制：执行任何具体 vs ... 命令前，须先查阅 vs-product-qa 确认当前命令面、所需标志、载荷字段、输入格式与允许值，之后再定参数并运行。用户已把凭据放入当前 shell 时优先 auth import-env，不要让其粘贴密钥；需要 LLM 凭据时优先 llm import-env 或 llm login。安装或分发技能前确认当前 CLI 版本满足 requires_cli。若 setup、认证、doctor 或运行检查失败，且用户询问产品概念、能力、API 字段、控制台路径、购买、计费等本工作流之外的问题，先临时转交 vs-product-qa，待获得有依据的答案后再返回。具体收费、价格与平台信息暂未提供。