DeepSeek Harness Hub
← 返回列表

SiriusNEO/StarAgent

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
需源码安装

⚠️ 这个项目目前主要面向个人使用,仍在快速开发中。稳定版本会在后续发布。

暂不能直接安装(需源码编译或环境不满足):仓库缺少 package.json,无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/9/9 · 已提供中文文档

轻量级代理多路复用器,全部集成在一个 Web 仪表板中

综合分
52.3
GitHub 分
52.3
用户评分
★ Stars
60
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add SiriusNEO/StarAgent
仓库缺少 package.json,无法用 dsh 插件安装命令安装,改用 GitHub 源安装
🟢实装验证通过· 2026/9/19
由 dsh-plugin-verify(GitHub Actions)在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/17(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包StarAgent(未发布到 npm,仅可源码安装)
Node 引擎未声明 engines.node
dsh CLI 依赖未声明 dsh 版本约束
入口文件缺少入口声明

仓库缺少 package.json,无法用 dsh 插件安装命令安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 21:21:14

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

StarAgent

English

⚠️ 这个项目目前主要面向个人使用,仍在快速开发中。稳定版本会在后续发布。

⚠️ 这个项目主要由 vibe coding 构建,可能存在潜在问题,使用前请注意。

StarAgent 是一个用于统一管理跨机器 coding agent session 的 agent multiplexer。它来自我自己并行使用多个 agent 的实践:

我们需要一个轻量的 tmux wrapper,用来管理 Codex / Claude Code,支持跨机器连接,并且能从任意设备访问。

设计原则

StarAgent 围绕日常使用 coding agent 时最常见的几个需求构建:

- 我们经常会在不同 working directory 里并行运行多个 agent CLI,每个 agent 处理一个独立任务。因此需要一个地方统一查看状态,并实时交互。
- 我们希望随时随地、在任意设备上和 agent 交互,并且 session 状态保持一致。
- Agent CLI session 应该长期存在,这样就不需要反复输入 /resume。

基于实际使用经验,StarAgent 采用了对这个工作流足够简单、有效的技术栈,让它像是在管理一个小型 coding agent 团队:

- tmux-first。所有 coding agent CLI session 都运行在长期存在的 tmux session 里。为了保持一致,系统级后台服务也会表示为 tmux session。Session 模型见 SESSIONS.md。

- 通过 Tailscale 实现跨机器连接。Tailscale 提供安全、统一的跨机器网络层。配置方式见 tailscale/README.md。

- 通过 Web Dashboard 统一管理。Web Dashboard 让你可以从任何带浏览器的设备控制 agent,包括手机和电脑,不需要额外安装客户端。

StarAgent 使用中心化架构:StarAgent Hub 运行 Web Dashboard,同时也作为本机 Node;其他机器作为 StarAgent Node 通过同一个 Tailscale 网络接入。每个 Node 都可以启动 agent session,并统一由一个 Dashboard 管理。
技术架构见 ARCHITECTURE.md。

预览

以下截图使用的是脱敏 demo 数据。二次元风格背景完全可选:可以从主题菜单上传任意图片,
再搭配主题色与玻璃面板效果。

在一个地方查看跨机器的所有 session:

带有二次元星空背景的 StarAgent Sessions 页面

每个 session 都包含一个轻量 Chat 控制台,用来和 agent 交互,同时也提供 Terminal 和 File Explorer。
Session 详情页左侧提供类似 IM 的会话切换栏,不需要先返回列表;窄屏设备上会折叠成可搜索的抽屉。

StarAgent Session 中的 Chat 与锁定状态 PTY Terminal

跨机器查看 Agent CLI 的可用性、登录状态、升级方式和启动 preset:

展示 Codex、Claude Code 与 OpenCode 的 StarAgent Agents 页面

注意: 这不会影响你手动 SSH 到服务器并 attach 到对应 tmux session 进行开发。Web 界面本质上只是 parser;服务器上的 tmux CLI session 始终是 ground truth。

Hub

在运行 Dashboard 的机器上执行:

pip install -e '.[dev]'
staragent hub --host 0.0.0.0 --port 8080

staragent hub 默认会创建 staragent-hub 这个 tmux system session。
打开 http://:8080,使用 staragent hub 打印出来的 token 登录。

认证与状态目录、Dashboard 页面、集中日志、Agent CLI 检测与升级、额度信息、preset 和历史会话恢复等
详细说明见 HUB.md。

Remote Node

在每台需要运行 agent session 的机器上执行:

pip install -e '.[dev]'
export STARAGENT_NODE_TOKEN=""
sudo tailscale up --ssh
staragent node-ts --sudo

staragent node-ts 会检查 Tailscale 是否已经安装并连接,然后启动 staragent-node 这个 tmux system session,并配置 tailscale serve。
如果 Tailscale 还没有准备好,它会打印需要先执行的 tailscale up --ssh 命令。
当 tailscale serve 需要 root 权限时,请使用 --sudo。

如果你使用 LAN 或其他不需要 tailscale serve 的网络层,可以执行:

staragent node

添加 Node 之前,先在 Hub 机器上验证连通性:

staragent verify-node

然后在 Hub Dashboard 里添加可访问的 Host 和 Port,例如 100.x.x.x 和 8081。
如果 Node 使用非默认端口,请显式填写对应端口,例如 8082。

致谢

StarAgent 的 CLI transcript parsing 借鉴并改造了 botmux 的思路和代码。Dashboard 视觉风格受到 Tailscale admin console 启发。Markdown Preview 遵循 GitHub Flavored Markdown 的常见约定。Web terminal 使用 xterm.js,文件预览高亮使用 highlight.js。

License

MIT. See LICENSE.

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群