greentfrapp/panel

来源：https://github.com/greentfrapp/panel

Panel

一个让你的代理并肩工作的研究工作台：聊天、文件、PDF 和笔记本集成在一个界面中，必要时代理还能创建自定义查看器和应用。

这是一个供测试人员使用的早期版本。可能存在不足，欢迎随时提交问题。

Panel 运行中截图。

开始之前

• Node (https://nodejs.org/en/download) 22.18 或更新版本（或 24.12 及更新版本）
• pnpm (https://pnpm.io/installation)
• uv (https://docs.astral.sh/uv/getting-started/installation/)，可自动获取所需的 Python (3.12 或更新版本)
• Claude Code (https://code.claude.com/docs/en/setup)，已安装并登录：运行 claude 一次并登录。代理和文献综述功能均通过此运行。

安装与启动

pnpm install
uv sync
pnpm start

然后打开 http://localhost:3000。pnpm start 会先构建应用，因此首次启动需要约一分钟。按 Ctrl-C 可停止所有启动的进程。

文件存储位置

• ~/Panel/panel.db 保存你的对话以及代理的所有操作记录。
• ~/Panel/workspaces 是新工作区的默认创建位置，除非你选择其他文件夹。 这两个位置都在此项目文件夹之外，因此删除或重新克隆代码库不会影响它们。

已实现功能

• 与能够读写文件的代理聊天，并在运行工具前征求你的意见。
• 工作区：代理工作的文件夹，拥有独立的聊天记录和保存的布局。
• 文件、PDF、Markdown 和 Jupyter Notebook 的显示窗格。Notebook 通过真实内核运行，你和代理可以同时编辑同一个笔记本。
• 后台运行的长时间命令，可查看进度并随时终止。
• 当内置窗格无法显示某些内容时，代理可为你编写自定义窗格。
• 文献综述：通过聊天请求，从工具卡中打开结果。

尚未支持

• 目前仅完整支持 Claude Code。
• 模块只能通过聊天请求启动，没有启动按钮。
• 假设模块没有自己的视图，因此结果可能难以阅读。
• 模块暂不支持 OpenAI API。

OpenAI 密钥（可选）

将 apps/server/.env.example 复制为 apps/server/.env，并设置 OPENAI_API_KEY。这会在代理选择器中添加“OpenAI API“，用于聊天和工具。文献综述和假设模块需要能够搜索网络的代理，目前只有 Claude Code 可以。未设置密钥时，选择器会显示 OpenAI 未配置，这是正常现象。

故障排除

• “Panel 无法连接到其服务器。” —— 服务器未运行。检查运行 pnpm start 的终端窗口，然后点击重试。
• 代理显示未配置。 —— 原因显示在消息框下方。
• 端口已被占用，或应用响应但无法加载：运行 pnpm dev:doctor。它会显示各端口占用情况及释放方法。

许可证

MIT

设计理念

UI

UI 包含多个可配置的窗口（称为窗格），可显示图像文件、数据文件、代码以及聊天会话等多种内容。这对需要在不同类型文件间切换的研究人员至关重要。系统默认提供一套常用窗格，但人类和代理也可添加自定义窗格，例如 PDB 查看器或 SQLite 可视化工具。

模块协议

模块类似于技能，但增加了支持模块间工作流及与工作区集成的定义。具体来说，模块包含输入、输出和中间数据的类型化定义。输入和输出是常规概念。中间数据指提供可观测性的对象，例如代理模块的思维链或临时记录，也可能是多阶段模块的中间输出。这对需要透明度的过程或需要显示进度的长期运行任务尤为重要。类型化定义支持运行时验证，使人和代理能更轻松地开发自定义模块来执行下游任务，并开发可视化窗格。

数据抽象层

数据抽象层桥接内存对象与文件系统对象，可将 URI 映射到内存存储或本地文件，使模块只需专注于对象操作。