核心用法
discord-context 是专为 Discord Forum 频道设计的线程上下文管理工具，通过命令行接口实现三大功能：
1. `poll` — 轮询并缓存活跃线程
- 从指定 Discord 服务器(Guild)的论坛频道拉取活跃话题
- 自动将线程元数据与上下文文本持久化到本地缓存
- 支持通过
--guild/--forum参数或环境变量指定目标
2. `context` — 查看缓存的线程信息
- 无参数时列出所有已缓存的线程 ID
- 指定
threadId时输出该线程的完整上下文与元数据 --json标志支持结构化数据输出，便于脚本集成
3. `link` — 建立线程与记忆文件的关联
- 将 Discord 线程与
memory/目录下的 QMD 文件绑定 - 自动刷新缓存中的上下文文本，实现外部知识库同步
显著优点
- 离线可用：缓存机制允许在无网络环境下查阅历史线程上下文
- 灵活配置：同时支持命令行参数与环境变量，适配 CI/CD 与本地开发
- 安全设计：强制数字 ID 校验、限制文件路径在
memory/目录内，防止路径遍历 - 生态集成：原生支持 OpenClaw 工作流，与记忆系统无缝对接
潜在缺点与局限性
- Token 依赖：所有 Discord API 操作需长期有效的 Bot Token，存在凭证管理负担
- 实时性瓶颈：
poll为手动触发机制，非 WebSocket 实时推送，可能遗漏高频更新 - 存储开销：长期运行的论坛频道会产生大量缓存文件，需定期清理策略
- 单线程限制：
poll未实现增量/差异更新，每次全量拉取存在 API 配额消耗风险
适合人群
- 使用 Discord Forum 作为知识管理或客户支持平台的团队
- 需要将 Discord 对话上下文注入 LLM 工作流（RAG/记忆增强）的开发者
- 运营社区管理员，需离线归档与检索历史讨论内容
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | `DISCORD_TOKEN` 若泄露可导致 Bot 被恶意控制 | 使用专用 Bot 账户、最小权限原则、密钥管理服务 |
| 数据残留 | 缓存文件可能包含敏感对话内容 | 加密工作目录、设置自动过期策略 |
| 注入攻击 | `qmdName` 严格限制字符集，但未完全消除 `..` 等风险（需依赖 `baseDir` 校验） | 审查 `baseDir` 来源可信度 |
| API 限流 | Discord 全局速率限制可能影响大规模轮询 | 实现指数退避、分片拉取 |