原理与维护
这一章面向想修改框架本身,或者想弄清一个问题出在哪一层的人。使用 Covel、做世界、做插件都不需要先读这一章。
它是怎样运转的
| 页面 | 回答的问题 |
|---|---|
| 设计原则 | 什么该进内核,什么该交给插件 |
| 回合管线与数据流 | 一个回合怎样经过触发、调度、执行和提交 |
| 包的职责 | 仓库里每个包负责什么,谁依赖谁 |
| 存储 | 三种存储后端,浏览器存档,数据的归属 |
| 安全边界 | 出站请求、密钥、部署层级和社区插件的信任 |
| NPC 关系图 | 关系图插件怎样存储和检索人物关系 |
| 已知的限制 | 有意保留的限制,以及什么情况下该升级它们 |
参与开发
| 页面 | 内容 |
|---|---|
| 贡献指南 | 分支、提交、检查和发布流程 |
| 命令 | 不常用的脚本,Git 钩子,CI 的范围 |
| 浏览器端到端测试 | Playwright 测试和发版前的玩家流程验收 |
| 桌面打包 | 本地构建、签名和发布清单 |
| 开发 Agent 的技能 | 仓库自带的技能,以及怎样写一个 |
| v0.0.42 升级指南 | 从 v0.0.42 之前的版本升级时要做的事 |
| 更新日志 | 每个版本的变化、破坏性变更和升级说明 |
从哪里读起
想改框架时,按这个顺序读: