🐙 Octop 倚甚户管理场景完党指南

䞀仜诊实的 Octop 倚甚户䜿甚手册涵盖管理员运绎䞎兞型场景案䟋 💡

📋 目圕

  1. 🎯 倚甚户架构抂述
  2. 👚‍💌 管理员功胜倧党
  3. 👀 普通甚户䜿甚䜓验
  4. 🏠 兞型场景案䟋
  5. 🔒 安党䞎隔犻机制
  6. ⚙ 运绎最䜳实践

1. 🎯 倚甚户架构抂述

1.1 䞺什么 Octop 芁做倚甚户

䌠统的 AI 助手比劂䜠盎接圚终端跑䞀䞪 CLI 工具是单甚户的——数据、配眮、记忆党绑圚䞀䞪系统莊号䞊。🥲

䜆现实䞖界是这样的

🏠 场景䞀家庭共甚䞀台服务噚
├── 爞爞需芁倄理工䜜邮件、写报告 📧
├── 劈劈做饭助手、莭物枅单 🍳
└── 孩子孊习蟅富、䜜䞚答疑 📚

🏢 场景二创䞚小团队
├── 创始人需芁垂场分析、竞品调研 📊
├── 工皋垈代码审查、技术方案 💻
└── 运营文案撰写、数据报衚 📈

👚‍👩‍👧 场景䞉远皋办公
├── 员工 A甚飞乊接入随时提问 🙋
├── 员工 B甚钉钉权限䞍同 🔐
└── 实习生只读权限限制访问 ⚠

Octop 的倚甚户讟计就是䞺了解决这些问题🎉

1.2 栞心架构

┌─────────────────────────────────────────────────────────────┐
│                     Octop Server                            │
│                    (单䞀进皋 🚀)                             │
├──────────────────────────────────────────────────────────────
│                                                             │
│   ┌─────────────────────────────────────────────────┐       │
│   │              UserManager (甚户管理)              │       │
│   ├──────────────────────────────────────────────────       │
│   │                                                 │       │
│   │  👀 甚户 A ──→ HarnessAgentManager ──→ Agent 1  │       │
│   │                │                    ├── Agent 2  │       │
│   │                │                    └── Agent 3  │       │
│   │  👀 甚户 B ──→ HarnessAgentManager ──→ Agent 1  │       │
│   │                                  └── Agent 2  │       │
│   │                                                 │       │
│   │  👀 甚户 C ──→ HarnessAgentManager ──→ Agent 1  │       │
│   │                                                 │       │
│   └─────────────────────────────────────────────────┘       │
│                                                             │
│   ┌─────────────────────────────────────────────────┐       │
│   │          SharedServices (共享服务)               │       │
│   │  ├── SqlitePool (统䞀数据库)                     │       │
│   │  ├── ExpertCatalog (䞓家库)                      │       │
│   │  ├── ChannelManager (IM 通道)                    │       │
│   │  └── CronManager (定时任务)                      │       │
│   └─────────────────────────────────────────────────┘       │
│                                                             │
└─────────────────────────────────────────────────────────────┘

1.3 关键讟计原则

原则诎明奜倄
🔐 数据隔犻每䞪甚户有独立的 Agent、工䜜空闎、记忆隐私有保障
👑 角色分级Admin / 普通甚户 䞀级权限管理有床
📊 统䞀存傚共享 SQLite 数据库运绎简单
🔄 䌚话独立甚户闎对话互䞍干扰䜓验流畅

2. 👚‍💌 管理员功胜倧党

2.1 初始化䞎莊号创建

銖次安装后运行初始化向富

octop init

这䞪呜什䌚

  1. 📁 创建 ~/.octop/ 数据目圕
  2. 🗄 初始化 SQLite 数据库
  3. 🔑 生成 JWT 密钥
  4. 👀 创建第䞀䞪管理员莊号默讀 admin / octop
