Assistant 面板式个人助理
把笔记、清单等面板放进共享工作区,让 Claude Code、Codex、Pi 等 AI 代理与你在同一界面上协作。
- Star 数
- ★ 92
- 最近更新
- 6 天前
- 主语言
- TypeScript
- FA 评分
- 38/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 已经在用 Claude Code 或 Codex,希望把任务清单、会议笔记和代理对话放在同一面板工作区的开发者
- 不适合
- 需要稳定生产环境与官方支持的团队
- 不想自己安装 Node 服务、管理配置和 API 密钥的用户
- 不愿让笔记与会话数据存在自托管机器上的用户
- 维护状态
- 近 30 天有提交最近提交 2026-11-15最新版本 v0.18.2(2026-04-06) · 预发布
- 源码审查
- 38/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Assistant 是一个实验性的自托管个人 AI 助理,由 Node.js 的 agent-server 与浏览器端 web-client 组成,通过 WebSocket 传输聊天消息与音频帧,通过 HTTP 提供静态文件与 REST API。界面采用面板(panel)布局,聊天、笔记、清单、时间追踪等都以插件定义的插件面板呈现,用户可与 AI 代理共享同一份工作区数据。代理可以选择内置的 Pi SDK 进程内对话,也可以调用本机安装的 Claude Code、Codex、Pi CLI 子进程,还可能通过 MCP(stdio JSON-RPC 2.0)调用外部工具。输入支持浏览器 Web Speech API 语音识别,输出可选 OpenAI TTS 或 ElevenLabs 流式 TTS,Android 端还可接入 openai-speech-server。仓库同时提供 Electron 桌面封装、Tauri 过渡封装、Capacitor 移动封装和推送通知代理,插件可导出为 Claude Code、Codex、Pi 可用的 skills 与命令行工具。作者明确说明这是个人软件,不保证稳定性与支持。
agent-server 启动后监听 WebSocket 与 HTTP:WebSocket 承载聊天、文本与二进制音频帧,HTTP 提供静态资源和 REST API。每个会话以追加写入的 JSONL 事件日志保存在 ${DATA_DIR}/sessions/<sessionId>/events.jsonl,索引位于 ${DATA_DIR}/sessions.jsonl,因此多个浏览器窗口可以共享同一会话。代理按 config.json 中的定义运行:进程内 Pi 代理引用命名的 chatProfiles(有序的 provider/model 组合与各模型思考等级),CLI 代理则以子进程方式启动 Claude、Codex 或 Pi。内置会话工具允许代理列出、搜索、创建、切换、重命名和固定会话;插件定义面板与操作,代理可对清单、笔记等面板执行读改写。通过 MCP over stdio 挂载外部工具。插件构建脚本可把插件导出为 skills 目录,其中 notes、lists、time-tracker、url-fetch 等技能自带 CLI(如 notes-cli list、lists-cli list),支持 --json 结构化输出;lists、notes、time-tracker 默认开启 Git 自动快照版本。
- 已经在用 Claude Code 或 Codex,希望把任务清单、会议笔记和代理对话放在同一面板工作区的开发者
- 想要一个自托管、数据留在自己机器上的个人助理,而不使用云端 SaaS 笔记应用的用户
- 需要在桌面浏览器和 Android 设备之间共享同一个会话与工作区的重度语音输入用户
- 用 cron 定时触发 CLI 代理跑例行任务(如每日整理)的人
- 希望用插件 SDK 为团队内部流程编写自定义面板和命令行工具的开发者
- 需要让代理通过 MCP 调用本地已有工具链的技术用户
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 端口
3000- 环境变量
DATA_DIRAPP_CONFIG_PATHELEVENLABS_API_KEYELEVENLABS_TTS_VOICE_IDELEVENLABS_TTS_MODEL- 配置文件
packages/agent-server/data/config.jsonpackages/agent-server/data/config.example.json- 运行环境
- Node.js 22.19.0
如何安装或部署这个 Agent?
需要 Node.js 22.19.0 或更高版本;CLI 代理需要在系统中单独安装对应的可执行文件。克隆仓库后按序执行:
git clone https://github.com/kcosr/assistant
cd assistant
npm install
npm run build启动服务端,内置配置位于 packages/agent-server/data/config.json:
npm run start -w @assistant/agent-server随后在浏览器打开 http://localhost:3000 。若需自定义数据目录或配置文件路径:
export DATA_DIR=/path/to/data
export APP_CONFIG_PATH=/path/to/config.json
npm run start -w @assistant/agent-server如需 ElevenLabs 流式语音输出(可选,费用较高):
export TTS_BACKEND=elevenlabs
export ELEVENLABS_API_KEY=<key>
export ELEVENLABS_TTS_VOICE_ID=VUGQSU6BSEjkbudnJbOj
export ELEVENLABS_TTS_MODEL=eleven_multilingual_v2完整的配置项见 docs/CONFIG.md 与 packages/agent-server/data/config.example.json。
如何使用这个 Agent?
启动后在 http://localhost:3000 打开面板界面,用 Ctrl/Cmd + K 打开命令面板,Ctrl/Cmd + ] 与 [ 在面板间切换焦点,Ctrl + I 聚焦输入框,Ctrl + R 切换语音录制。要把插件能力交给外部 CLI 代理使用,先构建 skills:
npm run build:plugins -- --skills-dir /tmp/skills
cp -r /tmp/skills/{notes,lists} ~/.pi/skills/也可以只构建指定技能并直接写入代理的 skills 目录:
npm run build:plugins -- --skills notes,lists --skills-dir ~/.pi/skills/若技能自带 CLI,将其目录加入 PATH 或使用完整路径调用:
export PATH="$PATH:$HOME/.pi/skills/notes:$HOME/.pi/skills/lists"关闭某个插件的 Git 自动快照,可在 config.json 中设置:
{
"plugins": {
"lists": {
"enabled": true,
"gitVersioning": {
"enabled": false
}
}
}
}这个 Agent 有哪些优点和局限?
- 面板化布局加插件 SDK,笔记、清单、时间追踪等都作为可扩展面板,而不是固定功能列表
- 同一工作区同时接入 Pi SDK 进程内模型和 Claude Code、Codex、Pi CLI 子进程,并有内置会话工具让代理管理对话
- 插件可导出为 skills 与自带 CLI,Claude Code、Codex、Pi 能直接复用同一套笔记/清单/时间追踪能力
- 会话以 JSONL 追加日志持久化,多浏览器窗口共享;lists、notes、time-tracker 默认开启 Git 自动快照版本
- 提供 Electron、Tauri、Capacitor 多种客户端封装与推送通知代理,自托管部署只需 Node.js
- 作者明确标注为实验性个人软件,不承诺稳定性或支持
- Node.js 22.19.0 起、依赖 Pi SDK 1.5.2,CLI 代理还需各自单独安装可执行文件,运行时门槛不低
- 许可证字段在仓库元数据中显示为 unknown,尽管 README 写的是 MIT,采用前需自行核对
- 语音能力依赖浏览器 Web Speech API,TTS 输出依赖 OpenAI 或 ElevenLabs 付费服务
- 缺少中文界面与中文文档证据,配置与技能文档均为英文
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Assistant 面板式个人助理 当前 | 38 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 92 | 6 天前 | TypeScript | Codex · Claude Code · OpenAI API |
| Lotti 私人日志与任务助手 | 78 · 表现良好 | 桌面应用免费 + 模型费 | ★ 1.2k | 今天 | Dart | OpenAI API · Claude API |
| Waku | 65 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2.2k | 1 天前 | Python | OpenAI API · Claude API |
| Qwen Audio Agent | 70 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 3.3k | 3 天前 | JavaScript | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示存在工具白名单/黑名单、Realtime 工具显式 opt-in、web_search 使用受限权限配置,以及静态 token 认证设计文档,说明有最小权限意识;但 TOOL_APPROVALS.md 明确标注为草稿且“无当前代码引用”,面板工具审批尚未实现,用户确认能力薄弱。敏感数据处理方面 CONFIG.md 说明 API key 仅存于服务端、不进入客户端,但 WS token 走 query 参数存在日志泄漏风险。依赖安全仅见 package.json 版本范围,无审计或锁定证据。回滚方面 git 版本化默认开启(lists/notes/time-tracker),但仅覆盖插件数据,非全局。来源归属仅 README 提及 MIT 与作者,无更细归属。整体为薄证据,故各项给 1。
README 与 package.json 对 Node 版本(>=22.19.0)、Pi SDK 1.5.2 一致,构建/测试脚本存在;但 CLI provider 需另行安装可执行文件,依赖可用性依赖外部环境。失败信息在 push-cli 与 notify-proxy 中有基本错误输出,但整体错误处理证据有限。自洽性有少量文档与代码对应,但样本不完整,故给 1。
README 覆盖文本/语音、多 CLI agent、插件、移动端与桌面端,场景较广,给 2;但能力边界(哪些工具默认启用、审批缺失)描述不完整,触发精度依赖 AGENTS.md 建议文本而非强制机制,环境适配(systemd、Android 构建)指向仓库外 skill,故给 1。
README 有目录、仓库布局、文档地图,信息架构较好(2);安装步骤清晰(2);但命名稳定性、FAQ、已知限制(仅“实验性软件”一句)、许可证(README 称 MIT 但元数据未知)、版本化(AGENTS.md 描述 CHANGELOG 流程但未见 CHANGELOG 文件)、维护责任(个人项目、无支持承诺)均薄弱,给 1。
产品功能丰富,输出可用性依赖运行环境;但作为 Agent 产品,缺少审批、权限边界与可验证的默认安全配置,边际价值与成本收益难以从静态证据确认,故各项给 1。
README 声明与部分代码/文档可交叉印证(如 Pi SDK 版本、配置路径),但多数安全与行为声明缺乏测试或代码引用支撑;TOOL_APPROVALS 明确为未实现设计,事实与推断分离尚可但证据薄,故给 1。
- 面板工具审批(TOOL_APPROVALS.md)仍为草稿且无代码实现,Agent 对面板的操作缺少用户确认层。
- WebSocket 认证 token 通过 query 参数传递,可能经日志、代理或浏览器历史泄漏;静态 token 非完整认证系统。
- README 自述为实验性个人软件,不保证稳定性或支持;许可证元数据未知,使用前需自行核实。
- CLI provider 需另行安装可执行文件,依赖可用性与版本兼容需自行验证。
- git 版本化仅覆盖部分插件数据,非全局回滚机制。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.18.2 预发布
发布说明摘录
Breaking Changes Added - Added chat.thinking support for claude-cli agents: the composer now surfaces the thinking picker for Claude agents, and the selected level is translated to Claude's --effort flag (none/off suppress the flag, xhigh maps to max, and low/medium/high/max pass through) ([#92](https://github.com/kcosr/assistant/pull/92)). - Added a native Android voice setting in the web voice settings menu to enable or disable the local recognized stop command ([#92](https://github.com/kcosr/assistant/pull/92)). Changed Fixed …在 GitHub 查看 ↗
常见问题
它自己会调用大模型吗,还是必须有外部 CLI?
我的数据存在哪里?
语音功能需要额外付费吗?
能否在 Claude Code 或 Codex 里直接用它的笔记和清单?
适合生产环境或团队正式部署吗?
Assistant 面板式个人助理 用哪个端口?
Assistant 面板式个人助理 开源吗?
Assistant 面板式个人助理 安全吗?
Assistant 面板式个人助理 还在维护吗?
Assistant 面板式个人助理 是谁开发的?
谢谢反馈,我们会据此改进页面。