用途：weknora 是驱动 WeKnora RAG 服务器的 agent-first CLI，每个命令输出统一 JSON 信封并返回类型化退出码，便于按机器可读结果分支，而非解析文本。使用任何任务型 weknora-* 技能前应先阅读本基础技能。
认证：agent 通常可跳过 profile，直接设置 WEKNORA_API_KEY（或 WEKNORA_TOKEN）与 WEKNORA_HOST 实现无状态、零磁盘认证。持久化 profile 用法须先注册再看登录：weknora profile add prod --host https://kb.example.com --use，然后 echo "$WEKNORA_API_KEY" | weknora auth login --with-token；auth status 验证身份。auth login 不接受 --host/--name。
知识库选择：--kb 接受名称或 UUID，解析顺序为 --kb → WEKNORA_KB_ID → 目录链接（weknora link --kb X）→报错。search * 与破坏性 --all 操作必须显式指定 --kb。新建 KB 须绑定 embedding model 才可检索，可用 kb create --embedding-model <m> --chat-model <m> 一步创建，或用 kb config set 事后绑定。
输出契约：默认 --format json，含 ok、data、meta、error、profile 字段；error.type 为稳定类型码，可用 --jq 过滤。多项目命令以退出码为准。
退出码：0 成功；1 local/unclassified；2 参数校验；3 认证；4 资源不存在；5 input.*；6 限流；7 服务端/网络；10 需确认的破坏性操作；124 超时；130 取消。
破坏性写入：未加 -y 时返回退出码 10 与 input.confirmation_required，须向用户展示并取得明确批准后才可重跑 -y，不可自行添加。
预览：任何变更命令支持 --dry-run，输出 meta.plan，零副作用。
链式调用：变更命令在 data.id 返回新资源 id。
资源模型：kb、doc、chunk、session、message、agent、model、search、chat、api、link/unlink、mcp serve。chat 为一次性 KB 问答，session ask --agent 调用自定义智能体，search chunks 为无 LLM 原始检索。
CLI 与 MCP：自行脚本控制用 CLI（支持 dry-run、退出码 10、全部动词）；IDE 宿主智能体可用 weknora mcp serve 暴露 kb_list、search_chunks、chat 等工具，MCP 工具只接受原始 id。
自帮助：weknora <command> --help；设 WEKNORA_AGENT_HELP=1 时输出 JSON。
限制：资料未提供价格、平台支持、性能指标等细节，暂未提供。