wordpal-个性化专业英语学习助手

- Migrated script dependencies to package.json for streamlined management. - Removed obsolete scripts: question-plan.js, select-review.js, stage-word.js, updater.js, and validate-new-words.js. - No changes to user-facing skill protocol or features.

修复 report-stats.js：buildNextAction 中 review_now 改为 learn_now（review 模式已移除，该值不再有效） report.md：移除已废弃的 risk_words 和 memory_digest 字段引用；报告格式由"不固定"改为严格的 5 区块模板（词库概览、近七天趋势、到期预览、学习表现、下一步引导）

- 移除 review 复习功能及其相关文档，简化为仅支持 “learn” 和 “report” 两大模式 - 描述与核心协议同步：新增个性化出词、FSRS算法、AI题型解析等介绍 - 将原有 N 系列（新词题型）和 R 系列（复习题型）合并为统一的 Q1–Q17 编号，并优化题型设置

- Refined user onboarding: session context initialization now runs before intent detection. - Updated skill description for clarity and conciseness. - Removed obsolete features reference file. - Added new learner memory service. ### 破坏性变更 - **学习状态范围收缩**：移除 Status 0，最低状态改为 1，相关升降级映射、FSRS 调度参数、题型分组、报告统计权重均同步调整 - **Status 3 emoji**：⚠️ → ❌ ### 新增 - 恢复 `learner-memory.js` 模块，`session-context` 重新输出 `learner_memory` 字段（高频错误词、近期混淆词） - 新增 `docs/` 目录，包含 PRD 文档与脑图 ### 变更 - Hint token 恢复 30 分钟过期校验，超时抛出 `HINT_TOKEN_EXPIRED` - 术语：`用户画像` → `基础学习配置`

增加cron显式说明

# Changelog ### 新增 - `show-hint.js`：展示提示并生成一次性 `hint_token`，在提交 `wrong` / `remembered_after_hint` 事件前必须调用 ### 变更 - `submit-answer.js`：`--event wrong` 和 `--event remembered_after_hint` 现在要求携带 `--hint-token`（由 `show-hint.js` 生成），缺失时返回 `HINT_TOKEN_REQUIRED` 错误 ### 文档修复 - `SKILL.md`：共享事件映射补全 `submit-answer.js` 的必填参数（`--word`、`--last-reviewed`）；答错流程改为先调 `show-hint.js` 再按 B-3 判定 - `references/learn.md`： - 状态展示模板加强制说明"不可省略任何行"（修复难度行被跳过的问题） - 补新词时 `WORD_REJECTED` 细化：`exists_pending` 视为已就绪继续出题，其余才重新生成 - 答题后衔接规则：`correct` / `skip` 自动出下一题；`wrong` / `remembered_after_hint` 等待用户主动继续 - `references/onboarding.md`：步骤 4 推送注册说明更新 - `docs/scripts-contract.md`：新增 `show-hint.js` 契约；`submit-answer.js` 新增 `HINT_TOKEN_REQUIRED` / `HINT_TOKEN_INVALID` 错误码说明

出题质量增强： - Session 状态栏：learn/review 开始时展示目标、难度、今日进度摘要 - Phase A/B/C 输出规范：统一答题前（出题）、答题中（判定）、答题后（反馈）三阶段输出格式，含 B-3 答错提示子流程 - 题型质量约束：为 N1/N3/R3/R4/R5/R6/R7/R10/R11 共 9 种题型添加 notes（选项位置随机、例句不泄露答案等） Token 精简： - SKILL.md：删除用户画像契约、脚本调用规范表；表格→列表； - learn.md：删除输入定义、LLM 责任等冗余段；表格→列表； - review.md：同上； 其它： - 将所有 `<skill-dir>` 占位符替换为 OpenClaw 原生模板变量 `{baseDir}`，框架自动注入实际安装路径，agent 不再需要手动推断； - 删除 SKILL.md 和 report.md 中"手动替换安装目录"的冗余说明； - 修复 clawhub 安装到 `~/.openclaw/skills/wordpal` 后脚本路径可能解析失败的问题。 - 修改description

Added 新增 next-question.js，用于为学习/复习场景生成下一题的紧凑题型规划。 新增 question-plan.js，将题型选择独立为可复用的规划层能力。 新增 submit-answer.js，支持按答题事件直接提交结果并返回轻量进度信息。 新增 session-summary.js，可基于一轮学习的 op_id 输出结构化会话总结。 新增 profile.js，支持统一读写用户画像配置。 新增 push-plan.js，可将用户推送时间转换为 learn/review 的注册计划。 新增 features 与 scripts-contract 文档，补充产品能力说明与脚本契约。 Changed 将 WordPal 从“词库管理/复习工具集”升级为“可直接驱动 Agent 学习流程的完整闭环”。 重构题型体系，统一为新词 N1..N7 与复习 R1..R11，并支持按难度、状态、上一题类型稳定选题。 重构 session-context.js，使其更明确承担学习、复习、报告的事实层输入角色。 重构 report-stats.js，输出更聚焦总量、趋势、风险词和下一步动作。 更新 onboarding、learn、review、report 流程文档，使上层 Agent 的执行顺序和责任边界更清晰。 Improved 用户画像从旧的 Markdown 文件方案迁移为 SQLite user_profile 表持久化，配置管理更稳定。 数据层新增 schema version、用户画像表及更多查询能力，支持风险词、事件汇总、画像读取等场景。 updater.js / update-word.js 强化为基于答题事件驱动的状态推进逻辑，减少上层手动计算状态的负担。 强化 SRS 与复习时间一致性约束，提升词状态与调度结果的可靠性。 整体 CLI / JSON 协议更加统一，便于被宿主 Agent 或工作流稳定调用。 Removed / Simplified 精简旧版以静态说明为主的部分参考文档结构，改为围绕实际脚本契约和流程文档组织。 移除对旧版本地画像文件写入方式的依赖，统一收口到数据库持久化方案。

WordPal 1.0.1 - skill name capitalized and new emoji metadata added for improved identification. - Script path documentation now uses the placeholder <skill-dir> to clarify installation flexibility; explicit guidance for non-default install locations. - Clarified that WordPal is an agent within the host, not specifically “OpenClaw”; updated references throughout. - Description updated for greater clarity and consistency. - No behavioral changes or file modifications; documentation improvements only.

Initial release of WordPal, a word memorization agent. - Supports onboarding, learning, review, and progress report features, with automatic onboarding on first run. - Implements fixed workflow with intent recognition and strict file/script-based integrations. - Manages user profile and vocabulary status via standardized markdown and SQLite-backed scripts. - Enforces contract-driven operations, including fine-grained status transitions and context injection constraints. - Limits on reminders and prohibits direct DB access, ensuring robust, modular, and user-centric task flow.