⚠ 重芁提瀺安装后记埗立即修改默讀密码䞍芁甚匱密码

2.2 甚户管理 CLI 呜什

# 查看所有甚户
octop user list

# 创建新甚户
octop user create --username alice --password "Str0ngP@ss!"

# 删陀甚户需芁确讀
octop user delete --username alice

# 修改甚户密码
octop user password --username alice --new-password "NewP@ss123"

# 查看甚户诊情
octop user info --username alice

2.3 Web 控制台管理

圚浏览噚打匀 http://127.0.0.1:8088甚管理员莊号登圕后

┌────────────────────────────────────────────────────────┐
│  ⚙ 讟眮䞭心                                           │
├─────────────────────────────────────────────────────────
│                                                        │
│  👥 甚户管理                                           │
│  ├─ 📋 甚户列衚                                        │
│  │   ├─ 👀 admin (管理员) ✓                           │
│  │   ├─ 👀 alice (普通甚户) ✓                          │
│  │   ├─ 👀 bob (普通甚户) ✓                             │
│  │   └─ 👀 charlie (普通甚户) ⚠ 穁甹侭                │
│  │                                                     │
│  ├─ ➕ 添加甚户                                        │
│  │   ├─ 甚户名: [________]                             │
│  │   ├─ 密码:   [________]                             │
│  │   └─ 角色:   (•) 普通甚户  ( ) 管理员                │
│  │                                                     │
│  └─ 🔧 甚户操䜜                                        │
│      ├─ 猖蟑甚户                                       │
│      ├─ 重眮密码                                       │
│      ├─ 启甚/犁甚甚户                                  │
│      └─ 删陀甚户                                       │
│                                                        │
└────────────────────────────────────────────────────────┘

2.4 管理员权限枅单

䜜䞺管理员䜠可以

权限诎明CLI 呜什
👥 甚户管理创建、删陀、犁甚甚户octop user *
🀖 Agent 管理查看所有甚户的 Agent䜆䞍胜操䜜内容octop agent list --all
🔌 枠道配眮配眮 IM 枠道飞乊、钉钉等octop channel *
📅 定时任务党局 Cron 调床octop cron *
💟 数据倇仜倇仜/恢倍敎䞪系统octop backup *
⚙ 系统配眮修改系统级配眮octop config *

2.5 兞型管理操䜜瀺䟋

场景新人入职添加新甚户

# 1. 创建莊号
octop user create --username david --password "Welcome2024!"

# 2. 分配䞀䞪䞓属 Agent假讟已有 "coder" Agent
# 圚 Web 控制台甚户 david → 关联 Agent "coder"

# 3. 配眮访问枠道
# 圚 Web 控制台䞺 david 匀通钉钉访问权限

# 4. 通知甚户
echo "✅ 莊号创建完成
甚户名: david
初始密码: Welcome2024!
访问地址: http://your-server:8088
请銖次登圕后立即修改密码"

场景员工犻职回收莊号

# 1. 犁甚甚户保留数据
octop user disable --username david

# 2. 或者盎接删陀数据䞍可恢倍
octop user delete --username david --confirm

# 3. 检查该甚户的定时任务删陀盞关 Cron
octop cron list --user david
octop cron delete <cron-id>

3. 👀 普通甚户䜿甚䜓验

3.1 登圕䞎讀证

普通甚户通过以䞋方匏访问 Octop

枠道诎明配眮方匏
🌐 Web 控制台浏览噚访问蟓入甚户名密码默讀启甚
💬 即时通讯飞乊、钉钉、QQ、Discord、䌁䞚埮信管理员配眮
⌚ CLI呜什行登圕octop chat --user alice
🔐 讀证流皋

甚户蟓入凭证
    ↓
JWT Token 生成包含甚户身仜和权限
    ↓
Token 有效期验证
    ↓
授权访问对应资源

3.2 甚户䞓属工䜜区

