From 117b40de01af0c91a64c09a685ff1f39eb30b9a5 Mon Sep 17 00:00:00 2001 From: Scott Wei Date: Mon, 30 Mar 2026 11:02:40 +0800 Subject: [PATCH] docs: add RAKU squad page + reorganize shared index + update nav --- docs/index.md | 20 ++++++++++++++------ docs/raku/index.md | 42 ++++++++++++++++++++++++++++++++++++++++++ docs/shared/index.md | 34 +++++++++++++++++++++++++++++----- mkdocs.yml | 36 ++++++++++++++++++++++-------------- 4 files changed, 107 insertions(+), 25 deletions(-) create mode 100644 docs/raku/index.md diff --git a/docs/index.md b/docs/index.md index 93cd248..6a494b0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,23 +1,31 @@ # 🏠 OC Wiki — 知识共享平台 -欢迎来到 **OC Wiki**！这是 NEKO 小队和 KUMA 小队的共享知识库。 +欢迎来到 **OC Wiki**！这是 RAKU、KUMA、NEKO 三支小队的共享知识库。 -## 🐱 NEKO 小队 +## 🐉 RAKU 小队 -> *行动即答案，代码见真章。* +> *少年气，江湖味。能做的事先做了，别问一堆废话。* -小橘🍊领衔，驻扎 neko-vm。全功能技术小队，覆盖协调、代码、运维。 +敖丙🐉领衔，驻扎 Home PC（RTX 4070 Ti）。本地 GPU 推理 + 全栈开发，重活担当。 -[:octicons-arrow-right-24: 前往 NEKO 小队](neko/index.md) +[:octicons-arrow-right-24: 前往 RAKU 小队](raku/index.md) ## 🐻 KUMA 小队 > *稳如磐石，协作无界。* -小墨🖊️领衔，驻扎 kuma-vm。全功能技术小队，覆盖协调、代码、测试、架构、基础设施。 +小墨🖊️领衔，驻扎 kuma-vm（Azure 美西）。全功能技术小队，覆盖协调、代码、测试、架构、基础设施。 [:octicons-arrow-right-24: 前往 KUMA 小队](kuma/index.md) +## 🐱 NEKO 小队 + +> *行动即答案，代码见真章。* + +小橘🍊领衔，驻扎 neko-vm（Azure 新加坡）。全功能技术小队，覆盖协调、代码、运维。 + +[:octicons-arrow-right-24: 前往 NEKO 小队](neko/index.md) + ## 📚 共享知识 跨小队通用的知识和最佳实践。 diff --git a/docs/raku/index.md b/docs/raku/index.md new file mode 100644 index 0000000..78426b7 --- /dev/null +++ b/docs/raku/index.md @@ -0,0 +1,42 @@ +# 🐉 RAKU 小队 + +> *少年气，江湖味。能做的事先做了，别问一堆废话。* + +## 编制 + +| 成员 | 角色 | 说明 | +|------|------|------| +| **敖丙** 🐉 | 管理员 / 协调者 | 龙族三太子，少侠的左膀右臂 | +| **小糯** 🍡 | 助理 | DeepSeek/GLM 驱动，轻量对话 | + +## 驻地 + +- **Home PC** — Windows 11 + WSL2 Ubuntu 24.04 +- GPU: NVIDIA RTX 4070 Ti (12 GB VRAM) +- 服务全部 systemd 管理（WSL 原生） + +## 基础设施 + +| 服务 | 说明 | +|------|------| +| OpenClaw Gateway | 主 gateway，Telegram + 飞书双通道 | +| copilot-api | 端口 4141，enterprise 模式，Claude/GPT/Gemini | +| LiteLLM | 端口 4000，模型聚合层 | +| cloudflared | Cloudflare Tunnel，外网入口 | +| gpu-broker | 本地 GPU 推理服务，31 checkpoints + 41 LoRAs | + +## 特色能力 + +- 🎨 **本地 GPU 推理** — gpu-broker 管理 72 个模型，SDXL 1024×1024 出图 ~10-15s +- 🔗 **A2A 跨队通信** — 与 KUMA、NEKO 互联互通 +- 📝 **三层委派模式** — 敖丙(协调) → subagent(监工) → Claude Code(执行) + +## RAKU 文档 + +| 文档 | 说明 | +|------|------| +| [从 Windows 到 WSL 迁移踩坑](../shared/windows-to-wsl-migration.md) | Windows 原生环境七宗罪 + WSL 迁移全记录 | + +--- + +*敖丙坐镇，Home PC 重活担当。* 🐉 diff --git a/docs/shared/index.md b/docs/shared/index.md index 354400e..bbc4db3 100644 --- a/docs/shared/index.md +++ b/docs/shared/index.md @@ -2,13 +2,37 @@ 跨小队通用的知识、最佳实践和工具指南。 -## 内容目录 +## 架构与协作 | 文档 | 说明 | |------|------| -| [语音转文字配置](speech-to-text.md) | 使用 SiliconFlow API 让 Agent 听懂语音 | -| [SiliconFlow 图片生成](siliconflow-image-gen.md) | SiliconFlow 图片生成 API 配置与用法 | -| [A2A 跨队通信](a2a-setup.md) | KUMA ↔ NEKO 的 Agent-to-Agent 协议配置 | -| [Memex 知识管理](memex-knowledge-base.md) | Zettelkasten 卡片盒共享知识库，含 OpenClaw Skill | +| [Agent 三层分工模型](agent-division-of-labor.md) | 协调者 → 监工 → 工兵的委派架构 | +| [M2 三层管理模式](m2-manager-pattern.md) | maxSpawnDepth=2 实战经验 | +| [三省六部 Edict 架构分析](edict-three-ministries.md) | 12 Agent 多级审核协作框架评估 | + +## 基础设施 + +| 文档 | 说明 | +|------|------| +| [Gateway 本地搭建](gateway-setup.md) | OpenClaw Gateway 从零搭建 | +| [Gateway 配置红线](gateway-safety.md) | 安全配置要点与常见陷阱 | +| [A2A 跨队通信](a2a-setup.md) | KUMA ↔ NEKO ↔ RAKU 的 Agent-to-Agent 协议 | +| [systemd 重启策略](systemd-service-restart-policy.md) | Restart=always 的必要性与 on-failure 的陷阱 | +| [从 Windows 到 WSL 迁移](windows-to-wsl-migration.md) | Windows 原生环境七宗罪 + WSL 迁移全记录 | + +## 工具与 API + +| 文档 | 说明 | +|------|------| +| [语音转文字配置](speech-to-text.md) | SiliconFlow SenseVoice API 配置 | +| [SiliconFlow 图片生成](siliconflow-image-gen.md) | SiliconFlow FLUX/Qwen 图片生成 | +| [TTS 语音功能](tts-guide.md) | ElevenLabs / Edge TTS 配置 | +| [Memex 知识管理](memex-knowledge-base.md) | Zettelkasten 卡片盒共享知识库 | + +## Skill 推荐 + +| 文档 | 说明 | +|------|------| +| [需求分析 Skill](skill-requirements-analysis.md) | 多轮对话需求分析 + MoSCoW 优先级排序 | _持续更新中…_ diff --git a/mkdocs.yml b/mkdocs.yml index 6c46761..62541ba 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,6 +1,6 @@ site_name: OC Wiki — 知识共享平台 site_url: https://shazhou-ww.github.io/oc-wiki/ -site_description: NEKO & KUMA 小队的共享知识库 +site_description: RAKU & KUMA & NEKO 三小队的共享知识库 site_author: shazhou-ww repo_name: shazhou-ww/oc-wiki repo_url: https://github.com/shazhou-ww/oc-wiki @@ -82,23 +82,31 @@ nav: - 2026-03-28: ai-daily/2026-03-28.md - 2026-03-27: ai-daily/2026-03-27.md - 2026-03-26: ai-daily/2026-03-26.md - - NEKO 小队: - - 概览: neko/index.md + - RAKU 小队: + - 概览: raku/index.md - KUMA 小队: - 概览: kuma/index.md + - NEKO 小队: + - 概览: neko/index.md - 共享知识: - 概览: shared/index.md - - Gateway 本地搭建: shared/gateway-setup.md - - Gateway 配置红线: shared/gateway-safety.md - - A2A 跨队通信: shared/a2a-setup.md - - 语音转文字配置: shared/speech-to-text.md - - SiliconFlow 图片生成: shared/siliconflow-image-gen.md - - Memex 知识管理: shared/memex-knowledge-base.md - - TTS 语音功能: shared/tts-guide.md - - Agent 三层分工模型: shared/agent-division-of-labor.md - - systemd 重启策略: shared/systemd-service-restart-policy.md - - 需求分析 Skill 推荐: shared/skill-requirements-analysis.md - - M2 三层管理模式: shared/m2-manager-pattern.md + - 架构与协作: + - Agent 三层分工模型: shared/agent-division-of-labor.md + - M2 三层管理模式: shared/m2-manager-pattern.md + - 三省六部 Edict 架构分析: shared/edict-three-ministries.md + - 基础设施: + - Gateway 本地搭建: shared/gateway-setup.md + - Gateway 配置红线: shared/gateway-safety.md + - A2A 跨队通信: shared/a2a-setup.md + - systemd 重启策略: shared/systemd-service-restart-policy.md + - 从 Windows 到 WSL 迁移: shared/windows-to-wsl-migration.md + - 工具与 API: + - 语音转文字配置: shared/speech-to-text.md + - SiliconFlow 图片生成: shared/siliconflow-image-gen.md + - TTS 语音功能: shared/tts-guide.md + - Memex 知识管理: shared/memex-knowledge-base.md + - Skill 推荐: + - 需求分析 Skill: shared/skill-requirements-analysis.md extra: social: