AiInsight Connector · 私聊动作
知识库空间或云文档文件夹里的每一份文件，按飞书里的目录结构，落到你在 AiInsight 里选定的一个目录下。之后按周期自动跑，跑完给你发报告。
想象一位定期上门的搬运工。你给他三样东西：门钥匙（让 insight 应用进得了你的飞书空间）、你的工牌（你的 AiInsight API key）、目的地地址（AiInsight 里的目标目录）。剩下的都是他的事。
01
没有部门、没有目标池、没有运维登记。三样配齐就是一个固定任务，再加上周期这一个运行参数。
门钥匙：让 insight 应用进得来。
一个知识库空间的链接，或一个云文档文件夹的链接。
你要做的：把「aiInsight-企业知识平台」加为知识库的空间成员，或云文档文件夹的协作者。加谁，机器人就只能读到谁。
工牌：搬运工以你的身份进门放东西。
同步用它写入。你能写的地方才会被写，不需要管理员。key 撤了，任务自然停。
你要做的：在 AiInsight 个人设置里生成一把 key，填进卡片。key 只在卡片回调里传一次，不进聊天记录，建好任务后加密存放。
地址：东西放到哪个柜子下面。
AiInsight 里一个已存在的 asset 目录，共享的或你个人的都行。飞书的结构原样挂在它下面。
你要做的：在卡片里一级一级选，不用手输路径。只列你看得到的目录。
02
下面是真实的对话顺序和卡片文案。没有自由文本猜意图：只认精确指令 /同步文档 和卡片按钮。发 /帮助 能看到可用指令。
提交后服务端马上验证两件事：应用读不读得到这个链接，key 打不打得开 AiInsight。哪项不过，就把表单带着原因再发一次。
来源：CUC 知识库
当前位置：TSG
CUC 知识库 → TSG/CUC · 每天 · 等待首次同步
03
任务建好立刻跑第一轮，之后按周期到点再跑。每一轮都是一次完整走查，顺序固定。
| 飞书里是什么 | 怎么取 | 到 AiInsight 变成 |
|---|---|---|
| 文档（新版 docx / 旧版 doc） | 导出任务 | 标题.docx |
| 电子表格 / 多维表格 | 导出任务 | 标题.xlsx |
| 上传的文件（pdf、图片、压缩包…） | 直接下载 | 原文件名，不改 |
| 目录 / 知识库节点本身 | 只取结构 | 同名目录 |
| 思维笔记、幻灯片等飞书不给导出的类型 | 取不到 | 未同步清单 |
04
开始一条文字，结束一张结果卡，失败一条原因。都发在你和机器人的私聊里。
CUC 知识库 → TSG/CUC
同步文件 128 · 目录 17 · 删除 0 · 未同步 2
下次同步：09-11 08:00
未同步清单
哪个文件、卡在哪一步（飞书读不到 还是 AiInsight 写入失败）、原始错误。清单只保留本轮还失败的项；修好权限后下一轮自动从清单里消失。
仅一次 · 每 6 小时 · 每 12 小时 · 每天 · 每周。「仅一次」跑完自动暂停，想再跑点「现在同步」。同步进行中再点「现在同步」会回「正在同步中，跑完会把结果发给你。」，不会排两份。
05
只做 AiInsight 已有的能力，不发明新概念。
/同步文档 或卡片按钮，机器人不回。06
给要维护它的人。上面的内容不需要这里也能理解。
# 对话进程（连接器） ALMANAC_CONNECTOR_DOCSYNC_TASK_API_URL=http://almanac-document-sync:8087 ALMANAC_CONNECTOR_DOCSYNC_TASK_API_TOKEN=… # ≥32 字节，两者必须成对 # 同步进程 ALMANAC_DOCSYNC_KIND=doc | wiki ALMANAC_DOCSYNC_POSTGRES_DSN=postgres://… ALMANAC_DOCSYNC_FEISHU_APP_ID / FEISHU_APP_SECRET # 同一个 insight 应用 ALMANAC_DOCSYNC_AIINSIGHT_BASE_URL=… # 生产 gateway-inner ALMANAC_DOCSYNC_CREDENTIAL_ENCRYPTION_KEY=… # key 加密主密钥
07
分清已验证、进行中和还没做的。