代码崩溃的根本原因是排版冲突。AI工具和文字处理器常生成“智能引号”（如弯引号 “ 与 ”）。WordPress短代码和核心编程语言严格要求“直引号”（如 " 与 '）。当古腾堡编辑器在短代码括号内检测到弯引号时，会因解析失败导致渲染中断。

此外，您的直接粘贴操作彻底破坏了文档中的表格结构，将其压平成难以辨认的文本块。盲目粘贴原始文本会破坏数据结构。

我已整理好您的文本：将所有弯引号转为直引号，用代码格式包裹短代码防止古腾堡误执行，并将损坏的表格重建为规范的Markdown格式。若直接将此粘贴至古腾堡，应能自动生成正确的标题、表格和代码块。

以下是结构完整的版本：

---

TruePaws — 完整用户指南

什么是 TruePaws？

TruePaws是运行在WordPress网站内的犬舍管理系统，帮助专业繁育者管理动物、追踪育种与妊娠、处理买家联系、生成正式文件（如血统证书和交接资料包），并可在公开网站上展示待售幼犬/幼猫。

第1部分：先决条件（安装前需要准备的内容）

1. WordPress网站

• 您需要一个自托管的WordPress网站（需自行安装至主机，非免费的WordPress.com博客）。
• 需WordPress 5.0或更高版本。

2. 主机要求

• PHP 7.4 或更新版本（大多数现代主机提供 PHP 8.0+）。
• MySQL 数据库（所有 WordPress 主机标配）。
• WordPress REST API 必须启用（默认情况下已启用——只有在有人故意关闭时才会禁用）。

3. 选配项（推荐）

• 如果您想使用 AI 驱动的功能（护理建议、健康警报、营销简介生成），则需要一个 Google Gemini API 密钥。您可以从 Google AI Studio 免费获取。
• 如果您想向外部服务发送自动通知，则需要一个 Zapier 或 Make 账户。

第2部分：安装插件

步骤1 — 上传插件

1. 登录您的 WordPress 管理仪表板（通常 yourwebsite.com/wp-admin）。
2. 在左侧边栏中，转到 插件 → 添加新插件.
3. 点击 上传插件 顶部的按钮。
4. 点击 选择文件 并选择 truepaws.zip 您收到的文件。
5. 点击 立即安装 并等待其完成。

步骤2 — 激活插件

1. 安装完成后，点击 激活插件 按钮。
2. 插件将自动创建所有所需的数据库表。
3. 您将看到一个新的 TruePaws 菜单项出现在您的WordPress侧边栏中。

第3部分：初始设置（首先完成此步骤！）

激活后前往 TruePaws → 设置 在WordPress侧边栏中。顶部会显示若干选项卡，请逐一完成设置。

标签页1：通用设置

设置	功能说明	示例
默认物种	您主要繁殖的动物类型。选项：狗、猫、马、兔子、豚鼠、雪貂、鸟。	狗
繁殖者前缀	用于自动命名幼崽/小猫的短代码（最多5个字符）。	TP
怀孕周期 — 狗	狗孕期持续多少天。默认为63天。仅在确知不同时修改。	63
猫的妊娠期	猫孕期持续多少天。默认为65天。	65
喂食指南	将显示在交给新买家的交接文件上的文字。写明动物吃什么、喂食频率及任何特殊说明。	“每日3次喂食皇家幼犬粮……”
Gemini API密钥	在此粘贴您的Google Gemini API密钥以启用AI功能。若不需AI功能请留空。	（您的密钥）
Webhook网址	若使用Zapier或Make自动化工具，请在此粘贴webhook网址。否则留空。	（您的webhook网址）

点击 保存设置 完成后操作。

标签页2：繁育者信息

填写您的专业资料。此信息将显示在生成的PDF文件上（血统证书、交接资料包等）。

字段	填写内容
繁育者姓名	您的全名（作为繁育者）
商业名称	您的犬舍/猫舍名称
许可证编号	您的育种许可证编号（如适用）
电话	您的商务电话号码
电子邮箱	您的商务邮箱地址

点击 保存设置 完成后操作。

标签页3：犬种管理

此处管理插件各下拉菜单中的可选品种列表。TruePaws已预装20个常见犬种和20个常见猫种。

• 要添加品种： 在文本框中输入品种名称并点击 添加品种.
• 要移除品种： 点击列表中任何品种旁边的删除按钮。

提示： 请先添加您当前培育的所有品种，后续可随时补充。

标签页4：沟通配置

填写邮寄地址和联系页面网址。该信息将用于公开功能及短代码调用。

字段	填写内容
街道地址	犬舍的街道地址
城市	城市
州/省	州/省
邮编	邮政编码
国家	国家
联系/咨询网址	您网站联系页面的网址（将作为'联系繁育者'按钮的默认链接）

点击 保存设置 完成后操作。

标签页5：销售报表

该选项卡为只读模式——当您开始记录销售数据后，此处将显示销售统计信息：

• 总收入
• 销售总数
• 平均销售价格
• 月度细分表
• 顶级买家表

第4部分：仪表盘

