知识库 / 站点文档

管理员使用手册

公开文档 · 更新于 2026年8月4日

适用对象：站点管理员、内容编辑、运营同学
入口：/admin
对应前台会员手册：user-manual-member.md
English：user-manual-admin.en.md
知识库产品细节：knowledge-base-product-plan.md

本文按「日常怎么管」写，不展开部署与源码。运维交钥匙与升级见 ops-delivery.md。

0. 按站点形态阅读（模块裁剪）

站点形态	优先阅读	可略过
导航站	§3 导航、看板、设置	论坛/Space 未开则可跳过
博客站	§4 内容、评论、投稿、SEO	纯博客模式下的导航 Tab
社区站	§5 论坛与 Space、用户	未售广告可略过广告
全能站	全文	—

侧栏没有某个 Tab = 模块关闭或当前角色无权限。

1. 登录与权限

打开站点 /admin，使用管理员账号登录。
左侧菜单按角色权限与模块开关显示；没有权限的 Tab 不会出现。
超级管理员拥有全部权限；可按角色分配例如：
- 导航：nav.links / nav.categories
- 内容：content.posts / content.pages / 评论 / 投稿
- 社区：forum.moderate / space.manage
- 知识库：kb.manage
- 设置：settings.*、用户 users.* 等

建议：日常编辑只开内容相关权限；系统设置与用户管理单独授权。

2. 后台总览（侧栏 Tab）

Tab	用途
数据看板	访问量、外链点击、内容概况
网址管理 / 链接分类 / 导航布局	导航站网址与首页分类结构
文章管理	博客文章、SEO、发布状态
静态页面	关于、友链等固定页
媒体库	图片/附件统一管理
标签管理	文章标签
投稿审核	前台用户投稿
评论管理	博客/内容评论审核
论坛	版块、主题、举报与治理
交流空间	Space 频道与成员策略
反馈与申诉	处理用户反馈并复核社区处罚申诉
动态流	Feed 来源与健康度
品牌合作	广告位与素材
通知渠道	邮件/推送等
邮箱	站内 Webmail（若开启）
用户管理	会员、角色、状态
内容翻译	多语言内容版本
知识库	公开/团队空间与文档
定时任务	计划任务与备份类作业
系统设置	站点名、模块开关、SEO 等

模块关闭（如论坛、Space、广告）后对应 Tab 会隐藏，前台入口也会随之关闭。

3. 导航站运营

3.1 网址与分类

链接分类：先建分类树，再放网址。
网址管理：标题、URL、描述、图标、所属分类、排序。
导航布局：控制首页展示的分类顺序与入口。
支持回收站类能力时，删除前先确认是否可恢复（见链接回收相关配置）。

3.2 质量与健康

定期检查死链、重复网址（若后台有链接质量/健康工具）。
重要外链变更后抽查前台首页与搜索结果。

4. 博客与内容

4.1 文章

文章管理 → 新建/编辑：标题、正文 Markdown、标签、封面、状态（草稿/发布）。
关注 SEO 检查清单（标题、摘要、slug）。
发布后确认：
- /blog 列表可见
- 文章详情页、RSS、sitemap 正常（视站点配置）

4.2 静态页与媒体

固定说明页放在 静态页面，不要占用博客时间线。
图片统一走 媒体库，避免外链失效。

4.3 投稿与评论

投稿审核：通过后可进入正式内容库。
评论管理：垃圾评论、待审、批量处理。

5. 社区：论坛与 Space

5.1 论坛

维护版块结构、置顶、关闭、处理举报。
重要讨论可引导用户「沉淀到知识库」（前台按钮，需会员登录）。

5.2 交流空间（Space）

管理频道、置顶、违规消息。
频道适合轻量沟通；需要权威文档时仍应沉淀到知识库或博客。

5.3 反馈与处罚申诉

在后台 反馈与申诉 查看用户反馈和待复核处罚；需要 feedback.manage 权限。
普通论坛移除使用可恢复隐藏，不使用硬删除。隐藏已发布主题或回复、Space 删除消息/禁言/移出成员会生成 7 天申诉记录。
原处理管理员不能复核自己的处罚，交由其他管理员或超管处理。
申诉通过会自动恢复对应内容、论坛计数、动态状态或 Space 权限；驳回与通过都必须填写回复。
仅超管保留论坛永久删除能力。永久删除不可恢复，不应用作日常举报处理。

5.4 Space ↔ Telegram 桥（仅 @，不做镜像）

后台 交流空间 → Telegram 桥：

先在「通知渠道」配置好 TG Bot Token（与系统通知共用）。
把 Bot 拉进目标 TG 群，记下群 chat_id（多为负数）。
将站点 Webhook 设为：https://你的域名/api/telegram/webhook（需 HTTPS）。
在后台绑定：Space 频道 + chat_id，按需开关 TG→Space / Space→TG。

规则（A 模式）

方向	触发	行为
TG → Space	群消息 @Bot（或回复 Bot）	写入绑定频道，署名「某某（Telegram）」
Space → TG	消息含 `@telegram` 或 `@tg`	去掉标记后推到绑定群
其它消息	无 @	不转发（非镜像）

防回环：Bot 自己的消息忽略；桥接影子账号在 Space 发的消息不再推回 TG。

6. 知识库（重点）

知识库分三层：

层	谁写	谁看	后台可管
公开 `public`	有 `kb.manage` 的管理员	全网（已发布）	是
团队 `team`	管理员	登录用户	是
个人 `personal`	仅本人	仅本人（可单篇分享）	不管正文

6.1 空间管理

/admin?tab=kb 打开知识库。
创建/启用/停用公开或团队空间。
默认常有 docs 一类公开空间（标题可本地化）。