每䞪甚户郜有独立的工䜜空闎

~/.octop/
├── agents/                          # Agent 配眮
│   ├── <user_alice>/               # Alice 的 Agent
│   │   ├── SOUL.md                 # Agent 性栌讟定
│   │   ├── AGENTS.md               # Agent 行䞺规则
│   │   ├── USER.md                 # 甚户画像
│   │   ├── skills/                 # 技胜配眮
│   │   └── memory/                 # 长期记忆
│   └── <user_bob>/                 # Bob 的 Agent
│       └── ...
│
├── memory/                          # 甚户记忆库
│   ├── <user_alice>/
│   │   ├── atoms/                  # 原子记忆
│   │   ├── pages/                  # 知识页面
│   │   └── raw/                    # 原始对话
│   └── <user_bob>/
│       └── ...
│
└── workspaces/                     # 工䜜目圕
    ├── <user_alice>/
    └── <user_bob>/

3.3 倚 Agent 切换

普通甚户可以创建倚䞪 Agent按场景切换

🎭 我的 Agent 团队

┌─────────────────────────────────────────────────────────┐
│  💌 工䜜助手 (默讀)                                      │
│  ├─ 䞓长邮件倄理、报告撰写、PPT 生成                      │
│  ├─ 语气䞓䞚、简掁                                     │
│  └─ 记䜏我的项目进展、团队成员                           │
├──────────────────────────────────────────────────────────
│  🍳 矎食助手                                             │
│  ├─ 䞓长菜谱掚荐、食材搭配、烹饪技巧                      │
│  ├─ 语气亲切、热情                                     │
│  └─ 记䜏我家人口味、过敏食材                            │
├──────────────────────────────────────────────────────────
│  📚 孊习富垈                                             │
│  ├─ 䞓长知识点讲解、习题蟅富                            │
│  ├─ 语气耐心、有趣                                     │
│  └─ 记䜏孩子的幎级、孊习进床                            │
└─────────────────────────────────────────────────────────┘

💬 切换呜什
"切换到矎食助手" 或 /agent cook

3.4 记忆持久化

Octop 的记忆系统让 AI 胜记䜏䜠的偏奜

🧠 Alice 的记忆库

📌 原子记忆 (atom)
├── "alice 的邮箱是 alice@company.com" ⏰ 2024-01-15
├── "alice 喜欢川菜䞍吃蟣" ⏰ 2024-01-20
└── "alice 莟莣后端匀发" ⏰ 2024-02-01

📄 知识页面 (page)
├── alice_profile.md - 䞪人信息汇总
├── project_roadmap.md - 圓前项目进展
└── team_members.md - 团队成员资料

💬 对话记忆 (raw)
├── 2024/01/15/ - 关于 API 讟计的讚论
├── 2024/01/20/ - 晚逐地点掚荐
└── 2024/02/01/ - Sprint 计划䌚议

4. 🏠 兞型场景案䟋

4.1 场景䞀家庭智胜助手 👚‍👩‍👧

背景

  • 䞀台 NAS 服务噚运行 Octop
  • 家庭成员爞爞、劈劈、孩子
  • 共甚䞀䞪飞乊矀聊入口

郚眲架构

┌─────────────────────────────────────────────────────────┐
│                    Octop Server                         │
│                   (家庭 NAS 侊)                          │
├──────────────────────────────────────────────────────────
│                                                         │
│  👚 爞爞                                                │
│  ├─ Agent: 工䜜助手 (INTJ - 战略家)                      │
│  ├─ 胜力邮件倄理、PPT 撰写、垂场分析                    │
│  └─ 枠道飞乊 (工䜜矀)                                 │
│                                                         │
│  👩 劈劈                                                │
│  ├─ Agent: 生掻管家 (ESFJ - 䞻人)                       │
│  ├─ 胜力菜谱掚荐、莭物枅单、日皋提醒                    │
│  └─ 枠道飞乊 (家庭矀) + Web                            │
│                                                         │
│  👊 孩子                                                │
│  ├─ Agent: 孊习富垈 (ENFP - 远梊人)                      │
│  ├─ 胜力䜜䞚答疑、知识讲解、孊习计划                    │
│  └─ 枠道飞乊 (家庭矀) - 限制只胜孊习盞关              │
│                                                         │
│  🀖 共享䞓家库                                          │
│  ├─ 倩气查询                                            │
│  ├─ 闹钟讟眮                                            │
│  └─ 玧急联系人                                          │
│                                                         │
└─────────────────────────────────────────────────────────┘

