opencode-wiki-historian 0.2.0

package/skills/historian/references/adapting-your-own-wiki.md

@@ -0,0 +1,53 @@
+# 接入你自己的 wiki.js / Adapting Historian to Your Own Wiki
+
+把史官插件搬到另一台机器、指向你自己的 Wiki.js 实例的六步自助上手指南。所有示例均为占位值（example.com / localhost / team-notes/ / 8000），不含任何真实部署。
+
+Six-step self-onboarding for pointing the historian plugin at your own Wiki.js instance on another machine. Every value below is a placeholder.
+
+## 1. 指向你的 wiki.js 实例 / Point at your instance
+
+- `baseUrl` 选项：默认 `http://localhost:3000`，一般无需改。
+- API token：在 wiki.js 管理端 Settings → API Tokens 生成读写 token。两种放置方式，读取优先级为**密钥文件在前、env 在后**：
+  - `apiKeyPath` 指向的单行文件（默认 `~/.wikijs-api-key`，内容一行 token，读取时 trim）；
+  - 或环境变量 `WIKIJS_API_KEY`。
+- 配置写在 `opencode.jsonc` 的 `plugin` 二元组第二参数：
+
+```jsonc
+"plugin": [
+  ["opencode-historian", { "baseUrl": "http://example.com:3000" }]
+]
+```
+
+## 2. 章节白名单 / sections 白名单
+
+- 选项 `sections` 默认空数组 = 插件端**不限制**路径前缀；真正的写权限由你的 wiki.js token 的 page rules 决定。
+- 想把 AI 写入约束在特定区：`"sections": ["team-notes/", "scratch/"]`——越界写入直接报 ConfigError 类错误。
+- 不要复用别人的章节表；接入后先 `historian_map action=show` 看你自己的布局。
+
+## 3. 翻译腿是可选项 / The translate leg is optional
+
+- 发布包**不内置**任何翻译端点。解析链：`translate.endpoint` 选项 → 环境变量 `HISTORIAN_TRANSLATE_ENDPOINT` → 未配置。
+- 翻译 key 链：`translate.apiKey` → `DASHSCOPE_API_KEY` → `translate.providerKey` 指定的本地 jsonc provider（三段都缺 = 翻译腿关闭）。
+- 端点未配置时的行为：页面照常创建，zh 孪生页返回 `zh_status: 'pending'`；随后手工双语补全——创建/追加时直接给 `sectionZh` 参数，或配好翻译腿后用 `historian_translate_snippet` + `historian_page_update`。
+
+## 4. 认清 wiki.js 的 9 个 API 陷阱 / Know the 9 pitfalls
+
+`references/wikijs-guide.md` 汇总了 wiki.js 2.x 实测的 9 条 API 行为（搜索通配、locale 路径、孪生解析、assets 上传等）。史官工具已全部内化；若你绕过工具直接调 GraphQL，先读那一节。
+
+## 5. 隐私红线与发布门 / Privacy red-lines & the pre-publish gate
+
+- 任何进入包/文档的内容不得包含：真实主机名、真实用户路径（`/home/...`）、token、真实私有部署的页面标题与章节表。
+- 硬门：`node tools/privacy-audit.mjs` 扫描 `npm pack` 全部文件（含 `dist/` 与 `skills/`）。改过任何随包文本后必须跑到 exit 0 再发布。
+
+## 6. 机构记忆层开关 / reading-loop & capture switches
+
+- `readingLoop` 默认 `true`：插件向每次请求的 system 注入"先查 wiki"提示。严格 OpenAI 兼容后端（如 vLLM）会拒绝多条 system 消息——此类部署设 `"readingLoop": false`。
+- `capture.enabled` 默认 `false`：置 `true` 后会话空闲时弹一条 toast 提醒；**只提醒、绝不自动写页**。`/historian-capture` 命令始终注册，与此开关无关。
+
+```jsonc
+["opencode-historian", { "readingLoop": false, "capture": { "enabled": true } }]
+```
+
+---
+
+配完六步，你的史官即就位：consult（reading loop 自动引路）、notice（capture 提醒留痕）、record（G1-G5 骨架 + map/timeline 归档）。

package/skills/historian/references/genres.md

