WIKIBOX · HELP
帮助
WikiBox 是面向研发团队的中心知识系统：Raw 证据留痕、结构化 Wiki、Agent 检索接入与人工治理。
控制台功能导览
系统健康
知识库完整性、审计结果、索引状态与待处理内容总览。
知识内容
浏览与管理 20_Wiki 结构化页面、Raw 证据与来源。
知识审阅
草稿批准流：Agent 产出先成草稿，维护者批准后正式发布。
全文检索
跨 Wiki 与 Raw 的全文搜索，结果带可追溯出处。
反馈
提交缺陷与功能需求；开发侧定期拉取驱动迭代。
Obsidian
签发设备 WebDAV 令牌，以只读投影在 Obsidian 中审阅知识图谱。
系统连接
配置禅道等外部系统连接与允许同步的项目范围。
团队权限
成员、角色、项目范围与分类可见范围管理；勾选项目自动勾选其映射分类；为 Agent/设备签发独立 MCP Token。
存储管理
vault 用量与内容分布、可清理对象盘点、保留策略与一键清理（10_Raw 证据永久不可清理）。
系统管理
修改管理员密码、运行诊断与治理任务。
FOR AGENTS
Agent / MCP 接入
- 接入地址：
/mcp（Streamable HTTP），请求头携带Authorization: Bearer <Token>；Token 在「团队权限」页签发，仅显示一次。 - 检索问答：
wikibox_search全文检索并返回出处，wikibox_get_document按文档 ID 下钻 Raw 原文。 - 写入知识：临时输入走
wikibox_capture进入 Inbox/Daily；长期知识经wikibox_upsert_page写入 20_Wiki，自动同步 index/log。 - 治理：
wikibox_audit审计元数据与 Raw 不可变性，wikibox_sync增量同步已启用来源，wikibox_ingest_queue列出待编译 Raw。 - 知识插件：
wikibox_list_skills/wikibox_get_skill检索与按需加载 60_Plugins 预制件；skill 安装走 /skills/ 市场（凭 MCP token）或 skills sync，见快速接入页。 - 分类治理：
wikibox_list_categories查受控词表（动态可调），wikibox_manage_category/wikibox_set_project_categories（维护者）治理词表与项目分类映射——对 Agent 说「整理知识分类词表」即可。 - 一步接入：可复制的接入命令与配置见快速接入页。
RULES
核心规则
- Raw append-only：10_Raw/ 证据快照不可修改、删除或重命名。
- 证据分级：实时系统 > Raw/来源摘要 > Wiki > 对话记忆；回答须附出处（如 knowledge/...#L12-L18）。
- 分类边界：插件与 Wiki 页面可打受控分类；受限成员在检索与目录中看不到未授权分类的内容，无分类内容全员可见。
- 不落凭据：密码、Token、私钥不进知识库与文档。
OPERATIONS
运维速查
- 容器状态：
docker compose ps；只读体检：python3 -m wikibox --root /vault doctor。 - 审计与重建索引：
audit/reindex（同一 CLI 入口）。 - 部署与回滚流程见服务器上项目目录内 docs/ 文档。
- 升级备份与回滚：
docs/deploy-runbook-0.6.md（两级备份、三级回滚）。