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 表格渲染功能已于 2026 年 7 月 22 日修复，现在可以正常使用。
标准格式
markdown
| 名称 | 作者 | 年份 |
| --- | --- | --- |
| 终将成为你 | [[仲谷鳰]] | 2015 |
| 柑橘味香气 | [[サブロウタ]] | 2012 |
表格格式规则
- 每行必须以
|开始和结束； - 表头下方需有一行分隔符，格式为
| --- | --- | ... |； - 表头、分隔行、数据行之间必须有换行；
- 列数需保持一致。
单行表格（粘贴场景）
从外部复制表格内容时，换行符可能会丢失，变成单行格式。YuriWiki 现在也能正确识别：
markdown
| 名称 | 作者 | 年份 | | --- | --- | --- | | 终将成为你 | 仲谷鳰 | 2015 |
移动端适配
表格宽度超过屏幕时，会自动在表格区域生成横向滚动条，页面整体布局不会被撑开。
信息框填写规范
信息框需以 JSON 格式填写，例如：
json
{"作者":"[[仲谷鳰]]","连载":"2015-2019","卷数":"8卷"}
支持在值中嵌入站内链接 [[ ]] 和外链 [文本](URL)。
别名设置用途
别名为字符串字段，多个别名使用英文逗号 , 分隔。作用是增强搜索匹配能力。
例如：词条标题为「终将成为你」，设置别名为 やがて君になる, Become You，则用户搜索这些别名也能找到该词条。
四、新建词条
当用户达到相应权限后，可创建新词条。
操作入口
- 方法一：点击顶部导航栏用户名进入「用户中心」，选择「新建词条」；
- 方法二：直接访问
/?page=edit。
填写内容
新建词条需填写以下字段：
- 标题：主名称，唯一标识。
- 副标题：补充说明（可选）。
- 分类：选择所属类别（如漫画、小说、动画等）。
- 标签：关键词标签，便于归类检索。
- 别名：用于搜索匹配的其他名称，逗号分隔。
- 信息框：JSON 结构化数据。
- 正文：Markdown 格式内容。
审核机制
- 免审批用户：提交后立即发布。
- 普通用户：需等待管理员审核，通过后方可公开显示。
五、用户中心
登录状态下，点击顶部导航栏的用户名即可进入个人中心。
主要功能
- 权限进度查看：实时显示当前所处权限阶段（访客 / 编辑者 / 新建者 / 免审批）。
- 贡献统计：已成功修订次数、已成功新建条数。
- 快速操作入口：「新建词条」按钮直达编辑页。
六、搜索功能
YuriWiki 提供全文搜索支持：
搜索范围
支持在以下字段中进行匹配查找：
- 词条标题
- 正文内容
- 标签
- 别名
搜索优先级
- 别名精确匹配优先展示
- 其次按标题相似度排序
- 最后是正文与标签匹配结果
七、公告系统
系统会定期推送重要通知。
显示逻辑
- 用户访问首页时，若有有效公告，则自动弹出。
- 用户可点击「我知道了」手动关闭。
- 若勾选「不再显示」，则除非公告更新，否则不会再次弹出。
八、开放 API
YuriWiki 提供开放接口，所有接口均以 JSON 格式返回，已开启 CORS 跨域支持，方便第三方应用与开发者调用。
接口基础地址：
https://wiki.yuri.fan/?page=api，所有请求均通过 GET 方式提交。搜索词条
根据关键词模糊搜索词条，支持标题、内容、标签、别名匹配。
请求方式
GET
请求地址
https://wiki.yuri.fan/?page=api&action=search&q=百合
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action |
string | 是 | 固定值 search |
q |
string | 是 | 搜索关键词 |
返回示例
json
{
"code": 200,
"data": [
{
"id": 1,
"title": "百合",
"subtitle": "Yuri",
"slug": "yuri",
"content": "...",
"tags": "tag1,tag2",
"infobox": "...",
"view_count": 100,
"updated_at": "2026-07-21 10:00:00"
}
]
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
id |
int | 词条唯一 ID |
title |
string | 词条标题 |
subtitle |
string | 副标题 |
slug |
string | URL 标识（用于获取单条词条） |
content |
string | 正文内容（Markdown 原文） |
tags |
string | 标签，逗号分隔 |
infobox |
string | 信息框 JSON 字符串 |
view_count |
int | 浏览次数 |
updated_at |
string | 最后更新时间 |
获取单条词条
通过 slug 获取单个词条的完整信息。
请求方式
GET
请求地址
https://wiki.yuri.fan/?page=api&action=article&slug=yuri
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
action |
string | 是 | 固定值 article |
slug |
string | 是 | 词条的 URL 标识 |
返回示例
json
{
"code": 200,
"data": {
"id": 1,
"title": "百合",
"subtitle": "Yuri",
"slug": "yuri",
"content": "...",
"tags": "tag1,tag2",
"infobox": "...",
"aliases": "别名1,别名2",
"view_count": 100,
"updated_at": "2026-07-21 10:00:00"
}
}
与搜索接口的差异
单条获取接口比搜索接口多返回一个 aliases 字段，包含该词条的所有别名信息。
HTTP 状态码说明
| code | 说明 |
|---|---|
200 |
请求成功 |
400 |
参数错误（缺少必填参数或 action 无效） |
404 |
词条不存在 |
500 |
服务器内部错误（会返回具体错误信息） |
CORS 已开启：接口支持跨域访问，可直接在浏览器端通过 JavaScript 的
fetch 或 XMLHttpRequest 调用，无需额外配置代理。九、注意事项
安全警告：所有输出内容会经过自动转义处理，不支持直接输入 HTML 标签，防止 XSS 攻击。
频率限制：注册与登录接口设有频率限制，防止机器人批量操作。
封禁说明：被封禁账号无法登录，如有疑问请联系管理员申诉。
十、联系管理员
如遇技术问题、功能建议或申诉需求，请通过以下方式联系：
- QQ：3176906054
- 邮箱：mu@kina.ink
常见问题
为什么注册后不能编辑词条？
新注册用户前7天为「访客」身份，只能浏览和搜索。满7天后自动晋升为「编辑者」，即可修改现有词条。
为什么我不能新建词条？
新建词条需要注册满 30 天。满30天后提交的新建词条需管理员审核，审核通过后才会显示。
什么是免审批权限？
累计贡献达标后（满足 3 条新建被批准 或 9 次修订被批准），新建和修改词条无需等待管理员审核，直接发布。
信息框怎么填？
信息框使用 JSON 格式，例如：
{"作者":"[[仲谷鳰]]","连载":"2015-2019","卷数":"8卷"}。支持在值中使用站内链接 [[ ]] 和外链 [文本](URL)。别名有什么用？
别名用于增强搜索匹配能力。例如词条「终将成为你」设置别名为「やがて君になる」，用户搜索该日文名时也能找到该词条。
表格现在能用了吗？
可以了。2026 年 7 月 22 日已修复表格渲染问题，支持标准多行格式和单行粘贴格式。表格宽度超过屏幕时会自动横向滚动，不会撑开页面布局。格式要求：每行以 | 开始和结束；分隔行格式为 | --- | --- |（列数一致）；表头、分隔行、数据行之间必须有换行。
图片插入后为什么不显示？
请确认使用了正确的语法
，并且提供的 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
我们将持续优化平台体验。