星池指挥官

星池指挥官是个人算力网的本地入口。它把用户自己的办公室电脑、家里电脑、 实验室机器和无桌面 Linux 服务器接入同一个工作台，让用户围绕目标工作，而 不是围绕设备、文件位置和工具配置工作。

从用户视角看，它不是“多装几个 AI 工具”，而是一个连续工作网络：

• 一个入口：桌面快捷方式、文件夹右键菜单或 Linux agentserver 命令都进入同一个工作体系。
• 多台机器：每台电脑可以作为可调度的工作现场，承载本地文件、长任务或专用环境。
• 自动拆任务：Loom driver/slave 把复杂目标拆成可推进的小任务，并协调多个助手执行。
• 上下文不断：工作区、设备状态、模型登录和本地任务状态由 AgentServer 与本机状态共同维护。
• 用户可控：安装、登录、模型访问、更新、在线状态和本机 slave 都在星池指挥官里可见、可恢复。

当前仓库负责什么

本仓库提供把个人设备接入个人算力网的客户端和安装包：

• Windows 安装包 agentserver-app
  • 默认安装并配置 Codex Desktop。
  • 可选择极简 VS Code + Codex CLI 模式。
  • 提供桌面快捷方式“星池指挥官”和资源管理器右键“用星池指挥官打开”。
  • 常驻本地控制台和托盘，用于查看登录、额度、更新、本机 slave 和工作区状态。
• Linux headless 版本 agentserver
  • 在无桌面服务器上直接运行当前目录作为 slave。
  • agentserver install-driver 可把 driver MCP 挂入当前用户的 Codex CLI。
  • 通过 device code 和二维码完成 code.cs.ac.cn / agent.cs.ac.cn 登录。
• 共享模型访问路径 + 多模型路由
  • 本地代理把 Codex / Codex Desktop 的 Responses API 请求转发到 ModelServer 网关 https://code.ai.cs.ac.cn/v1，并按模型在代理内做协议转换：gpt-5.5 直通 Responses，glm-5.2 转为 Anthropic Messages，deepseek-v4-pro 转为 Chat Completions —— 客户端始终只说一种协议，第三方模型不需要单独配置。
  • 默认模型可在「星池指挥官」控制台的模型选择卡切换，或用 agentctl set-model <name> / agentserver set-model <name> 直接改 ~/.codex/config.toml； 新建的 Codex 对话立即生效（旧对话沿用创建时锁定的模型）。
  • 后台 refresher 维护短期 access token，避免长进程因为 token 刷新而失效。

背后系统分工

• 星池指挥官 app：安装、登录、更新、前端选择、本地控制台、设备接入。
• AgentServer：工作区、设备状态、远程身份和跨入口连续体验。
• ModelServer：模型账号、模型调用、使用边界和用量记录。
• Loom：driver/slave 协作、任务拆分、多助手执行和多机器调度。

典型使用

1. 用户安装 Windows 安装包，或在 Linux 服务器上解压 agentserver。
2. 首次启动时完成 ModelServer 和 AgentServer 登录。
3. 星池指挥官配置 Codex/Codex Desktop，让模型请求走本地代理。
4. 用户可以从桌面、右键菜单或 Linux 命令进入同一个工作区。
5. 本机或远端 slave 加入后，用户只需要说明目标，系统负责拆分、分派和持续推进。

开发构建

make build          # 构建本机/目标二进制到 dist/
make test           # 前端构建 + go test -race -count=1 ./...
make cross-windows  # 交叉构建 Windows 二进制
make package        # 完整 Windows 打包，需要 Wine + Inno Setup

更多设计文档见：

• docs/superpowers/specs/2026-06-07-tray-dashboard-design.md
• docs/superpowers/specs/2026-06-09-local-token-proxy-design.md
• docs/superpowers/specs/2026-06-09-local-slave-management-design.md
• docs/superpowers/specs/2026-06-13-linux-headless-server-design.md