goodbuddy/FEATURES.md

GoodBuddy 功能矩阵与路线图

本文记录 GoodBuddy 的已提供能力和路线图。未完成项目不代表已包含在当前版本中。

状态说明

• 已提供
• 开发中或规划中，具体以条目标注为准

功能总表

桌面基础、工作空间与上下文

• 跨平台桌面应用：支持 Windows、macOS、Linux，以及 x64、arm64 发布目标。
• Projects 与独立对话：按项目隔离上下文，管理会话、附件和 Git 工作区变更。
• 文件、截图、窗口、剪贴板上下文：用户明确选择后才加入模型上下文。
• 富文本回答：支持 GitHub Flavored Markdown、LaTeX 数学公式和受控 Mermaid 图表；大图可缩放、拖动或查看源码，失败时保留原始图表代码。
• 项目 Agent Space（规划中）：在 Project 中统一角色、知识、Skills/MCP、模型、审批策略、预算和超时，并支持模板复用。

Agent Runtime 与模型连接

• 直连模型 Runtime：支持问答、知识总结、受控工具执行和图像生成。
• OpenCode 与 Continue：使用隔离子进程、环境变量白名单、统一配置、取消、超时和活动记录。
• Ask 与 Execute 工作模式：Ask 保持只读；Execute 运行已启用且受边界约束的工具。
• 专家与 Subagent：支持显式专家、团队分析和最多三个只读专家并行分析。
• 角色绑定模型连接：每个角色可继承默认模型或选择独立文本模型连接，失效连接安全回退默认模型，综合角色始终继承默认模型。
• 多协议模型配置：支持 Anthropic Messages、OpenAI Chat Completions、OpenAI Images 和无认证本机模型。
• Main-only 凭据保护：API Key 使用系统安全存储加密，不暴露给 Renderer。
• 可执行 Subagent（规划中）：提供显式 Execute 委派，限制嵌套、并行、Token、时间和工具权限，并保留父子任务审计。

Skills、MCP 与知识库

• Skills 按需接入：使用有界资源和受控 Runtime 边界。
• MCP Tools：直连模型可使用显式启用的 MCP Tools，并可在模型轮次间按需刷新动态 MCP 工具。
• 本地知识库：支持文件、目录和网页导入、SQLite FTS5 检索及来源追溯。
• 知识图谱：支持规则、模型和混合抽取，以及实体、关系、别名和证据维护。
• 向量模型配置与检索：可配置兼容 Embeddings 接口并用于语义检索。
• 向量诊断与索引任务：提供真实向量生成诊断、按文档重建进度、取消、失败状态与重启后结果恢复；每篇成功文档立即可用于检索。
• 混合检索测试台：支持全文、中文词组、向量和图谱通道诊断，可调 Top K、阈值、权重、本地或学习型重排及上下文预算。
• 分块、维护与评估：支持固定、结构化和父子分块，分块维护、可取消重建及双语检索评估。
• 受控知识本体：每个知识库可定义实体、关系、别名和端点约束，保留证据偏移、置信度和抽取来源，并显式提示图谱重建。
• 强制检索与引用上下文：对话可按需或每次先检索，显示零结果、降级、失败与取消状态，并可查看引用上下文或安全打开来源。
• 魔法笔记 / Magic Notes：提供本地优先的笔记与待办工作台、范围管理、编辑、筛选和受控 AI 评论；创建、保存和评论结果使用统一应用通知。
• MCP Server Control Plane（规划中）：统一 MCP 生命周期、健康检查、重连、Schema 缓存、隔离、审批和审计。
• 可追溯笔记摘录与 AI 编辑（规划中）：从对话、知识和网页收集带来源的摘录，并提供需确认的总结、改写和整理操作。

工作管理、长期协作与工作流

• 任务、活动与成果：集中管理任务状态、审计活动和成果文件；活动按会话分组并默认收起，避免长历史占满页面。
• 记忆与智能心跳：提供周期回顾、建议记忆、洞察、后续任务和可审计运行轨迹。
• 批量运行与对比实验室（规划中）：对模型、Prompt、角色和工作流配置执行批量对比，汇总质量、耗时、Token、费用、失败率和成果差异。
• 时态记忆与事实冲突检测（规划中）：为记忆和知识图谱增加有效期、当前事实、过期与矛盾检测、事实核验及证据回溯。
• 可视化受控工作流（规划中）：提供版本化 DAG、条件分支、审批、取消和恢复，执行节点继续经过 Main Runtime 边界。
• 统一 Run Graph 与回放（规划中）：关联任务、Subagent、模型、知识、工具审批、用量和成果，支持失败定位、重试和脱敏导出。

浏览器、通信、语音与应用维护

• 浏览器和桌面受控工具：保留范围、取消、超时、输出边界和执行记录。
• 远程消息通道项目：微信 ClawBot、企业微信和钉钉分别拥有系统管理的项目、独立远程会话、工作目录、处理后端、默认 Ask/Execute 模式及任务活动归属。
• 微信 ClawBot 扫码与媒体：通过独立 Sidecar 完成本机扫码、验证码、加密凭据和文字收发；支持个人微信私聊图片与文件，单条消息最多 4 个附件、解密后合计不超过 12MB。
• 微信安全回传：支持返回当前任务生成的图片，或在用户明确要求时将本次最终文本生成为 Markdown 附件；不自动读取或发送已有工作区文件。
• 企业微信与钉钉连接：支持 Main-only 加密设置、环境变量只读覆盖、连接测试、动态启停、发送者范围和状态诊断。
• 可选本地语音模型管理：应用不内置模型权重；提供校验下载、进度与取消、来源链接、本地目录导入、切换和删除。
• 本地录音与离线转写：采集麦克风音频并使用已选择的本地模型离线转写，支持停止、取消、状态反馈和资源释放。
• 版本检查：仅检查固定官方 Release 和当前平台清单，不自动下载或安装。
• 内网兼容模式：默认开启；允许应用内 HTTP 与无效、自签名或过期的 HTTPS 证书，关闭后恢复严格地址和证书校验。

开源、构建与发布

• 0BSD 开源许可：原创代码可自由使用、复制、修改、分发和商用；第三方组件和资源仍遵循各自许可证。
• 可复现依赖安装与源码构建：使用锁定依赖、Node.js 24 和统一的测试、类型检查、Lint、生产构建命令。
• 六平台原生发布矩阵：Windows、macOS、Linux 的 x64、arm64 目标由原生 Runner 构建，并提供发布清单和 SHA-256 哈希。

开放接口、团队协作与远程执行

• 远程任务委派：仅在用户显式配置端点和令牌后启用，按全局内网兼容模式使用 HTTP(S)，结果进入持久化发件箱。
• Headless Runtime API（规划中）：提供本机优先的任务、事件、状态和成果 API，以及有范围、有效期、限流和撤销能力的令牌。
• GoodBuddy Team Hub（规划中）：以可选服务提供组织、RBAC、项目共享、远程 Agent、策略下发和租户审计。
• 多云远程沙盒 Agent（规划中）：通过云厂商 API 和 SSH Agent 管理专用 Linux 沙盒；凭据留在 Main 进程，高风险控制面操作单独确认。

规划原则

规划中的工作流、Subagent、MCP、远程 API 和沙盒能力不得绕过现有 Main Runtime、Ask/Execute、权限、取消、超时和审计边界。