Pinny AI地图助手
借助 Layerpin 内置对话式 AI 助手 Pinny，快速生成标记、勾勒区域边界、配置过滤器、将全图翻译为 16 种语言并查询套餐容量。
认识 Pinny：您的 AI 交互式地图副驾驶
Pinny 是 Layerpin 原生对话式 AI 助手，专为交互式平面图、建筑蓝图、园区地图和技术原理图设计。无需手动绘制数十个图钉或复制粘贴翻译表格，您只需使用自然语言描述需求、附加参考文档，即可让视觉模型直接在底图上准确定位标记。
- Human-in-the-Loop Validation: Pinny 严格通过结构化提案运行。未经您的明确核验，绝不会私自更改或发布在线地图。
- Draft-First Workspace Safety: 批准的更改会直接写入编辑器的草稿会话中。在您核对并点击“发布”之前，访客看到的嵌入地图不受任何影响。
- Zero-Markup Direct BYOK: 接入您自己的开发者 API 密钥。密钥在服务器上使用 AES 加密存储，直接由您选择的 AI 服务商按开发者官方费率计费。
- Persistent Threads & Proposals: 对话和提案状态持久保存在数据库中。您可以关闭浏览器，随时返回查看过去的草稿或重新执行批处理。
BYOK 设置与支持的 AI 服务商
Pinny 适用于符合条件的 Layerpin 付费方案（Starter、Pro 和 Ultra）。为保护隐私并确保可预测的费用，Pinny 采用自带密钥（BYOK）模式，Layerpin 不收取任何 Token 加价费用。
配置您的开发者密钥
在仪表板或地图编辑器中打开 Pinny。在聊天头部点击“更多操作 (…) > API 密钥”。选择服务商并粘贴密钥，然后点击“保存密钥”。密钥在首次发送消息时验证，之后绝不会以明文显示。
重要提示： 个人订阅（如 ChatGPT Plus 或 Claude Pro）不提供 API 访问权限。您需要开通了计费功能的开发者平台账户。切勿将密钥粘贴到提示词或地图描述中。
账户聊天与地图聊天范围
Pinny 运行在两个专用的工作上下文中，每个都配备了量身定制的自主智能体工具：
从主控制台启动。在您的整个账号、团队工作区和订阅配额范围内工作。
Pinny 可以做什么：
- 查看地图数量、发布上限和月度浏览配额
- 按标题查找您的地图或列出最近更新
- 读取地图尺寸、项目数量和已发布快照状态
直接嵌入交互式地图编辑器的侧边栏。深度感知画布图像、项目、几何形状、标签和过滤器。
Pinny 可以做什么：
- 绘制可自定义的标记图钉、多边形、矩形和测量线
- 批量编辑现有标记、标签、样式和自定义字段
- 整理分类、图例开关和交互式过滤栏
- 将所有地图内容、过滤器和媒体文本翻译成 16 种语言
- 目视检查蓝图，在房间和地标上放置图钉
- 检查地图质量，找出缺失的描述或未分配的分类
对话式地图创作
Pinny 理解 Layerpin 标准化的 0–100 坐标系、数据模式和设计样式标记。您可以用日常语言在几分钟内构建复杂的地图：
1. 生成图钉、图标和结构化字段
让 Pinny 生成单个图钉或批量生成数百个兴趣点。Pinny 会自动配置坐标、图钉样式、十六进制颜色、自定义图标、标签、Markdown 描述和自定义键值字段。
2. 导入参考表格（CSV、JSON、Markdown）
无需重新输入名录数据。将 CSV、JSON 文件或 Markdown 表格直接拖入地图聊天框。Pinny 会提取名称、电话、营业时间和标签，映射到结构化字段并分配分类。
3. 描绘多边形、边界和区域轮廓
Pinny 可以生成矢量边界，包括复杂多边形顶点、展位矩形和限制半径圆形，并设置填充不透明度、边框粗细和标签锚点。
4. 智能分类整理与过滤器合并
随着时间推移，地图会积累杂乱的分类。Pinny 可以分析您的项目并推荐单选或多选过滤栏。如果存在重复分类（例如“咖啡馆”和“餐饮”），Pinny 可以智能合并为统一过滤器并自动重新映射所有项目分配。
视觉图像解析
当您选择支持视觉输入的模型（如 GPT-4o、Claude Sonnet 5 或 Gemini 3.5 Flash）时，Pinny 可以目视检查基础地图图像以定位建筑房间，并直接在图上放置图钉。
视觉放置的工作原理
当您让 Pinny 根据蓝图的视觉特征放置项目时，它会生成基础图像的高清预览渲染。AI 检查图像，目视识别房间号、地标标签或停车位，并将其像素位置转换为标准化地图单位（0 到 100）。
视觉图钉放置最佳实践：
- 清晰的标签:上传高分辨率源图像，使建筑编号和房间标签清晰锐利。
- 提供视觉锚点:用空间线索引导 Pinny（例如：“查看 B 入口附近的东北角，在 201 至 208 房间放置标记”）。
- 检查近似几何形状:AI 视觉坐标是准确的建议。保存前请务必点击“检查提案”以在地图画布上检查图钉。
全量多语言翻译
Layerpin 支持 16 种访客原生语言。无需手动翻译字符串，Pinny 可一次性完整翻译整张地图：
- Map Metadata: 地图标题与描述
- Markers & Pins: 标题与 Markdown 内容
- Shapes & Zones: 标题、描述与文字标签
- Structured Fields: 自定义字段标题与值
- Action Buttons: CTA 链接与弹窗按钮
- Category Filters: 过滤器名称与值标签
- Media Images: 显示名称与描述
- Accessibility: 图片替代文本与媒体标签
- Proper Names: Preserves room IDs, SKUs & brand names
多语言提案检查
当 Pinny 返回多种语言的翻译（例如法语、西班牙语、德语）时，提案卡会呈现语言胶囊。您可以按语言预览更改、打开详细 diff 对话框，逐个应用语言或点击全部应用。
想要配置公开语言选择器或在 4 选项卡编辑器中手动编辑翻译？请参阅 多语言地图和翻译指南.
提案审查与安全工作流
Layerpin 确保您对公开交互资产拥有完整的作者控制权。Pinny 严格通过验证后的提案对象运作：
- 1Pinny 准备结构化提案当 Pinny 执行创作工具时，会直接在聊天对话中生成交互式提案卡。该卡显示项目数量、分类映射和状态徽章（就绪可应用）。
- 2在卡片视图或表格视图中检查点击“检查提案”打开全屏检查器。在卡片视图（用于视觉布局检查）和表格视图（用于原值与建议更新之间的高密度并排 diff 对比）之间切换。
- 3使用对话框内编辑器微调需要调整建议的标记标题或微调坐标？点击提案检查对话框中的任意项目，打开内联提案项编辑器，在保存前直接修改数值。
- 4应用到编辑器草稿工作区点击“添加到草稿”（或“全部应用”）。项目会立即呈现在交互画布上。您可以在标准编辑器检查器中拖动标记、调整缩放级别或微调颜色。
- 5就绪后发布给访客实时嵌入和公开链接提供不可变的已发布快照。在您检查实时多设备预览并点击顶部标题栏的“发布”之前，草稿更新对网站访客不可见。
Token 分析与外部 MCP 集成
Pinny 对 AI 使用情况完全透明，并可扩展连接到外部开发者工具：
在聊天标题栏点击更多（…）> Token 用量。检查所有对话中的精确提示 Token、补全 Token、模型 ID 和预估服务商成本。
Connect your Layerpin account to ChatGPT or external MCP clients via our secure endpoint at https://mcp.layerpin.com.
高效提示词速查表
以下是久经考验的提示词模板，可复制并适配到您的交互地图：
Pinny 查询您的订阅等级、有效地图上限、已发布地图上限和同步的计费浏览指标，不修改数据。
视觉模型在蓝图上目视定位标签，并自动计算每个图钉的标准化地图单位。
提取结构化行，零手动录入创建图钉、自定义字段和分类。
翻译地图标题、描述、项目、结构化字段、过滤器选项和媒体替代文本，并进行多语言提案检查。