@@ -0,0 +1,160 @@
+# 页型模板 G1-G5
+
+> 五种页型覆盖 wiki 中所有知识形态。选定页型后用对应骨架写作。骨架实现见 `src/templates/skeletons.ts`，本文件是操作指南。
+
+## Phase 1.5 页型分类
+
+在开始写作前，必须声明页型。分类关键词：
+
+| 页型 | 关键词信号 | 何时选 |
+|------|-----------|--------|
+| G1 事件复盘 | 故障/复盘/事故/incident/postmortem/outage | 记录已发生的事件：症状→根因→修复→预防 |
+| G2 对比选型 | 对比/选型/vs/versus/compare/benchmark/alternatives | 比较两个或以上方案，给出选型建议 |
+| G3 清单索引 | 清单/列表/inventory/checklist/catalog/命令速查 | 罗列同类对象（端口、模型、命令、配置项） |
+| G4 概念原理 | 原理/为什么/how it works/概念/机制 | 解释一个概念或机制的工作原理 |
+| G5 现状账本 | 端口/版本/已部署/当前状态/上次核实/last verified + 组件表 | 记录此刻部署/运行态，每行可复核、可追漂移 |
+
+声明格式：`页型: G<N> <类型名>`（如 `页型: G1 事件复盘`）
+
+若关键词冲突，按页面核心目的选择；仍有歧义则选 G4。
+
+---
+
+## G1 事件复盘 (Incident Postmortem)
+
+记录一次已发生的事件。
+
+**固定节序**：
+
+1. 摘要 (Summary) — 3-5 句概括事件全貌
+2. 元数据 (Metadata) — 日期、影响范围、严重级别
+3. 背景 (Background) — 事件前的系统状态
+4. 时间线 (Timeline) — **三列表**：时间 | 事件 | 来源
+5. 量化影响 (Impact) — 数字说话：持续时长、影响用户数、损失
+6. 根因 (Root Cause) — 区分直接原因 vs 根本原因；5 Whys
+7. 处置 (Remediation) — 止血 vs 根治
+8. 行动项 (Action Items) — **六列（含五要素）**：措施(行内容) | 类型 | 负责人 | 期限 | 验证 | 状态
+9. 教训 (Lessons Learned) — 做得好 / 做错 / 侥幸
+10. 附录 (Appendix) — 原始日志片段、截图
+11. 相关页面 (Related Pages)
+
+**状态块示例**：
+```markdown
+> **Status**: Active | **Updated**: 2026-09-01 | **Scope**: 2026-08-05 Solar Ray V2 ERC 电源网失明事件复盘
+```
+
+---
+
+## G2 对比选型 (Comparison & Selection)
+
+比较方案并给出选型建议。
+
+**固定节序**：
+
+1. 结论先行 (Bottom Line) — 首段给选型结论
+2. 维度定义 (Dimension Definitions) — 明确比较维度及权重
+3. 对象概览 (Object Overview) — 被比较对象的简要介绍
+4. 对比表 (Comparison Table) — 含**来源列**，禁止合并单元格
+5. 基准 (Methodology/Benchmark) — 测试方法、数据来源
+6. 选型建议 (Recommendation) — 场景化推荐
+7. 相关页面 (Related Pages)
+
+**对比表格式**：
+
+| 维度 | A | B | C | 来源 |
+|------|---|---|---|------|
+| 性能 | 120 tok/s | 85 tok/s | 95 tok/s | bench-2026-08 |
+
+---
+
+## G3 清单索引 (Inventory & Reference)
+
+罗列同类对象，便于查阅。
+
+**固定节序**：
+
+1. 范围声明 (Scope Statement) — 本清单收录什么、不收录什么
+2. 内容 (Contents) — 可选的目录概览
+3. 条目表 (Entry Table) — 按主题分组的结构化表格
+4. 维护说明 (Maintenance Note) — 如何添加/删除条目
+5. 相关页面 (Related Pages)
+
+**条目表示例**：
+
+| 名称 | 端口 | 协议 | 状态 | 备注 |
+|------|------|------|------|------|
+| Wiki.js | 3000 | HTTP | Active | 知识库 |
+
+---
+
+## G4 概念原理 (Concept & Explanation)
+
+解释一个概念、机制或原理。
+
+**固定节序**：
+
+1. 定义 + 收录理由 (Definition + Rationale) — 是什么、为什么值得记录
+2. 重要性排序小节 (Aspects by Importance) — 按重要性从高到低展开各方面
+3. 工作原理 (How It Works) — 机制详解，可含代码/图示
+4. 归因 (Attribution) — 观点来源、不同立场
+5. 相关页面 (Related Pages)
+
+---
+
+## G5 现状账本 (Current-State Ledger)
+
+记录机器"此刻部署/运行着什么"的权威快照，供人和 agent 索引现状、追踪漂移。是状态卡，不是叙事页。
+
+**固定节序**：
+
+1. 状态块 — 机读单行取值：`Active` | `Superseded-by: <path>` | `Deprecated`
+2. 部署物清单 (Component Table) — 每行必填：组件 | 版本 | 端口/路径 | 端点 | 依赖 | **上次核实于**
+3. 依赖与集成 (Dependencies & Integration) — 外部依赖与被依赖方
+4. 失效策略 (Invalidation Policy) — 什么事件作废本卡 + 复核周期
+5. 验证方法 (Verification) — 每组件一条可执行命令，agent 可直接复跑核实
+6. 变更记录 (Change Log) — 仅追加小表（日期 | 变更 | 依据）；完整历史写 G1 事件页并交叉引用
+7. 相关页面 (Related Pages)
+
+**部署物清单示例**（占位值，勿用真实部署）：
+
+| 组件 | 版本 | 端口/路径 | 端点 | 依赖 | 上次核实于 |
+|------|------|-----------|------|------|------------|
+| example-svc | 1.2.3 | 8000 | http://example.com/api | postgres | 2026-09-01 |
+
+**禁止**：叙事正文；行缺「上次核实于」；验证方法写成散文。**Supersede**：现状大改时新建卡，旧卡状态行改 `Superseded-by: <新卡路径>` 并保留，不删除。自检门第 4-6 项对 G5 换用账本变体判据（见 `src/migrate-score.ts` 的 `scoreG5Item*`）。
+
+---
+
+## 通用元素（所有页型共享）
+
+### 状态块（H1 后紧跟）
+
+```markdown
+> **Status**: Active | **Updated**: 2026-09-01 | **Scope**: 一句话回答本页解决什么问题
+```
+
+状态取值：`Active`（当前事实）| `Historical`（保留上下文，已非当前）| `Superseded`（被取代，附 banner + 链接）
+
+中文页：`> **状态**: 活跃 | **更新**: … | **范围**: …`
+
+### 表达件速查
+
+| 元素 | 语法 | 用途 |
+|------|------|------|
+| 提示块 | `> 内容\n{.is-info}` | 重要提示（可选 `is-warning` / `is-danger` / `is-success`） |
+| 紧凑表 | 表格后 `{.dense}` | 减少表格行距 |
+| 脚注 | `[^1]` 定义 `[^1]: 内容` | 补充说明 |
+| 标签页 | `[Tab A](#tab-a)` + `## Tab A` | 多选项展示 |
+
+### 禁止使用
+
+- ❌ `{{toc}}` — wiki.js 不处理，会原样输出
+- ❌ `:::` container — wiki.js 不识别，会破坏渲染
+- ❌ YAML frontmatter (`---\ntitle: ...\n---`) — wiki.js 会把它当正文显示
+- ❌ `[[path|label]]` 旧链接语法 — 用 `[Label](/path)`
+
+## 来源
+
+骨架实现：`src/templates/skeletons.ts`（G1_ZH/G1_EN/G2_ZH/G2_EN/G3_ZH/G3_EN/G4_ZH/G4_EN/G5_ZH/G5_EN）。
+分类规则：`src/templates/genres.ts`（`classifyGenre` 函数）；G5 门控判据：`src/migrate-score.ts`（`scoreG5Item4/5/6`）。
+调研依据：`docs/research/cross-cultural-wiki-writing.md` Genre templates 节。

