@sokeai/cli 1.0.78 → 1.0.80

package/skills/mono/references/modules/soke-certificate/MODULE.md

@@ -9,7 +9,53 @@ metadata:
   cliHelp: "soke-cli certificate --help"
 ---
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../soke-shared/MODULE.md`](../soke-shared/MODULE.md)，其中包含认证、配置、权限处理**
+## 共享前置
+
+开始前按需读取：
+
+- `../../shared/environment-check.md`
+- `../../shared/auth-check.md`
+- `../../shared/command-discovery.md`
+- `../../shared/object-context.md`
+- `../../shared/pagination.md`
+- `../../shared/interaction.md`
+- `../../shared/write-guard.md`
+- `../../shared/write-verify.md`
+- `../../shared/output-policy.md`
+- `../../shared/error-handling.md`
+
+本模块只保留证书业务规则；通用规则统一由共享层维护。
+
+## 职责
+
+负责证书模板、证书分类、证书资源、获得人员和证书生命周期查询/管理；不负责课程、考试或学习地图资源配置。
+
+## 输入
+
+- 用户明确的证书模板、列表、详情、分类或获得人员查询
+- 创建、更新、发布、关闭、删除或颁发时所需的业务字段
+- 真实证书、分类和学员 ID
+
+## 流程
+
+```text
+查询模板/分类 → 创建或查询证书 → 配置坐标
+→ 发布/关闭/颁发（按需确认） → 查询获得人员或关联关系
+```
+
+## 业务特例
+
+- 证书资源 UUID、证书分类 UUID 与证书获得记录 UUID 不可混用。
+- 发布、关闭、删除、颁发和批量操作必须遵循证书业务校验与共享写守卫。
+- 坐标配置和模板字段以本模块后续命令章节为准。
+
+**失败降级**：写操作（create/update/award/close/delete）若返回业务错误、未生成 `uuid` 或状态未达预期，立即停止并说明原因，不要假设成功；发布/关闭/删除等不可逆或状态敏感操作，务必先以 `+get` 或 `+list` 回读确认当前状态，再决定是否继续。
+
+## 输出
+
+返回证书名称、状态、分类、编号、获得人员和处理结果等业务摘要；内部 UUID 和完整响应遵循 `../../shared/output-policy.md`。
+
+**完成判定**：写操作以真实状态为准——`+create` 完成当且仅当返回新的 `uuid`；`+update --action publish` 完成当且仅当 `+get` 查到的 `status=1`；`--action close` 完成当且仅当 `status=2`；`+award` 完成当且仅当 `+users` 能查到对应获得记录；`+delete` 完成当且仅当原证书在 `+list` 中不再出现。仅 CLI 返回“成功”提示但状态未变更的，视为未完成。
 
 ## 核心概念
 

package/skills/mono/references/modules/soke-course/CHANGELOG.md

@@ -0,0 +1,93 @@
+# 变更日志
+
+## v6.50.0 · 2026-09-03
+
+- 修正创建课程模式判定：create 意图下除已明确给出 course-id/目录/单文件+标题外，第一步必须先弹原生二选一「单课程上传/多课程批量上传」，禁止默认进单课程（此前「仅无法判断才弹」与意图路由「默认进单课程」冲突，导致用户只说「创建课程」时看不到模式选择）。
+
+## v6.48.0 · 2026-09-03
+
+- 完整落地「创建课程」业务逻辑：新增交互规范（硬规则）、意图路由（Gate 0）、5 Phase 主流程、批量 B0-B7 流程。
+- 模式选择改为按上下文判定（course-id/目录/单文件），仅无法判断时弹原生二选一。
+- 统一 A-H 编码方案（课件来源/分类/模板/小测验/发布/学习类型/指派/出题方式）。
+- 明确弹窗例外清单：模式选择、批量上传确认、加小测验、出题方式、指派+发布条件、指派部门选择、发布警告用原生弹窗；已有试卷选择用 Markdown 表格展示前 20 份。
+- 明确「先上传课件 → 再问小测验 → 最后指派+发布条件弹窗」默认流程，禁止代发布。
+- 新增 subs/assign、subs/exam、subs/photo、subs/charge、subs/copy 五个子 SOP。
+- 新增 intent-cases.md（意图案例库）与 sop-publish-check.md（发布 Gate Check，6 项 + 关闭第 7 项）。
+- 分类编码统一为 B1..Bn；模板设置表列序统一为「设置项｜值｜状态」；批量固定不加小测验。
+- 修正 check_readiness.sh 路径（subs/ 扁平化）；补充 cli-facts.md 的 list-papers/get-paper。
+
+## v6.47.0 · 2026-09-01
+
+- 移除单独的“回复格式：课程标题 A1B3C1”和固定编码示例。
+- 改为自然语言提示用户直接提供课程标题、课件来源、分类、模板及本地文件路径。
+
+## v6.46.0 · 2026-09-01
+
+- 固定单课程首轮输出顺序，确保标题、A 来源、B 分类、分类提示、C 模板和回复示例完整出现。
+- 分类和模板统一使用“编码在名称前”的展示格式。
+- 指派与发布改为两个连续弹窗：先确认是否指派，再确认是否发布。
+- 指派弹窗固定为「1. 指派（推荐）/2. 不指派」；发布弹窗固定为「1. 发布/2. 不发布」。
+
+## v6.45.0 · 2026-09-01
+
+- 统一单课程首轮输出顺序和格式。
+- 分类、模板选项统一采用“编码在名称前”的展示方式。
+- 指派弹窗固定顺序为“1. 指派（推荐）/2. 不指派”。
+- 发布弹窗固定顺序为“1. 发布/2. 不发布”。
+
+## v6.44.0 · 2026-09-01
+
+- 修复创建课程时 B 分类列表为空或使用占位内容的问题。
+- 分类选择现在必须先拉取真实分类接口返回，再展示一级分类标题和 UUID。
+- 统一分类字段为 `data.list[].title`、`uuid`、`parent_id`，不再使用未验证的 `name`/`id` 字段。
+- 未确认的 `--parent-id`、`--level` 参数不得直接调用。
+
+## v6.43.0 · 2026-09-01
+
+- 优化未登录处理：自动执行 `soke-cli auth login` 调用网页登录授权。
+- 登录完成后自动回查「用户凭证」，失败或取消时停止后续写操作。
+- 修正环境检查脚本对中文登录字段的识别。
+
+## v6.42.0 · 2026-09-01
+
+- 优化“查看学习统计”入口：未指定课程时先展示已发布线上课前 20 个。
+- 增加按课程标题模糊搜索和分页选择提示，选定课程后再查询统计。
+
+## v6.41.0 · 2026-09-01
+
+- 优化对外分享元数据，移除残留英文示例。
+- 增加已有课程操作不再弹模式选择的使用说明。
+
+## v6.40.0 · 2026-09-01
+
+- 补齐关键 CLI 命令的最低返回字段契约。
+- 增加批量目录扫描的隐藏文件、符号链接、大小写扩展名和空目录规则。
+- 完善动作级中断恢复和批量结果记录要求。
+- 清理分享元数据中的英文示例。
+
+## v6.39.0 · 2026-09-01
+
+- 修复已有 `course-id`、目录路径与模式选择之间的路由冲突。
+- 增加创建前查重、发布确认前二次状态查询和 Gate Check。
+- 明确批量任务的单课失败隔离、超时回查、失败汇总和恢复位置。
+
+## v6.38.0 · 2026-09-01
+
+- 统一为 5 阶段流程：创建、课件、设置、指派与发布、查询与维护。
+- 统一执行顺序：课件 → 设置 → 指派 → Gate Check → 发布。
+- 模板自动应用 CLI 支持的高级设置，后台能力标记为待办。
+- 修正立即发布与定时发布的 Gate Check 和回查规则。
+- 修正图片字段白名单、分类末级选择、素材库分页和 clock 分页字段。
+- 增加写操作回查、批量失败隔离和中断恢复要求。
+- 统一示例、排障文档和 WorkBuddy 安装路径。
+
+## 兼容性说明
+
+- 命令参数以 `references/cli-facts.md` 为唯一事实源。
+- 当前事实表实测版本为 `soke-cli v1.0.77`。
+- 旧版示例中的“先发布后指派”流程不再适用。
+- 未经 `--help` 或实际回归验证的参数，不得直接写入其他 SOP。
+
+## 历史版本
+
+- v6.37.0 及更早版本的详细记录保留在版本发布包或内部备份中；对外分享包只保留当前版本和兼容性说明。