文档列表
📅 2026-11-21
👁️ 0
文档列表
文档列表是全站文档的管理中心,用于筛选、查找、编辑、批量处理文档,以及进入回收站和批量导入。
入口路径
后台顶部菜单 →「内容」→「文档列表」。实际地址:/system/archive/list,需要管理员权限(canAdmin)。
功能说明
列表按文档模型分组展示,提供标题、模型、分类、Flag、状态等筛选条件,以及添加文档、批量导入、批量替换关键词、回收站等入口。
界面截图

列表字段说明
| 字段 | 含义 | 取值或来源 | 对操作的影响 |
|---|---|---|---|
| ID | 文档**编号 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 标题 | 文档标题 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| thumb | 是否有缩略图 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 文档模型 | 文档所属模型(文章模块/产品模块/案例模块等) | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 所属分类 | 文档所属分类 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 浏览 | 浏览次数 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 状态 | 正常 / 草稿 / 待发布 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 发布/更新时间 | 发布与最后更新时间 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 操作 | 修改、快速编辑、更多(删除等) | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 | |
| :— | :— | :— | :— |
| ID | 文档**编号 | — | 系统生成或按平台要求填写 |
| 标题 | 文档标题 | — | 填便于识别的名称,与前台展示保持一致 |
| thumb | 是否有缩略图 | — | 按模板要求的尺寸与比例上传 |
| 文档模型 | 文档所属模型(文章模块/产品模块/案例模块等) | — | 按实际业务范围选择,可多选 |
| 所属分类 | 文档所属分类 | — | 按实际业务范围选择,可多选 |
| 浏览 | 浏览次数 | — | 按页面提示与业务需要填写 |
| 状态 | 正常 / 草稿 / 待发布 | — | 按业务需要选择启用或停用 |
| 发布/更新时间 | 发布与最后更新时间 | — | 按业务节奏设置,参考默认值 |
| 操作 | 修改、快速编辑、更多(删除等) | — | 按需点击对应操作 |
筛选条件
- 标题:输入关键词连续匹配,不会拆词。
- 文档模型:按模型过滤,切换后只显示该模型文档。
- 所属分类:只列出当前分类及其子分类下的文档。
- Flag:按推荐属性筛选。
- 状态:正常 / 草稿 / 待发布。
批量操作与状态流转
- 「批量导入文档」:按接口规范导入外部内容。
- 「批量替换关键词」:批量替换标题或正文中的指定词。
- 「文档回收站」:查看已删除文档,可恢复或彻底删除。
- 状态流转:正常文档可转为草稿或待发布;待发布文档经过发布后变为正常。
筛选条件
| 筛选项 | 取值 | 匹配规则 |
|---|---|---|
| 标题 | 关键词 | 连续匹配,不拆分词 |
| 文档模型 | 各模型 | 切换后只显示该模型文档 |
| 所属分类 | 各分类 | 含当前分类及其子分类 |
| Flag | 不限制/各推荐属性 | 按推荐属性筛选 |
| 状态 | 正常/草稿/待发布 | 按发布状态筛选 |
状态流转
| 状态 | 含义 | 可执行动作 |
|---|---|---|
| 正常 | 已发布,前台可见 | 修改、转入草稿、删除 |
| 草稿 | 未发布 | 编辑后发布 |
| 待发布 | 定时发布待生效 | 到设定时间自动发布 |
| 回收站 | 已删除 | 恢复或彻底删除 |
操作步骤
- 进入「内容 → 文档列表」。
- 用筛选条件缩小范围。
- 点击「修改」进入完整编辑页,或点「快速编辑」改少量字段。
- 使用「更多」执行删除等操作。
适用场景与建议
- 内容多的站点优先用「文档模型 + 分类」两级筛选,比标题搜索更快定位。
- 批量改-link 或品牌词时用「批量替换关键词」,不要逐篇修改。
前台调用示例
文档列表通过 archiveList 标签调用:
{% archiveList archives with type="list" moduleId="1" categoryId="1" limit="10" %}
{% for item in archives %}
<a href="{{ item.Link }}">{{ item.Title }}</a>
{% endfor %}
{% endarchiveList %}
type="page" 时配合 {% pagination pages with show="5" %} 输出分页。列表项可用 item.CreatedTime、item.UpdatedTime 等字段,时间戳需经 stampToDate 格式化。
注意事项
- 标题筛选是连续匹配,输入「模板标签」不会匹配只含「模板」和「标签」但分开出现的标题。
- 删除文档会进入回收站,不是立即彻底删除。
- 筛选条件较多时,先清除旧条件再重新筛选,避免结果为零却误以为没有数据。