6.2 管理文档

在空间卡片点 管理文档。
左侧树：文件夹 / 文档；支持层级、拖拽排序。
新建文档 → 编辑 Markdown → 状态改为 已发布/published 后前台可见。
草稿、归档仅管理员在后台或带 admin=1 的树可见。
「打开」优先使用 slug 路径：/kb/w/{空间slug}/{文档slug}。

6.3 前台验收清单

/kb 能打开公开空间目录
已发布文档有稳定 slug URL
匿名不可见草稿
全站搜索能搜到公开已发布文档（个人文档绝不进公开搜索）
页脚/导航知识库入口（若开启 kb_enabled）

6.4 模块开关

系统设置中与 KB 相关的键（名称以实际后台为准）：

kb_enabled：总开关
kb_public_enabled / kb_team_enabled / kb_personal_enabled：分层开关

关闭总开关后，前台 /kb 与后台 Tab 均应不可用。

6.5 管理员不做什么

不要在后台编辑用户的个人知识库正文（隐私边界）。
用户个人笔记、分享链接由用户自己在 /kb/me 管理。

7. 用户与权限

用户管理：启用/禁用账号、分配角色。
用户组：用户可以同时属于多个组；后台角色负责管理权限，用户组用于邀请码归属、定向通知和 Space 频道可见范围。系统“注册用户”组会自动包含所有账号，不能删除。
邀请码：可设置注册次数、截止时间和注册后自动加入的额外用户组；邀请码不会绕过“关闭用户注册”的总开关。
给编辑角色时遵循最小权限：能发文不必能改系统设置。

8. 系统设置与 SEO

常见检查项：

站点名称、描述、默认语言（中/英）
品牌与媒体：Logo、Favicon、全局 OG 分享图；可用 OG 图片工作台上传底图、调整排版并生成 1200×630 PNG
模块开关：博客、论坛、Space、Feed、广告、知识库等
SEO：robots、sitemap、索引策略
通知与发信：订阅、验证码、评论通知依赖发信配置

OG 工作台的底图只在浏览器本地参与合成；点击“生成并设为全局 OG”后，还需要保存系统设置才会正式生效。

改完模块开关后，用无痕窗口抽查前台入口是否一致。

8.1 Space、Telegram 与内容安全

在「系统设置 → 存储」配置 Space 临时媒体和 Telegram 私有存储频道；Telegram 媒体必须经站点代理访问，音视频不在服务器本地缓存。
「Space Telegram 配置展示」可控制频道管理员是否看到桥接配置。频道桥接配置页可生成群识别命令。
TG → Space：文字、图片、GIF、音视频和文件可在媒体 caption 中 @Bot 或回复 Bot；回复目标媒体后仅发送 @Bot 也可同步；还可回复目标媒体或贴纸后发送 /fwd、/forward、/转 或 /转发。视频贴纸支持同步，动态 .tgs 贴纸暂不支持。Space → TG：使用编辑器的 Telegram 按钮，服务端识别稳定内部令牌。
Space 附件可预览图片、音视频、PDF、Markdown 和 Excel 首表；Word 与其他文件保持下载。拒绝 HTML、脚本和可执行文件。
spam_bad_words 可用逗号或换行扩展词库。论坛、博客、Space 会在写入时打码命中词，不自动硬删除；应只添加明确违规词，避免宽泛词造成误伤。
在「安全中心」管理后台 2FA、恢复码和登录审计。2FA 不应通过普通系统设置修改。
在「通知」中配置站内、邮件、Telegram 与浏览器通知；全站公告和群发通知应先小范围测试后再全量发送。
Space 支持匿名频道、成员/频道权限和临时媒体清理。匿名仅影响显示名；清理策略应与有限服务器磁盘容量一致。
S3/R2 备份份数可配置，最小为 1；定期检查备份任务、恢复演练和对象清理结果。

9. 动态流、广告、任务

动态流：确认内容源（博客/网址等）是否按预期进入 /feed。
品牌合作：广告位与素材；无素材时不应强插。
定时任务：备份、推送、清理类任务；失败看任务日志。

10. 中英文

界面文案支持中/英切换。
用户内容（文章、网址、论坛）保留原文；需要时用 内容翻译 维护译文。
API 错误在英文界面会尽量显示英文，避免中文乱码感。

11. 推荐日常节奏

频率	动作
每日	评论/投稿/举报；看板异常流量
每周	知识库公开文档更新；死链抽查
每月	用户角色复核；备份与定时任务成功记录
发版后	按 `ops-delivery.md` 验收清单走一遍

12. 常见问题

Q：后台没有「知识库」Tab？
A：检查是否登录管理员、是否有 kb.manage、kb_enabled 是否关闭。

Q：前台 /kb 404 或空白？
A：模块开关；是否有启用的 public 空间；是否有已发布文档。

Q：改了文档前台还是旧内容？
A：确认状态为已发布；检查是否编辑了错误空间；强刷缓存。

Q：个人用户说找不到知识库入口？
A：引导 /kb/me 或个人中心「知识库」Tab；需登录；个人层开关需开启。

Q：分享链接被搜到了？
A：设计上分享页 noindex 且不进全站搜索；若被传播属链接泄露，用户可在 /kb/me 撤销链接。

13. 相关文档

文档	说明
会员手册（中）	普通登录用户前台能力
会员手册（英）	Member manual
管理员手册（英）	Admin manual (EN)
知识库计划	功能清单与验收
运维交付	部署、升级、回滚
站群原则	多站交付原则

文档版本与代码主路径对齐：知识库 P1–P16。若后台文案与本地化键不一致，以实际界面为准。