CodeWords
CodeWords 是一个位于 VS Code 独立 Activity Bar 入口中的英语词汇微学习插件。它让你在不离开编辑器的情况下,用很短的间隙完成一轮拼写练习。
核心功能
- CET-4、CET-6、编程英语为免费本地词库。
- 雅思、托福、考研、BEC 为 Pro 词库,需要通过后端 Pro 校验后解锁。
- 每轮 10、15 或 20 个词,支持 Enter 提交、Esc 跳过。
- 自动收集错词,并按错误次数优先复习。
- 提供今日练习、连续学习、本月日历、近 4 周热力图、累计词数、正确率、WPM 和词库分布。
- 自动适配 VS Code 深色、浅色和高对比度主题。
CodeWords Pro 购买流程
CodeWords Pro 售价 ¥19.9,一次性买断,终身享用。
购买与兑换流程:
- 在插件的「我的」Tab 或 Pro 词库提示中点击「购买 Pro」。
- 在系统浏览器打开的爱发电页面完成购买。
- 从爱发电订单详情、自动回复或私信中复制 CodeWords Pro 兑换码。
- 回到 VS Code 插件的「我的」Tab。
- 登录 CodeWords 账号。
- 输入兑换码并完成兑换。
- 解锁 CodeWords Pro。
一个兑换码只能使用一次。
一个 Pro 账号支持 2 台常用设备。
登录与兑换 Pro
CodeWords 登录流程:
- 在插件「我的」Tab 点击“打开登录页”。
- 在系统浏览器中完成邮箱或 GitHub 登录。
- 登录成功后,浏览器会自动尝试返回 VS Code。
- CodeWords 将自动交换一次性登录码、刷新账号与 Pro 状态,并打开「我的」Tab。
如果浏览器未能自动打开 VS Code,可以复制页面中的一次性登录码,回到插件「我的」Tab 手动完成登录。手动登录码是自动返回失败、浏览器拒绝打开 VS Code 或远程环境不支持自动返回时的兜底流程,不需要重新完成邮箱或 GitHub 授权。
退出登录会调用后端退出接口,并清除本地 token 与账号摘要。
隐私说明
CodeWords does not read, upload, or analyze your workspace files.
Authentication is only used to unlock Pro word sets and manage device activation.
Tokens are stored using VS Code SecretStorage.
CodeWords 不读取当前编辑器内容,不遍历 workspace,不上传项目路径,也不上传任何代码内容。练习进度保存在 VS Code ExtensionContext.globalState,认证 token 保存在 VS Code SecretStorage。
使用方式
CodeWords appears as an independent Activity Bar view.
Click the CodeWords icon in the left Activity Bar to open the learning panel.
安装并启用插件后:
- 在“练习”中选择词库并输入当前单词。
- 非 Pro 用户点击 Pro 词库时会看到锁定提示,可购买 Pro,并前往“我的”Tab 登录或兑换。
- 在“错题”中复习历史错词。
- 在“打卡”中调整下一轮词数。
- 在“统计”中查看本地累计数据。
- 在“我的”中登录账号、查看 Pro 状态、购买 Pro、输入兑换码或退出登录。
内部 Preview 验证
仓库的 Run CodeWords Extension F5 调试配置默认使用固定 Preview API;正式安装包固定使用 Production API。Pro 词条仅由 API 提供,本地只保留最多 200 条、带过期时间的加密缓存。
独立 Preview 后端准备完成后,可构建不会上传 Marketplace、不会覆盖正式扩展标识的内部包:
CODEWORDS_PREVIEW_API_BASE_URL=https://your-preview.example npm run package:preview -- --mode=strict
Preview 包同样严格使用 API,禁止本地 Pro 回退。脚本拒绝 Production API,输出到 gitignored 的 artifacts/internal-preview/,并将扩展显示名、扩展 ID、View ID 和版本标记为 Preview。API URL 是公开 origin;任何 Token、数据库凭据或 Deployment Protection bypass secret 都不得写入命令、源码、VSIX 或普通 VS Code 设置。
后续规划
- 更多开发者场景词库,例如 PR Review、GitHub Issues 和技术文档阅读。
- 可选的词条导入与导出。
- 更细粒度的复习策略。
- 在保持本地优先前提下评估跨设备同步。
Verified for OpenVSX Issue 12194: Claiming namespace fgg