本地静态模版转为wangmarket的模版

本文是 WangMarket MCP 模板建站流程的执行规范。除明确标注为固定枚举或固定语法外，文中 HTML、文案、URL、栏目名、codeName、ID、账号、QQ、图片地址和返回 info 均为示例或占位值，不得直接写入生产站点。

版本基准：本文所有”已确认”的模板标签、URL 生成规则、templatePath 行为等结论，均基于 WangMarket 6.1 源码（依赖 wangmarket-6.1.jar）反编译核对。目标站点运行版本不是 6.1 时，标注”6.1 已确认”的项仍须按第 11 章实测确认；标注”跨版本注意”的项尤其需要验证。

执行前置条件：目标站点已开通且已明确；登录凭据有效；运行时工具列表至少包含本次分支所需的 login、save_template_var、save_site_column、save_template_page、save_template_page_text、generate_site，并按页面类型提供 save_news（信息列表内容）或 save_alone_page_content（独立页面内容）；只有实际使用全局变量时才需要 save_site_var/save_site_var_value，只有绑定缺失且获授权修复时才需要 save_template。各工具 schema 必须与本文调用相符；站点是否已有同名对象已确认；预览所需的真实站点基础 URL 已由用户、宿主或后台提供。当前工具集没有站点 URL/生成结果查询工具，也没有”按栏目创建独立页面内容”的工具：真实页面 URL 必须外部提供，独立页面内容若未自动创建必须人工在后台添加后 AI 才能更新。任一当前分支必需条件缺失时必须先报告并停止，不得猜测或开始写入。

⚠️ 静态资源上传前置检查（必须在第 1 章之前完成）：

开始读取和制作模板之前，必须先检查用户上传的 HTML 模板包中是否引用了本地静态资源文件，包括但不限于：

检查与处理流程：

1. 扫描模板：读取所有 HTML 文件，提取上述引用路径，区分绝对 URL（http://、https:// 开头，可直接使用）与相对/本地路径（./、../、/、纯文件名开头，需要上传）。
2. 统计清单：列出所有需要上传的本地静态资源文件路径、数量、总大小，向用户报告。
3. 提醒上传：如果存在本地静态资源，必须暂停模板制作流程，提醒用户将这些资源上传到线上可访问的存储服务，可选方式包括：
   • 阿里云 OSS / 腾讯云 COS / 七牛云等对象存储
   • 公司 FTP 服务器 / 静态资源 CDN
   • 网市场后台的附件上传功能（如有）
   • 其他可公网访问的 HTTP/HTTPS 静态文件服务
4. 配置访问域名：资源上传完成后，必须为存储服务配置一个可公网访问的域名，注意事项：
   • 不得直接使用存储服务的临时域名、内网地址或 IP 地址（如 https://bucket.oss-cn-hangzhou.aliyuncs.com/ 临时域名可能有访问次数限制或随时失效）
   • 必须使用用户自己的已备案域名（如 https://cdn.example.com/、https://static.example.com/），并完成 DNS 解析（CNAME 指向存储服务）
   • 域名必须已完成 ICP 备案（中国大陆服务器要求），未备案域名无法正常访问
   • 建议配置 HTTPS 证书，确保资源通过 https:// 访问，避免混合内容问题（站点如果是 HTTPS，HTTP 资源会被浏览器拦截）
   • 配置完成后，需验证域名可正常解析且资源可通过该域名访问（如 https://cdn.example.com/css/style.css 返回 200）
5. 获取 URL：域名配置并验证通过后，要求用户提供每个资源对应的线上可访问 URL（或一个统一的基础 URL 前缀 + 相对路径映射规则，如基础前缀 https://cdn.example.com/ + 相对路径 css/style.css）。
6. 验证可访问：对每个线上 URL 进行可访问性验证（HTTP 状态码 200、Content-Type 正确、非空响应体），图片资源建议验证可正常渲染。
7. 替换路径：验证通过后，将模板 HTML 中所有本地静态资源路径统一替换为对应的线上 URL。
8. 继续流程：完成上述步骤后，才能进入第 1 章开始正常的模板制作流程。

禁止行为：

• ❌ 不得将本地相对路径（如 images/logo.png、css/style.css）直接写入模板页面或模板变量，否则生成的站点会出现图片不显示、样式丢失、脚本失效等问题。
• ❌ 不得使用 {templatePath} 前缀指向本地资源目录——{templatePath} 仅用于模板自带的示例资源路径，生产环境必须替换为真实可访问的线上 URL。
• ❌ 不得在未验证 URL 可访问的情况下继续流程，必须确认资源真实可访问后再替换。
• ❌ 不得使用存储服务的临时域名、内网地址或 IP 地址作为资源访问地址——临时域名可能有访问次数限制或随时失效，内网地址/IP 无法公网访问，必须使用用户自己的已备案域名并配置 HTTPS。

例外情况：如果模板中所有静态资源均已使用绝对 URL（如 https://cdn.example.com/css/style.css），且验证可访问，则无需上传，可直接进入第 1 章。

目录

• ⚠️ 静态资源上传前置检查
• 1. 相关资料
  • 1.1 index.html 首页源代码
  • 1.2 about.html 关于我们源代码
  • 1.3 news.html 新闻列表源代码
• 2. 抽取，创建模板变量
  • 2.1 查看 HTML 模板源代码
  • 2.2 创建模板变量
  • 2.3 改动模板页面
• 3. MCP 接口
• 4. 创建首页
  • 4.1 创建首页的模板页面
  • 4.2 生成整站，预览成果
• 5. 创建关于我们页面
  • 5.1 创建关于我们的模板页面
  • 5.2 创建”关于我们”栏目
  • 5.3 修改”关于我们”的内容，预览
  • 5.4 独立页面当前底层实现
• 6. 创建新闻列表页面
  • 6.1 创建”新闻列表”的模板页面
  • 6.2 添加”新闻资讯”栏目
  • 6.3 添加新闻资讯内容，并预览本栏目
• 7. 修改导航栏菜单的链接网址
• 8. 设置全局变量
• 9. 模板标签公开基线白名单与上下文规则
• 10. 已确认规则与仍需确认的执行边界
• 11. 运行时确认操作指南
• 常见问题与避坑指南
• AI 自动执行的唯一闭环

阅读指南

本文档版本：基于 WangMarket 6.1 核对版本编写。不同版本的标签适用性、URL 生成规则和字段行为可能存在差异，执行前必须按第 11 章「运行时确认操作指南」核对目标运行时。

AI 执行前置规则：来源优先级、版本边界与禁止猜测

本文档供 AI 读取并执行模板建站，但只把有当前运行时或明确源码依据的规则标为可执行。文档中的示例和历史说明不自动成为参数默认值。执行时必须遵守以下规则：

