<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="zh-Hans">
	<id>https://xenoblade.cn/index.php?action=history&amp;feed=atom&amp;title=%E6%A8%A1%E5%9D%97%3AArtsShop</id>
	<title>模块:ArtsShop - 版本历史</title>
	<link rel="self" type="application/atom+xml" href="https://xenoblade.cn/index.php?action=history&amp;feed=atom&amp;title=%E6%A8%A1%E5%9D%97%3AArtsShop"/>
	<link rel="alternate" type="text/html" href="https://xenoblade.cn/index.php?title=%E6%A8%A1%E5%9D%97:ArtsShop&amp;action=history"/>
	<updated>2026-11-19T07:25:01Z</updated>
	<subtitle>本wiki上该页面的版本历史</subtitle>
	<generator>MediaWiki 1.43.9</generator>
	<entry>
		<id>https://xenoblade.cn/index.php?title=%E6%A8%A1%E5%9D%97:ArtsShop&amp;diff=3994&amp;oldid=prev</id>
		<title>头号云：​创建页面，内容为“-- Module:ArtsShop —— 商店战技书查询（独立模块，与 ArtsData 主链路解耦） -- -- 用法： --   {{#invoke:ArtsShop|main|12}}          渲染战技12的商店在售表 --   {{#invoke:ArtsShop|offers|12}}        返回原始数据（Lua 表，供其他模块调用） -- -- 数据链路（XBDB 深度解析已验证 2026-10-08）： --   shop_index[战技ID] → 货架行号列表（静态：XBDB 无法枚举，行号映射离线建） --…”</title>
		<link rel="alternate" type="text/html" href="https://xenoblade.cn/index.php?title=%E6%A8%A1%E5%9D%97:ArtsShop&amp;diff=3994&amp;oldid=prev"/>
		<updated>2026-10-08T16:35:30Z</updated>

		<summary type="html">&lt;p&gt;创建页面，内容为“-- Module:ArtsShop —— 商店战技书查询（独立模块，与 ArtsData 主链路解耦） -- -- 用法： --   {{#invoke:ArtsShop|main|12}}          渲染战技12的商店在售表 --   {{#invoke:ArtsShop|offers|12}}        返回原始数据（Lua 表，供其他模块调用） -- -- 数据链路（XBDB 深度解析已验证 2026-10-08）： --   shop_index[战技ID] → 货架行号列表（静态：XBDB 无法枚举，行号映射离线建） --…”&lt;/p&gt;
&lt;p&gt;&lt;b&gt;新页面&lt;/b&gt;&lt;/p&gt;&lt;div&gt;-- Module:ArtsShop —— 商店战技书查询（独立模块，与 ArtsData 主链路解耦）&lt;br /&gt;
--&lt;br /&gt;
-- 用法：&lt;br /&gt;
--   {{#invoke:ArtsShop|main|12}}          渲染战技12的商店在售表&lt;br /&gt;
--   {{#invoke:ArtsShop|offers|12}}        返回原始数据（Lua 表，供其他模块调用）&lt;br /&gt;
--&lt;br /&gt;
-- 数据链路（XBDB 深度解析已验证 2026-10-08）：&lt;br /&gt;
--   shop_index[战技ID] → 货架行号列表（静态：XBDB 无法枚举，行号映射离线建）&lt;br /&gt;
--   → post shoplist[货架行]（实时）&lt;br /&gt;
--   → post FLD_npclist(shop_npc 货架行) → 商店名（实时中文，缓存）&lt;br /&gt;
--   → post ITM_artslist[战技书行] → 书名 + 实时价格&lt;br /&gt;
--&lt;br /&gt;
-- ⚠ 注释风格约定：本文件只用 -- 行注释，不用 --[[ ]] 块注释&lt;br /&gt;
--   （块注释会被正文里的 ]] 提前终止，已踩坑一次）&lt;br /&gt;
&lt;br /&gt;
local p = {}&lt;br /&gt;
&lt;br /&gt;
local post = require(&amp;quot;Module:RequestHelper&amp;quot;).post&lt;br /&gt;
local getArgs = require(&amp;quot;Module:Arguments&amp;quot;).getArgs&lt;br /&gt;
local html = require(&amp;quot;Module:Html&amp;quot;)&lt;br /&gt;
local compress = html.compress&lt;br /&gt;
&lt;br /&gt;
local shopIndex = require(&amp;quot;Module:ArtsShop/index&amp;quot;)&lt;br /&gt;
local shopNpc = require(&amp;quot;Module:ArtsShop/npc&amp;quot;)&lt;br /&gt;
local lv1 = require(&amp;quot;Module:ArtsData/lv1&amp;quot;)&lt;br /&gt;
&lt;br /&gt;
-- 货架行号 -&amp;gt; 商店名（NPC 名 + mob_name，缓存）&lt;br /&gt;
local npcCache = {}&lt;br /&gt;
local function fetchShopName(shopRow)&lt;br /&gt;
  local npcId = shopNpc[shopRow]&lt;br /&gt;
  if not npcId then return nil end&lt;br /&gt;
  local cached = npcCache[npcId]&lt;br /&gt;
  if cached ~= nil then return cached end&lt;br /&gt;
  local name = nil&lt;br /&gt;
  local ok, npc = pcall(post, &amp;quot;bdat_common.FLD_npclist&amp;quot;, npcId)&lt;br /&gt;
  if ok and type(npc) == &amp;quot;table&amp;quot; then&lt;br /&gt;
    local parts = {}&lt;br /&gt;
    if npc.name and npc.name ~= &amp;quot;&amp;quot; then parts[#parts + 1] = npc.name end&lt;br /&gt;
    if npc.mob_name and npc.mob_name ~= &amp;quot;&amp;quot; and npc.mob_name ~= npc.name then&lt;br /&gt;
      parts[#parts + 1] = npc.mob_name&lt;br /&gt;
    end&lt;br /&gt;
    name = #parts &amp;gt; 0 and table.concat(parts, &amp;quot;·&amp;quot;) or nil&lt;br /&gt;
  end&lt;br /&gt;
  npcCache[npcId] = name&lt;br /&gt;
  return name&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- 查询某战技的商店在售。返回数组或 nil：&lt;br /&gt;
--   { { shopRow=货架行, shopName=商店名, artName=书名, money=价格 }, ... }&lt;br /&gt;
function p.fetchOffers(artId)&lt;br /&gt;
  artId = tonumber(artId)&lt;br /&gt;
  local entries = artId and shopIndex[artId] or nil&lt;br /&gt;
  if not entries or #entries == 0 then&lt;br /&gt;
    return nil&lt;br /&gt;
  end&lt;br /&gt;
  local offers = {}&lt;br /&gt;
  for _, e in ipairs(entries) do&lt;br /&gt;
    local o = { shopRow = e.sr, money = e.m }&lt;br /&gt;
    local ok, row = pcall(post, &amp;quot;bdat_common.shoplist&amp;quot;, e.sr)&lt;br /&gt;
    if ok and type(row) == &amp;quot;table&amp;quot; then&lt;br /&gt;
      o.shopName = fetchShopName(e.sr)&lt;br /&gt;
      local okB, book = pcall(post, &amp;quot;bdat_common.ITM_artslist&amp;quot;, e.br)&lt;br /&gt;
      if okB and type(book) == &amp;quot;table&amp;quot; and book.name then&lt;br /&gt;
        o.artName = book.name&lt;br /&gt;
        if book.money then o.money = book.money end&lt;br /&gt;
      end&lt;br /&gt;
      offers[#offers + 1] = o&lt;br /&gt;
    end&lt;br /&gt;
  end&lt;br /&gt;
  if #offers == 0 then return nil end&lt;br /&gt;
  return offers&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- Lua 层调用别名&lt;br /&gt;
p.offers = p.fetchOffers&lt;br /&gt;
&lt;br /&gt;
-- 渲染商店在售表&lt;br /&gt;
function p.main(frame)&lt;br /&gt;
  local args = getArgs(frame)&lt;br /&gt;
  local artId = args[1] and mw.text.trim(args[1]) or &amp;quot;&amp;quot;&lt;br /&gt;
  local offers = p.fetchOffers(artId)&lt;br /&gt;
  if not offers then&lt;br /&gt;
    return &amp;quot;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
&lt;br /&gt;
  return compress(p.renderOffers(artId, offers))&lt;br /&gt;
&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- 按角色渲染全部有商店在售的战技：{{#invoke:ArtsShop|role|shulk}}&lt;br /&gt;
function p.role(frame)&lt;br /&gt;
  local args = getArgs(frame)&lt;br /&gt;
  local key = args[1] and mw.text.trim(args[1]) or &amp;quot;&amp;quot;&lt;br /&gt;
  local role = lv1.roles[key]&lt;br /&gt;
  if not role then&lt;br /&gt;
    return &amp;quot;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
&lt;br /&gt;
  local out = {}&lt;br /&gt;
  out[#out + 1] = html.h2(role.name .. &amp;quot; · 战技书商店在售&amp;quot;)&lt;br /&gt;
  for _, id in ipairs(role.ids) do&lt;br /&gt;
    local offers = p.fetchOffers(id)&lt;br /&gt;
    if offers then&lt;br /&gt;
      out[#out + 1] = p.renderOffers(id, offers)&lt;br /&gt;
    end&lt;br /&gt;
  end&lt;br /&gt;
  if #out == 1 then&lt;br /&gt;
    return &amp;quot;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
  return compress(table.concat(out, &amp;quot;\n&amp;quot;))&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
-- 从 main 提取的渲染核心（单个战技的商店表），供 main 与 role 复用&lt;br /&gt;
function p.renderOffers(artId, offers)&lt;br /&gt;
  local artName = offers[1].artName or (&amp;quot;战技 &amp;quot; .. artId)&lt;br /&gt;
&lt;br /&gt;
  local out = {}&lt;br /&gt;
  out[#out + 1] = html.h3(artName .. &amp;quot; · 商店在售&amp;quot;)&lt;br /&gt;
  out[#out + 1] = &amp;#039;&amp;lt;table class=&amp;quot;wikitable&amp;quot; style=&amp;quot;text-align:center;&amp;quot;&amp;gt;&amp;#039;&lt;br /&gt;
  out[#out + 1] = &amp;quot;&amp;lt;tr&amp;gt;&amp;lt;th&amp;gt;商店&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;战技书&amp;lt;/th&amp;gt;&amp;lt;th&amp;gt;价格&amp;lt;/th&amp;gt;&amp;lt;/tr&amp;gt;&amp;quot;&lt;br /&gt;
  for _, o in ipairs(offers) do&lt;br /&gt;
    out[#out + 1] = &amp;quot;&amp;lt;tr&amp;gt;&amp;quot;&lt;br /&gt;
      .. &amp;quot;&amp;lt;td&amp;gt;&amp;quot; .. (o.shopName or (&amp;quot;货架 &amp;quot; .. tostring(o.shopRow))) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;quot;&lt;br /&gt;
      .. &amp;quot;&amp;lt;td&amp;gt;&amp;quot; .. (o.artName or &amp;quot;—&amp;quot;) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;quot;&lt;br /&gt;
      .. &amp;quot;&amp;lt;td&amp;gt;&amp;quot; .. (o.money and (tostring(o.money) .. &amp;quot; G&amp;quot;) or &amp;quot;—&amp;quot;) .. &amp;quot;&amp;lt;/td&amp;gt;&amp;quot;&lt;br /&gt;
      .. &amp;quot;&amp;lt;/tr&amp;gt;&amp;quot;&lt;br /&gt;
  end&lt;br /&gt;
  out[#out + 1] = &amp;quot;&amp;lt;/table&amp;gt;&amp;quot;&lt;br /&gt;
  return table.concat(out, &amp;quot;\n&amp;quot;)&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
return p&lt;/div&gt;</summary>
		<author><name>头号云</name></author>
	</entry>
</feed>