Assistant 面板式个人助理

把笔记、清单等面板放进共享工作区,让 Claude Code、Codex、Pi 等 AI 代理与你在同一界面上协作。

Star 数
★ 92
最近更新
6 天前
主语言
TypeScript

30 秒速览

运行形态
自托管服务网页应用桌面应用
可在哪里用
通用 · 跨平台Codex · Claude Code · OpenAI API
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js 22.19.0 或更高版本Claude Code CLI 可执行文件(可选)Codex CLI 可执行文件(可选)Pi CLI 可执行文件(可选)Pi SDK 1.5.2OpenAI API 密钥ElevenLabs API 密钥(可选)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
已经在用 Claude Code 或 Codex,希望把任务清单、会议笔记和代理对话放在同一面板工作区的开发者
不适合
  • 需要稳定生产环境与官方支持的团队
  • 不想自己安装 Node 服务、管理配置和 API 密钥的用户
  • 不愿让笔记与会话数据存在自托管机器上的用户
维护状态
近 30 天有提交最近提交 2026-11-15最新版本 v0.18.2(2026-04-06) · 预发布

这个 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 自动快照版本。

  1. 已经在用 Claude Code 或 Codex,希望把任务清单、会议笔记和代理对话放在同一面板工作区的开发者
  2. 想要一个自托管、数据留在自己机器上的个人助理,而不使用云端 SaaS 笔记应用的用户
  3. 需要在桌面浏览器和 Android 设备之间共享同一个会话与工作区的重度语音输入用户
  4. 用 cron 定时触发 CLI 代理跑例行任务(如每日整理)的人
  5. 希望用插件 SDK 为团队内部流程编写自定义面板和命令行工具的开发者
  6. 需要让代理通过 MCP 调用本地已有工具链的技术用户

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

端口
3000
环境变量
DATA_DIR APP_CONFIG_PATH ELEVENLABS_API_KEY ELEVENLABS_TTS_VOICE_ID ELEVENLABS_TTS_MODEL
配置文件
packages/agent-server/data/config.json packages/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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
38/ 100 五分制 1.9 / 5
信任安全 10/29
可靠稳定 5/14
适用触发 8/18
规范维护 8/18
有效结果 4/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

证据显示存在工具白名单/黑名单、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。

可靠稳定5 / 14 · 1.8/5

README 与 package.json 对 Node 版本(>=22.19.0)、Pi SDK 1.5.2 一致,构建/测试脚本存在;但 CLI provider 需另行安装可执行文件,依赖可用性依赖外部环境。失败信息在 push-cli 与 notify-proxy 中有基本错误输出,但整体错误处理证据有限。自洽性有少量文档与代码对应,但样本不完整,故给 1。

适用触发8 / 18 · 2.2/5

README 覆盖文本/语音、多 CLI agent、插件、移动端与桌面端,场景较广,给 2;但能力边界(哪些工具默认启用、审批缺失)描述不完整,触发精度依赖 AGENTS.md 建议文本而非强制机制,环境适配(systemd、Android 构建)指向仓库外 skill,故给 1。

规范维护8 / 18 · 2.2/5

README 有目录、仓库布局、文档地图,信息架构较好(2);安装步骤清晰(2);但命名稳定性、FAQ、已知限制(仅“实验性软件”一句)、许可证(README 称 MIT 但元数据未知)、版本化(AGENTS.md 描述 CHANGELOG 流程但未见 CHANGELOG 文件)、维护责任(个人项目、无支持承诺)均薄弱,给 1。

有效结果4 / 13 · 1.5/5

产品功能丰富,输出可用性依赖运行环境;但作为 Agent 产品,缺少审批、权限边界与可验证的默认安全配置,边际价值与成本收益难以从静态证据确认,故各项给 1。

证据核验3 / 8 · 1.9/5

README 声明与部分代码/文档可交叉印证(如 Pi SDK 版本、配置路径),但多数安全与行为声明缺乏测试或代码引用支撑;TOOL_APPROVALS 明确为未实现设计,事实与推断分离尚可但证据薄,故给 1。

风险与缓解建议
  • 面板工具审批(TOOL_APPROVALS.md)仍为草稿且无代码实现,Agent 对面板的操作缺少用户确认层。
  • WebSocket 认证 token 通过 query 参数传递,可能经日志、代理或浏览器历史泄漏;静态 token 非完整认证系统。
  • README 自述为实验性个人软件,不保证稳定性或支持;许可证元数据未知,使用前需自行核实。
  • CLI provider 需另行安装可执行文件,依赖可用性与版本兼容需自行验证。
  • git 版本化仅覆盖部分插件数据,非全局回滚机制。
证据充分度:低 评估于 2026年11月16日 审查版本 101db5745a1d
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/assistant.svg?lang=zh)](https://followagents.com/zh/agents/assistant)
<a href="https://followagents.com/zh/agents/assistant"><img src="https://followagents.com/badge/assistant.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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?
两条路都支持。进程内对话走 Pi SDK(1.5.2)访问模型,chatProfiles 里配置有序的 provider/model 组合;同时可以把本机安装的 Claude Code、Codex、Pi CLI 作为子进程代理调用,二者可并存。
我的数据存在哪里?
全部在自托管机器上:会话索引在 ${DATA_DIR}/sessions.jsonl,每个会话的事件日志在 ${DATA_DIR}/sessions/<sessionId>/events.jsonl,配置默认读取 ${DATA_DIR}/config.json。笔记、清单等插件数据目录还可开启 Git 自动快照。
语音功能需要额外付费吗?
语音输入使用浏览器自带的 Web Speech API,不需要额外密钥;语音输出可选 OpenAI TTS(默认)或 ElevenLabs 流式 TTS,后者 README 提示费用可能较高,需自行提供 API 密钥。
能否在 Claude Code 或 Codex 里直接用它的笔记和清单?
可以。运行 npm run build:plugins -- --skills-dir <目录> 会把插件导出为 skills,复制到 ~/.claude/skills/、~/.codex/skills/ 或 ~/.pi/skills/ 后即可使用,部分技能还带 notes-cli、lists-cli 等命令行工具。
适合生产环境或团队正式部署吗?
README 开篇即声明这是供教育用途分享的个人软件,不保证稳定性与支持;如果需求是可运维、有 SLA 的生产系统,应谨慎评估或另选方案。
Assistant 面板式个人助理 用哪个端口?
本页安装说明里用的是 3000 端口(例如 http://localhost:3000)。如果项目支持修改端口,方法以 README 为准。
Assistant 面板式个人助理 开源吗?
源码公开在 GitHub(kcosr/assistant),但仓库没有声明通用的开源许可证,能不能复用、修改并不明确。在此基础上开发前,建议先看 README 或询问作者。
Assistant 面板式个人助理 安全吗?
FollowAgents 的 FARS 评审(2026年11月16日)给 Assistant 面板式个人助理 的“信任与安全”打了 10/29 分。评审检查的 8 项安全措施没有完全缺失的。
Assistant 面板式个人助理 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-15,在最近 30 天内。
Assistant 面板式个人助理 是谁开发的?
Assistant 面板式个人助理 由 GitHub 账号 kcosr 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念