AI指南

本文旨在提供Wiki编辑场景下的AI使用指南，正在编写中。请注意，本文不是通用的AI指南。

在合理引导下，AI 可以成为 Wiki 建设的强大助手。

当前先进模型的能力已经相当强大，限制其发挥的往往是使用者自身的认知水平、表述能力、时间投入以及预算限制。

在 BWiki 这类多为游戏主题 Wiki 的平台，AI 能当多面手。除了快速问答，AI还能辅助排版、润色表述。如果提示词合适，AI能轻松完成模板/模块的设计与实现。目前，本站许多实用小工具（Widget）由AI主导编写，AI也润色了大量文档的表述，包括本文。

然而，AI 并非全知全能，它往往不了解 MediaWiki 编辑实战和 BWiki 扩展。

要在 Wiki 建设中充分发挥 AI 能力，关键是提供清晰的背景与需求。关于提示词设计，网上已有大量教程可供参考。有趣的是，许多“如何向人类有效提问”的方法论，例如经典的《提问的智慧》，同样适用于与 AI 的交流。

模型推荐

推荐 DeepSeek 和 GLM，国外模型可尝试 GPT-5 和 Claude。

均需开启“深度思考”，这能显著提升模型表现。

推荐原因

对于简单的问答、Wiki 编辑任务，多数模型都能轻松胜任，且大部分免费使用，无需推荐。

DeepSeek 是中文表述能力最强的模型，能自主深入分析问题。GLM 次之。一些模型如千问、豆包等，通常表现不佳。它们也许在日常问答、轻度办公上表现更好，但在 Wiki 场景，特别是复杂任务上，缺乏主动思考和处理边界情况的能力，经常不遵循指令细节，编写复杂 Wikitext 的能力差。

Wiki 场景中，DeepSeek 不是表现最好的模型。比如 GPT-5 开启 Thinking、Claude Sonnet 4.5 启用 Extended thinking，都在部分情况表现更好，但这两者的使用成本显著更高。比如它们不在国内提供服务，免费额度少且付费成本高（订阅成本约$20/月）。虽然通过 OpenRouter 等第三方平台可以按量使用这些模型，并支持国内支付方式，但其单价通常是 DeepSeek 的数十倍。

可以简单对比相关模型的 API 输出价格（注意使用API的综合成本受多方面影响）：

API价格，单位：元/每百万token输出
模型	价格	模型	价格
DeepSeek	3	Grok Code Fast 1	约 10
GLM 4.5	8 ~ 16	GPT-5	约 71
悬浮框doubao seed 1.6doubao-seed-1.6-thinking	8 ~ 24	GPT-5-mini	约 14
Qwen3 235BQwen3 235B A22B	20	Claude Sonnet 4	约 107
千问Max	24 ~ 60	Claude Opus 4.1	约 535

DeepSeek 显然是性价比最高的模型。

为什么 Wiki 场景会让看似性能接近的模型拉开差距？

模板编写就是一个典型案例。

虽然多数 AI 熟悉基础语法，但通常不了解实际编辑、不熟悉非著名扩展。更不可能了解各个平台的扩展/功能列表。绝大部分模型在编写模板时，会默认缩进HTML（Wikitext不能缩进，行首空格有另外的语义），不少模型会混淆 Wikitext 和 Markdown。

因此 AI 编写模板时，就需要用户提供非常充足的信息和需求，AI 需要理解并灵活运用这些"新知识"来完成模板的设计与编写。这对 AI 的要求较高，实际测试中，多数模型不能一次给出可用的模板。

前文推荐的模型能一次完成可用的模板。而豆包、千问等模型就通常需要多轮调整，反复强调和改错……这过于浪费人类时间。

新模型

每天都有新模型出现，它们可能更强。可以关注领域新闻、了解火山引擎和阿里云百炼等各大云平台的AI服务。

此外，还可以看如OpenRouter平台的销量榜单，用户“用钱投票”的市场份额不会骗人。

MCP工具

对于复杂的模板编写，比如需要使用大量解析器函数的，推荐使用编码工具配合 MCP（Model Context Protocol）工具。例如，可以让 AI 编写一个能够访问解析函数文档的 MCP 工具，辅助完成编写。

提示词分享

提示词的核心是为AI提供信息，不应墨守成规。与某个模型多次交流，熟悉其“能力和秉性”后，通常可以用较少的提示词完成复杂任务。

本节提供的提示词主要在 DeepSeek 上测试，兼顾GLM。

模板生成

提示词包含以下两个部分：

任务：描述具体需求
模板编写说明：预设的指导规则，用于引导AI生成符合BWiki规范的模板

食用方法：

修改「任务」部分，以定义您想生成的模板内容
调整「说明」部分，以精确控制AI的编写行为