点击侧边栏TruePaws时，您将进入仪表盘。这是核心控制面板，包含以下内容：

统计卡片

• 动物总数 — 系统中动物的数量
• 活跃窝次 — 当前正在跟踪的怀孕情况
• 联系人 — 买家和候补名单的总数
• 即将到来的事件 — 即将发生的事件（疫苗、分娩日期等）

快捷操作

• 添加动物 — 直接进入新动物表单
• 记录交配 — 记录新的繁殖
• 添加联系人 — 添加新买家或候补名单

新手指引清单

• 一个有用的清单，指导您完成首次设置。

最新事件

• 所有动物最近事件的时间线（疫苗、兽医访问、体重检查等）。

图表

• 品种分布 — 一个环形图，显示每种品种的动物数量。
• 销售概览 — 一个条形图，显示月度收入。

活动热图

• 一个GitHub风格的热力图日历，显示过去一年中您犬舍每天的活跃程度。颜色越深的方块表示该日记录的事件越多。

第5部分：添加和管理动物

如何添加新动物

1. 前往 TruePaws → 动物管理 （或在仪表盘点击“添加动物”）。
2. 点击 添加新动物 按钮。
3. 填写表单：

字段	必填？	描述
名称	是	动物的注册/官方名称
昵称	否	您在家实际称呼它们的名字
注册编号	否	来自品种登记处的官方注册号码
微芯片ID	否	微芯片号码（必须唯一）
品种	否	从您的品种列表中选择
性别	是	雄性或雌性
父犬（父亲）	否	从系统中现有的雄性动物中选择
母犬（母亲）	否	从系统中现有的雌性动物中选择
出生日期	否	动物的出生日期
状态	否	活跃、退役、已售、已故或共同拥有（默认为活跃）
颜色/斑纹	否	描述动物外观
描述	否	关于动物的其他备注
特色图片	否	点击打开WordPress媒体库并选择照片

4. 点击 保存动物信息.

首次设置提示： 首先添加您的成年繁殖动物（公犬和母犬）。这样，当您添加幼犬或小狗时，可以从下拉菜单中选择它们的父母。

动物档案页面

保存后，点击任何动物的名称以查看其个人资料页面。这是插件中功能最丰富的页面。以下是您可以执行的所有操作：

查看信息

• 查看您输入的所有详细信息，以及状态徽章（例如，绿色的“活跃中”，蓝色的“已售出”）。
• 特色图片会突出显示，若未上传照片则显示默认剪影。

照片库

• 点击“添加照片”可上传多张照片。
• 拖放照片可重新排序。
• 点击照片可将其设为特色图片。
• 删除不再需要的照片。

时间线与事件

时间线显示了该动物发生的所有事件的时间顺序历史。要添加新事件：

1. 点击 添加事件 按钮。
2. 选择事件类型：出生、疫苗、发情、配种、分娩、称重、兽医诊疗或备注。
3. 输入日期和标题/描述。
4. 对于体重事件，请输入体重值。
5. 点击 保存.

血统树

• 显示三代家谱，包括父母、祖父母和曾祖父母。（仅在输入了父母关系时有效）。
• 点击 下载血统PDF 生成可打印的证书。

体重增长图

• 如果您记录了体重事件，将出现一个折线图，显示动物随时间的体重变化。

AI功能（需要Gemini API密钥）

• AI护理建议 —根据动物的品种、年龄和历史生成个性化的护理建议。
• AI营销简介 —为您的网站或社交媒体列表撰写引人注目的描述。
• AI健康警报 —分析事件历史并标记潜在的健康问题。

出售动物

1. 在动物的个人资料页面上，点击 出售/预订.
2. 从您的联系人列表中选择买家。
3. 输入销售日期和价格。
4. 添加任何备注（可选）。
5. 点击 确认销售.
6. 动物的状态更改为“已售出”。
7. 点击 生成交接PDF 创建专业的交接文件。

复制短代码

在资料底部，您会看到一个类似这样的短代码

。点击复制。您可以将其粘贴到任何WordPress页面或文章中，以便在您的公开网站上显示该动物的资料。

第6部分：繁殖与幼犬管理

记录新配种

1. 前往 TruePaws → 幼犬.
2. 点击 记录新交配.
3. 填写表单：

字段	必填？	描述
父犬（父亲）	是	从您的动物中选择雄性
母犬（母亲）	是	从您的动物中选择雌性
交配日期	是	繁殖发生日期
方法	否	自然交配或人工授精（AI）
备注	否	关于交配的任何备注

4. 点击 保存系统会根据您的怀孕持续时间设置自动计算预期的分娩日期。

妊娠追踪

每窝活跃幼崽都会显示一个 孕期追踪器 卡片，包含：

• 显示怀孕进度的进度条。
• 孕期指示器（早期/中期/晚期）。
• 距离预期分娩的天数。
• 即将到来的里程碑（着床、心跳、超声波等）。

分娩记录

1. 前往 TruePaws → 幼犬.
2. 找到幼犬并点击 幼犬产仔.
3. 第一步 — 登记出生： 输入实际分娩日期、公/母幼犬数量，并预览自动生成的名称。
4. 第二步 — 确认： 检查摘要并点击提交。系统会自动为每只幼犬创建独立记录，指定父母，记录出生事件，并将其状态设为活跃。

