文档管理

文档管理

文档是 M-Doc 中组织内容的核心容器。每本文档归属于一个组织,包含多个版本和文章。


创建文档

进入组织页面,点击「新建文档」,填写以下信息:

字段 说明 示例
文档名称 文档的显示名称 产品手册
文档标识(Slug) URL 中的唯一标识 product-manual
描述 文档简要说明 产品使用说明文档
可见性 访问权限控制 public

Slug 命名规范

  • 仅支持小写字母、数字和连字符(-
  • 在同一组织内必须唯一
  • 一旦创建不可修改
  • 建议使用简短、有意义的名称

可见性

选项 说明
public 所有人可见,无需登录
org 仅组织成员可见
private 仅文档创建者可见

编辑文档

在文档设置中可以修改:

  • 文档名称
  • 文档描述
  • 可见性
  • 默认版本

删除文档

删除文档将级联删除该文档下的所有版本和文章。此操作不可逆。

仅文档创建者和组织 Owner/Admin 有权删除文档。

文档 URL 结构

https://mdoc.cc/{orgSlug}/{docSlug}                   → 默认版本
https://mdoc.cc/{orgSlug}/{docSlug}/{version}          → 指定版本
https://mdoc.cc/{orgSlug}/{docSlug}/{version}/{articleId}  → 指定文章

文档级 Embedding 配置

每本文档可以单独配置 AI 向量化参数,覆盖全局配置:

  • Embedding API 地址:自定义 Embedding 服务端点
  • Embedding API Key:自定义 API 密钥
  • Embedding 模型:自定义模型名称

未配置时自动回退到全局 vectorize 配置。