语雀知识库目录可通过四种方式设置：一、手动编排目录，拖拽调整文档层级；二、AI自动生成目录框架，输入主题词与需求说明；三、发布时添加文档到目录，选择父节点并设序号；四、API批量设置，用JSON定义结构调用接口。
如果您正在编辑语雀知识库，但发现文档未按预期结构组织或目录无法自动呈现，则可能是由于目录尚未在知识库中显式编排。以下是设置语雀目录的多种方法：
一、通过知识库目录视图手动编排
该方法适用于需要精细控制文档层级与顺序的场景，直接在可视化界面中拖拽调整，所有操作实时同步至知识库结构。
1、进入目标知识库首页，点击右上角「编辑目录」按钮，进入目录编排界面。
2、左侧区域显示当前知识库中所有未加入目录的文档列表，右侧为已配置的目录树形结构。
3、将左侧文档拖拽至右侧目录区域的指定位置；若需设为子节点，可在拖入后按键盘右方向键缩进一级。
4、对已有节点可执行编辑名称、移除（移除后文档回归左侧列表）、新建同级/子级空白文档等操作。
5、误操作时可立即使用快捷键 Ctrl+Z（Windows）或 Cmd+Z（Mac） 撤销。
二、使用语雀AI自动生成目录框架
该方法适用于新建知识库或内容初具规模但缺乏逻辑结构的文档集合，AI可根据关键词与语义自动构建符合技术文档规范的层级目录。
1、打开任意语雀文档编辑页，点击工具栏中的「AI助手」图标。
2、选择「智能目录生成」功能模块。
3、在输入框中填写核心主题词，例如：前端开发、Vue3、组件通信、状态管理。
4、可追加需求说明以提升匹配精度，例如：按学习路径递进，每章含代码片段与调试提示。
5、点击「生成」，AI将输出带编号与缩进的Markdown格式目录草案，支持一键插入当前文档或直接应用于知识库目录编排。
三、通过发布流程中添加文档到目录
该方法适合单篇文档定稿后即时归入既有目录体系，避免重复进入目录编辑器，提升协作发布效率。
1、在文档编辑页面右上角点击「发布」按钮，打开发布侧边栏。
2、展开「添加到目录」选项，系统自动列出当前知识库已存在的目录节点。
3、选择目标父级节点，例如：第二章｜API设计规范。
4、设定当前文档在该节点下的排序序号，支持输入数字或使用上下箭头微调。
5、勾选「发布后自动同步至目录」，确认发布，文档即刻出现在指定位置且对协作者可见。
四、通过API批量设置目录结构
该方法面向开发者或管理员，适用于需将外部文档体系（如本地文件夹结构、Git仓库目录）完整映射至语雀知识库的批量初始化场景。
1、确保已获取具备repo.write权限的语雀个人Token，并配置至环境变量 YUQUE_TOKEN。
2、准备JSON格式的目录结构定义文件，包含title、slug、parent_id及sort字段，示例节点需明确父子关系标识。
3、调用语雀开放API接口 POST /repos/{namespace}/{slug}/toc，传入结构化数据体。
4、响应返回200 OK且data.updated为true，表示目录树已按请求内容覆盖更新。
5、刷新知识库目录视图，验证层级与文档归属是否与JSON定义完全一致。