package/skills/historian/references/rules.md

@@ -0,0 +1,30 @@
+# 写作规则 20 条 (SYN-1..20)
+
+> 跨文化 wiki 写作的通用合成规则。每条规则可在 `docs/research/cross-cultural-wiki-writing.md` 找到原始调研证据。
+
+| # | 规则 | 要点 |
+|---|------|------|
+| SYN-1 | **结论先行** | 首段给出结论或行动建议，不要让读者猜。技术文档不是悬疑小说。 |
+| SYN-2 | **一页一问** | 一个页面回答一个问题。回答了两个就拆；两个页面答同一个就合并或 supersede。 |
+| SYN-3 | **导言密度** | 导言占全文 10-15%，概括全文核心结论。超出则裁剪，不足则补全。 |
+| SYN-4 | **句长约束** | 中文句 ≤20 字，英文句 ≤25 词。超过就拆句。 |
+| SYN-5 | **表格判据** | ≥3 个字段的结构化数据用表格；≤2 字段用描述列表或行内文本。 |
+| SYN-6 | **来源列** | 对比表与时间线表必须含「来源」列。无来源的断言不可信。 |
+| SYN-7 | **时间线三列** | 事件时间线表固定三列：时间 | 事件 | 来源。缺来源列=不合格。 |
+| SYN-8 | **行动项五要素** | 行动项表六列（含五要素）：措施(行内容) | 类型 | 负责人 | 期限 | 验证 | 状态。五要素=类型、负责人、期限、验证、状态。 |
+| SYN-9 | **固定尾部** | 每页尾部必须有 `## Related Pages` / `## 相关页面` 节，挂至少一个真实链接到现存页面。 |
+| SYN-10 | **状态块** | H1 后紧跟状态块：`> **Status**: Active | **Updated**: YYYY-MM-DD | **Scope**: 一行回答本页回答什么问题`。状态取值 `Active` / `Historical` / `Superseded`。中文页用 `状态`/`更新`/`范围`。 |
+| SYN-11 | **无杂项筐** | 禁止「其他」「杂项」「Miscellaneous」节。归不进去的内容放别的页面或不放。 |
+| SYN-12 | **无溢美词** | 禁止「robust」「streamline」「leverage」「utilize」「world-class」「cutting-edge」及其等价中文（「强大的」「领先的」「赋能」）。用事实和数据说话。 |
+| SYN-13 | **无占位债** | 禁止 TODO、TBD、待补充。不知道就不写那个节。 |
+| SYN-14 | **原始数据精度** | 数字按需保留精度。`65.38461538461539/100` 写 `65.4/100`，除非精度本身是要点。 |
+| SYN-15 | **禁止空节** | `### 优点` 下写 `（无）`→ 删掉整个节。空节占空间不传递信息。 |
+| SYN-16 | **禁止原始转储** | shell 输出、聊天日志、超过 5-10 行的堆栈跟踪不直接入页。提取发现，只引用决定性行。 |
+| SYN-17 | **时间 vs 主题** | 参考页按主题组织，不按天记日记。时间线结构只用于事件/事故页(G1)。 |
+| SYN-18 | **链接规范** | 内部链接用 `[Label](/path)` 格式。禁止 `[[path|label]]` 旧语法。每条链接必须指向 cache map 中现存的路径。 |
+| SYN-19 | **双语孪生** | 每个 en 页有 zh 孪生页，路径相同、语言不同。孪生标题各用本语言（如 `Architecture` / `建筑`）。正文节对节镜像。 |
+| SYN-20 | **Supersede 协议** | 新页取代旧页时：(1) 新页达标准 (2) 旧页状态块改 `Superseded` + 链接新页 (3) 更新 wiki-index (4) 不允许两页同时声称是某主题的权威。 |
+
+## 来源
+
+提炼自 `docs/research/cross-cultural-wiki-writing.md` 的 SYN-1..20 综合规则集，结合 5 文化维度（EN/ZH/DE/FR/RU）的交叉验证。

