YuriWiki 使用指南
本指南为 YuriWiki 的技术文档,详细说明各项功能与操作流程。
一、注册与登录
首次使用 YuriWiki 需完成注册流程:
- 点击顶部导航栏的 「登录」 按钮。
- 在弹出界面中切换至 「注册」 标签页。
- 填写以下信息:
- 用户名:长度为 3 至 20 位字符,支持中文、英文字母、数字和下划线(
_)。 - 密码:至少 6 位。
- QQ号:选填项,用于绑定头像及联系。
- 用户名:长度为 3 至 20 位字符,支持中文、英文字母、数字和下划线(
注意:注册/登录操作设有频率限制,防止恶意批量注册或爆破攻击。
账户权限演进机制
YuriWiki 实行渐进式权限制度,保障社区内容质量:
| 权限阶段 | 时间要求 | 可执行操作 |
|---|---|---|
| 访客 | 注册后前7天 | 仅可浏览与搜索词条 |
| 编辑者 | 注册满7天 | 可修改已有词条 |
| 新建者 | 注册满30天 | 可提交新建词条(需管理员审核) |
| 免审批用户 | 满足贡献条件 | 新建与修改无需审核,直接发布 |
免审批权限获取条件
满足以下任一条件即可获得免审批权限:
- 成功提交 3 条新建词条并通过审核;
- 或累计有 9 次修订记录被批准。
二、浏览词条
浏览是所有用户的最基本功能:
- 在首页顶部的搜索框输入关键词。
- 点击「搜索」按钮进行查询。
- 在结果列表中点击目标词条标题进入详情页。
词条页结构
每个词条页面包含以下组成部分:
- 正文区域:展示 Markdown 渲染后的内容。
- 右侧信息框:显示结构化元数据,如作者、年份等。
- 底部贡献者区域:列出参与该词条编辑的用户,并展示其 QQ 头像。
提示:若某用户 QQ 号设置了隐私保护,其头像可能无法正常加载。
三、编辑词条
具备「编辑者」及以上权限的用户可对现有词条进行修改。
操作步骤
- 进入任意词条页面。
- 点击页面上方的 「编辑词条」 按钮。
- 在文本编辑区使用 Markdown 语法撰写内容。
- 填写信息框(JSON 格式)。
- 输入别名(多个用逗号分隔)。
- 点击 「保存修改」 提交变更。
系统将自动生成本次修改的修订历史,供管理员追溯。
支持的 Markdown 语法
| 功能 | 写法示例 | 输出效果 |
|---|---|---|
| 站内链接 | [[终将成为你]] |
→ 终将成为你 |
| 站外链接 | [GitHub](https://github.com) |
→ GitHub |
| 图片插入 |  |
插入图片 |
| 一级标题 | # 标题 |
大号标题 |
| 二级标题 | ## 标题 |
中号标题 |
| 三级标题 | ### 标题 |
小号标题 |
| 粗体 | **粗体** |
粗体 |
| 斜体 | *斜体* |
斜体 |
| 粗斜体 | ***粗斜体*** |
粗斜体 |
| 删除线 | ~~删除线~~ |
|
| 无序列表 | * 列表项 |
• 列表项 |
| 分割线 | --- |
—————— |
| 黄色警告框 | >! 内容 |
显示黄色提示背景 |
| 绿色提示框 | >? 内容 |
显示绿色提示背景 |
| 红色错误框 | >x 内容 |
显示红色警示背景 |
表格语法
重要提示:目前表格在页面上尚无法正常渲染,此功能处于临时不可用状态,正在修复中。
正确格式要求(未来可用时遵循)
markdown
| 名称 | 作者 | 年份 |
| --- | --- | --- |
| 终将成为你 | [[仲谷鳰]] | 2015 |
| 柑橘味香气 | [[サブロウタ]] | 2012 |
表格格式严格规则
- 每行必须以
|开始和结束; - 表头下方需有一行分隔符,格式为
| --- | --- | ... |; - 表头、分隔行、数据行之间必须有换行;
- 列数需保持一致。
提示:即使格式完全正确,当前仍无法显示表格,请避免在正文中使用复杂表格结构。
信息框填写规范
信息框需以 JSON 格式填写,例如:
json
{"作者":"[[仲谷鳰]]","连载":"2015-2019","卷数":"8卷"}
支持在值中嵌入站内链接 [[ ]] 和外链 [文本](URL)。
别名设置用途
别名为字符串字段,多个别名使用英文逗号 , 分隔。作用是增强搜索匹配能力。
例如:词条标题为「终将成为你」,设置别名为 やがて君になる, Become You,则用户搜索这些别名也能找到该词条。
四、新建词条
当用户达到相应权限后,可创建新词条。
操作入口
- 方法一:点击顶部导航栏用户名进入「用户中心」,选择「新建词条」;
- 方法二:直接访问
/?page=edit。
填写内容
新建词条需填写以下字段:
- 标题:主名称,唯一标识。
- 副标题:补充说明(可选)。
- 分类:选择所属类别(如漫画、小说、动画等)。
- 标签:关键词标签,便于归类检索。
- 别名:用于搜索匹配的其他名称,逗号分隔。
- 信息框:JSON 结构化数据。
- 正文:Markdown 格式内容。
审核机制
- 免审批用户:提交后立即发布。
- 普通用户:需等待管理员审核,通过后方可公开显示。
五、用户中心
登录状态下,点击顶部导航栏的用户名即可进入个人中心。
主要功能
- 权限进度查看:实时显示当前所处权限阶段(访客 / 编辑者 / 新建者 / 免审批)。
- 贡献统计:已成功修订次数、已成功新建条数。
- 快速操作入口:「新建词条」按钮直达编辑页。
六、搜索功能
YuriWiki 提供全文搜索支持:
搜索范围
支持在以下字段中进行匹配查找:
- 词条标题
- 正文内容
- 标签
- 别名
搜索优先级
- 别名精确匹配优先展示
- 其次按标题相似度排序
- 最后是正文与标签匹配结果
七、公告系统
系统会定期推送重要通知。
显示逻辑
- 用户访问首页时,若有有效公告,则自动弹出。
- 用户可点击「我知道了」手动关闭。
- 若勾选「不再显示」,则除非公告更新,否则不会再次弹出。
八、注意事项
安全警告:所有输出内容会经过自动转义处理,不支持直接输入 HTML 标签,防止 XSS 攻击。
频率限制:注册与登录接口设有频率限制,防止机器人批量操作。
封禁说明:被封禁账号无法登录,如有疑问请联系管理员申诉。
九、联系管理员
如遇技术问题、功能建议或申诉需求,请通过以下方式联系:
- QQ:3176906054
- 邮箱:mu@kina.ink
常见问题
为什么注册后不能编辑词条?
新注册用户前7天为「访客」身份,只能浏览和搜索。满7天后自动晋升为「编辑者」,即可修改现有词条。
为什么我不能新建词条?
新建词条需要注册满 30 天。满30天后提交的新建词条需管理员审核,审核通过后才会显示。
什么是免审批权限?
累计贡献达标后(满足 3 条新建被批准 或 9 次修订被批准),新建和修改词条无需等待管理员审核,直接发布。
信息框怎么填?
信息框使用 JSON 格式,例如:
{"作者":"[[仲谷鳰]]","连载":"2015-2019","卷数":"8卷"}。支持在值中使用站内链接 [[ ]] 和外链 [文本](URL)。别名有什么用?
别名用于增强搜索匹配能力。例如词条「终将成为你」设置别名为「やがて君になる」,用户搜索该日文名时也能找到该词条。
为什么我的表格显示不正确?
表格格式要求极为严格,必须满足以下全部条件:每行必须以 | 开始和结束;分隔行格式为 | --- | --- |(列数一致);表头、分隔行、数据行之间必须存在换行;列对齐方式不影响解析。
重要提示:目前表格在页面上尚无法正常渲染,此功能处于临时不可用状态,正在修复中。建议如遇表格问题,请先检查换行是否缺失,或暂时改用列表形式替代。
重要提示:目前表格在页面上尚无法正常渲染,此功能处于临时不可用状态,正在修复中。建议如遇表格问题,请先检查换行是否缺失,或暂时改用列表形式替代。
图片插入后为什么不显示?
请确认使用了正确的语法
,并且提供的 URL 是可公开访问的地址。推荐使用本站图床:https://img.wiki.yuri.fan/xxx.jpg,确保图片链接有效且未被防盗链拦截。如何修改自己的词条?
进入任意词条页面,点击「编辑词条」按钮即可进行修改。每次修改都会生成一条修订历史,管理员可追溯变更记录。
QQ头像不显示怎么办?
请检查注册时填写的 QQ 号是否准确无误。头像由系统调用 QQ 官方接口获取,若该 QQ 号设置了头像隐私保护,则可能无法显示。
如何上传图片?
目前不支持本地图片上传。请使用外链图片地址。推荐使用 YuriWiki 官方图床服务:
https://img.wiki.yuri.fan,上传图片后获取直链,在 Markdown 中使用  插入。遇到 bug 或功能建议怎么办?
欢迎提出反馈!请联系管理员:
QQ:3176906054
邮箱:mu@kina.ink
我们将持续优化平台体验。
QQ:3176906054
邮箱:mu@kina.ink
我们将持续优化平台体验。