常见问题：

语法错误：偶尔会遗漏括号}，或多个class拼接时没有正确留空格
使用markdown：某些模型要反复强调禁止使用markdown
虽然针对千问和豆包常出的Bug打了不少补丁，但其模型能力实在有限，不会自主处理边界情况，经常不遵循提示词要求。需要多轮调整才勉强可用。

# 任务

(这里描述你的需求，比如)请创建一个用于展示提示或警告信息的Wiki模板。该模板需要包含小标题和内容区域，采用扁平化设计风格。

# 模板编写说明
## 平台背景
BWiki是基于MediaWiki 1.37构建的Wiki平台，类似于灰机、Fandom、Miraheze等平台。关键扩展包括：
- Semantic MediaWiki、DynamicPageList3、LabeledSectionTransclusion
- Variables、Arrays、Loops、Scribunto
- ParserFunctions（含字符串函数）、ParserPower、RegexFunctions
- SimpleMathJax、WikiSEO

BWiki带有JQuery和Bootstrap V3（尽量不用，Bootstrap仅在需要时可用栅格系统）。

BWiki托管了大量的Wiki站点，内容以游戏为主，涵盖多个领域。用户参与了其中某个Wiki的编辑（不是BWiki本身）。

## 模板规范要求

### 文件结构
```wikitext
<includeonly>模板主体内容</includeonly><noinclude>
模板文档说明
</noinclude>
```

### Wikitext规范
- 优先使用Wikitext语法，避免不必要的HTML标签。
- 禁止行首空格，禁止缩进（会被解析器视为<pre>块）
- 换行处理：<includeonly>和<noinclude>标签前后不得换行，禁止多余换行（两个换行会被视为新段落，加<p>，仅在需要时使用新段落）。
- 解析函数细节：解析器函数中，参数首尾的空格会被移除（这意味着 class="a{{#if:x| b}}"的结果是class=ab，并非a和b，如需用if添加额外的class，注意在#if前留出空格）
- 其他细节：禁止Unicode符号作为图标；wikitext的列表语法是星号*，子列表是多个星号，如**、***

### CSS规范
- 推荐方法：使用 #css 解析器函数（带安全过滤，禁用 url/var/attr/filter）如必须用相关特性，改用 <bstyle> 标签 
- 缩进换行：正常缩进，必须换行
- 类名规范：采用BEM命名法，禁止使用 bwiki 或 bw 前缀，需避免与现有类名/标签冲突
- 避免重复：模板会多次使用，因此需要仅首次调用时注入CSS，方式在下文代码模板参考中有示例
- 样式数量：避免引入大量CSS代码
- 注释：禁止注释
- 其他细节：禁止rem，无需指定font-family

### HTML规范
- 允许标签：仅限常见安全标签（div、span等）和Mediawiki解析器支持的扩展标签
- 标签使用：优先使用Wikitext语法，避免不必要的HTML标签
- 结构规范：避免复杂嵌套，行首非块级元素需用div包裹（避免被解析器识别为新段落强制加<p>）
- 缩进：禁止缩进、禁止行首空格
- 换行：非块级元素（如span）之前禁止换行（行首的非块级元素被视为新段落，需避免），块级元素如<div>前可换行

### 参数设计规范
- 参数类型：核心参数使用数字参数，非核心参数使用命名参数
- 默认值：所有参数必须提供合理的默认值
- 空值处理：使用 #if 判断空值时，注意避免生成空HTML标签和意外换行
- 模版名：禁止使用 bwiki 或 bw 平台相关名称

## 代码模板参考
```wikitext
<includeonly><!-- 模板内容 -->{{#if:{{#varexists: 模板名CSS }} || {{#vardefine: 模板名CSS | 1 }}{{#css:
/* CSS样式代码，不包含注释 */
}}}}<!-- 若需使用 bstyle，请改用以下写法 -->{{#if:{{#varexists: 模板名CSS }} || {{#vardefine: 模板名CSS | 1 }}<bstyle>/*<pre>*/
/* CSS样式代码 */
/*</pre>*/</bstyle>}}</includeonly><noinclude>
== 功能 ==
描述功能和边界

== 参数 ==
* 1：主要内容，默认值"默认内容"

== 示例 ==
<pre lang=wiki><!-- 示例，按需给出多个，首个采用最小化用法 -->
{{模板名|Hello World|参数名=super}}
</pre>

{{模板名|Hello World|参数名=super}}<!-- 实际展示结果 -->
</noinclude>
```

## 设计需求
- 能适配不同屏幕尺寸，按需做响应式设计
- 确保内容区域具有良好的可读性和间距

请基于以上要求设计模板结构、参数和UX，并编写完整的模板Wikitext代码，包括样式和文档。