package/skills/historian/references/style.md

@@ -0,0 +1,84 @@
+# 写作风格与信息密度
+
+> 控制 wiki 页面的信息密度、语言规范、双语写作惯例。
+
+## 信息密度规则
+
+| 规则 | 阈值 | 违反时的修正 |
+|------|------|-------------|
+| 导言占比 | 全文 10-15% | 超过则裁剪到核心结论；不足则补充概括 |
+| 中文句长 | ≤20 字 | 拆为两句或用逗号分隔 |
+| 英文句长 | ≤25 词 | 拆为两句或改为列表 |
+| 结构化入表 | ≥3 字段 | 用表格呈现；≤2 字段用描述列表 |
+| 来源列 | 对比表/时间线必含 | 补充来源列 |
+| 无溢美词 | 零容忍 | 删除修饰词，用数据替代 |
+| 无杂项筐 | 禁止「其他」「Miscellaneous」 | 归入具体主题或移出本页 |
+| 固定尾部 | `## Related Pages` 必须存在且含真实链接 | 补链接或删除空节 |
+
+## 双语写作惯例
+
+wiki 页面是 **en/zh 孪生体**：同一路径、两种语言、节对节镜像。
+
+### 标题
+
+每种语言用自然标题：
+
+| en | zh |
+|----|----|
+| Architecture | 建筑 |
+| Incident Postmortem | 事件复盘 |
+| KV Cache Tuning | KV 缓存调优 |
+| Model Comparison | 模型对比 |
+
+不混合语言。英文标题不出现在中文页，反之亦然。
+
+### 正文结构
+
+- **节序一致**：en 页的 `## Background` 对应 zh 页的 `## 背景`，顺序相同
+- **表格结构一致**：列数和含义一致，列标题各用本语言
+- **代码块不翻译**：命令、配置、代码保持原样
+- **链接路径不翻译**：`[标签](/path)` 中 path 不变，label 翻译
+
+### 状态块双语
+
+英文页：
+```markdown
+> **Status**: Active | **Updated**: 2026-09-01 | **Scope**: How KV cache sizing affects throughput
+```
+
+中文页：
+```markdown
+> **状态**: 活跃 | **更新**: 2026-09-01 | **范围**: KV 缓存大小如何影响吞吐量
+```
+
+### 翻译行为
+
+- `historian_page_create(twin:true)` 自动创建另一语言的孪生页
+- `historian_translate_snippet` 手动翻译片段
+- 代码块、表格行、URL 在翻译时被保护（不替换）
+- 翻译失败时 en 页正常落库，zh 状态标 `pending`
+
+## 中文写作细则
+
+1. **用简体字**，不用繁体
+2. **数字与单位**：数字用阿拉伯数字（`3 个`，不 `三个`），单位用国际符号（`ms`、`GB`、`tok/s`）
+3. **中英混排**：中文与英文/数字之间加半角空格（`使用 Docker 部署`）
+4. **标点**：中文语境用全角标点；引号用「」（不 ""）
+5. **术语**：首次出现给中英对照（`KV 缓存 (KV Cache)`），后续用中文
+
+## 禁止词汇
+
+| 英文 | 中文等价 | 替代 |
+|------|---------|------|
+| robust | 强大的 | 用具体指标 |
+| leverage / utilize | 利用 / 赋能 | 用「使用」 |
+| streamline | 优化 | 写具体改了什么 |
+| world-class | 领先的 | 给排名或基准 |
+| cutting-edge | 先进的 | 给版本号 |
+| in order to | — | 用「to」 |
+| please don't hesitate | — | 删除 |
+| delve | 深入 | 用「分析」或「调查」 |
+
+## 来源
+
+提炼自 `docs/research/cross-cultural-wiki-writing.md` 信息密度节（SYN-3/4/5/11/12/14/15）与双语写作惯例（EN/ZH 对照样本）。