1. 实际运行时 MCP 工具的 inputSchema / enum / 返回结果决定“接口能否接受某个参数”；源码和本文档决定“当前业务是否应该使用该参数”。“schema 仍兼容”不等于“AI 可以继续新建时使用历史废弃值”。
2. 父级源码和帮助页只用于解释已核对的当前语义；存在版本差异时必须保留“待确认”状态。
3. /templateTag/*.do 帮助页用于核对标签名称、适用页面、循环上下文和调用语法，但帮助页版本必须与目标运行时一致。
4. 本地未渲染 Markdown 是本文的 canonical 文本。在线 CMS 页面可能执行花括号标签或破坏转义，不能在未验证原样发布前作为机器执行依据。
5. 遇到本文档写为“源码未定义”“无完整技术规范”或“需确认”的内容时，必须停止并请求依据，不得由 AI 自行补全。
6. 禁止按照其他 CMS、Jinja、Django、Vue、WordPress 等系统经验推导网市场不存在的标签、枚举、输入模型代码或 DOM 协议。
7. 本文自动执行入口是 MCP。authHandle 只能原样使用 login.result=1 时返回的值，并显式传给每个业务工具；不得用用户名、密码、上游 token、session 或 iwSID 替代。
8. 每次响应先检查 MCP/传输错误，再检查业务 result。出现 mcpError、isError=true、超时、连接中断或 result != 1 时停止当前依赖链；result=2 时重新登录后只重试刚才失败的步骤。提交状态不明时不得盲目重试写操作。
9. 只有接口定义明确说明为 ID 的真实成功返回值才能传给后续 ID 参数。非数字信息、示例值、名称、codeName 或根据 URL 猜出的数字都不是 ID；当前 MCP 无查询能力且上下文没有真实值时必须暂停。
10. 模板标签唯一确认规则：只有目标运行时帮助页或一次真实生成结果确认某个标签及其上下文可用，AI 才能把它写入模板；帮助资料冲突且无法确认时必须暂停，不得回退、混用或猜测。WangMarket 6.1 例外：{news.*}、{siteColumn.*}、{page.*}、{templatePath} 已通过源码反编译确认可用（见第 10 章已确认表），6.1 版本可直接使用；动态调用标记（SiteColumn_Start/End、List_Start/End、SubColumnList_Start/End）内部字段及非 6.1 版本仍按本规则确认。
11. 上游 URL、application/x-www-form-urlencoded、token、iwSID Cookie 只属于 MCP Server 与 WangMarket 之间的实现核对信息，不是 AI 的执行步骤。AI 只调用 MCP 工具；不得直接请求上游 URL，也不得自行构造 token、iwSID 或 Cookie 去替代 authHandle。
12. 本文所有可执行 JSON / HTML 示例中的 URL、文案、联系方式、账号、codeName、ID、图片地址都是示例或占位值，不得原样提交到生产站点；必须先替换为用户、宿主或后台提供的真实值。
13. 静态资源强制检查规则：开始制作模板前，必须扫描用户上传的 HTML 模板中引用的所有本地静态资源（CSS、JS、图片、字体、视频等），如存在相对路径或本地路径引用，必须暂停流程，提醒用户上传到线上云存储或 FTP 并提供可访问 URL，验证 URL 可访问后替换模板中的本地路径为线上 URL，验证通过后方可继续。禁止将本地相对路径直接写入模板页面或模板变量（详见文首「静态资源上传前置检查」）。

原样发布要求：本文中的 {...}、HTML 和 JSON 示例必须使用 CMS 提供的原样代码保护方式，或在发布前实体编码。发布后必须重新抓取验证：代码块中的标签仍为字面文本，JSON 可独立解析，没有整篇正文嵌入、重复章节或丢失反斜杠。无法保证原样发布时，在线页面不得作为 AI 执行依据。

当前最重要的版本结论：

TemplatePage.type
0 = TYPE_ELSE / 其他；只有历史常量，无明确标准业务生成、绑定、预览路径；MCP 不使用
1 = 首页模板；当前使用
2 = 文章列表模板；当前使用
3 = 文章详情模板；当前使用；关于我们等单页面也并入该模板类型
6 = TYPE_ALONEPAGE / 旧独立页面模板；已废弃并入 type=3；MCP 不使用
SiteColumn.type
1 = TYPE_NEWS / 新闻信息；CMS 已废弃
2 = TYPE_IMAGENEWS / 图文信息；CMS 已废弃
3 = TYPE_PAGE / 旧版独立页面；仅历史兼容
4 = TYPE_LEAVEWORD / 留言板；CMS 已废弃
5 = TYPE_HREF / 超链接；CMS 已废弃
6 = TYPE_TEXT / 纯文字栏目；CMS 已废弃
7 = TYPE_LIST / 信息列表；当前 CMS 使用
8 = TYPE_ALONEPAGE / 独立页面；当前 CMS 使用

当前 AI/MCP 新建栏目只按业务使用：

新闻资讯等列表栏目 → SiteColumn.type = 7
关于我们等独立页面栏目 → SiteColumn.type = 8

因此“关于我们”的当前执行关系示例为：

TemplatePage.type = 3
+
SiteColumn.type = 8
+
SiteColumn.templatePageViewName = about
+
SiteColumn.editMode = 0（通过内容管理维护正文时）

特别注意：TemplatePage.type=3 与 SiteColumn.type=3 不是同一含义。前者是当前详情页模板，后者只是旧版独立页面栏目兼容值；若目标运行时版本不同，必须以运行时 schema 和实际结果为准。

1. 相关资料

教程中的 HTML 原始模板

现有 HTML 模板共有三个页面：首页、关于我们、新闻列表。
这里，来演示将此 HTML 模板制作成网市场云建站系统所用模板的步骤。
为了方便 AI 直接读取、分析并根据本文档进行模板制作，本教程不再要求另外下载附件，下面直接提供原始模板中的三个 HTML 文件完整源代码：

• index.html：首页
• about.html：关于我们
• news.html：新闻列表

⚠️ 第 1 章三段源码不可直接提交：仅作视觉与结构参考

下面三段是第三方原始模板的完整源码，其中的开发者姓名、QQ、微信、微信公众号、官网、GitHub、开源中国地址、交流 QQ 群号以及全部宣传文案，都是原模板自带的内容，不是本次建站的目标数据。

执行型 AI 不得把它们原样复制到生产站点：制作模板时只保留结构与样式，把文案、联系方式、链接全部替换为用户提供的真实值。第 2 章之后的每个可执行 JSON / HTML 示例同样如此（前置规则第 12 条）。

1.1 index.html 首页源代码

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <title>网·市场</title>
</head>
<body>
<!-- 每个页面都有的头部导航 -->
<nav style="text-align:center; font-size:26px;">
    <a href="index.html">首页</a>
    <a href="about.html">关于我们</a>
    <a href="news.html">新闻列表</a>
    <hr/>
</nav>
<div>
    <h2>hi，这是首页</h2>
</div>
<div>        网市场云建站系统，系统成熟、流程完善、细节精致、使用简单。极低的成本投入，30秒安装部署，选好模版一键导入。最快出网站，最快赚到钱。网市场云建站系统，历经8年，不断完善，拒绝半成品！
    注重实际业务应用，一切以建站公司的利益为主。
</div>
<div>
    <h3>交流反馈:</h3>
    开发者姓名：管雷鸣<br/>
    开发者QQ：921153866<br/>
    开发者微信：xnx3com<br/>
    开发者微信公众号：wangmarket<br/>
    交流QQ群：472328584<br/>
    官方网站：www.wang.market<br/>
    GitHub：github.com/xnx3/wangmarket<br/>
    开源中国：gitee.com/mail_osc/wangmarket<br/>
</div>
<!-- 每个页面都有的尾部 -->
<footer style="text-align:center; padding-top:30px;">
    <hr/>
    power by: wang.market  
    author: 管雷鸣  
    QQ群：472328584 
</footer>
</body>
</html>

1.2 about.html 关于我们源代码

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <title>网·市场</title>
</head>
<body>
<!-- 每个页面都有的头部导航 -->
<nav style="text-align:center; font-size:26px;">
    <a href="index.html">首页</a>
    <a href="about.html">关于我们</a>
    <a href="news.html">新闻列表</a>
    <hr/>
</nav>
<h1>关于我们</h1>
<div>
    网市场云建站系统，于09年开发wap系统建站。之后在xnx3、iw等基础上开发而来。
    于15年重新启动，<br/>
    16年开始试运行<br/>
    17年底正式开源发布！<br/>
    截止17年底：<br/>    共建立网站服务客户一千余个，经过市场及客户验证。而非一时兴起作出来扔网上开源后就不管的<br/>
    截止17年中旬，svn版本更新迭代837次、版本功能性升级57次！
</div>
<!-- 每个页面都有的尾部 -->
<footer style="text-align:center; padding-top:30px;">
    <hr/>
    power by: wang.market  
    author: 管雷鸣  
    QQ群：472328584 
</footer>
</body>
</html>

1.3 news.html 新闻列表源代码

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <title>网·市场</title>
</head>
<body>
<!-- 每个页面都有的头部导航 -->
<nav style="text-align:center; font-size:26px;">
    <a href="index.html">首页</a>
    <a href="about.html">关于我们</a>
    <a href="news.html">新闻列表</a>
    <hr/>
</nav>
<h1>新闻列表</h1>
<ul>
    <li><a href="about.html">v4.0升级了！</a></li>
    <li><a href="about.html">v3.9升级了！</a></li>
    <li><a href="about.html">v3.8.1升级了！</a></li>
    <li><a href="about.html">v3.8升级了！</a></li>
    <li><a href="about.html">v4.0升级了！</a></li>
    <li><a href="about.html">v3.9升级了！</a></li>
    <li><a href="about.html">v3.8.1升级了！</a></li>
    <li><a href="about.html">v3.8升级了！</a></li>
    <li><a href="about.html">v4.0升级了！</a></li>
    <li><a href="about.html">v3.9升级了！</a></li>
</ul>
<div>
    <!--这是分页-->
    <a href="">首页</a>
    <a href="">上一页</a>
    <a href="">下一页</a>
    <a href="">尾页</a>
</div>
<!-- 每个页面都有的尾部 -->
<footer style="text-align:center; padding-top:30px;">
    <hr/>
    power by: wang.market  
    author: 管雷鸣  
    QQ群：472328584 
</footer>
</body>
</html>

2. 抽取，创建模板变量

创建模板变量的目的，如：
很多页面中都有头部导航，如果导航中要增加一项，那么有导航的每个页面也要挨个改过来，页面很多，太麻烦。而做成模板变量，可以只需要改动模板变量即可。
页面中都是调用模板变量，也就不用再每个页面都去改了。

2.1 查看 HTML 模板源代码

查看上面提供的 about.html、index.html、news.html 三个模板页面源代码，找到三个模板页面中都共同有的头部、尾部。
当然，这里不一定非得头部、尾部，这里只是把相同的地方找出来。
根据上面三个 HTML 文件，可以直接确认共同的头部导航代码为：

<!-- 每个页面都有的头部导航 -->
<nav style="text-align:center; font-size:26px;">
    <a href="index.html">首页</a>
    <a href="about.html">关于我们</a>
    <a href="news.html">新闻列表</a>
    <hr/>
</nav>

共同的尾部代码为：

<!-- 每个页面都有的尾部 -->
<footer style="text-align:center; padding-top:30px;">
    <hr/>
    power by: wang.market  
    author: 管雷鸣  
    QQ群：472328584 
</footer>

2.2 创建模板变量

将上面找到的相同的两处，分别保存成网市场云建站系统的模板变量。
登录当前网站的管理后台后，在左侧菜单中依次进入：

模板管理
→ 模板变量

其中：

• 模板管理：左侧一级菜单；
• 模板变量：展开”模板管理”后显示的二级菜单。
  点击”模板变量”后，即进入模板变量管理页面。
  在创建或编辑模板变量时，页面中主要需要填写以下内容：

  变量名
  备注
  模板变量代码

  以头部导航为例，创建一个名为 nav 的模板变量。
  填写方式：

  变量名：nav
  备注：通用头部导航
  模板变量代码：粘贴三个 HTML 页面中共同的头部导航代码

  nav 的模板变量代码为：

  <nav style="text-align:center; font-size:26px;">
    <a href="index.html">首页</a>
    <a href="about.html">关于我们</a>
    <a href="news.html">新闻列表</a>
    <hr/>
  </nav>

  保存后，这段公共导航代码就成为一个名为 nav 的模板变量。
  同样的方法，再创建一个名为 footer 的模板变量。
  填写方式：

  变量名：footer
  备注：通用页面底部
  模板变量代码：粘贴三个 HTML 页面中共同的尾部代码

  footer 的模板变量代码为：

  <footer style="text-align:center; padding-top:30px;">
    <hr/>
    power by: wang.market  
    author: 管雷鸣  
    QQ群：472328584 
  </footer>

  保存后，共得到两个模板变量：

  nav
  footer

  在模板变量页面中可以看到说明：模板页面中可以使用：

  {include=变量名}

  调用模板变量。
  因此，名为 nav 的模板变量，在模板页面中使用：

  {include=nav}

  进行调用。
  名为 footer 的模板变量，在模板页面中使用：

  {include=footer}

  进行调用。
  也就是说：

  {include=nav}
  → 调用上面保存的公共头部导航代码
  {include=footer}
  → 调用上面保存的公共尾部代码

  注：模板变量名字可以自己随便起名，限英文、数字、_（下划线）。
  例如：

  nav
  footer
  header
  top_nav
  footer_1

  均符合命名要求。

2.2.1 使用 MCP 创建模板变量

最新 MCP 文档已经定义：

save_template_var

用于创建或更新当前登录站点的公共模板变量。
因此，原来需要通过后台原生模板变量保存接口完成的 nav、footer 创建，现在如果 AI 已经连接网市场 MCP Server，可以直接调用 save_template_var 完成。
MCP 对应的上游接口为（仅作实现核对信息，不是 AI 的执行步骤；AI 只调用 MCP 工具）：

POST /plugin/adminapi/site/saveTemplateVar.json

对应的 MCP 工具名称为：

save_template_var

调用 save_template_var 前，必须先通过：

login

登录成功，并取得有效：

authHandle

如果前面还没有登录，则先执行：

login
→ result = 1
→ 获取 authHandle

然后再创建模板变量。本文只讨论 MCP 调用；传统 HTTP 的 token 仅属于上游请求层，不得代替 authHandle。

2.2.2 save_template_var 参数说明

save_template_var 支持以下参数：
| 参数 | 是否必填 | 类型 | 含义 |
|—-|—-|—-|—-|
| authHandle | 是 | string | login 成功返回的不透明认证句柄 |
| varName | 是 | string | 模板变量代码，例如 nav、footer |
| id | 否 | integer/null | 省略、null 或 0 表示创建；大于 0 表示更新已有变量 |
| remark | 否 | string/null | 模板变量备注，仅用于后台管理和识别 |
| text | 协议可选；本流程必填 | string | 模板变量的完整 HTML 内容；每次调用会覆盖该变量原内容。创建页面会引用的变量时必须显式传入非空完整 HTML；省略会保存空内容。 |
其中最关键的是：

varName

它就是页面中：

{include=变量名}

所使用的变量代码。
例如：

varName = nav
→ 页面中使用 {include=nav}
varName = footer
→ 页面中使用 {include=footer}

text 则是实际需要被替换进去的完整 HTML。

id 省略、传 null 或传 0 时接口按“新建”处理，不会按 varName 自动查找并覆盖已有变量。执行前必须确认 nav/footer 同名变量不存在；若已存在，只能取得并核验该变量的真实 ID 后按更新调用，ID 不明时停止，不得再次省略 id 创建副本。

2.2.3 通过 MCP 创建 nav

创建 nav 时调用：

save_template_var

⚠️ 不可直接提交：以下示例仅用于说明 JSON 结构。其中 index.html、about.html、news.html 是原始模板自带的相对链接，不是最终地址；文案、链接、数量都必须替换为用户提供的真实内容，最终导航须按第 7 章用真实 URL 重写。HTML 字符串必须由 JSON 编码器正确转义。

传参示例：

{
  "authHandle": "<login 返回的有效 authHandle>",
  "varName": "nav",
  "remark": "通用头部导航",
  "text": "<nav style="text-align:center; font-size:26px;">n<a href="<真实首页 URL>">首页</a>n<a href="<真实关于我们 URL>">关于我们</a>n<a href="<真实新闻列表 URL>">新闻列表</a>n<hr/>n</nav>"
}

若此时尚未取得真实 URL，可按文末闭环第 3 步先保存不含猜测链接的最小导航，待第 8 步拿到真实 URL 后再按真实变量 ID 更新；不得用 about.html、news.html 等示例路径充数。最小指导航仅保留结构、不含任何 <a href> 链接项，例如：

<nav style="text-align:center; font-size:26px;">
<hr/>
</nav>

它保证页面有完整 nav 结构但不输出错误链接；取得真实 URL 后必须按真实变量 ID 替换为完整导航。
参数对应关系：

authHandle
→ login 成功后返回的认证句柄
varName = nav
→ 模板变量名称
remark = 通用头部导航
→ 后台备注
text
→ nav 的完整 HTML 代码

如果是新建变量：

id

可以省略，也可以传：

0

不需要自行传：

userid
siteid
templateName

这些信息由当前登录站点状态自动确定。
正确返回结果应满足：

{
  "result": 1,
  "info": "123"
}

其中：

result = 1
→ 模板变量保存成功
info = "123"
→ 示例中的模板变量 ID

实际 ID 必须以接口真实返回值为准；只有 info 能严格解析为大于 0 的模板变量 ID 时才保存，用于后续更新。若 result=1 但 info 为空或为非数字成功文本，变量可能已保存但当前 MCP 无法定位它，必须停止后续覆盖操作并由后台确认，不能猜 ID 或用 id=0“更新”。
结果判断：
| 返回情况 | 是否正确 | 处理 |
|—-|—-|—-|
| result = 1 且 info 为已确认的正整数 ID | 正确 | nav 创建成功，保存真实 ID 后继续创建 footer |
| result = 1 但 info 不是有效 ID | 不完整 | 停止依赖该 ID 的更新操作，要求后台确认，避免重复创建 |
| result = 0 | 不正确 | 模板变量保存业务失败，应查看 info |
| result = 2 | 不正确 | 未登录或 authHandle 已失效，需要重新 login |
| 返回 mcpError | 不正确 | MCP 适配器发生传输、协议、序列化或参数转换错误 |
创建成功后：

{include=nav}

即可用于模板页面中引用该变量。

2.2.4 通过 MCP 创建 footer

nav 保存成功以后，再次调用：

save_template_var

创建 footer。

⚠️ 不可直接提交：原始模板里的 wang.market、作者名、QQ 群号等都是原模板自带内容；下面已统一改成占位符，执行前必须替换为用户提供的真实署名与联系方式（QQ 群号后续会按第 8 章改成 {var.qq}）。

传参示例：

{
  "authHandle": "<login 返回的有效 authHandle>",
  "varName": "footer",
  "remark": "通用页面底部",
  "text": "<footer style="text-align:center; padding-top:30px;">n<hr/>npower by: <用户提供的真实署名> &nbsp;nauthor: <用户提供的真实作者名> &nbsp;nQQ群：<用户提供的真实 QQ 群号> n</footer>"
}

参数对应关系：

authHandle
→ 与前面创建 nav 时使用同一个仍然有效的 authHandle
varName = footer
→ 模板变量名称
remark = 通用页面底部
→ 后台备注
text
→ footer 的完整 HTML 代码

正确返回结果同样应满足：

{
  "result": 1,
  "info": "124"
}

其中：

result = 1
→ footer 保存成功
info = "124"
→ 示例中的模板变量 ID

实际 ID 以真实接口返回值为准；只有正整数 info 才能作为后续更新 id。
保存成功以后：

{include=footer}

即可在模板页面中调用该变量。

2.2.5 模板变量 MCP 调用的正确顺序

本流程要求：在调用 save_template_page_text 保存包含 {include=...} 的页面 HTML 之前，先创建对应模板变量并确认保存成功。 这是为了保证生成时有可替换内容；不要把“协议层 text 可选”理解成可以创建空变量继续流程。
因此，本教程正确的 MCP 顺序应为：

login
↓
确认 result = 1
↓
获得 authHandle
save_template_var
varName = nav
text = nav 完整 HTML
↓
确认 result = 1
save_template_var
varName = footer
text = footer 完整 HTML
↓
确认 result = 1
之后才能：
save_template_page
↓
save_template_page_text

也就是说，不能先保存：

{include=nav}
{include=footer}

到模板页面，再去创建变量。
正确顺序必须是：

先创建 nav、footer
↓
确认两个 save_template_var 都 result = 1
↓
再保存引用它们的 index.html / about.html / news.html

如果页面引用的变量不存在或内容为空，生成结果可能保留占位符或输出空内容；必须在生成前检查变量已成功保存。
而 generate_site 在生成网站时，会从当前站点模板变量缓存中读取与变量代码匹配的 text，再用实际 HTML 替换：

{include=nav}
{include=footer}

因此：

save_template_var

不仅是在后台创建一条变量记录，同时还会：

写入 template_var
写入 template_var_data
刷新模板变量缓存
记录操作日志

这一步必须在模板页面引用变量之前完成。

2.2.6 模板变量命名、嵌套、保留名与命名空间

父级源码确认模板变量本质上保存于：

template_var.var_name

引用格式固定为：

{include=变量名}

当前可以确定的规则：

• 模板变量名按本教程规则仅使用英文、数字、下划线 _；MCP varName 最大长度 20。
• nav、footer 只是推荐命名，不是系统强制保留名。
• 当前父级源码中没有发现一份固定的模板变量系统保留名清单，因此不得伪造“保留变量列表”。
• 本自动流程不依赖模板变量嵌套。不同运行时可能循环展开 {include=...}，旧资料又称嵌套不生效，行为存在版本冲突；需要多个公共片段时，统一在模板页面中分别调用。
• 严禁直接或间接循环引用（例如 A 引用 B、B 又引用 A），以免替换不终止或产生不可预测结果。模板变量内部是否支持非循环的 {include=...} 必须按目标版本实测确认；{var.xxx}、通用标签和动态栏目调用仍按各自适用范围处理。

AI 必须严格区分以下命名空间：

因此不得把 site.*、siteColumn.*、news.*、page.* 当成模板变量去创建，也不得把 {var.logo} 改写成 {include=logo}。

2.3 改动模板页面

上一步我们创建了两个模板变量 nav、footer，接下来，就可以将模板页面中的这两处改成动态调用模板变量。
将原来的公共头部导航代码替换为：

{include=nav}

将原来的公共尾部代码替换为：

{include=footer}

三个页面都同样如此。
修改后的 index.html：

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <title>网·市场</title>
</head>
<body>
{include=nav}
<div>
    <h2>hi，这是首页</h2>
</div>
<div>        网市场云建站系统，系统成熟、流程完善、细节精致、使用简单。极低的成本投入，30秒安装部署，选好模版一键导入。最快出网站，最快赚到钱。网市场云建站系统，历经8年，不断完善，拒绝半成品！
    注重实际业务应用，一切以建站公司的利益为主。
</div>
<div>
    <h3>交流反馈:</h3>
    开发者姓名：管雷鸣<br/>
    开发者QQ：921153866<br/>
    开发者微信：xnx3com<br/>
    开发者微信公众号：wangmarket<br/>
    交流QQ群：472328584<br/>
    官方网站：www.wang.market<br/>
    GitHub：github.com/xnx3/wangmarket<br/>
    开源中国：gitee.com/mail_osc/wangmarket<br/>
</div>
{include=footer}
</body>
</html>

修改后的 about.html：

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <title>网·市场</title>
</head>
<body>
{include=nav}
<h1>关于我们</h1>
<div>
    网市场云建站系统，于09年开发wap系统建站。之后在xnx3、iw等基础上开发而来。
    于15年重新启动，<br/>
    16年开始试运行<br/>
    17年底正式开源发布！<br/>
    截止17年底：<br/>    共建立网站服务客户一千余个，经过市场及客户验证。而非一时兴起作出来扔网上开源后就不管的<br/>
    截止17年中旬，svn版本更新迭代837次、版本功能性升级57次！
</div>
{include=footer}
</body>
</html>

修改后的 news.html：

<!DOCTYPE HTML>
<html>
<head>
    <meta charset="utf-8">
    <title>网·市场</title>
</head>
<body>
{include=nav}
<h1>新闻列表</h1>
<ul>
    <li><a href="about.html">v4.0升级了！</a></li>
    <li><a href="about.html">v3.9升级了！</a></li>
    <li><a href="about.html">v3.8.1升级了！</a></li>
    <li><a href="about.html">v3.8升级了！</a></li>
    <li><a href="about.html">v4.0升级了！</a></li>
    <li><a href="about.html">v3.9升级了！</a></li>
    <li><a href="about.html">v3.8.1升级了！</a></li>
    <li><a href="about.html">v3.8升级了！</a></li>
    <li><a href="about.html">v4.0升级了！</a></li>
    <li><a href="about.html">v3.9升级了！</a></li>
</ul>
<div>
    <!--这是分页-->
    <a href="">首页</a>
    <a href="">上一页</a>
    <a href="">下一页</a>
    <a href="">尾页</a>
</div>
{include=footer}
</body>
</html>

以上三段是中间处理稿，不是可直接提交生产站点的最终 HTML。news.html 中的固定文章、about.html 链接和空分页链接只用于展示原始模板；保存到 MCP 前必须按第 6.1 节改为文章循环、真实 {news.url} 和分页 URL。about.html 也必须按第 5.1 节替换为详情模板标签。任何未完成这些转换的源码不得直接调用 save_template_page_text。

⚠️ 重要提醒：模板页面必须保留完整 HTML 结构（含 <meta charset="utf-8">）

在将原始 HTML 改造成模板页面时，必须保留完整的 HTML 文档结构，包括 <!DOCTYPE html>、<html>、<head>、<meta charset="utf-8">、<title>、<body> 等标签。

如果只保留 body 内部内容（如只写 {include=nav} + 内容 + {include=footer}），生成的静态 HTML 文件将缺少 <head> 中的编码声明，浏览器会使用默认编码解析，导致中文乱码。

正确的模板页面结构示例：

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>页面标题</title>
</head>
<body>
{include=nav}
...页面内容...
{include=footer}
</body>
</html>

详见本文档末尾「常见问题与避坑指南」中的问题2。

3. MCP 接口

本节 JSON 只是某一版本的 tools/list 定义快照，不是可直接发送的 MCP 请求，也不保证代表当前运行时。执行前必须重新读取运行时 tools/list；只使用实际返回且 schema 匹配的工具和字段。缺少当前分支必需的工具或字段时必须停止，不得按快照补造；未使用的可选工具不构成阻断。

上游 HTTP 层信息只作实现核对（前置规则第 11 条）：本文任何位置出现的上游 URL、application/x-www-form-urlencoded、token、iwSID Cookie、POST /plugin/... 都只是 MCP Server 与 WangMarket 之间的实现说明，不是 AI 的执行步骤。除非用户明确要求传统 HTTP 调用，AI 只调用 MCP 工具，不得直接请求这些 URL，也不得自行构造 token、iwSID 或 Cookie 去替代 authHandle。

{
"jsonrpc": "2.0",
"id": "<echo-request-id>",
"result": {
"resultType": "complete",
"ttlMs": 0,
"cacheScope": "private",
"tools": [
{
"name": "login",
"title": "登录网市场站点",
"description": "使用用户名或邮箱与密码建立 WangMarket 上游应用认证状态。成功后返回 authHandle；后续每一个 WangMarket 业务工具调用都必须显式传入该 authHandle。MCP Server 通过 authHandle 从内部私有认证存储中解析上游 iwSID Cookie 并转发给 WangMarket，绝不向 MCP Client 暴露 iwSID Cookie 或上游 token。",
"inputSchema": {
"type": "object",
"required": ["username", "password"],
"additionalProperties": false,
"properties": {
"username": {
"type": "string",
"minLength": 1,
"description": "登录用户名或邮箱。MCP HTTP 适配器必须将其编码为上游表单字段 username。"
},
"password": {
"type": "string",
"minLength": 1,
"description": "登录密码。MCP Client 和 Server 不得在日志、工具摘要或普通文本回复中泄露该值。MCP HTTP 适配器必须将其编码为上游表单字段 password。"
}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {
"type": "integer",
"enum": [0, 1, 2],
"description": "上游 LoginVO/BaseVO 状态码。1=登录成功，0=登录业务失败，2=未登录或 WangMarket 上游应用认证状态无效。"
},
"info": {
"type": "string",
"description": "上游登录结果说明。失败时可以直接作为面向用户的错误文本。"
},
"authHandle": {
"type": ["string", "null"],
"description": "仅 result=1 时返回的不透明认证句柄。后续每一个业务工具 save_template_var、save_site_column、save_news、save_alone_page_content、save_template_page、save_template_page_text、save_template、save_site_var、save_site_var_value、generate_site 都必须原样传入此值。它不是 iwSID、上游 token、用户名或密码；不得尝试解析、修改或记录其完整值。"
},
"user": {
"type": ["object", "null"],
"description": "登录用户信息。服务端已过滤密码等敏感字段；字段集合可能随服务端版本变化。"
},
"parentAgency": {
"type": ["object", "null"],
"description": "当前用户的上级代理信息；没有上级代理时可能为空。"
},
"mcpError": {
"type": ["object", "null"],
"description": "仅 MCP 适配器自身失败时出现，不是上游 LoginVO 字段。",
"properties": {
"kind": {"type": "string", "enum": ["transport", "protocol", "serialization", "adapter"]},
"message": {"type": "string"}
}
}
}
}
},
{
"name": "save_template_var",
"title": "保存模板变量",
"description": "创建或更新当前登录站点的公共模板变量。变量由 varName 和 text 组成：varName 是页面 HTML 中 {include=变量名} 的引用名，text 是生成整站时替换该占位符的完整 HTML。必须先成功保存变量，才保存引用它的页面 HTML。常见变量为 nav（导航）和 footer（页脚），但它们只是推荐名称，不是系统保留字。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "varName"],
"additionalProperties": false,
"properties": {
"authHandle": {
"type": "string",
"minLength": 1,
"description": "login 成功返回的不透明认证句柄。每次调用都必须显式传入；MCP Server 用它解析内部保存的 WangMarket iwSID Cookie，不会将此字段发送给上游接口。"
},
"id": {
"type": ["integer", "null"],
"default": 0,
"description": "模板变量主键。缺省、null 或 0 表示创建；大于 0 表示更新。更新时 ID 对应变量必须属于当前登录站点。"
},
"varName": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "模板变量代码，例如 nav 或 footer。页面中必须通过完全相同的 {include=varName} 占位符引用，例如 {include=nav}。父级会对该值执行安全过滤。"
},
"remark": {
"type": ["string", "null"],
"maxLength": 30,
"description": "变量备注，仅用于管理和识别；不会作为页面内容输出。父级会对该值执行安全过滤。"
},
"text": {
"type": "string",
"default": "",
"description": "变量的完整 HTML 内容。每次调用都会覆盖该变量原内容；例如 nav 的导航片段或 footer 的页脚片段。"
}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2], "description": "1=保存成功，0=业务失败，2=未登录或 authHandle 无效。"},
"info": {"type": "string", "description": "保存成功时为模板变量 ID；失败时为父级返回的原因。"},
"mcpError": {
"type": ["object", "null"],
"description": "仅 MCP 适配器发生 HTTP、协议、序列化或参数转换失败时出现。"
}
}
}
},
{
"name": "save_site_column",
"title": "创建或更新网站栏目",
"description": "使用同一个工具创建或更新网站栏目并绑定模板页面。父级历史常量：1=新闻信息（已废弃），2=图文信息（已废弃），3=旧版独立页面兼容，4=留言板（已废弃），5=超链接（已废弃），6=纯文字栏目（已废弃），7=信息列表（当前），8=独立页面（当前）。当前 MCP 新建业务只使用 7 或 8；schema 中若仍兼容 1/2/3，不代表 AI 应继续新建时使用。列表栏目填写 templatePageListName，独立页面填写 templatePageViewName。TemplatePage.type 与 SiteColumn.type 是不同字段。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "name", "type"],
"additionalProperties": false,
"properties": {
"authHandle": {"type": "string", "minLength": 1, "description": "login 返回的不透明认证句柄。"},
"id": {"type": ["integer", "null"], "default": 0, "description": "栏目 ID；缺省或 0 创建，大于 0 更新。"},
"name": {"type": "string", "minLength": 1, "description": "栏目名称，例如 新闻动态、关于我们。"},
"type": {"type": "integer", "enum": [1, 2, 3, 7, 8], "description": "当前接口兼容的 SiteColumn 类型值。1=新闻信息（历史废弃），2=图文信息（历史废弃），3=旧版独立页面兼容值，7=信息列表（当前使用），8=独立页面（当前使用）。父级历史 4=留言板、5=超链接、6=纯文字，但不在当前 MCP schema 中。AI 新建栏目只使用 7 或 8。"},
"url": {"type": ["string", "null"], "description": "历史兼容 URL 字段，通常省略。"},
"icon": {"type": ["string", "null"], "description": "栏目图标 URL，可选。"},
"templatePageListName": {"type": ["string", "null"], "description": "列表栏目绑定的模板页面名称。"},
"templatePageViewName": {"type": ["string", "null"], "description": "详情或独立页面栏目绑定的模板页面名称；关于我们应填写此前创建的详情模板（模板页面 type=3）。"},
"codeName": {"type": ["string", "null"], "description": "CMS 栏目代码。需要按代码生成页面时显式传入真实值；它不是 URL。只有已确认目标站点 generateUrlRule=code 时，才能按当前运行时规则推导文件名；否则必须使用真实返回或后台确认的栏目 URL。"},
"parentCodeName": {"type": ["string", "null"], "description": "CMS 父栏目代码，可选。"},
"listNum": {"type": ["integer", "null"], "default": 10, "minimum": 1, "description": "信息列表每页条数。"},
"inputModelCodeName": {"type": ["string", "null"], "description": "输入模型代码。省略、null、空字符串或字符串 "0" 表示不指定自定义模型；其他值必须是当前网站真实存在的 input_model.code_name。当前 MCP 没有输入模型查询工具，不得猜测 product、news、article 等代码，也不得把源码文件路径当作参数值。"},
"editMode": {"type": ["integer", "null"], "enum": [0, 1, null], "default": 0, "description": "独立页面内容编辑方式；0=内容管理 UEditor 富文本，1=直接编辑模板。省略时插件接口对 type=8/3 默认按 0 处理；要修改父级自动创建的 News 内容必须使用 0。"},
"listRank": {"type": ["integer", "null"], "enum": [1, 2, null], "default": 1, "description": "列表排序：1 发布时间倒序，2 发布时间正序。"},
"editUseTitlepic": {"type": ["integer", "null"], "enum": [0, 1, null], "description": "内容管理是否显示标题图片/列表图上传区域；1=显示，0=隐藏。信息列表栏目（type=7）省略时默认为0，建议显式传1；独立页面（type=8）省略时插件默认补为1。"},
"editUseIntro": {"type": ["integer", "null"], "enum": [0, 1, null], "description": "内容管理是否显示简介输入区域；1=显示，0=隐藏。信息列表栏目（type=7）省略时默认为0，建议显式传1；独立页面（type=8）省略时插件默认补为1。"},
"editUseText": {"type": ["integer", "null"], "enum": [0, 1, null], "description": "内容管理是否显示正文输入；1=显示 UEditor 富文本区域，0=隐藏。**信息列表栏目（type=7）省略时默认为0，必须显式传1才能看到正文文本域**；独立页面（type=8）省略时插件接口默认补为1，显式传0才会隐藏。"},
"editUseExtendPhotos": {"type": ["integer", "null"], "enum": [0, 1, null], "description": "内容管理是否显示图集输入。"},
"useGenerateView": {"type": ["integer", "null"], "enum": [0, 1, null], "default": 1, "description": "是否生成内容页面，默认 1。"},
"templateCodeColumnUsed": {"type": ["integer", "null"], "enum": [0, 1, null], "default": 1, "description": "模板栏目调用中是否显示，默认 1。"},
"adminNewsUsed": {"type": ["integer", "null"], "enum": [0, 1, null], "default": 1, "description": "内容管理中是否显示该栏目，默认 1。"},
"used": {"type": ["integer", "null"], "enum": [0, 1, null], "default": 1, "description": "栏目是否启用。"},
"keywords": {"type": ["string", "null"], "description": "SEO 关键词，可选。"},
"description": {"type": ["string", "null"], "description": "SEO 描述，可选。"}
}
},
"outputSchema": {"type": "object", "required": ["result", "info"], "additionalProperties": true, "properties": {"result": {"type": "integer", "enum": [0, 1, 2]}, "info": {"type": "string"}, "mcpError": {"type": ["object", "null"]}}}
},
{
"name": "save_news",
"title": "创建或更新新闻资讯内容",
"description": "使用同一个工具创建或更新信息列表栏目的新闻内容。创建时省略 id 或传 0；更新时传入已有 News.id。当前 MCP schema 在两种操作中都要求 cid，它必须是已确认属于当前站点的真实栏目 ID。保存成功后必须调用 generate_site；预览地址只能使用真实返回、已知上下文或后台确认的 URL。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "cid", "title", "text"],
"additionalProperties": false,
"properties": {
"authHandle": {"type": "string", "minLength": 1, "description": "login 返回的不透明认证句柄。"},
"id": {"type": ["integer", "null"], "default": 0, "description": "News.id；省略或 0 表示创建，大于 0 表示更新。"},
"cid": {"type": "integer", "minimum": 1, "description": "新闻所属栏目 SiteColumn.id。仅当 save_site_column 的 result=1 且 info 可严格解析为已确认属于当前站点的大于 0 的栏目 ID 时使用；不能传非数字 info、栏目代码或模板页面 ID。"},
"title": {"type": "string", "minLength": 1, "description": "新闻标题。"},
"titlepic": {"type": "string", "default": "", "description": "标题图片 URL，可选。"},
"intro": {"type": "string", "default": "", "description": "新闻简介，可选。"},
"text": {"type": "string", "description": "新闻正文的完整 HTML。"}
}
},
"outputSchema": {"type": "object", "required": ["result", "info"], "additionalProperties": true, "properties": {"result": {"type": "integer", "enum": [0, 1, 2]}, "info": {"type": "string"}, "mcpError": {"type": ["object", "null"]}}}
},
{
"name": "save_alone_page_content",
"title": "保存独立页面栏目内容",
"description": "修改独立页面栏目自动创建的内容。仅当 cid 已确认属于当前站点、栏目类型为当前独立页面 type=8（或已确认兼容的历史 type=3）、SiteColumn.editMode=0，且该栏目确实只有一条目标内容时使用。底层按 cid 查询单条 News；若历史数据存在多条同 cid 记录，目标记录不确定，必须停止并由后台确认。保存后必须调用 generate_site，再使用真实 URL 预览。",
"inputSchema": {"type": "object", "required": ["authHandle", "cid", "title", "text"], "additionalProperties": false, "properties": {"authHandle": {"type": "string", "minLength": 1, "description": "login 返回的不透明认证句柄。"}, "cid": {"type": "integer", "minimum": 1, "description": "已确认属于当前站点的独立页面栏目 ID；仅接受 save_site_column 的 result=1 且 info 可严格解析为大于 0 的真实 ID。"}, "title": {"type": "string", "minLength": 1, "description": "内容标题，关于我们通常填写 关于我们。"}, "text": {"type": "string", "description": "要保存的完整正文 HTML。"}, "intro": {"type": "string", "default": "", "description": "内容简介；为空时父级从正文自动截取。"}, "titlepic": {"type": "string", "default": "", "description": "标题图片 URL，可选。"}, "htmlName": {"type": "string", "default": "", "description": "自定义静态 HTML 文件名，不含扩展名可选；不能据此推导预览 URL。"}, "reserve1": {"type": "string", "default": "", "maxLength": 10, "description": "输入模型预留字段 1，可选。"}, "reserve2": {"type": "string", "default": "", "maxLength": 10, "description": "输入模型预留字段 2，可选。"}}},
"outputSchema": {"type": "object", "required": ["result", "info"], "additionalProperties": true, "properties": {"result": {"type": "integer", "enum": [0, 1, 2]}, "info": {"type": "string"}, "mcpError": {"type": ["object", "null"]}}}
},
{
"name": "save_template_page",
"title": "保存模板页面基本信息",
"description": "创建或更新当前登录站点的 TemplatePage 元数据。该工具不保存 HTML 正文；需要保存正文时，必须在页面存在后调用 save_template_page_text。MCP 接口只支持首页、列表页和详情页三种类型；关于我们等单页面使用详情页 type=3。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "name", "type"],
"additionalProperties": false,
"properties": {
"authHandle": {
"type": "string",
"minLength": 1,
"description": "login 成功返回的不透明认证句柄。每次调用都必须显式传入。MCP Server 使用它解析内部保存的 WangMarket iwSID Cookie；不会将该字段发送给上游 saveTemplatePage 接口。"
},
"id": {
"type": ["integer", "null"],
"default": 0,
"description": "模板页面主键。缺省、null 或 0 表示创建；大于 0 表示更新。更新时该 ID 对应的页面必须存在且属于当前站点。"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"description": "模板页面名称，也是 save_template_page_text 的 pageName 定位键，例如 index 或 about。父级会安全过滤该值；同一站点、同一模板下名称不可重复。"
},
"type": {
"type": "integer",
"enum": [1, 2, 3],
"description": "MCP 接口允许的 TemplatePage 类型：1=首页，2=新闻列表，3=新闻详情。关于我们等单页面统一使用 3。类型 1 在同一站点只能存在一个；0 和 6 不属于本 MCP 接口支持范围。"
},
"templateName": {
"type": ["string", "null"],
"description": "页面所属模板名称。创建时父级会无条件改为当前站点 site.templateName；更新时父级不会修改它。普通 AI 调用应省略该参数。"
},
"remark": {
"type": ["string", "null"],
"maxLength": 30,
"description": "页面备注，建议填写便于后台识别，如'网站首页'、'关于我们独立页面'、'新闻列表页'。省略时后台备注列为空。父级会对该值执行安全过滤。"
},
"editMode": {
"type": ["integer", "null"],
"enum": [1, 2, null],
"default": 2,
"description": "TemplatePage 编辑模式：1=智能/可视化模式，2=代码模式。父级源码已标记可视化模式即将废弃、不建议使用；当前仅确认 iframe 编辑、在 </head> 前注入 htmledit.js、注入 htmledit_upload_url、保存时清理 XNX3HTMLEDIT 标记区和编辑器附加资源/属性。没有完整 DOM/API 规范，因此 AI/MCP 默认必须显式传 2。"
}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2], "description": "1=保存成功，0=业务失败，2=未登录。"},
"info": {"type": "string", "description": "保存成功时为模板页面 ID；失败时为父级返回的原因。"},
"mcpError": {
"type": ["object", "null"],
"description": "仅适配器发生 HTTP、协议、序列化或参数转换失败时出现。"
}
}
}
},
{
"name": "save_template_page_text",
"title": "保存模板页面 HTML 内容",
"description": "按照 pageName 完全覆盖当前登录站点指定模板页面的 HTML 内容。必须先通过 save_template_page 创建页面，或确认目标页面已存在。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "pageName", "html"],
"additionalProperties": false,
"properties": {
"authHandle": {
"type": "string",
"minLength": 1,
"description": "login 成功返回的不透明认证句柄。每次调用都必须显式传入。MCP Server 用它解析 WangMarket 上游认证状态；不会将该字段发送给上游 saveTemplatePageText 接口。"
},
"pageName": {
"type": "string",
"minLength": 1,
"description": "目标页面名称，对应 template_page.name，不是页面 ID。父级会安全过滤此值；它必须与已保存的页面名称一致。"
},
"html": {
"type": "string",
"description": "完整 HTML 源码。每次保存会覆盖原内容。模板自带 CSS、JS、图片等资源必须使用 {templatePath}/相对路径引用，不得写死本地或云端模板域名。代码模式基本直接保存；可视化模式会清理编辑器标记区、编辑器附加资源及部分编辑属性，并按父级流程处理模板内容。"
}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2], "description": "1=保存成功，0=业务失败，2=未登录。"},
"info": {"type": "string", "description": "成功时通常为成功消息；失败时为页面不存在、变量不存在或其他父级错误原因。"},
"mcpError": {
"type": ["object", "null"],
"description": "仅适配器失败时出现。"
}
}
}
},
{
"name": "generate_site",
"title": "生成整站 HTML",
"description": "根据当前登录站点的模板页面、模板变量、栏目和内容生成整站 HTML。工具没有业务输入参数。父级仅返回 BaseVO，不会返回 previewUrl；MCP Client 或 Host 如需预览，必须从已知站点上下文获取地址，不能编造返回字段。",
"inputSchema": {
"type": "object",
"required": ["authHandle"],
"additionalProperties": false,
"properties": {
"authHandle": {
"type": "string",
"minLength": 1,
"description": "login 成功返回的不透明认证句柄。每次调用都必须显式传入。MCP Server 用它解析 WangMarket 上游认证状态；不会将该字段发送给上游 generate 接口。"
}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2], "description": "1=生成成功，0=业务失败，2=未登录。"},
"info": {"type": "string", "description": "生成结果说明或失败原因。此字段不是预览 URL。"},
"mcpError": {
"type": ["object", "null"],
"description": "仅适配器失败时出现。"
}
}
}
},
{
"name": "save_site_var",
"title": "创建或更新网站全局变量",
"description": "创建或更新当前网站的全局变量。全局变量在模板页面或模板变量中通过 {var.变量名} 引用，例如 {var.qq}。它与用于整段 HTML 的 {include=变量名} 模板变量完全不同，不能混用。QQ群号等普通文本使用 type=text；图片使用 type=image；固定选项使用 type=select。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "name"],
"additionalProperties": false,
"properties": {
"authHandle": {"type": "string", "minLength": 1, "description": "login 成功返回的不透明认证句柄。MCP Server 用它解析 WangMarket 上游 iwSID 状态，不会将该字段写入 site_var。"},
"updateName": {"type": "string", "default": "", "description": "修改前的变量名。新建时留空；同名修改时可与 name 相同；重命名时填写旧名称，name 填新名称。"},
"name": {"type": "string", "minLength": 1, "description": "变量代码，只使用稳定简短的英文或数字，例如 qq、logo。模板引用格式为 {var.name}。"},
"description": {"type": "string", "default": "", "description": "给非技术用户看的详细填写说明。应注明用途、建议字数、图片尺寸、文件格式或下拉选项含义，例如“QQ群号，只填写数字，不要填写QQ群：前缀”。"},
"value": {"type": "string", "default": "", "description": "变量初始值。text 为普通文本，image 为图片 URL，select 为 valueItems 中某个选项的值。"},
"type": {"type": "string", "enum": ["text", "image", "select"], "default": "text", "description": "录入类型：text 文本、image 单图片、select 下拉选择。"},
"title": {"type": "string", "default": "", "description": "后台全局变量管理页面显示的标题。"},
"valueItems": {"type": "string", "default": "", "description": "type=select 时的完整选项定义；当前 6.1 后台解析格式为每行 值:显示文本。非 select 类型留空。若目标运行时版本不同，必须先在后台确认格式，不能改用猜测的分隔符。"}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2], "description": "1=保存成功，0=业务失败，2=未登录或认证状态无效。"},
"info": {"type": "string", "description": "父级保存结果说明。"},
"mcpError": {"type": ["object", "null"], "description": "仅 MCP 适配器自身失败时出现。"}
}
}
},
{
"name": "save_site_var_value",
"title": "修改网站全局变量值",
"description": "仅修改已存在网站全局变量的值，不改变变量名称、类型、标题、说明或下拉选项。适合后续修改QQ群号、联系电话等内容；变量不存在时必须先调用 save_site_var 创建。修改后仍需调用 generate_site 发布静态页面。",
"inputSchema": {
"type": "object",
"required": ["authHandle", "name", "value"],
"additionalProperties": false,
"properties": {
"authHandle": {"type": "string", "minLength": 1, "description": "login 成功返回的不透明认证句柄。"},
"name": {"type": "string", "minLength": 1, "description": "已存在的全局变量代码，例如 qq；必须与模板中的 {var.qq} 保持一致。"},
"value": {"type": "string", "description": "新的变量值。image 类型填写图片 URL，select 类型填写已配置选项的值。"}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2]},
"info": {"type": "string"},
"mcpError": {"type": ["object", "null"]}
}
}
},
{
"name": "save_template",
"title": "创建或绑定网站模板",
"description": "尝试补齐当前网站 site.template_id 对应的 template 记录。该实现可能在 template_id 无效时使用 ID 1，可能创建或修改既有模板，且 template_id 已指向现存记录时不会重新绑定到其它模板。result=1 只表示本次接口执行成功，不证明模板页面归属、后台生成按钮或最终预览已经正确；调用前必须确认允许其影响现有模板，调用后仍需生成和真实预览验证。",
"inputSchema": {
"type": "object",
"required": ["authHandle"],
"additionalProperties": false,
"properties": {
"authHandle": {"type": "string", "minLength": 1, "description": "login 成功返回的不透明认证句柄。每次调用都必须显式传入。MCP Server 用它解析 WangMarket 上游认证状态；不会将该字段发送给上游 saveTemplate 接口。"},
"name": {"type": "string", "default": "自定义模板", "description": "模板名称，可选，默认「自定义模板」。当模板不存在需要创建时使用此名称；模板已存在时，若传入非默认值则更新名称。"},
"remark": {"type": "string", "default": "", "description": "模板备注，可选，默认空字符串。当模板不存在需要创建时使用此备注；模板已存在时，若传入非空值则更新备注。"}
}
},
"outputSchema": {
"type": "object",
"required": ["result", "info"],
"additionalProperties": true,
"properties": {
"result": {"type": "integer", "enum": [0, 1, 2], "description": "1=保存成功，0=业务失败，2=未登录或认证状态无效。"},
"info": {"type": "string", "description": "成功时为模板 ID；失败时为错误原因。"},
"mcpError": {"type": ["object", "null"], "description": "仅 MCP 适配器自身失败时出现。"}
}
}
}
]
}
}

4. 创建首页

4.1 创建首页的模板页面

网市场云建站系统中，新建一个模板页面，然后将上面已经改成 {include=nav}、{include=footer} 调用方式的 index.html 源代码直接复制到新建立的首页模板页面中，保存即可。
操作过程可以理解为：

模板管理
→ 模板页面
→ 新建模板页面
→ 创建首页模板页面
→ 粘贴修改后的 index.html 源代码
→ 保存

人工后台操作和 MCP 自动操作是两条互斥路径。使用 MCP 时只调用工具，不模拟后台点击；使用人工路径时按后台页面操作，不把点击结果当作 MCP 返回值。
如果当前 AI 已连接 MCP Server，则创建首页模板页面可以按照下面的 MCP 调用顺序执行。

4.1.1 第一步：调用 login 登录网市场站点

在没有有效 authHandle 的情况下，必须先调用：

login

需要传入两个参数：
| 参数 | 是否必填 | 类型 | 含义 | 首页创建时如何传 |
|—-|—-|—-|—-|—-|
| username | 是 | string | 网市场登录用户名或邮箱 | 传用户实际登录用户名或邮箱 |
| password | 是 | string | 网市场登录密码 | 传用户实际登录密码 |
传参示例：

{
  "username": "user@example.com",
  "password": "<用户实际登录密码>"
}

这里的密码只作为 MCP 工具调用参数使用，不能输出到普通回复、日志、工具摘要或其他持久文本中。
login 调用完成后，重点检查返回结果中的：

result
info
authHandle

正确结果应满足：

{
  "result": 1,
  "info": "<登录成功信息>",
  "authHandle": "<MCP Server 返回的不透明认证句柄>"
}

判断规则：
| 返回情况 | 是否正确 | 后续处理 |
|—-|—-|—-|
| result = 1，且返回有效 authHandle | 正确 | 可以继续调用 save_template_page |
| result = 0 | 不正确 | 登录业务失败，停止后续操作，并查看 info |
| result = 2 | 不正确 | 未登录或上游认证状态无效，需要重新登录 |
| 返回 mcpError | 不正确 | 属于 MCP 传输、协议、序列化或适配器错误，应先处理该错误 |

authHandle 是后续业务调用必须使用的不透明认证句柄。MCP Client 不应获取或传递网市场上游的 iwSID Cookie，也不能使用用户名、密码或其他 token 代替 authHandle。

4.1.2 第二步：调用 save_template_page 创建首页模板页面

登录成功并取得有效 authHandle 后，调用：

save_template_page

创建首页模板页面。
首页创建时推荐传入：
| 参数 | 是否必填 | 类型 | 首页示例值 | 含义 |
|—-|—-|—-|—-|—-|
| authHandle | 是 | string | <login 返回的 authHandle> | 当前登录认证句柄 |
| name | 是 | string | index | 模板页面名称，后续保存 HTML 时 pageName 必须与此一致 |
| type | 是 | integer | 1 | 模板页面类型，1 表示首页 |
| id | 否 | integer/null | 省略或 0 | 省略、null 或 0 表示创建；大于 0 表示更新 |
| remark | 否 | string/null | 首页模板 | 页面备注，最大 30 个字符 |
| editMode | 本流程必填 | integer/null | 2 | 编辑模式；本教程每次显式传 2，不能依赖 schema 的 default |
| templateName | 否 | string/null | 普通 AI 调用应省略 | 创建时系统会自动使用当前站点的模板名称 |
完整传参示例：

{
  "authHandle": "<login 返回的 authHandle>",
  "name": "index",
  "type": 1,
  "remark": "首页模板",
  "editMode": 2
}

这里没有传：

id
templateName
siteid
userid

原因是：

id 省略
→ 表示新建页面
templateName
→ 普通 AI 创建时应省略，由当前站点自动确定
siteid、userid
→ 当前 MCP 工具参数中没有这两个字段，不能自行添加

其中：

type = 1

明确表示首页。同一站点只能存在一个首页模板，因此如果当前站点已经存在首页模板，再次创建可能返回业务失败。

这里同时记录父级 TemplatePage 的完整历史常量边界，避免 AI 以后看到 0 或 6 时自行猜测：

type=0 的正确文档结论不是为它臆造一个业务场景，而是：历史上它表示“其他”，当前没有标准业务路径，MCP 不使用。
调用成功时，正确结果应类似：

{
  "result": 1,
  "info": "123"
}

其中：

result = 1
→ 保存成功
info = "123"
→ 示例中的模板页面 ID

这里的 123 只是示例，实际页面 ID 以接口真实返回值为准；该 ID 仅用于记录或后续明确的更新调用，不传给 save_template_page_text。
结果判断：
| 返回情况 | 是否正确 | 含义与处理 |
|—-|—-|—-|
| result = 1 | 正确 | 首页模板页面基本信息创建成功；创建时 info 为页面 ID |
| result = 0 | 不正确 | 业务失败，应直接查看 info，可能是页面名称重复、已有首页模板、保存失败等 |
| result = 2 | 不正确 | 登录状态失效，不能继续，需要重新 login 获取新的 authHandle |
| 返回 mcpError | 不正确 | MCP 适配器自身发生错误 |

需要注意：save_template_page 只保存模板页面的基本信息，不会把第 2.3 节中的完整 index.html 正文保存进去。因此创建页面成功以后，还必须继续调用 save_template_page_text。

4.1.3 第三步：调用 save_template_page_text 保存首页 HTML

首页模板页面已经通过 save_template_page 创建成功后，再调用：

save_template_page_text

保存首页完整 HTML。
需要传入：
| 参数 | 是否必填 | 类型 | 首页示例值 | 含义 |
|—-|—-|—-|—-|—-|
| authHandle | 是 | string | <login 返回的 authHandle> | 当前有效认证句柄 |
| pageName | 是 | string | index | 目标模板页面名称，必须与前面 save_template_page.name 完全一致 |
| html | 是 | string | 第 2.3 节修改后的完整 index.html | 要保存的完整 HTML 源码 |
传参结构示例（占位符不能原样提交）：

{
  "authHandle": "<login 返回的 authHandle>",
  "pageName": "index",
  "html": "<这里必须传入第 2.3 节修改后的 index.html 完整源码>"
}

实际调用时，html 不能只传上面的占位说明，而应把第 2.3 节中已经完成：

{include=nav}
{include=footer}

替换后的 完整 index.html 源码 作为字符串传入。
pageName 必须为：

index

因为前一步创建页面时使用的是：

{
  "name": "index"
}

两者对应关系：

save_template_page.name = index
↓
save_template_page_text.pageName = index

调用成功时，正确结果应满足：

{
  "result": 1,
  "info": "<保存成功信息>"
}

结果判断：
| 返回情况 | 是否正确 | 含义与处理 |
|—-|—-|—-|
| result = 1 | 正确 | index 模板页面 HTML 已保存成功 |
| result = 0 | 不正确 | 业务失败，检查 info；可能是页面不存在、模板变量不存在或模板内容保存失败 |
| result = 2 | 不正确 | 认证状态失效，需要重新 login |
| 返回 mcpError | 不正确 | MCP 适配器自身错误 |
需要特别注意：

save_template_page_text

每次保存都会完整覆盖目标模板页面原有 HTML，不是追加。
同时，该工具不会自动创建页面。如果：

pageName = index

对应的模板页面不存在，则保存会失败。
因此首页创建的正确 MCP 顺序是：

login
→ 获得 authHandle
→ save_template_page
→ 创建 name=index、type=1 的首页模板页面
→ save_template_page_text
→ 向 pageName=index 写入完整 index.html

4.2 生成整站，预览成果

人工路径可以点击 生成整站 并在后台预览。MCP 路径只调用工具，生成和预览必须分开确认。
人工操作顺序：

保存首页模板页面
→ 生成整站
→ 生成网站静态 HTML 页面
→ 预览网站

如果使用 MCP，在 save_template_page_text 返回成功后，先确认当前站点是否已经绑定有效 template。只有绑定缺失且用户已授权其潜在副作用时，才调用 save_template；确认绑定有效时不要重复调用。之后才能调用：

generate_site

生成整站。

重要提醒：首次生成整站前只有在模板绑定缺失时才考虑调用 save_template；调用成功不等于绑定状态已经验证。

后台点击「生成整站」时，系统会校验当前网站是否已绑定有效模板（site.template_id 对应 template 表中存在记录）。如果 template 表为空或 site.template_id 指向不存在的模板，会提示：