本手册介绍如何创建钉钉企业内部测试应用、配置机器人与Stream模式、绑定9cWork账号，并核对私聊回复和本地对话记录。
当前支持本人私聊文本问答。电脑上的9cWork必须保持运行和联网；电脑退出、休眠或断网时不会即时回复。当前聊天渠道不开放本机文件、电脑控制或业务写入工具。消息经过钉钉和所选模型服务。
1. 准备账号与环境
安装并登录9cWork，确认已选择正确的九宸账号和组织。
使用有企业内部应用创建、配置和发布权限的钉钉账号。
建议单独创建测试应用，可使用范围先只加入本人。
钉钉企业管理员负责钉钉应用权限与发布；九宸平台管理员负责机器人归属登记。两者不是同一种权限。
2. 创建钉钉企业内部应用
打开钉钉开发者后台，用本人钉钉扫码登录并选择企业。
进入“应用开发”，选择“企业内部应用”下的“钉钉应用”，点击“创建应用”。
应用名称建议填写“9cWork测试助手”，应用描述填写“用于本人私聊测试9cWork文本问答、连续对话、本地历史记录与重启恢复”。
根据页面要求设置图标，保存应用。
完成后，应进入应用详情页，并看到“凭证与基础信息”“添加应用能力”“版本管理与发布”等菜单。看不到创建按钮时，请该钉钉企业管理员为当前账号授予应用开发权限。
3. 添加机器人并配置Stream模式
进入该应用的“添加应用能力”。
找到“机器人”（支持群聊、单聊的应用能力），点击“添加”。
进入左侧“机器人”菜单；如页面有机器人启用开关，将其打开。
填写机器人名称和图标，名称建议与应用一致。机器人简介最多10个字符，例如“九宸文本问答”；机器人描述最多200个字符，说明本人私聊文本问答及电脑在线要求。还需上传必填的“机器人消息预览图”，使用不含账号密钥的示意图片。
确认“消息接收模式”默认已选中“Stream模式”，填写所有必填项后，点击机器人配置页底部的“发布”。这是机器人配置发布，后续还需完成应用版本与可见范围发布。
截图用于说明字段及范围设置，不代表该示例应用已经完成发布或真实收发验收。
机器人名称、简介、描述与必填消息预览图
默认Stream模式与机器人配置页的发布按钮
Stream由9cWork与钉钉建立长连接，不需要你部署公网消息回调服务器，也不用安装SDK或运行官方示例项目。不要从钉钉聊天群里创建仅用于群通知的自定义Webhook机器人来代替企业应用机器人。
如果新版后台嵌入的机器人配置区域空白，但同一应用的独立配置页可以加载，可在独立页核对应用名称后继续配置。若两处均无法加载，重新进入页面并保留脱敏截图，检查网络或联系技术支持；不要重复创建应用。
4. 发布到本人可见范围
进入“版本管理与发布”，创建版本。
若要求版本号，可填“1.0.0”；说明填写“首次私聊测试”。
将应用可使用或可见范围限定为本人测试账号。
保存并提交发布；企业要求审批时由企业管理员完成审批。
确认版本已发布或已生效，而非草稿或待审批。
应用版本配置中的仅我可见范围
应用基础信息保存、机器人配置页的“发布”和应用版本发布是不同阶段。配置修改需要在生效版本中发布，客户端才能使用。
5. 在9cWork保存应用凭据
进入钉钉应用的“凭证与基础信息”，复制以下两项：
钉钉后台字段 9cWork“设置→聊天平台→钉钉”输入框
Client ID，也可能标为AppKey Client ID
Client Secret，也可能标为AppSecret 应用Secret
打开9cWork，进入“设置→聊天平台→钉钉”。
阅读并勾选专用测试机器人和第三方处理说明。
填入对应的Client ID和Secret，点击“保存专用应用凭据”。
Client ID不是企业Corp ID、AgentId或robotCode。Secret只输入到本机工作台；不要发到聊天、工单、截图或公开文档中。保存后密钥不回显，不需要因看不到明文而反复重填。
6. 九宸归属登记和渠道连接
保存后，工作台会显示机器人登记标识和不含密钥的登记信息。
将Client ID或不含密钥的登记信息提供给九宸平台管理员，登记到当前九宸账号所属的租户和用户。
归属登记成功后，在工作台点击“连接渠道”。
等待出现连接已启动及一次性绑定口令的提示。
归属登记用于避免其他账号抢用同一机器人。未登记或登记到其他账号时，工作台会拒绝建立执行连接。此时重新输入Secret或重复创建应用不能解决归属问题。
7. 从钉钉确认本人身份
在钉钉客户端切换到该应用所属企业，搜索已发布的机器人名称，打开机器人单聊。
从电脑工作台复制当前显示的完整绑定口令，例如“绑定”加当前随机口令。
在机器人单聊发送完整口令；不要使用示例文字、微信旧口令或过期口令。
回到电脑，核对待确认的钉钉用户属于本人，再完成身份确认。
机器人搜索不到时，检查当前企业、版本发布状态和本人是否在可见范围。首次身份确认后，正常重启沿用绑定，不需要每次重复发口令。
8. 完成真实对话和本地记录测试
测试 操作 应看到的结果
普通问答 钉钉私聊发送“12×13等于多少？” 收到156，不能只有连接成功提示
连续对话 发送“记住测试编号DD-1104”，再问“刚才的测试编号是什么？” 正确回答DD-1104
本地记录 工作台左侧“未分组”打开对应会话 能看到相同问题与回答，标注IM安全对话
重启恢复 正常退出9cWork，再打开并发送新问题 历史保留，渠道恢复，新问题有回复
手动停止 工作台点击“停止连接”，重启应用 保持停止；手动连接后才能继续收发
能力说明 问“你现在能做什么？” 说明当前为文本对话，不声称能操作电脑或业务系统
仅SDK连接成功不等于通过。必须确认钉钉收到正确的最终回答，并能在本地查看同一会话记录。
异常退出后旧主机租约可能尚未到期；应用会在有限时间内尝试恢复。不要同时启动多个工作台实例抢用同一机器人。未完成任务不会因重启自动重跑，超过消息有效期的任务需要重新发送。
9. 对话内容保存在哪里
工作台本机保存对话正文和执行记录，使用应用的持久数据目录，不依赖临时文件夹。
解绑默认保留本地历史，可以在工作台删除会话。
去重和待补发结果最多保留7天；这与会话正文的保留周期不同，不能理解为7天后自动删除全部聊天记录。
使用九宸平台模型网关时，平台调用日志还会记录请求内容、回答和用量；消息也经过钉钉及所选模型服务，不是仅存本机。
本机应用Secret存入凭据服务，不会在普通状态页面回显。
10. 常见问题
现象 检查方法
无法创建应用 核对钉钉企业和应用开发权限
找不到Stream模式 确认已添加企业应用的机器人能力
机器人配置区域空白 同一应用独立配置页可加载时，可核对应用名称后继续；两处均失败再保留脱敏截图检查网络，不重复创建应用
钉钉里搜不到机器人 检查同一企业、已发布版本和本人可见范围
提示未登记或无权 核对九宸平台归属登记和当前登录账号
凭据保存按钮不可用 检查两个输入框和隐私说明勾选状态
连接失败 核对Client ID与Secret来自同一应用，Stream和发布状态正确
绑定口令无反应 使用机器人单聊，保持电脑在线，确认口令未过期
已连接但没有回复 核对本人确认、工作台模型账号、任务执行与回传状态
提示“本轮未完成” 保留发送内容、时间和截图，先查失败原因，不反复扫码
回复中断 可私聊发送“重发结果”；只有已完成并保留的结果可补发，不重新执行任务
首期不验收群聊、图片、语音或文件。遇到错误先保留现场，不要立即解绑或撤销Secret，以免丢失排查条件。
官方参考
钉钉官方Stream Node SDK：创建企业应用、添加机器人和发布步骤
钉钉企业机器人配置说明