1粘贴老师发来的安装指令
老师会从后台生成你专属的一条指令。直接粘贴进 Codex 或 WorkBuddy，自动绑定账号并安装 nkk-step1 至 nkk-step5。指令 24 小时内一次有效，不用再手填 Key。
需要 Python 3.8+，并至少打开一次客户端。安装完成后新建会话；如果只有旧版 Key，仍可用下面的手动安装方式。
也可以在终端粘贴下面命令下载并安装：
出现「授权 Key」提示时再粘贴 Key，输入不会显示。不要把 Key 发给 AI 或写进安装命令。
把五步方法，接入你的 AI 工作台。
完成一次安装，以后直接说出你的业务任务。系统按需获取对应工作流，分析和产物保留在你自己的工作环境中。
2检查接入状态
安装成功后，运行检查命令。它会检查服务器授权、入口技能和脚本依赖。
依赖缺失时按提示处理。检查通过只代表接入与环境就绪，业务结果仍需每一步实际校验。
3选择对应 Skill，执行本地任务
五个入口：nkk-step1 产品分析、nkk-step2 市场洞察、nkk-step3 策略、nkk-step4 Brief、nkk-step5 复盘。Codex CLI 输入 $nkk-step1；支持 @ 技能选择器的客户端可直接选择。通用调用示例：
使用 nkk-step1 分析这个产品。先从云端读取该步骤，再告诉我需要哪些产品资料。
需要自动选步时说「使用 nkk-workflow 完成我的任务」。每个项目分别记录进度，新版本不会自动打断进行中的项目。WorkBuddy 的 @ 选择需在对应版本中确认；直接说 Skill 名称也可触发。
遇到问题，按这里处理
提示 Key 无效、已停用或已到期
联系老师核对账号状态。新 Key 发放后，在终端重新执行安装命令，不要在聊天里发送 Key。
客户端没有识别到 NKK 入口
先打开一次客户端，再执行 install。安装日志会列出实际写入的目录；重启客户端或新建会话后重试。
旧版本已下线，项目无法继续
先核对上游产物，再运行 upgrade 查看变更。明确接受后执行 upgrade --confirm，原进度将归档，当前步骤重新开始。
Python、图片或浏览器依赖缺失
CLI 只使用 Python 标准库；第 4 步还需要 requests、Pillow、openpyxl，第 3 步渲染测试需要 Playwright 和浏览器。doctor --full 会检查 Python 包。第 1 步外部 HTML 校验器需由老师补齐。
正文输出分成多段，或任务执行中断
让客户端按每段末尾给出的 --part 命令读完所有分段，再执行。重新进入同一个项目目录可查看 status，不能把未校验的产物标为完成。