Appearance

Choose a theme for this browser.

GeekGravity
中EN
Log in / Sign up
Knowledge / Site docs
Feedback

管理员使用手册

Public document · Updated

On this page · 290. 按站点形态阅读（模块裁剪）1. 登录与权限2. 后台总览（侧栏 Tab）3. 导航站运营3.1 网址与分类3.2 质量与健康4. 博客与内容4.1 文章4.2 静态页与媒体4.3 投稿与评论5. 社区：论坛与 Space5.1 论坛5.2 交流空间（Space）5.3 反馈与处罚申诉5.4 Space ↔ Telegram 桥（仅 @，不做镜像）6. 知识库（重点）6.1 空间管理6.2 管理文档6.3 前台验收清单6.4 模块开关6.5 管理员不做什么7. 用户与权限8. 系统设置与 SEO8.1 Space、Telegram 与内容安全9. 动态流、广告、任务10. 中英文11. 推荐日常节奏12. 常见问题13. 相关文档

适用对象：站点管理员、内容编辑、运营同学
入口：/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. 登录与权限

  1. 打开站点 /admin，使用管理员账号登录。
  2. 左侧菜单按角色权限与模块开关显示；没有权限的 Tab 不会出现。
  3. 超级管理员拥有全部权限；可按角色分配例如：
    • 导航：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 网址与分类

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

3.2 质量与健康

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

4. 博客与内容

4.1 文章

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

4.2 静态页与媒体

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

4.3 投稿与评论

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

5. 社区：论坛与 Space

5.1 论坛

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

5.2 交流空间（Space）

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

5.3 反馈与处罚申诉

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

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

后台 交流空间 → Telegram 桥：

  1. 先在「通知渠道」配置好 TG Bot Token（与系统通知共用）。
  2. 把 Bot 拉进目标 TG 群，记下群 chat_id（多为负数）。
  3. 将站点 Webhook 设为：https://你的域名/api/telegram/webhook（需 HTTPS）。
  4. 在后台绑定：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 空间管理

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

6.2 管理文档

  1. 在空间卡片点 管理文档。
  2. 左侧树：文件夹 / 文档；支持层级、拖拽排序。
  3. 新建文档 → 编辑 Markdown → 状态改为 已发布/published 后前台可见。
  4. 草稿、归档仅管理员在后台或带 admin=1 的树可见。
  5. 「打开」优先使用 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. 用户与权限

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

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。若后台文案与本地化键不一致，以实际界面为准。