适用于当前源码,尚未发布到新的 npm 或桌面版本。先阅读 代码约定 和 组件规范,按项目实际安装的版本确认接口。
- 阅读项目 AGENTS.md 和依赖;确认正在修改活动工程还是 Studio addon。桌面工程的包别名是
slidev-addon-studio,本文安装路径是node_modules/slidev-addon-studio/docs/custom-code/agent-guide.md。 - 明确要改的是外观、共享规则、外部数据还是宿主能力;只修改对应范围。
- 查找已有组件和 store。使用内置题目时复用 useQuiz,不新建另一份相同答案状态。
- 说明状态归属:当前组件、当前浏览器试播,或外部活动服务。Pinia 的共享范围不跨设备。
- 新依赖、重要接口/模型变更、后台服务和部署方式先提出方案,由用户确认。
| 用户要求 | 推荐修改 |
|---|---|
| 改计数器样式 | components 中的显示组件及 props |
| 把计数器移到另一侧 | 页面上的 v-drag 配置或 Studio 操作 |
| 改计分规则 | store action/纯规则函数,不在模板里累加 |
| 同一份分数显示在几页 | 多处显示组件读取同一 store |
| 请求题库 | services 请求和格式转换,store 接收业务数据 |
| 手机遥控 | 先确认活动服务路线;消息最终调用同一业务操作 |
| 新的互动类型 | 一个 store 和一个组件起步,按实际需要增加其他层 |
- 组件/应用代码仅使用公共 runtime 入口,不依赖编辑器内部 state、DOM 选择器或 Slidev 私有文件。
- 组件通过上下文 Pinia 取得 store;服务显式接收依赖。import 时不启动活动。
- props 保存配置,store 保存试播状态;操作经过 action,计数只由一个业务入口维护。
- 每个 service 写清启动者和停止者;所有定时器和事件订阅有清理。
- 页面 active 和组件 mounted 分开;预览使用示例数据,不发送正式操作。
- 不为少量低频使用自动增加队列、重试、恢复状态、数据库表或幂等协议。
- 不把只读 Pinia facade 当作安全沙箱;本阶段针对可信作者代码。
列出改动文件、使用接口、实际运行命令和结果,以及未验证项。新增测试只覆盖具体核心行为缺口,复用现有 fixture。检查通过后结束,不重复全量验证。浏览器最多截图;发布、远程后台和跨仓库模板同步需要另有明确范围。
从 slidev-addon-studio/runtime 导入 getStudioRuntime、useStudioContext、useQuiz、dispatchInteraction 及其公共类型。addon 已在 setup 安装宿主;工程 setup 使用 getStudioRuntime(app),组件使用 useStudioContext()。
- 当前页答案:
useQuiz().question(id)返回 computed,只读且可能为 undefined。 - 整场次数:
useQuiz().correctCount,每页每题首次答对贡献一次。 - 页面操作:
useQuiz().dispatch(signal);组件外操作:dispatchInteraction(runtime, signal)。 - 局部清空:
clear-pending只清选择和反馈;整场重置:runtime.resetTrial()。 - 自定义 store:传入上下文的
runtime.pinia,需要随整场重置时登记runtime.onReset并保留取消函数。
旧代码 dispatchInteraction(signal) 需改为显式传宿主。不要从模块顶层保存一个主宿主供所有组件复用,这会绕过组件库和缩略图的独立状态。无网络的 service 组装示意见代码约定。