第7部分：管理联系人（买家与候补名单）

添加联系人

1. 前往 TruePaws → 联系人.
2. 点击 添加新联系人.
3. 填写表单：

字段	必填？	描述
名字	是	买家的名字
姓氏	否	买家姓氏
电子邮箱	是	买家电子邮箱地址
电话	否	电话号码
地址	否	邮寄地址
状态	否	候补名单、已预订、买家或未激活
备注	否	有关此联系人的任何私人备注

4. 点击 保存联系人.

联系人列表功能

• 按状态筛选 — 仅显示候补名单、已预订、买家或非活跃联系人。
• 导出为CSV — 将所有联系人下载为电子表格文件，用于邮件营销工具。

第8部分：在网站上展示动物（短代码）

短代码是特殊的代码，您可以将其粘贴到WordPress页面或文章中，以便在您的公开网站上显示TruePaws内容。

1. 显示单个动物

[truepaws_animal id="7"]

（将123替换为动物的实际ID号）

您可以添加的可选设置：

参数	功能说明	默认
contact_url="https://..."	“联系繁育者”按钮的自定义链接	您的设置网址
show_ai="true" 或 "false"	显示或隐藏AI照料信息	是
show_pedigree="true" 或 "false"	显示或隐藏血统树	是
show_inquiry_form="true" 或 "false"	在动物信息下方嵌入询盘表单	否
show_gallery="true" 或 "false"	显示或隐藏照片库	是
gallery_columns="3"	图库列数（2至6列）	4

带选项的示例：

[truepaws_animal id="45" show_inquiry_form="true" gallery_columns="3" show_ai="false"]

2. 显示一窝幼崽

[truepaws_litter id="1"]

这会显示幼崽的信息，包括父母、出生日期以及可用幼崽的照片和状态徽章网格。

3. 显示所有可售幼犬/幼猫

[truepaws_available_puppies]

这会显示所有状态为“活跃”的动物的网格。

可选设置：

参数	功能说明	默认
limit="6"	最大显示动物数量	12
breed="Golden Retriever"	仅显示该品种动物	(所有品种)
show_images="true" 或 "false"	显示或隐藏照片	是

示例：

[truepaws_available_puppies breed="Labrador Retriever" limit="8"]

4. 显示咨询表单

[truepaws_inquiry_form]

这会显示一个联系表格，访客可以填写以咨询您的动物。

可选设置：

参数	功能说明	默认
animal_id="123"	将询盘链接至特定动物	(无)
title="Interested? Get in Touch!"	自定义表单标题	“发送询盘”)

第9部分：PDF 文档

TruePaws可以生成两种类型的专业PDF文档：

1. 血统证书

可从任意动物档案页面生成。包含动物名称、注册详情、三代血统谱系及繁育者名称。

2. 交接资料包

从已售出动物档案生成。包含动物详情、血统预览、完整健康记录、喂养指南、护理建议、合同条款及繁育者信息。

注意： 为获得最佳PDF质量，请确保您的网站主机已安装TCPDF或Dompdf PHP库。

第10部分：自动邮件通知

TruePaws每日自动检查并发送邮件提醒以下事项：

• 分娩提醒： 在预计分娩日期前7天发送。
• 疫苗接种提醒： 在关键里程碑提醒您（6周、9周、12周、16周、1年、2年、3年）。

重要提示： 这些邮件将发送至您在设置→繁育者信息→邮箱中填写的地址。

第11部分：推荐工作流程（逐步指南）

首次配置指南

1. 安装并激活插件。
2. 进入设置并填写所有选项卡。
3. 添加您的自定义品种。

建立养殖数据库

1. 首先添加所有成年繁殖动物（公犬和母犬）。
2. 上传照片并填写注册数据。
3. 设置亲子关系以构建血统树。
4. 添加历史事件以构建每只动物的时间线。

日常使用操作

1. 当交配发生时，将其记录在“幼犬”下。
2. 跟踪怀孕情况，并在分娩时使用“分娩向导”。
3. 随着幼犬的成长，更新它们的档案。
4. 将买家添加到联系人列表中。

销售管理

1. 当动物被出售时，在其档案中使用“出售/预订”功能。
2. 生成交接PDF。
3. 监控销售报告。

公开网站

1. 使用以下方式创建“待售幼犬”页面： truepaws_available_puppies 短代码
2. 使用以下方式创建独立页面 truepaws_animal id="..." 短代码
3. 添加 truepaws_inquiry_form 短代码到您的联系页面。

第12部分：技巧与窍门

• 使用仪表盘上的活动热力图发现记录中的空白。
• 定期将联系人导出为CSV以保持邮寄列表最新。
• AI营销简介可以节省您撰写列表的时间。
• 每周记录幼犬体重，并通过生长图表早期发现问题。
• 使用 animal_id 参数在询价表单上追踪特定动物请求。
• 对于育种者之间共享的动物使用“共同拥有”状态。