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

此外，您的直接复制粘贴完全破坏了文档中的表格结构，将其压平为难以辨认的文本块。盲目复制原始文本会破坏结构化数据。

我已清理文本：将所有引号转为直引号，用代码格式包裹短代码防止古腾堡执行，并将损毁的表格重建为规范的Markdown格式。直接粘贴到古腾堡后，系统将自动生成正确的标题、表格和代码块。

以下是结构完整的版本：

---

TruePaws 完整用户指南

什么是TruePaws？

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

第一部分：安装前准备（所需条件）

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账户。

第二部分：安装插件

步骤1 — 上传插件

1. 登录WordPress管理员后台（通常为 yourwebsite.com/wp-admin）。
2. 在左侧菜单中进入 插件→添加新插件.
3. 点击顶部 上传插件 按钮。
4. 点击 选择文件 并选择 truepaws.zip 您收到的文件。
5. 点击 立即安装 并等待其完成。

步骤2 — 激活插件

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

第三部分：初始设置（优先完成！）

激活后前往 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：销售报告

此标签页为只读模式——开始记录销售数据后，将显示您的销售统计信息。您会看到：

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

第四部分：仪表盘

点击侧边栏TruePaws时，将进入仪表盘。这是您的主控台，包含以下内容：

统计卡片

• 动物总数 — 系统中现有动物数量
• 活跃窝次 — 当前追踪中的怀孕记录
• 联系人 — 买家及候补名单总数
• 即将到来事件 — 近期计划（疫苗、分娩日期等）

快捷操作

• 添加动物 — 直接跳转至新动物表单
• 记录交配 — 新增繁殖记录
• 添加联系人 — 新增买家或候补名单

新手指南清单

• 一份指导您完成首次设置的实用清单。

最新动态

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

图表

• 品种分布——环形图展示各类品种动物的数量。
• 销售概览——柱状图显示月度收入。

活动热力图

• GitHub风格的热力图日历，展示过去一年犬舍每日活跃度。颜色越深表示当日记录事件越多。

第五部分：添加与管理动物

如何添加新动物档案

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页面或文章中，以便在您的公开网站上显示该动物的资料。

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

记录新交配信息

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

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

4. 点击 保存系统将根据您设置的妊娠周期自动计算预计分娩日期。

妊娠期追踪

每个活跃的窝次都会显示一个 妊娠追踪器 卡片，包含：

• 显示妊娠进度的进度条。
• 妊娠阶段指示器（早期/中期/晚期）。
• 距离预计分娩剩余天数。
• 即将到来的重要节点（着床、胎心、超声波检查等）。

分娩记录（产仔）

1. 前往 TruePaws → 幼犬管理.
2. 找到对应幼犬批次并点击 幼犬出生登记.
3. 第一步——记录出生信息： 输入实际分娩日期、公/母幼犬数量，并预览自动生成的命名。
4. 第二步——确认信息： 核对摘要后点击提交。系统将自动为每只幼犬创建独立档案、分配父母、记录出生事件，并将其状态设为活跃。

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

添加联系人

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

字段	必填？	描述
名字	是	买家名字
姓氏	否	买家姓氏
电子邮箱	是	买家电子邮箱
电话	否	电话号码
地址	否	邮寄地址
状态	否	候补名单/已预订/买家/非活跃
备注	否	关于该联系人的任何私人备注

4. 点击 保存联系人.

联系人列表功能

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

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

短代码是您粘贴到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!"	自定义表单标题	“发送询价”

第九部分：PDF文档

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

1. 血统证书

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

2. 交接资料包

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

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

第十部分：自动邮件通知

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

• 幼犬护理提醒 在预产期前7天发送。
• 疫苗接种提醒 在关键时间节点提醒您（6周、9周、12周、16周、1岁、2岁、3岁）。

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

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

首次设置

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 将短代码添加到您的联系页面。

第十二部分：技巧与窍门

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