Nạp tài liệu & duyệt Wiki — role tri thức Arkon

Đối tượng: Arkon contributor (viết/propose) và knowledge_manager (duyệt). Portal: Arkon :3119. Phạm vi áp dụng: Department của bạn + Global. Out-of-scope chỉ lộ tên scope, không lộ nội dung.

Bạn là ai

Role	Quyền cốt lõi	Bạn làm gì
viewer	doc/wiki/skill:read:own_dept	Đọc tri thức trong dept mình + global
contributor	+ doc:create:own_dept, wiki:write:own_dept, skill:create:own_dept	Upload tài liệu, propose draft Wiki/skill
knowledge_manager	doc/wiki/skill:*:all + skill:contribution:review + quản departments/employees/audit	Duyệt nội dung toàn hệ thống, quản category
admin	ALL_PERMISSIONS	Quản trị hệ thống — xem Vận hành

Quy tắc phân biệt quan trọng: propose draft cần wiki:write:*, nhưng direct edit/approve cần wiki:write:all — contributor không tự duyệt bài mình.

Đừng cấu hình theo tài liệu Workspace cũ

Tài liệu Arkon cũ còn mô tả Workspace realm + routers/projects.py, nhưng code hiện tại không còn — thực tế dùng Department / Global scope.

Nạp tài liệu vào Wiki — pipeline MRP

1. Knowledge → Upload Source: tải PDF/DOCX/MD/URL (ảnh được vision-caption trước khi biên dịch).
2. Nguồn chạy qua pipeline MRP 6 giai đoạn: MAP → REDUCE → plan_review → REFINE → VERIFY → COMMIT. Mọi lần nạp sinh plan duyệt trước khi ghi (liệt kê trang nào tạo/cập nhật) — bạn xem plan, Approve Plan (hoặc Regenerate kèm feedback) rồi Arkon mới biên dịch cây trang liên kết chéo.
3. Nguồn đỗ ở plan_ready là đúng, không phải treo — đó là cổng người duyệt mặc định. Chỉ tài liệu vượt ngưỡng token (auto_approve_extraction_threshold_tokens, mặc định 200k) mới đỗ thêm một nhịp ở awaiting_approval (bạn quyết có tiêu token AI để bóc tách không).
4. Trang mới merge (không overwrite) khi chạm trang cũ; mọi claim ghi nguồn biên dịch; draft persist giữa pipeline — crash chạy lại không mất việc LLM đắt tiền.
5. Theo dõi trạng thái nguồn: pending → processing → plan_ready → ready. Nguồn error → xem Xử lý sự cố.

Tick "Giữ nguyên văn" đúng tên trường: preserveVerbatim (camelCase)

Gửi sai tên (preserve_verbatim snake_case) bị bỏ qua im lặng — tài liệu đi qua MRP như không tick. Tick đúng thì nguồn bỏ qua MRP hoàn toàn, băm nguyên văn theo trang, không sinh trang wiki phái sinh — đúng thứ cần cho hợp đồng/đặc tả pháp lý.

Nguồn báo error? Nguyên nhân hay gặp nhất không phải bug mà là LLM timeout (mặc định 120s cho MAP). Nâng timeout hoặc đổi model rồi Retry — Retry chỉ chạy lại giai đoạn commit (idempotent, không gọi lại LLM), bấm nhiều lần an toàn.

Đề xuất và duyệt Wiki draft

• Propose (contributor): Wiki → Propose page (hoặc agent Board propose_wiki_edit / wikiProposals trong result.json tự thành draft). Draft vào hàng đợi.
• Review (knowledge_manager/admin): Wiki Review (/wiki/review, 3 pane queue/diff/meta, filter pending/needs_revision/approved/rejected, phím j/k/a/r/c/Esc/?) → đọc diff proposed/current + panel AI check + cảnh báo has_conflict → Approve & Merge / Request changes (note ≥ 20 ký tự) / Reject.
• Tác giả theo dõi draft của mình ở ?mine=true, có thể Withdraw/Resubmit.
• Conflict khi approve: vào Wiki Rebase (/wiki/branches/[id]/rebase) gỡ rồi merge lại.

Checklist tự xác minh

• Upload 1 file nhỏ → thấy plan_ready → Approve Plan → trang Wiki xuất hiện, có backlinks/outlinks, version history ghi nguồn.
• Propose 1 draft → manager thấy trong Review Queue → approve → trang live; thử Request changes note dưới 20 ký tự → bị từ chối đúng kỳ vọng.
• Tìm ngữ nghĩa ra trang mới nạp (chứng tỏ embedding chạy); đổi scope global/department thấy tập trang đổi theo.

Đọc tiếp: Board ↔ Wiki, Skills & MCP.

Gặp lỗi? Xem Xử lý sự cố.