package/skills/historian/references/wikijs-guide.md

@@ -0,0 +1,87 @@
+# wiki.js 2.x 能力指南
+
+> wiki.js 2.x 的写作表面、管理配置、API 陷阱。面向两类读者：(1) 史官工具使用者（"中文页面在哪看"）；(2) skill 开发者（API 陷阱→工具行为解释）。
+
+## 中文页面在哪看
+
+wiki.js 的多语言靠 **namespacing**（路径前缀）实现，不是浏览器翻译。
+
+| 场景 | URL | 说明 |
+|------|-----|------|
+| 英文页 | `http://<your-wiki>:3000/ops/wiki` | 默认 locale 无路径前缀 |
+| 中文页 | `http://<your-wiki>:3000/zh/ops/wiki` | 加 `zh/` 前缀 |
+| 语言切换 | 页面右上角 language switcher | 仅在 Admin > Locales 开启了多 locale + namespacing 后才显示 |
+
+**前置条件**（缺一不可）：
+1. Admin > Locales > 勾选 Active Namespaces 包含 `zh`
+2. Admin > Locales > 启用 namespacing
+3. 该页面确实有 zh locale 的内容（工具自动创建孪生页时完成）
+
+**目录 (TOC)**：wiki.js 的 TOC 不在页面内容里，而是由 Admin > Theme > TOC 配置自动从 H2/H3 生成。页面内不要手写目录。
+
+---
+
+## 写作表达件速查
+
+wiki.js 使用 markdown-it 11.0.1 渲染。以下是可用的增强语法：
+
+| 元素 | 语法 | 渲染效果 |
+|------|------|----------|
+| 提示块（信息） | `> 内容\n{.is-info}` | 蓝色信息提示框 |
+| 提示块（警告） | `> 内容\n{.is-warning}` | 黄色警告框 |
+| 提示块（危险） | `> 内容\n{.is-danger}` | 红色危险框 |
+| 提示块（成功） | `> 内容\n{.is-success}` | 绿色成功框 |
+| 紧凑表格 | 表格 markdown 后加 `{.dense}` | 减少行距 |
+| 脚注 | `[^1]` 引用 + `[^1]: 脚注内容` 定义 | 底部脚注 |
+| KaTeX 数学 | `$E=mc^2$`（行内）/ `$$...$$`（块） | 数学公式 |
+| Mermaid 图 | ` ```mermaid ` 代码块 | 流程图/时序图 |
+| 标签页 | `[Tab A](#tab-a)\n[Tab B](#tab-b)` + `## Tab A` | 切换标签 |
+| 定义列表 | `Term\n: Definition` | 术语定义 |
+
+## 禁止使用
+
+| 语法 | 为什么不行 |
+|------|-----------|
+| `{{toc}}` | wiki.js 不处理 mustache 模板标签，原样输出为文本 |
+| `:::` container | wiki.js 的 markdown-it 插件不识别 container 语法，破坏渲染 |
+| YAML frontmatter (`---\ntitle: …\n---`) | wiki.js 的标题/描述由数据库字段管理，frontmatter 会被当作正文显示 |
+| `[[path\|label]]` 链接 | wiki.js 用标准 markdown 链接 `[Label](/path)`，旧语法不解析 |
+
+---
+
+## API 陷阱（9 项）→ 工具行为解释
+
+这些陷阱是工具设计决策的直接原因。遇到工具返回错误时可对照此表。
+
+| # | 陷阱 | 工具如何应对 |
+|---|------|-------------|
+| 1 | `pages.update` 必须发送**全部字段**，只发变更字段会清空其余字段 | `historian_page_update` 内部先 read 全量再合并，写回完整字段集 |
+| 2 | 创建页面后无法直接从响应取 id；必须按 (path, locale) 回查 | `historian_page_create` 自动完成回查，返回 `page_id` |
+| 3 | `responseResult.succeeded===false` 时错误码在 payload 内，不在 HTTP 状态码 | 工具将 payload 错误解析为结构化错误返回 |
+| 4 | 空 content 创建会被拒绝（`Page content cannot be empty`） | `historian_page_create` 不传 content 时返回本地骨架模板，不发写请求 |
+| 5 | `pages.move` 是独立 mutation，不是 update 的 path 字段 | `historian_move` 专用 move mutation |
+| 6 | GraphQL 单页查询必须用 `singleByPath` + 显式 locale；默认 locale 查询可能命中错误页 | `historian_read` 始终传 locale 参数 |
+| 7 | 上传文件端点 `/u` 的字段名固定为 `mediaUpload`，文件名需净化 | `historian_page_create` 不涉及上传；资产上传为独立能力 |
+| 8 | `isPublished: false` 的页面匿名访问 404，所有 URL-200 检查会静默失败 | `historian_page_create` 默认 `isPublished: true`，仅 `_sandbox/` 显式传 false |
+| 9 | 路径首段匹配 locale 模式（`zh`/`en`/`a`）会被保留路径冲突，长度 1 也被拒 | `historian_page_create` 的路径校验拒 `zh/foo`、`home` 等保留路径 |
+
+## 路径校验规则
+
+合法路径：`lowercase-hyphen`，每段 ≥2 字符，不含 `.`、空格、`\`、`//`。
+保留路径（首段禁）：`home`、`login`、`register`、`graphql`、`healthz`、`_assets`、`favicon`。
+首段匹配 `^[A-Za-z]{2}(-[A-Za-z]{2})?$`（大小写不敏感）也被拒（防 locale 冲突）。
+
+## 管理配置入口
+
+| 功能 | 路径 |
+|------|------|
+| 多语言开关 | Admin > Locales > Active Namespaces + namespacing |
+| API Token 管理 | Admin > API Access |
+| Token 权限范围 | Admin > Groups > page-rules（path glob 匹配） |
+| 主题与 TOC | Admin > Theme |
+| 评论开关 | Admin > Comments |
+| 用户管理 | Admin > Users |
+
+## 来源
+
+调研文件：`docs/research/wikijs-2x-report.md`（API 陷阱实测）、`docs/research/wikijs-2x-capabilities-digest.md`（能力摘要）。