docs(guides): 按实际落地能力重述 integrations 页，并校正指南索引描述行 (#756)

[yinlianghui]

Fixes #756

沿用 #755（PR）确立、PM 认可的处置：未落地的能力标注「尚未落地」并保留设计意图 + 链到路线图，不单方面删除维护者书写的产品意图；「真的落地了」的行照实描述为已落地。逐行对 src/ 与平台包实测。

实测结论

连接器：一个都没有。 src/ 与 objectstack.config.ts 里 connector / gmail / outlook 的全部命中只有三类，没有一处是连接器元数据：

• src/objects/lead.hook.ts:138 线索评分里的免费邮箱域名正则；
• src/data/catalog.seed.ts:101 / sales.seed.ts 里名为 "Integration Connector Pack" 的商品种子；
• src/flows/contact-welcome.flow.ts:16 / opportunity-approval.flow.ts:15 的注释（前者恰好说明「发欢迎邮件需要一个邮件连接器 action，而我们没有」）。

对 Slack / Teams / DocuSign / Stripe / Twilio / Aircall / RingCentral / Five9 / Intercom / Zendesk / Snowflake / BigQuery / Redshift / Zapier / n8n 全表 grep src/：零命中（只有 striped: true 之类的假阳性）。src/apps/ 与 src/pages/ 里也没有任何 Integrations 导航——表格里那 10 条 Setup → Integrations → X 路径指向的界面并不存在，这是本页最具误导性的部分，因此设置路径整列删除，换成「今天最接近的落地能力」。

Webhooks 是本页唯一真实的能力，而原文错在另一个方向。 @objectstack/plugin-webhooks@17.0.0-rc.2 确实提供出站 webhook 服务（每条订阅一行 sys_webhook，可经管理界面编写或用 defineStack({ webhooks }) / defineWebhook() 在代码里声明，命中后交给共享的消息 HTTP 出站队列投递）。但 HotCRM 没有启用它：

• objectstack.config.ts 声明的是 requires: ['automation', 'triggers', 'analytics', 'auth', 'ui', 'approvals', 'sharing']，其中没有 webhooks；
• webhooks 也不在 PLATFORM_ALWAYS_ON_CAPABILITIES（queue / job / cache / settings / email / storage / sms / sharing / messaging / analytics）里；
• 本应用没有声明任何 webhook。

所以现在改述为「一个部署侧的决定，不是路线图项」，而重试次数、载荷结构选项、投递日志界面这些原文承诺的细节从来就不由 HotCRM 定义，交还给平台自己的文档，不在这里复述我没实测过的数字。

GraphQL 不存在。 平台的服务表里有一段明确记录：graphql 槽位被移除，理由是「GraphQL is not in the product plan」，/graphql 路由此前已从 dispatcher 删除。杜撰的 POST /api/v1/leads 示例一并删除——本应用注册的对象名是 crm_lead，而路由形态取决于运行时版本（customization/api-reference 页自己也是这么写的，本页与它对齐）。

事件总线 / 密钥存储 / 原生 *.connector.ts 插件：平台能力清单（PLATFORM_CAPABILITY_PROVIDERS）里没有事件总线词条，也没有密钥存储词条，因此没有可配置的东西，那两个 Setup → Integrations → … 页面同样不存在。各自标注「尚未落地」，并写明真正相邻的机制：记录事件确实驱动记录变更流程；secret 类型字段经部署注册的加密提供方加密后写入 sys_secret，未注册提供方时写入失败关闭而非存明文（本应用今天没有编写任何 secret 字段）；connector_action 流程节点在规格里存在，但没有任何东西为它注册连接器——本应用自己的审批流程注释就记录着这一点。

新增「今天已落地的能力」一节，全部有据：HTTP 数据 API；客户 / 联系人 / 线索 / 商机四个列表视图声明的 exportOptions: ['csv', 'xlsx']；带映射与试运行的电子表格导入；联系人上的出站发送邮件（#755 已实测：仅出站，未配置 provider 时回落 LogTransport）；notify 节点经消息服务送达 Console 铃铛。

索引行

guides/index.mdx 的邮件与日历行仍写着「连接 Gmail / Outlook、双向同步、邮件追踪」，与 #755 刚改完的目标页正文直接矛盾——按 issue 要求改掉。同表的集成行描述的正是本 PR 重写的这一页（原文「Slack、Teams、DocuSign、Stripe、电话系统」），留着会立刻复现同一个缺陷，因此一并改写；除这两行外未动该页。

验证

三语 callout 数一致（各 2 个），并做了反向验证——预测方向为红：把 zh-Hant 那个 webhook callout 临时降级成普通段落后，门禁按预测报红且点名了本 PR 的新文件（integrations.zh-Hant.mdx: 1 callout(s), but integrations.mdx has 2），证明它确实在读新页面而不是空过；随后已还原，重跑转绿。

• pnpm hygiene → clean（含 no raw control bytes）
• pnpm typecheck → 0 error
• pnpm vitest run 全量 → 62 files / 1475 passed | 1 skipped

content/docs/releases/ 未触碰；平台版本仍为 17.0.0-rc.2，无任何升版；src/**、email-and-calendar 各页（#755 刚定稿）、sales/**（#758 在飞）均未触碰。

顺手发现（未在本 PR 修，已另行记录）

• guides/import-and-export.mdx 三语：同一缺陷类，声称「Setup → Data → Import Wizard」与一个「随箱提供」的 Salesforce 迁移向导（OAuth 授权 + 自动对象映射表）——同目录下 importing-your-data.mdx 才是实测过的那一页。
• guides/mobile.zh-Hans.mdx:10 / .zh-Hant.mdx:10 链到 whats-new#roadmap，而 zh 页的标题是 ## 路线图 / ## 路線圖，#roadmap 是悬空锚点（sla-and-escalation 三语都链到 /docs/administration/automation#case-escalation，而 automation 页没有这个锚点 #749 同类）。

🤖 Generated with Claude Code

https://claude.ai/code/session_01VHrPAGEgFDoHjphqYG4BMa

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
hotcrm	Ignored		Aug 5, 2026 6:14pm