䜿甚瀺䟋

📱 飞乊矀聊

👚 爞爞@Octop 垮我写封邮件给匠总确讀明倩的䌚议时闎
    ↓
🀖 [爞爞的工䜜助手] 回倍
    "已䞺悚起草邮件
    䞻题关于明日䌚议时闎确讀
    匠总悚奜...
    [发送] [修改] [取消]"

👩 劈劈@Octop 今晚吃什么奜家里有番茄、鞡蛋、土豆
    ↓
🀖 [劈劈的生掻管家] 回倍
    "掚荐菜品
    🍅 番茄炒蛋 - 简单家垞10分钟搞定
    🥔 酞蟣土豆䞝 - 匀胃䞋饭
    🍳 番茄土豆炖牛肉 - 需芁去超垂买牛肉
    请问需芁哪䞪菜谱"

👊 孩子@Octop 这道数孊题怎么做...
    ↓
🀖 [孩子的孊习富垈] 回倍
    "这道题考查的是XX知识点...
    让我䞀步步教䜠
    第䞀步..."

管理员配眮

# 创建家庭成员莊号
octop user create --username dad --password "fam1ly2024!"
octop user create --username mom --password "fam1ly2024!"
octop user create --username kid --password "fam1ly2024!"

# 飞乊枠道配眮矀机噚人
octop channel install feishu --group-id "family_group"

# 讟眮孩子莊号的䜿甚限制通过 Tool Guard
echo "deny: kid -> web_browse: *gaming*"
echo "deny: kid -> tool: external_api: personal_social"

4.2 场景二创䞚小团队 🚀

背景

  • 5人创䞚团队
  • 技术栈Python + React
  • 需芁 AI 蟅助研发、垂场、运营

团队架构

🏢 创䞚团队 AI 配眮

👑 管理员 (CEO)
├─ 权限党郚
├─ Agent战略顟问 (ENTJ)
└─ 职莣党局管理、决策支持

💻 技术组
├─ Lead1人后端架构 (INTJ)
├─ Dev1人党栈匀发 (INTP)
└─ Agent 共享代码审查、技术调研

📊 垂场组
├─ Marketer2人内容运营 (ENFP)
└─ Agent 共享文案生成、竞品分析

📈 运营组
├─ Ops1人数据分析 (ESTJ)
└─ Agent 共享报衚生成、数据掞察

Agent 分工

Agent性栌莟莣领域权限
CodeMasterINTP - 逻蟑倧垈代码审查、技术方案读写代码库
ContentBotENFP - 创意蟟人文案撰写、瀟亀媒䜓发垃草皿
DataSageESTJ - 执行者数据分析、报衚只读数据库
ResearcherINTJ - 策划者垂场调研、竞品分析访问行䞚数据

团队协䜜瀺䟋

💬 #dev-channel

匀发者@CodeMaster 垮我 review 这段代码
        [代码片段...]
        ↓
🀖 CodeMaster 回倍
        "发现 3 䞪问题
        1. ⚠ 内存泄挏第 45 行未释攟资源
        2. 🔎 安党风险甚户蟓入未做 SQL 过滀
        3. 💡 䌘化建议可䜿甚猓存减少 API 调甚
        
        [查看完敎建议]"

---

💬 #marketing-channel

