文档
先按教程走一遍，再查使用帮助、产品说明与对接文档。正文与仓库里的帮助、产品文档、SDK 是同一份。
学习路径
建议按 快速入门 → 提高 → 升级 → 精通 读。后面几类分别来自使用帮助、产品说明、对接文档和机制说明。
使用帮助
Cadau 新用户帮助（目录版）
新手引导 — 第一次使用、界面与账号（主题目录 help/new-user-guide/）：
阅读新手引导：第一步与工作区
- 顶栏左侧：当前工作区名称（点一下可切换）；在「消息」里还会看到智能体列表的展开/收起按钮。
阅读新手引导：界面导航与两种助手
怎么进入：顶栏最右侧点 消息；应用 在 消息 左侧；本区席位或客服小组成员 可见 客服（在功能菜单与应用之间）；其余模块在 功能菜单（分栏图标）里。
阅读新手引导：登录、主题与账号
- 支持 手机号或邮箱 + 密码（默认）与 验证码 两种方式，可在登录页切换。
阅读Cadau 产品功能说明（目录版）
各模块 能做什么、怎么用 — 供日常查阅与帮助智能体检索（主题目录 help/product-features/）。
阅读产品功能：总览
各模块能做什么、怎么用——供已入门用户查阅，也供 帮助智能体 按问题检索。第一次使用请先看 新手引导。
阅读产品功能：创建与管理工作区
- 进入「工作区协作」（可点击：去工作区协作）。
阅读产品功能：资料库（模板与表格）
工作区内团队共用的 可套用文件，以及自己做好的 演示 / 文档 / 表格样式。发布后，自己和同事都能下载；在对话里选用办公样式时，助手会生成 新文件，不会改资料库里的原件。
阅读产品功能：工作区应用
本工作区内的轻量业务小软件——有界面、有数据，也可在 消息 里让工作智能体帮你创建或改进。
阅读工作流（产品帮助）
在 工作流 中从模板创建流程，可选发布到 应用桌面，再发起实例、处理待办。
阅读产品功能：数据连接与预定义查询
工作区管理员配置 数据连接（MySQL / PostgreSQL / SQLite）后，成员可在 消息 里让工作智能体 查业务数据（只读查询为主），并在授权范围内执行 受控变更（增删改，可配置审批）。本页说明 预定义查询是否必须、表预览行数限制、与 工作区技能 里写表定义的关系，以及怎样配才 又快又准。
阅读产品功能：消息、会话与附件
- 刚注册或未选工作区：进入 消息 即默认与 帮助智能体 对话，解答产品用法与入门问题（可点击：去消息）。
阅读产品功能：人工客服
智能体答不好时，用户可转 真人客服；由管理员为 每个智能体 单独开启，指定 本区客服同事 或授权 客服小组，在 客服工作台 接单处理。
阅读产品功能：制作演示文稿
助手可根据你描述的内容，一次生成带排版的 .pptx 文件（封面、要点页、流程页、总结页等），并支持在发送前 选择演示样式。
阅读产品功能：写一份文档
助手可根据你描述的内容，一次生成带排版的 Word 文件（.docx）：页眉、标题层级、表格、汇总卡片、说明底色，并支持在发送前 选择文档样式。
阅读产品功能：做一份表格
助手可根据你描述的内容，一次生成带版式的 Excel 文件（.xlsx）：标题条、表头底色、斑马纹、汇总卡片、说明底色，并支持在发送前 选择表格样式。
阅读产品功能：智能体记忆
帮助用户理解「助手跨会话记得什么、怎么写、怎么改、怎么清理」；与 知识文档目录（团队/个人说明材料）不是同一套东西。
阅读产品功能：智能体备忘
帮你把对话里要用的记录（文字、文件、图片）按标签存起来，需要时再查；不是助手自动记住的偏好。
阅读产品功能：技能与智能体
检索要点：技能中心可 导入技能包 / 导出技能包（标准或含历史）；智能体市场可另存模板并审核上架；对话里可 @ 技能，助手一般会先阅读再执行。
阅读产品功能：智能体操作规则（AGENTS.md）
部分智能体需要处理 「最近三天」「本月」「截止今天」 等相对日期，或按固定步骤调用业务接口。这类 怎么做，应写在 操作规则 里，而不是堆在人格（语气、风格）中。
阅读产品功能：怎么写好工作区技能
技能是供智能体 按步骤复现一类操作 的说明，不是背景知识（那在 知识文档目录）。写得好不好，直接影响对话里 会不会被想起、能不能做对。
阅读产品功能：交互式 HTML 报表脚本（ECharts / Mermaid / Leaflet）
助手在对话里写出可预览的 HTML 报表 时，统计图、组织/流程图、地图分别用哪套平台脚本；怎样导入示例技能、怎样判断有没有用对。
阅读产品功能：技能里该有什么（允许清单）
目的：生成或更新技能时，只保留执行所需；清单外一律不要。
阅读产品功能：联络（与同事、好友聊天）
两者分开，避免把「问 AI」和「找同事说话」混在同一列表里。
阅读产品功能：我的（账号与偏好）
管理 你本人 的登录身份、在联络里怎么被看到，以及 Web 端界面偏好。不必先选工作区 即可使用。
阅读产品功能：人力资源（应用）
在已选工作区的 应用桌面 打开 「人力资源」，维护本工作区的组织、人员与发展相关信息。
阅读用操作助手查人力资源
已选工作区，且部署启用了 人力资源 应用时：
阅读人力资源：权限怎么配、怎么用
说明在「人力资源」里如何绑定账号、任命角色，以及不同身份如何做自评、经理评与校准。
阅读知识文档的三层
Cadau 把给智能体读的说明分成三层，方便你在对的范围里写对的内容：
阅读谁可以维护哪一层
索引可选 paths：仅在与用户附件或消息中的文件路径相关时才注入该篇；三层知识均适用，详见 三层说明 与 系统知识索引说明。
阅读Cadau 实践指南（目录版）
使用技巧与功能关联 — 比产品功能更细：该写进人格、操作规则还是记忆？含模板与案例（主题目录 help/guides/）。
阅读实践指南：目录
比「产品功能」更细的使用技巧与 功能关联——帮你判断「这句话该写进人格、操作规则还是记忆」，并附带可直接改写的模板。适合已选工作区、正在配置 我的智能体 的用户。
阅读实践指南：写在哪里——决策与案例
同一句话，写进 人格、操作规则、记忆、知识文档或技能 效果不同。按下面问题自测，再对照案例。
阅读实践指南：智能体运行时文件一览
工作区里 我的智能体 在服务端有一份 运行时材料（你在 Web 各页编辑，不必自己找磁盘路径）。下面用 界面名称 为主，括号内为实现文件名，供对接与排查时对照。
阅读实践指南：USER.md 与记忆——模板与分工
用户画像（USER.md）与 长期记忆、日笔记 都关于「与你有关的信息」，但 维护方式 与 对话注入 不同。均在智能体 → 记忆 页（画像在页面上方，条目在下方）。
阅读实践指南：SOUL.md 人格模板与示例
人格 决定助手 怎么说，不替代 操作规则 里的 怎么做。在 智能体市场 → 我的智能体 → 人格 页维护（对应 SOUL.md）。
阅读实践指南：AGENTS.md 操作规则模板与示例
操作规则 约定 怎么做——步骤、工具约束、日期算法。在 操作规则 页编辑（对应 AGENTS.md）。人格与语气请在 人格 页。
阅读服务端配置说明（mindlink.json）
仅环境变量模式：不放置 mindlink.json 时，进程完全依赖环境变量（见各节「环境变量」列）。
阅读系统知识文档与检索索引
给谁看：平台管理员（管理端 系统知识文档 工作区）。
阅读智能体记忆维护（管理端）
给谁看：平台管理员（管理端 智能体记忆维护）。
阅读成员对接授权（多系统密钥）
工作区管理员可为 每位成员 配置 多套 外部系统授权（API Key、Bearer 令牌等）。该成员在本工作区内的 所有智能体 在对话中发起联网请求时，可由服务端注入真实密钥，不会在界面或帮助文档中回显明文。
阅读脚本执行与成员授权
工作区管理员可为成员开通 脚本执行：让智能体在对话中 按技能里的 Python 脚本，生成或修改 Excel / Word / PPT 等可下载文件。权限分 平台、工作区、成员 三层，与 联网请求 类似。
阅读产品说明
Cadau 产品介绍
Cadau 是一款面向企业与团队的 AI 助手产品。你可以把它理解成：
阅读Cadau 产品说明书（用户侧 · 集成侧）
本版以 企业管理员 / 运营 与 宿主系统开发 / 架构 为主；以下为建议阅读范围。
阅读Cadau 管理员端功能规格（Admin Console）
面向 管理员用户 的说明 一律以用户表达为准（见根 docs/产品规格.md 页眉）；界面与帮助文案用自然、可执行用语。
阅读Cadau 文档索引
产品能力以 产品规格.md 页眉为准；本页仅作导航，文件名均为中文。
阅读对接集成
Cadau SDK
本目录按 四类扩展方式 组织代码与文档。选型不确定时先看下表，再进对应子目录。
阅读传软嵌入 SDK（host-embed）
目录名：sdk/host-embed
阅读在网站中接入 Cadau 助手
将本文档交给负责网站或前端的同事，或粘贴给开发工具的 AI 作为完整集成上下文。
阅读Cadau 嵌入 SDK 契约（V1.5.13）
- 目标：让宿主系统以最低接入成本集成“我的智能体”对话能力，并支持有限、可审计的页面操作联动。
阅读宿主知识文档撰写要求
宿主指接入 Cadau 嵌入挂件（或等价 SDK）的 你的业务系统，不是 Cadau 控制台本身。
阅读嵌入智能体接入指南
- 在 Cadau 创建/选定嵌入用智能体，确定 app_id
阅读宿主 LLM 服务（指定智能体代答）
宿主后端原来若直接调大模型，可改为：由 Cadau 里 指定的工作智能体 代为回答。用户不必登录 Cadau，也不必打开页面挂件。
阅读宿主增强：Agent Run 与数据连接行/字段权限
面向 传软 / 旧有业务系统（宿主增强，见产品规格 §4.2.4）。可运行范例与 API 对照见仓库 examples/hr-multi-tenant/docs/HOST_LEGACY_INTEGRATION.md。
阅读插件应用 SDK（platform-plugin）
目录名：sdk/platform-plugin
阅读平台插件 REST API 契约
Base URL：{Cadau 站点}/api/v1
阅读工作区应用 SDK（appsdk）
目录名：sdk/appsdk
阅读工作区应用 · 界面描述规范（完整版）
读者：需要手写或审阅应用界面描述的人（含应用开发助手改草案时对照）
阅读应用包结构（必须有什么）
读者：要从零手工搭一个可运行工作区应用的人。
阅读动作与 handlers（界面按钮 → 代码）
读者：在界面加了动作表单后，要在包内写出对应实现的人。
阅读取数与流水线（pipeline）
读者：动作不仅写本地库，还要从工作区 数据连接 拉数、再组装结果的人。
阅读视图与布局：能做什么、不能做什么、以后怎么加
读者：要理解「界面长什么样」以及「按设计稿/截图做界面」该怎么走的人。
阅读手工搭建指南（读完能搭一个 App）
目标：不依赖「对话创建」，仅凭本目录文档 + 模板对照，手工做出可打开、可点、可取数（可选）的工作区应用。
阅读应用开发助手 · 运行规则摘要
- 工作区轻量应用：声明式界面（app.json）+ 可选包内脚本；适合登记、列表、一键办事、生成报告。
阅读插件工具 SDK（agent-capability）
目录名：sdk/agent-capability
阅读机制与规格
核心机制索引
本目录沉淀 Cadau 的核心机制说明（产品可理解表述 + 实现对照），便于统一理解与持续迭代。
阅读Cadau 产品规格
Cadau 是面向企业与团队的 AI 助手产品（多用户、多工作区协作）；Web 与移动端统一通过 Cadau Go 后端调用业务与对话能力。浏览器与移动端均不直连第三方「智能体网关」（历史上曾规划对接 OpenClaw，现已取消）。每个用户账号相互独立；用户可 创建工作区，并将其他用户 邀请或加入 自己任一所创建的工作区，在 工作区范围内 协作。共享资源、协
阅读mech-ui
与 产品规格.md 一致，产品文案以用户表达为准。
阅读智能体调用知识文档的方式
面向产品、运营与对接方，用用户能理解的用语说明「知识从哪来、怎么进对话」；实现名放在文末 实现对照。
阅读索引式说明/技能文档与反馈改进闭环
将说明文档与技能文档统一为“两层索引结构”，让系统在回答问题或执行操作前，能够快速、准确地检索到相关内容，并基于真实对话反馈持续改进 应答质量，形成长期可演进的知识闭环。
阅读规范库（法规与管理标准）
- 产品规格.md §3.2.1（知识文档三层）、§3.2.2（规范库）、§4.2.4（平台插件）
阅读检查方案（实践机读包）
- 产品规格.md §3.2.2 规范库、§3.2.3 资料库、§3.2.4 检查方案、§4.2.4 合规
阅读资料库（模板与表格）
- 产品规格.md §3.2.1（知识文档）、§3.2.2（规范库）、§3.2.3（资料库）
阅读合规：实践检查表 → 机读包
- 检查方案.md（机读包正式存放；必填依据规范）
阅读AI 生成知识文档索引（规则）
「用 AI 重新生成索引」 指：在 当前智能体的知识文档目录 下，根据已有 Markdown 说明，自动生成或刷新 两层检索用的索引文件，让后续对话能 先锁定相关文档、再读原文 作答或执行。
阅读文档驱动意图执行机制
这套机制用于让 Cadau 从“关键词触发”升级为“可理解用户意图并执行操作”的智能体系统。
阅读MemoryForge（记忆锻造）机制说明
- 英文名：memoryforge
阅读智能体记忆（用户智能体）
不写入记忆：代码路径、知识文档里已有的事实、通用产品说明、整段对话流水。
阅读智能体备忘
复制智能体方案时 不会 带上备忘。帮助智能体 没有 备忘。
阅读定时任务（Cron）
- 英文名：scheduled_tasks（实现包名建议 schedule）
阅读帮助动作链接
帮助智能体回答中的可点击跳转，用用户能懂的说法描述；实现协议为 mindlink://action/…。
阅读帮助智能体对话操作（ChatOps）
用户在「消息」或右下角操作助手里对 帮助智能体 说话时，不只是问「怎么用」，也可以让它 代做 自己在界面上能做的事。
阅读操作助手「快捷一句」动态排序机制
操作助手面板底部的三个快捷一句按钮（点击后会切换到对应模块并发送一条预设提问）不应长期固定不变，而应随用户当前所在模块、是否已选工作区以及近期在助手里的对话内容变化，优先展示更可能下一步会点的入口。
阅读统一对话与联络
- 一套对话体验：与同事单聊、与智能体单聊、工作区群聊，共用会话列表、气泡时间线、附件与未读。
阅读服务通知
- 系统找用户：工作区邀请、加入申请结果、好友申请等产品事件发生时，用户在 「消息」 里能看到 固定入口「服务通知」，不必记得去某个模块里翻。
阅读人工客服（即时）
用户在与某智能体对话时，若希望 马上有人在线协助，可点 「人工客服」；由该智能体 事先指定的客服同事 在工作台接单，并在同一对话中（嵌入）或通过 联络（主站）继续沟通。这是 即时 通道，有排队与约等提示。
阅读工单（异步）
用户不必马上等到真人在线时，可 提交工单 留下问题；客服同事稍后在工作台处理、留言回复并办结。工单 不要求及时性，与 即时人工客服（在线排队聊天）是两套能力。
阅读会话消息窗口化加载（微信式）
- Web：client/web/src/chatMessageWindow.ts、client/web/src/useChatSessions.ts、client/web/src/WorkChatMessageThread.tsx、client/web/src/ChatTurnNav.tsx
阅读会话阅读模式与导出
- Web：client/web/src/readerModePref.ts、ReaderModeBar.tsx、style.css（data-reader-mode）、WorkChatMessageThread.tsx、ChatTurnNav.tsx
阅读工作区数据驻留
产品能力与界面说明以用户表达为准。本文描述数据落在哪一层库，供实现与对接对照。
阅读技能组成规范
面向产品、运营与对接方，用用户能理解的用语说明「技能是什么、由哪些部分组成、如何进入对话」；实现名放在文末 实现对照。
阅读工作区能力包
面向产品、运营与管理员，说明工作区「助手能力包」是什么、如何映射到助手工具；实现名见 实现对照。
阅读工作区应用
面向产品、运营、对接与管理员；用户可见文案以 用户表达 为准，实现名见 实现对照。
阅读工作流
Cadau 提供 工作流 顶栏模块（与智能体、技能中心同级），用于：
阅读工作流与合规检查
面向产品、运营与对接；实现术语见 实现对照。
阅读