# Ziin 宿主资料清单 v1

适用对象：

- 宿主技术负责人
- 实施顾问
- 项目经理
- 对接研发

目标：

- 让宿主知道最少要准备什么资料
- 让联调开始前就把边界讲清楚
- 降低“先接了再补资料”带来的反复返工

## 一、最少要准备的系统信息

- 软件名称
- 试点模块名称
- 终端形态
  - Web
  - App
  - 微信小程序
  - 宿主 AI / 对话机器人
- 当前部署方式
  - 公网体验
  - 内网
  - 私有化

## 二、最少要提供的接入字段

- `softwareId`
- `tenantId`
- `userId`
- `question`
- `route`

建议同批提供：

- `pageTitle`
- `selectedMenu`
- `platform`
- `module`

排错场景建议再补：

- `pageId`
- `recordId`
- `workflowNode`
- `errors`
- `formState`

如果希望做成真正的使用助手，再补：

- `availableActions`

## 三、宿主要准备的业务资料

- 菜单树与页面路由清单
- 角色与权限码清单
- 试点模块操作手册
- 常见 FAQ
- 常见错误与排错说明
- 关键字段规则
  - 哪些是必填
  - 哪些受权限控制
  - 哪些依赖主数据

## 四、联调前确认

- Token 是否能稳定带出角色和租户
- 是否能拿到真实页面 route
- 是否能区分试点模块和非试点模块
- 是否已有一个明确试点页面可用于验证

## 五、接完后先问的 4 句

- 订单管理在哪里？
- 这个页面下一步怎么做？
- 为什么保存不了？
- 怎么给新员工开账号和分角色？

如果这 4 句都答不稳，优先检查：

- route 是否真实
- selectedMenu 是否真实
- 权限码是否真实
- 菜单映射是否缺失
- 当前页面上下文是否只传了标题，没传稳定 pageId

## 六、上线前边界

- 公网 ESM SDK 与 examples 可公开访问
- tgz 安装包仍可继续走商务收口
- 控制接口、供应商配置、知识导入、审计接口不建议默认公开
- 动作协议必须由宿主白名单执行
- 没有权限体系时只能先按粗粒度角色降级接入

## 七、建议的对接顺序

1. 先跑通一条真实 query
2. 再补菜单、权限和页面上下文
3. 再接 feedback
4. 再接多模态
5. 最后接动作协议

一句话收口：

先让 Ziin 看懂你当前在哪、你能做什么、你卡在哪里，再谈它是不是强智能体。