创游世界知识库 FAQ
一句话摘要
本文档汇总创游世界资料库的常见问题,帮助用户快速了解知识库的使用方式、贡献流程、文档规范和常见疑问。
适合谁阅读
- 第一次使用创游世界资料库的新用户
- 想了解如何参与资料库贡献的创作者
- 遇到文档使用问题的访客
- 需要查阅文档规范的研究者
你将学到什么
- 知识库的基本使用方式
- 如何找到你需要的文档
- 如何参与知识库贡献
- 文档的分类和导航方式
- 如何反馈问题或建议
基础问题
Q1:这个知识库是什么?
A:创游世界资料库(cysj-data)是由 Azek431 维护的创游世界引擎非官方资料库,旨在为创游世界用户提供全面的学习资源、系统解析和开发参考。 涵盖内容:
- 脚本系统与积木能力
- 组件与对象体系
- UI 设计与管理
- 项目架构与系统设计
- OCR 截图转文本资料
- 引擎版本更新记录
- 社区分析与待验证问题
Q2:知识库和创游世界官方是什么关系?
A:这是非官方的社区维护项目,不是创游世界官方产品。内容来源于官方教程、社区分享和个人整理,仅供学习参考使用。
Q3:这个知识库是免费的吗?
A:是的。知识库基于 MIT 许可证开源,任何人都可以免费查看、使用和贡献。
使用问题
Q4:我不知道从哪开始学习,应该看什么?
A:建议按以下顺序阅读:
- 新手阅读路线 - 完整学习路径
- 创游世界学习路线图 - 学习阶段规划
- 创游世界核心概念问答 - 核心概念速查
- 常见问题与避坑指南 - 实际问题解决
Q5:我想做某个功能(如战斗、背包、商店),应该看什么?
A:
| 功能方向 | 推荐文档 |
|---|---|
| 战斗系统 | 战斗系统设计入门 |
| 背包与货币 | 背包与货币系统设计入门 |
| 商店系统 | 商店系统实战设计指南 |
| 任务系统 | 任务与事件系统设计入门 |
| UI 界面 | UI数据同步架构 |
| 状态机 | 动作状态机入门 |
| 存档设计 | 存档与云变量设计入门 |
Q6:我遇到具体问题(如角色不动、广播没效果),应该看什么?
A:建议查看 常见问题与避坑指南,里面有高频问题的详细解答和解决方案。
Q7:文档中的术语我看不懂怎么办?
A:查看 创游世界术语速查 或 核心概念速查手册,里面有详细的术语解释。
Q8:旧视频教程里的方法和文档不一样怎么办?
A:引擎版本更新可能导致一些旧方法过时。建议:
贡献问题
Q9:我想参与知识库贡献,应该怎么做?
A:请阅读 社区贡献与维护指南,了解贡献流程和规范。 基本步骤:
- Fork 项目到自己的 GitHub 仓库
- 在本地克隆并创建新分支
- 添加或修改文档
- 提交 Pull Request
Q10:我发现文档有错误或缺失,应该怎么反馈?
A:有以下几种方式:
- GitHub Issue:在 GitHub 仓库 提交 Issue
- 页面编辑:点击页面底部的「在 GitHub 上编辑此页」
- Pull Request:直接提交修改内容
Q11:我没有 GitHub 账号,可以参与贡献吗?
A:可以通过以下方式:
- 在创游世界社区发帖反馈
- 联系维护者 Azek431
- 等待后续支持更多反馈渠道
文档规范问题
Q12:文档中标注的「E1」「E2」「E3」「E4」是什么意思?
A:这是证据等级标注,表示内容的可靠程度:
| 等级 | 说明 |
|---|---|
| E1 | 直接证据(官方截图、官方文档) |
| E2 | OCR/转写证据(截图转文本) |
| E3 | 归纳结论(多来源交叉验证) |
| E4 | 社区经验/推测(待验证) |
Q13:文档中标注的「待验证」是什么意思?
A:「待验证」表示该内容尚未得到直接证据支撑,可能存在不确定性。使用时需要自己判断,或等待后续验证。
Q14:文档状态「草稿」「整理中」「已复核」是什么意思?
A:这是文档的完成度状态:
| 状态 | 说明 |
|---|---|
| 草稿 | 仅有初步结构,待补充内容 |
| 整理中 | 正在整理,内容可能不完整 |
| 已结构化 | 结构完整,内容基本完善 |
| 待验证 | 核心内容需要验证 |
| 已复核 | 已通过人工复核 |
| 持续维护 | 长期更新维护 |
Q15:我写的文档怎样才能被接受?
A:请确保:
技术问题
Q16:这个知识库是用什么技术搭建的?
A:
- 文档框架:VitePress
- 构建工具:pnpm
- 部署平台:Cloudflare Pages
- 镜像同步:Gitee
- 版本控制:GitHub
Q17:我可以在本地运行这个知识库吗?
A:可以。请参考 站点部署与运维方案。 基本步骤:
bash
git clone https://github.com/Azek431/cysj-data.git
cd cysj-data
pnpm install
pnpm run docs:devQ18:知识库的内容可以商用吗?
A:知识库本身基于 MIT 许可证,但内容仅供参考学习。使用时请遵守相关法律法规,不要侵犯创游世界官方的版权。
其他问题
Q19:知识库会一直维护下去吗?
A:这取决于社区的需求和维护者的投入。我们会尽力持续更新,但无法保证长期维护。请以 GitHub 仓库的最新状态为准。
Q20:我有更多问题,应该联系谁?
A:
- GitHub Issue:提交 Issue
- 维护者:Azek431
- 社区论坛:创游世界相关社区
相关页面
待验证问题
以下问题需要进一步验证:
| 问题 | 状态 | 验证方向 |
|---|---|---|
| 更多用户反馈的常见问题 | 🔄 待验证 | 需要收集用户反馈 |
| 未来可能支持的其他反馈渠道 | 🔄 待验证 | 需要规划 |