运营@ContentBot 写䞀条产品发垃的埮博
      产品智胜埅办 App
      亮点AI 分类、跚平台同步
      
      ↓
🀖 ContentBot 回倍
      "🔥【新品发垃】智胜埅办 App 䞊线
      
      📱 AI 智胜分类任务管理从未劂歀蜻束
      🔄 跚平台实时同步手机电脑无猝衔接
      🎯 拖拜即排䌘先级䞀目了然
      
      👉 立即䜓验xxx.com
      #效率工具 #智胜埅办 #产品发垃
      
      [发垃到埮博] [修改文案] [生成曎倚版本]"

安党配眮

// config.json - 团队权限配眮
{
  "security": {
    "code_master": {
      "allowed_tools": ["read_codebase", "write_codebase", "terminal"],
      "denied_paths": ["/production/secrets", "/production/db"]
    },
    "content_bot": {
      "allowed_tools": ["draft_content", "preview"],
      "denied_tools": ["terminal", "database"]
    },
    "data_sage": {
      "allowed_tools": ["read_database", "generate_report"],
      "denied_tools": ["write_database", "terminal"]
    }
  }
}

4.3 场景䞉远皋办公团队 🏡

背景

  • 混合办公团队
  • 成员分垃圚北京、䞊海、深圳
  • 䜿甚钉钉䜜䞺䞻芁沟通工具

枠道配眮

🌏 远皋办公团队 - 接入枠道

📍 北京办公宀
├─ 员工研发 3人、讟计 2人
├─ 枠道钉钉 (工䜜暡匏)
└─ 特殊内眑 VPN 访问限制

📍 䞊海办公宀
├─ 员工运营 2人、垂场 1人
├─ 枠道钉钉 + Web
└─ 特殊工䜜时闎 UTC+8 9:00-18:00

📍 深圳办公宀
├─ 员工产品 1人、研发 2人
├─ 枠道钉钉
└─ 特殊需芁访问銙枯服务噚

🏠 居家办公
├─ 员工党䜓蜮流
├─ 枠道钉钉 (移劚端䌘先)
└─ 特殊无特殊限制

---

🔐 权限矩阵

        | 栞心代码 | 客户数据 | 莢务报衚 | 运营后台
--------|---------|---------|---------|---------
CEO     |   ✅     |   ✅    |   ✅    |   ✅
研发    |   ✅     |   ❌    |   ❌    |   ❌
讟计    |   ⚡     |   ❌    |   ❌    |   ⚡
运营    |   ❌     |   ⚡    |   ❌    |   ✅
垂场    |   ❌     |   ⚡    |   ❌    |   ⚡
产品    |   ⚡     |   ✅    |   ❌    |   ⚡

✅ = 完党访问   ⚡ = 受限访问   ❌ = 无访问

钉钉配眮瀺䟋

# 1. 创建钉钉机噚人
#    钉钉矀 → 矀讟眮 → 智胜矀助手 → 添加机噚人
#    选择「自定义」机噚人记圕 App Key 和 App Secret

# 2. 安装钉钉枠道
octop channel install dingtalk

# 3. 配眮钉钉参数
export DINGTALK_APP_KEY="ding_xxx"
export DINGTALK_APP_SECRET="xxx"

# 4. 䞺䞍同郚闚配眮䞍同 Bot
octop channel configure --channel dingtalk \
    --bot-name "研发助手" \
    --allowed-users "dev-team" \
    --default-agent "code-master"

octop channel configure --channel dingtalk \
    --bot-name "运营助手" \
    --allowed-users "ops-team" \
    --default-agent "ops-helper"

# 5. 启劚服务
octop run

4.4 场景四教育培训机构 📚

背景

  • 培训机构语数英䞉科
  • 教垈6人
  • 孊生纊100人

应甚场景

🎓 培训机构 AI 应甚

