来访自动收录图文教程：建站、审核与推荐位套餐配置

戴影来访自动收录（官方市场当前 0.1.12） 可以把戴影 CMS 扩展成独立网址导航：提供分类、搜索、详情、访客提交、来访发现、管理员审核，以及通过 Commerce 出售推荐位。原有八张截图来自 Core 1.2.84＋Commerce 1.0.9 的 0.1.11 隔离原生安装，网站、套餐和订单是演示数据；手机图为 390×844 模拟视口，购买页使用模拟支付提供者。本文新增的 99 元／30 天配置说明取自 2026-10-17 官网后台，套餐出现在前台不代表真实商户收款验收。

一、获取授权码并安装

在官方市场查看商品 official.site-directory。当前官方市场版本为 0.1.12，采用 LICENSE_REQUIRED 授权模式。销售方自行生成授权码，售价、授权站点数及有效期由销售方公布；插件包不承诺固定价格或终身权益。取得有效授权码后，使用 CMS 官方市场的授权安装流程。官方 trusted PHP 插件不能用普通本地 ZIP 上传入口替代安装信任。

启用后先访问 /directory，再由管理员打开 /admin/site-directory。全新安装没有演示网站或套餐；升级既有站点前请使用 CMS 原生备份。停用插件默认保留网站和订单等客户数据。

二、建立分类并审核网站

先在后台建立分类，填写中、英、西班牙语名称、Slug、简介及 SEO 字段。再设置来访自动发现、验证码、每 IP／每域名提交频率、抓取频率和黑白名单。Referer 只是发现线索，不是站点所有权证明；自动发现和访客提交的网站都进入待审核队列，不会自动公开。

管理员在审核页核对网址、标题、简介和分类，可批准、拒绝、禁用或恢复。失效反馈进入后台记录。没有 AI 模型时直接人工审核；配置 CMS AI 服务后，可以开启可选初审，但 AI 只提供建议，最终仍须管理员确认。

三、访客提交与浏览

访客从 /directory 进入“提交网站”，输入 HTTP／HTTPS 网址。系统尝试安全获取标题和简介；抓取失败仍可手动填写。提交者补充名称、简介、分类和验证码后，记录进入审核队列。提交成功时应保存一次性显示的私密凭证：它用于关联提交、订单和推荐位购买，不代表域名所有权，不能公开分享。

审核通过的网站会出现在首页、分类和搜索结果，详情页有独立标题与描述。页面可切换中文、English 和 Español；提交的网站介绍不会自动翻译。

四、栏目与根首页

普通内容站可把 /directory 放入菜单，保留文章首页。需要以导航为主站时，管理员可在支持该能力的 Core 1.2.84 后台启用受控首页来源切换；默认不会自动接管根路径。开启后检查 / 是否返回导航内容，再核对三语言、canonical、搜索／分页 noindex 和 sitemap。关闭或停用时按首页归属及配置 revision 恢复，避免覆盖管理员后续修改。旧 Core 缺少该能力时继续使用 /directory，不应把栏目入口当作根首页。

五、配置收费推荐位：从空白表单到前台可见

先分清两个东西：“推荐位”决定展示位置和同时可用的名额；“推荐套餐”决定购买价格与天数。套餐售价由每个导航站站长自行设置，与购买插件授权码的价格无关。下面用官网 2026-10-17 的运营配置举例：首页精选推荐，3 个同时展示名额，99 元／30 天。这是示例价格，不是插件强制售价。

先认清三个编号：不要把推荐位 ID 当作套餐 ID

这页有三张不同用途的表单，编号不能互换。看表格最左侧的 id 列，不看表单预填的 0。

官网当前的真实例子：“首页精选推荐”的推荐位 ID 是 1，“黄金广告位”的推荐位 ID 是 2；但目前“推荐套餐”列表只有一条，套餐 ID 是 1。最下方的“套餐编号”此时填 1 才会关联现有套餐；直接填推荐位 ID 2 会提示“操作未完成”，因为还没有 ID 为 2 的套餐。

想出售黄金广告位：先在“推荐套餐”新建表单填 id=0、推荐位编号=2，填好名称、价格、货币和天数后保存；再从新套餐那一行最左侧读出系统实际生成的套餐 ID，最后把这个套餐 ID 填入页面最下方的“套餐编号”并保存。不要预先猜新套餐一定是 ID 2。

第 1 步：建立推荐位

管理员打开 推荐位管理。页面上半部是推荐位表格及新建表单。第一次新建时，“编号”填 0；界面上的“网站名称”在这个表单中填写的是推荐位名称，例如“首页精选推荐”；“展示位置”选“精选推荐”；“分类编号”填 0；“展示数量”填 3；“排序权重”可填 100；“购买说明”写清审核、赞助标记和到期规则。首次配置先选“停用”，等 Commerce 关联完成后再启用，最后点“保存”。

