这一轮会得到什么？
这份教程用三道虚构的“颜色标记演练”题、两名演练成员，走完题库整理、复核发布、成员导入、考试管理和成绩查询。AI 负责准备与管理，管理员确认内容，员工本人完成作答。
先下载三个文件，放在同一个本地目录：
- 原始演练题目 TXT：原创的虚构规则、题目与答案。
- 整理后的候选题 JSON：符合当前结构化导入契约，仍需复核。
- 演练成员 JSON：两名虚构成员，没有联系方式或密码。
这些是公开合成材料，不含真实企业题库、人员或成绩。候选 JSON 用于 MCP 或 CLI 的结构化导入，不能当作 DOCX 文件上传到普通文档入口。本轮只有三题，适合核对流程，不适合评估考试区分度或得出员工能力结论。若要逐项检查导题、固定选项顺序、错题再练和岗位考核，可使用 30 题与边界题演练指南。教程提供复验步骤，完成情况以你实际回读的结果为准。
先准备账户与演练企业
你需要正常登录的知序平台账号、演练企业的负责人或管理员权限，以及有效的企业软件服务。选择一个可以明确操作的演练企业，记下它的真实 UUID；企业管理页地址中 org= 后面的值是企业 ID，不是成员登录用的组织短码。也可以让已授权客户端读取连接资源，核对企业 ID 与授权范围。后面的管理指令都限定在这个企业。
教程的 AI 主路径使用已经实际验证过的 Codex MCP 客户端。开始前先确认自己的个人空间可以打开 AI 助手并读取企业管理配置；如果页面提示尚未开放或无法提供配置，请先联系确认接入资格。先准备好客户端和文件，再开通短期体验，避免把有效时间用在安装和读文档上。可以在 服务与套餐 查看当前资格；¥0.10 体验支持 5 名成员、连续 1 小时，负责人也占一个名额。
正式接入前，不要把真实成员、保密题目、账号密码或令牌贴到 AI 对话里。这里使用的是可公开的演练材料；换成企业资料时，需要先确认外部 AI 服务的使用授权。
连接 MCP，再明确授权企业
知序 MCP 地址是：
https://apis.lihuanyu.com/question-bank/mcp
按下面顺序配置：
- 在知序切回个人空间，打开 AI 助手。连接管理入口在个人空间，企业授权在这页单独设置。
- 展开“企业管理配置”，复制页面提供的配置到 Codex 的 MCP 配置。不要拿默认只读或旧个人配置直接执行本教程。
- 运行页面提供的登录命令，完成正常 Accounts 登录并核对授权内容：
codex mcp login zhixu
- 返回 AI 助手页面，刷新连接，在该连接下选择演练企业与题库范围，点击“保存企业授权”；核对页面显示的授权状态和已有有效期限。
本教程需要创建新题库，因此该演练企业的题库授权应允许新题库，而不是仅允许一个已存在题库。这个选择只作用于你明确授权的企业。演练结束后，可以收窄到本次新题库或撤销连接；旧个人连接不会自动获得企业管理权限。
MCP 使用 OAuth 登录，REST 的 API 专用 PAT 不能替代 MCP OAuth。Codex 连接配置与登录方式可参考 OpenAI 官方 MCP 文档；知序的具体权限以 AI 助手页当前模板和连接状态为准。
第一步：先让 AI 整理，不写入系统
把源 TXT 提供给 AI，先做本地整理。下面这段可以直接复制：
请只读取 training-source.txt，暂时不要调用知序写入工具。
按原文整理三道题，逐题列出题干、选项、答案、解析和原文题号。
题干和答案必须来自源文件；缺失或矛盾处请标记，不要猜测。
判断题要保留正确/错误语义；依赖选项顺序的题请说明理由。
同时给出原文与整理结果的对照表，等待我核对。
对照表应保留这些答案：单选题为 B，多选题为 AC，判断题为错误。先看它是否遗漏选项、改变题意，或用自己的解释替换原答案。
下载的候选 JSON 已经整理好，可用于减少本轮操作步骤。每条候选的 sourceLocator.sources 记录了源文件名、题号与真实 SHA-256。这个摘要用于核对来源字节，不能证明题目答案正确；如果你修改源 TXT，需要重新计算摘要、更新来源记录，并重新复核。
第二步：导入候选，逐题确认后发布
接下来给 AI 明确范围和停止点。把 演练企业 UUID 替换为自己的真实企业 ID：
企业范围：演练企业 UUID。只在这个企业操作，不使用个人空间。
请预览创建一个名为“博客演练题库”的题库，用途为练习与考试。
先展示名称、用途和目标企业；等我确认后再执行 create_bank。
拿到真实题库 ID 后，预览 create_prepared_import：
文件名为 training-candidates.json，候选数组使用本地文件原内容。
这份公开合成样本允许保存和处理，rightsConfirmed 为 true。
每个逻辑写操作保留稳定幂等键，先展示预览，不自动发布。
确认后，AI 执行创建和导入，再用候选读取工具列出三道题。管理工具的具体参数应从当前工具定义读取，不能凭空编造题库 ID、候选 ID、版本号或确认凭据。
然后逐题核对原文和候选。如果有阻断问题，先修复或排除；没有问题，也需要明确复核。继续指令可以这样写：
请读取这次导入的全部候选，列出题干、选项、答案、问题项与行版本。
先不要批量接受。我会逐题确认；只接受我明确确认的候选。
完成复核后，读取题库当前版本并预览 publish_import，
展示将发布的题数、目标企业与题库，等待我确认。
导入发布后，读取题库当前工作修订，再预览 publish_bank_version；
再次确认后发布正式题库版本，并回读版本与三道题。
发布、成员确认和考试发布等重要操作采用预览与确认两步。确认凭据绑定原操作、目标、输入和版本，有效期有限；输入或资源变化时，应重新读取和预览。上传成功、导入成功、候选复核完成与题库正式发布是不同状态，最后要回读确认可用版本。
第三步：预检两名成员，再走正常激活
成员 JSON 使用 BLOG-DEMO-001、BLOG-DEMO-002 两个演练工号，同属“演练部门”和“演练岗位”。如果企业里已经有这些工号，请改成未占用的新工号，再使用修改后的同一份文件完成预检与确认。
只处理这次演练企业的 training-members.json。
请先用 preview_member_import 的 dryRun 校验名单，
列出工号、人数、岗位匹配或新建计划，以及当前剩余成员容量。
等我确认后执行预检，生成待确认批次，再回读该批次。
然后 dryRun 预览 confirm_member_import，展示最终影响，
等待我确认后才执行成员导入。
不要输入密码、领取激活码、转移所有者或修改其他成员。
完成后回读成员和岗位，返回两名演练成员的真实 ID 与状态。
一名负责人加两名演练成员，共占三个名额；企业中其它有效或待激活成员也会计入容量。文件预检不等于成员已经导入，确认完成后仍要核对实际状态。
MCP 导入的待激活成员可以沿用现有 Web 设置密码流程：管理员在该企业的成员列表找到两名演练成员，点击“设置密码”，分别设置初始密码并私下提供给本人。演练者在 统一登录页 选择组织成员，使用组织码、工号和密码登录。这些凭据不要交给 AI。也可以让已激活的、明确参与演练的成员使用自己的账号；本教程不要求在 MCP 导入后查找仅在 Web 本次新增或导入结果中出现的激活码入口。
第四步：展示考试草稿，确认后发布
成员可正常登录、题库已经发布后，再创建考试。用三题测试流程，可以按每题 10 分、总分 30 分、18 分通过设置；这只是演练参数。
只使用“博客演练题库”的已发布三题与本次两名已激活成员。
请先读取真实题目和成员 ID，生成考试草稿预览，不立即发布。
同一试卷，明确选择这三题，每题 10 分，总分 30，18 分通过。
题序与选项顺序均不打乱，方便这次流程核对。
每人 15 分钟，一次作答，成绩策略 highest，答案 after_close 公布。
请按当前北京时间生成未来时间窗：5 分钟后开放，开放后 25 分钟关闭；
先列出精确日期、时区与企业剩余服务期限，供我核对。
只选本次两名成员，不使用全员名单，也不影响其它考试。
等我确认配置后创建草稿，再 dryRun 预览 publish_exam；
展示考试、题库版本、名单与时间窗，确认后发布并回读。
如果剩余服务时间不足以完成演练，先处理服务期限，再确定考试窗口；不要为了赶时间跳过名单或题目核对。实际调用应使用当前读取到的 ID、配置与版本，不能把示例文字当作 API 参数。
开考后，允许增加考生和延长整场有效期；题目、每人作答时长等核心设置不再随意改动。延长整场有效期也不应理解成重建已经开始的个人考卷或延长其既定截止时间。
第五步：员工本人答题，AI 只查询管理结果
让演练成员在 Web 以本人身份进入考试、完成选择并交卷。AI 管理入口不提供正式考试开始、保存答案、提交答案或改成绩的工具；不要让它读答案后替考生作答。
交卷后，管理员可以让 AI 调用 get_exam_results，检查成员、提交状态和分数，再用 export_exam_results 获取成绩 JSON。返回有 nextCursor 时按游标读后续页，不能把第一页当作完整名单。
最终核对五项：三道题与原文一致、版本已发布、成员属于演练企业、考试仅包含指定名单、成绩来自本人实际提交。没有实际提交的成员就保留未作答状态，不生成假成绩。
出错时先回读，演练后收回授权
遇到超时或响应丢失，不要重新生成幂等键再点一次。先用 get_management_request_receipt 按原操作、企业和幂等键查询结果；已完成就读取原结果，仍在运行就等候回读。确认需要重试时，保留同一目标、输入和键。
遇到版本冲突，重新读取候选、题库或考试，核对变化再预览。企业或题库无权限时，回到 AI 助手页检查授权范围，不让 AI 换一个组织“试试看”。
演练结束后，在 AI 助手 收窄题库范围或撤销本次连接。后续正式培训可以保留 Web 管理方式，也可以按需要单独授权新的自动化任务。
其它入口：CLI 与一个只读 API 例子
CLI 已验证题库、导入复核、成员岗位、考试和成绩管理流程，安装包采用受控分发，需要 联系获取。新数据迁移能力的 CLI 适配与公开 npm 分发仍是独立待办，不能把 API/MCP 已上线的迁移流程视为 CLI 已完成。这里不使用尚未发布的 npm 注册安装命令，也不要求下载私有仓库文件。
API 适合已有系统集成。下面只读取考试列表，前提是：你已经通过正常 Accounts 身份获得绑定该企业、含 exams:read 权限且仍有效的专用 PAT，并将凭据与企业 UUID 从私有配置注入本地环境变量。
: "${ZHIXU_API_TOKEN:?请先注入有授权的企业只读 PAT}"
: "${ZHIXU_ORGANIZATION_ID:?请先注入该 PAT 绑定的企业 UUID}"
curl --fail-with-body --silent --show-error --max-time 30 \
--header "Authorization: Bearer ${ZHIXU_API_TOKEN}" \
--header "X-Organization-Id: ${ZHIXU_ORGANIZATION_ID}" \
"https://apis.lihuanyu.com/question-bank/exams"
这个请求不创建或发布考试；返回内容受当前企业身份、题库范围和权限限制。不要把真实令牌写进文章、Git 或日志，也不要把 REST PAT 当作 MCP 登录凭据。
截至 2026 年 10 月 15 日，API/MCP v1.2.32 与国内 Web v0.1.12 已正式提供分片数据导出与迁入。题目版本、原文件、成员和岗位可按支持范围恢复；迁入要经过预检、确认和本轮独立核对（fresh verify），不能用旧核对报告代替当前结果。历史考试、成绩、作答与个人学习事实只归档，不生成正式业务记录。这里的考试列表请求没有执行迁移；跨平台资料还需按格式转换并核对字段。
旧同步 JSON 出口每类 10,000 行的限制不是新异步迁移的总行数上限。新分片包总行数上限为 1,000,000，总交付字节上限为 5 GiB，另有文件及执行期限限制；这不代表套餐总存储或生产满容量承载已验证。迁移步骤和目标条件见 数据导出与迁入格式。