📋 教垈端
├── AI 倇诟助手生成教案、诟件
├── 䜜䞚批改蟅助快速检查对错
├── 家校沟通自劚生成反銈
└── 孊生管理孊情分析

📖 孊生端
├── 智胜答疑24小时䜜䞚助手
├── 错题本自劚園纳敎理
├── 孊习计划䞪性化掚荐
└── 家长端进床通知

---

🔧 具䜓配眮

👚‍🏫 教垈莊号6䞪
├─ 角色teacher
├─ Agent科目䞓家语文/æ•°å­Š/英语
├─ 权限管理自己班级的孊生数据
└─ 枠道飞乊工䜜甚

👊 孊生莊号100䞪
├─ 角色student
├─ Agent孊习䌙䌎
├─ 权限只读自己的孊习内容
└── 枠道埮信小皋序家长扫码绑定

👚‍👩‍👧 家长莊号~100䞪
├─ 角色parent
├─ Agent家庭教育助手
├─ 权限查看孩子孊习报告
└── 枠道埮信小皋序

䜿甚瀺䟋

👚‍🏫 英语李老垈
@Octop 垮我生成䞀仜初䞀英语Unit5的教案
      诟时2诟时
      重点现圚进行时
      
      ↓
🀖 回倍
      📚 初䞀英语 Unit5 教案
      
      【第䞀诟时】...
      【第二诟时】...
      [䞋蜜 Word] [富出 PPT] [调敎隟床]

---

👊 孊生小明数孊
@Octop 这道题䞍䌚
      已知凜数 f(x) = x² + 2x + 1
      求 f'(x)
      
      ↓
🀖 回倍
      📐 步骀解析
      
      1⃣ 识别这是䞀道求富数的基础题
      2⃣ 回忆公匏(xⁿ)' = n·xⁿ⁻¹
      3⃣ 逐步计算
         f(x) = x² + 2x + 1
         f'(x) = 2x + 2
      4⃣ 验证代入 x=1, f(1)=4, f'(1)=4 ✓
      
      💡 同类题掚荐...

---

👚‍👩‍👧 小明爞爞埮信小皋序
查看孩子的本呚孊习报告
      
      ↓
🀖 回倍
      📊 小明本呚孊习报告
      
      📈 进床数孊已完成第5ç«  80%
      📝 错题3道已加入错题本
      ⏰ 孊习时长8.5小时
      ⭐ 衚扬英语单词听写进步明星
      
      [查看诊情] [联系老垈]

5. 🔒 安党䞎隔犻机制

5.1 JWT 倚甚户隔犻

Octop 䜿甚 JWTJSON Web Token实现甚户讀证和隔犻

🔐 JWT 讀证流皋

1⃣ 甚户登圕
   POST /api/auth/login
   {
     "username": "alice",
     "password": "xxx"
   }
   
2⃣ 服务噚验证返回 Token
   {
     "access_token": "eyJhbGc...",
     "token_type": "bearer"
   }

3⃣ 后续请求携垊 Token
   GET /api/agents
   Headers: Authorization: Bearer eyJhbGc...

4⃣ 䞭闎件验证 Token解码甚户身仜
   {
     "sub": "alice",
     "role": "user",
     "exp": 1234567890
   }

5⃣ 数据访问控制
   只返回 alice 自己的数据

5.2 数据隔犻策略

层级隔犻内容实现方匏
🔐 甚户数据Agent、记忆、工䜜空闎数据库行级隔犻 + JWT 验证
📁 文件存傚䞊䌠文件、附件甚户目圕隔犻
💬 䌚话历史对话记圕甚户绎床分衚
⏰ 定时任务Cron 任务甚户绑定 + 执行䞊䞋文隔犻
🔌 枠道绑定IM 枠道权限甚户-枠道映射衚

5.3 Tool Guard工具技栏

Tool Guard 允讞管理员粟细控制每䞪甚户/Agent 胜䜿甚的工具

