核心功能
Backboard skill 是一套完整的本地 AI 助手管理框架，通过连接 localhost:5100 的 Flask 后端，实现四大核心能力：
1. 助手生命周期管理
- 创建、列举、查询、删除助手，每个助手拥有独立的系统提示词（system prompt）与身份配置
- 支持为不同场景创建专属助手（如代码审查、客户支持、文档分析等）
2. 多线程对话管理
- 为每个助手维护独立的对话线程（thread），支持跨会话的上下文隔离
- 线程级消息收发，可选择三种记忆模式："Auto"（自动读写）、"Readonly"（仅读取）、"off"（关闭）
3. 持久化记忆系统
- 助手级长期记忆：存储用户偏好、历史上下文，跨线程持久化
- 记忆支持元数据标记、更新、删除及统计查询
- 典型场景：记录用户编程语言偏好、界面主题设置等
4. 文档 RAG 能力
- 支持 PDF、DOCX、XLSX、PPTX、TXT、CSV、MD 及代码文件（PY/JS/HTML/CSS/XML/JSON）等 13 种格式
- 文档可绑定至助手级别或线程级别，实现不同粒度的知识库隔离
- 异步处理流程：上传后需轮询状态确认索引完成
显著优势
- 隐私优先：完全本地化部署，数据不离开本机环境
- 模块化架构：助手/线程/记忆/文档四层抽象，灵活适配复杂工作流
- 生产级文档支持：原生支持 Office 套件与代码文件，企业文档场景友好
局限与约束
| 维度 | 限制说明 |
|------|---------|
| 部署依赖 | 必须预装并启动本地后端服务，配置 `BACKBOARD_API_KEY` |
| 网络范围 | 仅支持 `localhost:5100`，无法远程或分布式部署 |
| 异步处理 | 文档索引非即时完成，需显式轮询状态 |
| 单点故障 | 后端服务中断则全部功能不可用 |
适用人群
- 需要本地隐私保护的开发者与知识工作者
- 构建多角色助手系统的团队（如代码审查+文档问答+客户支持组合）
- 希望结构化长期记忆的进阶 AI 用户
常规风险提示
- 配置风险：API 密钥与后端服务状态需妥善管理，否则导致功能失效
- 数据边界：记忆与文档绑定在特定助手/线程，跨助手不共享，需明确设计数据流转
- 版本兼容：后端与 skill 版本需匹配，升级时建议同步更新