展示数量 3 表示最多有 3 个网站同时占用此推荐位，并不是这个套餐只能卖 3 次。保存后以列表中实际生成的推荐位 id 为准；官网这次生成的是 1，其他站点不一定也是 1。页面下方再次看到“编号 0”只是新建表单，修改已有推荐位要点击列表该行的“编辑”。

第 2 步：建立推荐套餐

同一页面向下找到“推荐套餐”。首次新建时按下例填写：id=0；推荐位编号=刚保存的推荐位 id（官网示例为 1）；名称=首页精选推荐 · 30 天；价格（分）=9900；货币=CNY；购买期限（天）=30；启用状态=0；Commerce 商品编号=0；Commerce 支付动作编号=0。填完点这张表单的“保存”。

价格单位是分：9900 分就是人民币 99.00 元，填 99 只会变成 0.99 元。首次创建时两个 Commerce 编号应为 0；不要猜测编号，更不要把官网示例的编号照抄到其他站点。保存后在“推荐套餐”列表记下新套餐的 id，官网示例为 1。要修改已有套餐，请点列表该行“编辑”，不要再用 id=0 的新建表单创建重复套餐。

第 3 步：关联现有 Commerce

在同页最下方找到独立的“套餐编号”小表单，填入刚保存的套餐 id（官网示例为 1），点击“保存”。这是让插件通过现有 Commerce 创建或更新无物流服务商品及支付动作，不是再次创建套餐，也不是新建支付网关。返回“推荐套餐”列表，确认“Commerce 商品编号”和“Commerce 支付动作编号”都出现有效数字。官网这次两项均为 9；9 只属于官网这条记录，其他站点以自己的实际编号为准。若仍为空或为 0，先保持停用并检查 Commerce 与支付配置。

第 4 步：启用并核对前台

1. 点击套餐行的“编辑”，核对价格、货币、天数和两个 Commerce 编号，把“启用状态”改为 1 后保存。
2. 点击推荐位行的“编辑”，核对展示数量与购买说明，把“启用”改为“启用”后保存。
3. 打开 前台购买推荐位页面，应看到套餐名称、CNY 99.00、30 天和“广告／赞助”标记。官网这三项展示已核对；这只证明配置和页面可见，不代表真实商户收款已经测试通过。

购买者应先提交网站，等待管理员审核通过，并妥善保存提交时得到的私密凭证；购买时选择已审核网站、套餐及支付方式，用网站编号和该凭证建立订单关联。凭证不证明域名所有权。只有可信服务端核对订单、付款主体、金额、货币和提供者后才激活推荐，浏览器返回页不能证明付款。库存满时不得超卖，付费展示应标记“广告／赞助”，付费外链使用 rel="sponsored"，到期自动停止展示。

常见填错与修改建议

• 只看到 id=0：这是新建表单；看上方列表，修改已有项请点“编辑”。
• 前台看不到套餐：检查推荐位与套餐是否都启用、套餐是否指向正确推荐位，以及两个 Commerce 关联编号是否已生成。
• 想改价：若已有待支付或已支付订单，不要直接改原套餐价格、货币或期限；建议新建套餐、完成 Commerce 关联，再停用旧套餐，避免旧订单和新价格混淆。
• 购买说明写了固定天数：如果将来同时出售 30 天和 90 天套餐，请把推荐位说明改成通用表述，期限以所选套餐为准。

管理员可在订单页核对支付、取消、退款、到期和争议状态。可信争议开启或处理中会停展；仅有 closed 状态不能自动当作胜诉。人工停展独立优先，自动恢复前仍须核对净付款、有效期、网站状态及可用库存。

六、维护与常见问题

运营收费推荐位时让 site_directory.maintenance 持续运行，以处理订单对账、到期、待审核元数据与已启用的 AI 初审。即使调度延迟，展示查询仍核对有效期。真实网关的 webhook、退款和争议配置须按所用支付提供者文档单独验收；本教程截图没有证明真实商户收款。

没有 AI 可以用吗？可以，默认人工审核。提交后立即公开吗？不会，需管理员批准。付费能证明域名归属吗？不能，提交凭证只用于关联订单。停用会删数据吗？默认保留客户数据。能保证搜索引擎收录吗？不能，仍取决于内容质量与搜索引擎策略。

查看官方市场 0.1.12 发布记录。插件授权码由销售方生成，价格和权益以销售方公布的条款为准。