🛡 Tool Guard 配眮瀺䟋

~/.octop/security/tool_guard/
├── default.rules          # 默讀规则所有甚户
├── admin.rules            # 管理员规则
├── intern.rules           # 实习生规则
└── student.rules          # 孊生规则

规则文件瀺䟋

# intern.rules - 实习生权限
version: "1.0"

allow:
  # 可以䜿甚搜玢和文档工具
  - tool: web_search
  - tool: read_file
  - tool: read_docs
  
  # 可以运行测试
  - tool: run_tests
  
  # 可以读取代碌
  - path: /workspace/projects/**
    action: read

deny:
  # 犁止访问生产环境
  - tool: terminal
    path: /production/**
    
  # 犁止敏感操䜜
  - tool: database
    operation: [delete, drop, truncate]
    
  # 犁止倖郚 API 调甚
  - tool: external_api
    except: [github, jira]

confirm:
  # 高危操䜜需芁确讀
  - tool: delete_file
  - tool: terminal
    command: "rm*|delete*|drop*"

5.4 PII 脱敏

Octop 内眮䞪人信息识别和脱敏功胜

🔍 PII 检测䞎倄理

蟓入给我查䞀䞋匠䞉的身仜证号 110101199001011234
              ↓
         PII 检测噚识别
              ↓
脱敏倄理身仜证号被标记䞺 [PII_REDACTED]
              ↓
蟓出给我查䞀䞋匠䞉的身仜证号 [PII_REDACTED]
              ↓
    日志记圕管理员可见检测到 PII原始数据未进入 AI 倄理流皋

支持的 PII 类型

类型检测暡匏倄理方匏
🔢 手机号1[3-9]\d{9}脱敏䞺 138****5678
🆔 身仜证\d{17}[\dXx]脱敏䞺 110101********1234
📧 邮箱xxx@xxx.xxx脱敏䞺 a***@example.com
💳 银行卡\d{16,19}脱敏䞺 **** **** **** 1234

6. ⚙ 运绎最䜳实践

6.1 郚眲架构建议

🏗 掚荐生产架构

                    ┌─────────────────┐
                    │   莟蜜均衡噚    │
                    │   (Nginx/LB)   │
                    └────────┬────────┘
                             │
           ┌─────────────────┌─────────────────┐
           │                 │                 │
    ┌──────▌──────┐  ┌──────▌──────┐  ┌──────▌──────┐
    │   Octop 1   │  │   Octop 2   │  │   Octop 3   │
    │  (Web+API)  │  │  (Web+API)  │  │  (Web+API)  │
    └──────┬──────┘  └──────┬──────┘  └──────┬──────┘
           │                 │                 │
           └─────────────────┌─────────────────┘
                             │
                    ┌────────▌────────┐
                    │    SQLite       │
                    │  (共享数据库)    │
                    │  或 PostgreSQL   │
                    └─────────────────┘
📝 泚意Octop 默讀䜿甚 SQLite适合䞭小规暡<50 甚户。倧规暡郚眲建议䜿甚 PostgreSQL。

6.2 甚户管理 SOP

📋 甚户生呜呚期管理 SOP

1⃣ 入职流皋Onboarding
   ├── 创建莊号
   │   octop user create --username <name> --password <temp>
   ├── 分配 Agent
   │   octop agent assign --user <name> --agent <role>
   ├── 配眮枠道权限
   │   octop channel grant --user <name> --channel <ch>
   └── 发送欢迎通知
       "悚的莊号已创建请访问 xxx 登圕"

2⃣ 日垞䜿甚
   ├── 定期检查掻跃甚户
   │   octop user list --sort last_active
   ├── 查看䜿甚统计
   │   octop stats --period 30d
   └── 倇仜数据
       octop backup create --description "weekly"

3⃣ 犻职/调岗流皋Offboarding
   ├── 犁甚莊号保留数据
   │   octop user disable --username <name>
   ├── 蜬移数据劂需芁
   │   octop data transfer --from <old> --to <new>
   ├── 枅理定时任务
   │   octop cron delete --user <name>
   └── 泚销莊号数据删陀
       octop user delete --username <name> --confirm

6.3 倇仜䞎恢倍

# 创建倇仜
octop backup create --description "before-upgrade"

# 列出倇仜
octop backup list

# 恢倍倇仜
octop backup restore --backup-id <id>

# 定时自劚倇仜Cron
octop cron create \
    --name "daily-backup" \
    --schedule "0 2 * * *" \
    --command "backup create --description auto-daily"

6.4 监控䞎日志

# 查看实时日志
octop logs --follow

# 查看甚户掻劚日志
octop logs --user alice --level INFO

# 查看错误日志
octop logs --level ERROR --since "1 hour ago"

# 系统状态
octop status

# 蟓出瀺䟋
# ╔══════════════════════════════════════╗
# ║        Octop System Status           ║
# ╠══════════════════════════════════════╣
# ║  Status:       ✅ Running            ║
# ║  Uptime:       3d 14h 22m           ║
# ║  Users:        12 (3 online)        ║
# ║  Agents:       24 active            ║
# ║  CPU:          12%                   ║
# ║  Memory:       2.4 GB / 8 GB         ║
# ║  Disk:         45 GB / 100 GB        ║
# ╚══════════════════════════════════════╝

6.5 性胜䌘化

# 1. 数据库绎技
octop db vacuum     # 枅理 SQLite 碎片
octop db analyze    # 曎新统计信息

# 2. 内存䌘化
# config.json
{
  "performance": {
    "max_concurrent_agents": 10,
    "agent_timeout_seconds": 300,
    "memory_cache_size_mb": 512
  }
}

# 3. 限制并发甚户
octop run --max-users 50

# 4. 枅理过期数据
octop clean --older-than 90d --include-sessions

📚 附圕

A. 垞甚呜什速查衚

操䜜呜什
安装`curl -fsSL .../install.sh \bash`
初始化octop init
启劚服务octop run
创建甚户octop user create --username <name> --password <pwd>
查看甚户octop user list
删陀甚户octop user delete --username <name> --confirm
创建 Agentoctop agent create --name <name> --user <user>
配眮枠道octop channel install <feishu/dingtalk/...>
创建倇仜octop backup create --description "..."
查看日志octop logs --follow
系统状态octop status

B. 枠道配眮参考

枠道配眮项文档
飞乊App ID, App Secretdocs/channels-feishu.md
钉钉App Key, App Secretdocs/channels-dingtalk.md
QQBot AppID, Tokendocs/channels-qq.md
DiscordBot Tokendocs/channels-discord.md
䌁䞚埮信Corp ID, Agent Secretdocs/channels-wecom.md

C. 故障排查

问题排查呜什解决方案
甚户无法登圕octop logs --user <name>检查密码、JWT 配眮
枠道无响应octop channel status检查 Token、眑络
AI 无回倍octop logs --level ERROR检查 API Key、额床
性胜卡顿octop status增加资源、枅理猓存

🎉 结语

Octop 的倚甚户管理功胜让它䞍仅仅是䞀䞪 AI 助手曎是䞀䞪团队智胜䞭枢 🧠

无论是家庭䜿甚、小团队协䜜还是䌁䞚郚眲Octop 郜胜提䟛

  • ✅ 匀箱即甚的倚甚户支持
  • ✅ 灵掻的权限管理䜓系
  • ✅ 䞰富的枠道接入胜力
  • ✅ 可靠的数据隔犻机制
  • ✅ 简掁的运绎管理䜓验
🚀 快去试试吧 䞀行呜什即可安装curl -fsSL https://.../install.sh | bash

📅 文档曎新于2024幎
🐙 基于 Octop v0.9.x 版本猖写