Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,6 +233,13 @@ contract](docs/reference/protocols/lark-manager-context-authority-v0.md).
loopx dashboard
```

For the optional [Workbench](apps/workbench/README.md#统一启动命令), use
`loopx workbench start`, `loopx workbench status`, and `loopx workbench stop`
after installing its separate application. These commands preserve its data and
leave independently managed Core services running. Opt in to current-user login
startup and crash recovery with `loopx workbench start --autostart` (macOS launchd
or Linux systemd); `stop --disable-autostart` removes that registration and keeps data.

`loopx dashboard` is the supported browser/PWA launch path. You can also download
native desktop previews from the [current release](https://github.com/loopx-project/loopx/releases/latest);
they reuse the same loopback services and Goal state. Apple Silicon macOS supports
Expand Down
111 changes: 109 additions & 2 deletions apps/workbench/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ LooChat 不动 agent 本身的目录、配置和会话,装好即用。LooChat

## 使用方式

消息菜单中的复制为引用、整条回复引用、作为上下文和侧边追问,见[引用使用说明](docs/references.md)。

实时语音:开启后输入框换成一个会随声音起伏的球,你说的话以浅蓝气泡记进线程;后台任务和待批准事项一行可见;结束后逐句对话折成一行,下面留一份文字总结。

用量与诊断:多 agent 的 token 用量、TPM 走势和费用估算。
Expand All @@ -39,7 +41,47 @@ LooChat 不动 agent 本身的目录、配置和会话,装好即用。LooChat
| zcode | `zcode app-server` 精简接入 | 有 | 按原生模型能力 | 暂无 |
| DeepSeek Harness | `dsh --profile acp`(ACP) | 有(仅允许一次/拒绝) | 有(按当前模型路由) | 暂无 |

各家 agent CLI 需要先在主机上装好并完成登录或鉴权。没装的 agent 在界面里显示为不可用。
各家 agent CLI 需要先在主机上装好。没装的 agent 在界面里显示为不可用;已安装的 Claude Code 和 Antigravity 可从 Agents 页发起登录。

### Agent 未登录时恢复

读取模型时,所有 Agent 明确返回的原生认证失败都会在工作区显示「账号名 尚未登录」。恢复方式按该实例支持的能力提供:

| Agent | 恢复入口 |
| --- | --- |
| Claude Code、Antigravity | 「去登录」展开行内授权面板;验证后自动刷新模型 |
| Codex、TRAE CLI、ZCode | 「去登录」打开该账号的原生终端登录;模型读取确认可用后自动恢复 |
| pi、DeepSeek Harness | 显示原生客户端凭据配置指引和「重试」;pi 在原生客户端使用 `/login` |

空目录单独提示「暂无可用模型,请检查登录或模型配置」;空列表本身不作为未登录证据。配置型 Agent 在原生客户端配置后点击「重试」,已有草稿保留。网络故障、额度耗尽、不受支持的订阅和 Workbench 自身的访问令牌错误保留各自含义。

以下为构建页面与隔离测试账号的实际界面;原生授权结果由测试 CLI 提供,不代表真实账号授权已验收。

![Claude Code 未登录时的恢复入口](docs/images/agent-login-claude.png)

<img src="docs/images/agent-login-codex-phone.png" alt="手机上的 Codex 登录与重试入口,原草稿保留" width="390" />

![pi 空模型目录的配置指引](docs/images/agent-login-empty-models.png)

认证识别遵循原生协议:[ACP 的认证错误](https://agentclientprotocol.com/protocol/v1/authentication)、Codex 的 `account/read`(仅在 `requiresOpenaiAuth` 为真且账号为空时判断未登录),以及 CLI 明确的登录或缺失凭据诊断。Codex 自定义服务和旧版账号协议保留原有目录行为。

### Antigravity 登录

若读取模型时尚未登录,当前页面会显示「Antigravity 尚未登录」和「去登录」。点击后在原位置展开授权面板;登录验证成功后自动加载模型列表,无需刷新页面。若此时模型读取暂时失败,可以重试读取,不必重复授权。网络或 CLI 故障仍单独显示为错误。

![未登录时就地进入授权](docs/images/antigravity-login-required.png)

<img src="docs/images/antigravity-models-restored.png" alt="授权后自动恢复的模型列表(测试账号)" width="390" />

在 Agents 页点击 Antigravity 的「登录」,授权面板会在该账号行下方展开,不遮挡其他页面操作。打开 Google 授权链接,授权后把验证码或浏览器最后显示的完整回跳地址粘贴回来,点击「提交验证码」。出现登录成功后,账号邮箱会显示在列表中。收起面板、离开页面或刷新都不会取消登录,10 分钟内可从「继续登录」回到同一次授权;只有「取消登录」会主动结束它。链接过期或授权失败时点「重试」获取新链接。

另加账号时,选择「添加 agent → Antigravity → 添加账号」。创建后直接展开登录面板。新账号使用独立目录,只复制可移植设置、指令和技能,不复制原账号的凭据、历史或项目信任。原生 CLI 负责 OAuth 和保存凭据。安装器留下的 `.old` 等备份不会作为可用账号展示,原文件保留。

下面是同一登录入口在桌面与手机上的示意(使用测试账号):

![桌面 Antigravity 登录](docs/images/antigravity-login-desktop.png)

<img src="docs/images/antigravity-login-phone.png" alt="手机 Antigravity 登录:打开链接后粘贴授权码或回跳地址" width="390" />

## 插件与参与

Expand Down Expand Up @@ -87,6 +129,69 @@ curl -fsSL "https://raw.githubusercontent.com/loopx-project/loopx/$ref/apps/work

各家 agent CLI 要自己装好并登录,LooChat 只调用这台机器上现有的。

### 统一启动命令

安装支持此命令的 LoopX CLI,并安装、构建同版本 Workbench 后:

```bash
loopx workbench start
loopx workbench status
loopx workbench stop
```

`start` 在后台启动 Workbench,输出访问地址和私密登录链接。重复执行复用已有实例;
`status` 只读检查实际服务及 Core 连通性,不创建配置、不签发登录链接。
`stop` 保留配置和会话数据,存在运行中的 Agent 时拒绝停止;明确要中断时使用
`loopx workbench stop --force`。Core 仍独立管理,以上命令不会启动、替换或停止 Core。
Core 不可达会明确提示,普通 Agent 会话仍可使用;连通性不代表 Goal 功能已验收。

需要登录电脑后自动运行时,显式启用:

```bash
loopx workbench start --autostart
loopx workbench status
# 本次停止;下次登录仍自动启动
loopx workbench stop
# 停止并取消自启动,保留会话和配置
loopx workbench stop --disable-autostart
```

macOS 使用当前用户的 LaunchAgent,登录后启动、异常退出后恢复;不承诺未登录时运行。
Linux 使用 `systemd --user`,需要可用的用户服务管理器;不自动启用 linger 或申请 root 权限。
`status` 从系统服务管理器读取自启动状态,无法核实会明确报错。普通 `start` 不主动开启自启动;
已有注册时沿用该服务。为已运行的 CLI 实例启用自启动需要一次空闲重启,运行中的任务会阻止迁移。
系统服务只读取已有配置,不签发登录链接;交互执行 `start` 就会输出带 token 的私密登录链接。
默认地址只适用于同机浏览器;异机访问仍需已有的可达域名或代理。

注册使用 Node 和当前 CLI 的绝对路径。应从稳定安装位置启用,保留 Node、CLI、应用及配置文件;
移动安装位置或更换 Node 后,先用原安装执行 `stop --disable-autostart`,再从新安装启用。
若服务文件被外部修改,CLI 会拒绝覆盖或删除,需先核对并恢复原注册;服务管理器不可用时不假报成功。
服务文件只保存启动路径和必要环境,不复制登录 token;密钥仍由已有 `.env` 管理。

默认数据目录与 `scripts/workbench.sh` 相同:
`${XDG_STATE_HOME:-~/.local/state}/loochat-workbench`。
可以用 `WORKBENCH_STATE_DIR` 或每次传入 `--state-dir` 指定已有目录。
`start --port 8796`、`--workbench-dir /path/to/apps/workbench`、
`--env-file /path/to/workbench.env` 可选择端口、已构建应用和已有配置;
成功启动后保存这些选择,停止后再次启动沿用。应用依次从显式目录、
`LOOPX_WORKBENCH_DIR`、已保存目录、`LOOCHAT_HOME`、CLI 源码目录和默认安装目录查找。
依赖或构建缺失时给出准备命令,不自动下载安装。

原有脚本或 systemd 正在管理的实例不会被接管或停止。迁移时先用原启动方式正常停止,
再指定同一数据和配置,例如安装器的默认目录:

```bash
loopx workbench start --state-dir ~/.local/state/loochat --env-file ~/.config/loochat/.env
loopx workbench status --state-dir ~/.local/state/loochat
loopx workbench stop --state-dir ~/.local/state/loochat
```

systemd 实例继续使用原服务管理也完全可行,不要让两种启动方式同时管理同一数据。
CLI 管理使用独立的私有 Unix socket,不开放浏览器或远程 relay 的停服接口;
旧 PID 文件不授予停止权限。后台日志在状态目录的 `daemon.log`;
启动失败先看日志,修正配置后重试。异常中断留下 `lifecycle.lock` 时,先确认没有进行中的
启动,再移除该锁目录重试。命令支持 `--format json`,但 `start` 输出包含登录链接,勿公开。

### 从源码开发

```bash
Expand Down Expand Up @@ -208,6 +313,8 @@ npm test -w @calli/e2e -- --test-concurrency=1 test/smoke.spec.mjs

### 安装为桌面应用

在 Chrome 中打开 LooChat 后,可通过浏览器菜单将它安装为应用。安装名称为 LooChat,图标使用蓝白配色的大小钳小螃蟹。
在 macOS 或 Windows 的 Chrome 中打开 LoopX,浏览器允许安装时,侧栏底部会出现「安装 LoopX」。点击「安装」后,在 Chrome 弹窗中确认;网页不能跳过这次确认。安装后可从 Spotlight 或开始菜单打开独立窗口。

选择「以后再说」或取消安装后,7 天内不再主动提示;「配置 → 安装 LoopX」仍可手动进入。没有快捷安装按钮时,该页面会显示浏览器菜单安装说明。请使用 HTTPS(本机 localhost 也可);受管理的浏览器可能禁用安装。独立窗口仍需连接原来的 Workbench 服务,不提供离线 Agent 执行。

如果此前安装的应用仍显示 Limi、AgentHub 或旧图标,先尝试关闭所有应用窗口后重新打开,并接受 Chrome 提供的名称或图标更新。如果仍未更新,可卸载旧应用后从当前网页重新安装;卸载时不要勾选清除网站数据,以保留本机登录和偏好。
34 changes: 34 additions & 0 deletions apps/workbench/THIRD_PARTY_NOTICES.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,3 +25,37 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

## Calli

Antigravity account isolation and native OAuth login (`packages/daemon/src/adapters/agy-account.ts`,
`code-login.ts`, inline login UI and related account tests) are adapted from Calli
(`maxliux5/calli`, account flow at `d2a6d6f1dc524dd0ce36a73f6674bd74967c950c`,
inline/resumable login at `c9802662b5219395b14e65ba30dfff21230df91b`).

Quote-paste handling is adapted from Calli `b456a10716221f06baee5d62a02f87dd626df460`;
quoted side-chat model selection from `80eb16edbd3e2cc3e2a3c887a2560fe39b6ab209`,
including the current local SideChat preference/catalog refinements. Existing Loochat
message-draft protections and machine-scoped provenance are retained.

MIT License

Copyright (c) 2026 Calli contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
9 changes: 9 additions & 0 deletions apps/workbench/docs/install-agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,15 @@ LOOCHAT_LOOPX_REGISTRY=/path/to/registry.global.json
3. 通过带 Workbench token 的 `/api/loopx/healthz` 检查 Core 代理;无法连接时应返回 `502`、`loopx_core_unavailable` 和目标地址。
4. 修正 `.env` 或启动 Core 后,按下节方式重启 Workbench 并重试。连通性通过不代表已验证 Goal 创建和会话恢复,需按用户授权另外验收。

## 用 LoopX CLI 管理 Workbench

新版 LoopX CLI 提供 `loopx workbench start|status|stop`,用法见
[统一启动命令](../README.md#统一启动命令)。它需要已安装并构建的 Workbench,
默认不接管本安装器创建的 systemd 服务,也不改变 Core 的独立安装边界。
使用 `--no-service` 安装后,可通过 `start --workbench-dir` 指定应用,
通过 `--env-file` 和 `--state-dir` 复用安装器的配置与数据。
`status` 只读;`stop` 不删除数据,有正在运行的会话时需等结束或明确加 `--force`。

## 更新、重启与卸载

更新时重跑同一个安装入口;分支 ref 获取最新提交,完整 SHA 则保持固定版本。安装器打印实际检出的 SHA。存在源码改动或安装后新增的本地提交时,先保存到另一个工作目录,再更新。上游 Calli 的已有克隆不能就地当作本仓库更新:请选择新的 `LOOCHAT_HOME`;原有配置与数据仍保留。
Expand Down
33 changes: 33 additions & 0 deletions apps/workbench/docs/references.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# 引用消息、会话与目录

消息下方的操作栏、更多菜单、桌面右键和手机长按提供复制、复制为引用、引用整条回复、交给助手、作为上下文和选择文字。选中的文字还可以加注释或在侧边栏追问。

## 复制与粘贴引用

「复制为引用」保留富文本和 Markdown 两种表示。在另一个会话的输入框中粘贴时,整段引用成为输入框上方的注释条,已有草稿保留;可继续添加评论或移除引用。外部应用复制来的整段 `>` 引用也可以识别,混合引用和正文仍按普通文本粘贴。

工作台复制的引用记录来源机器、会话和轮次。同一机器的另一会话附带 `loochat history THREAD --turn TURN` 来源说明;同一会话或其他机器只携带所选正文,不把另一台机器的标识当作本机历史读取权限。注释条沿用已有草稿、排队、撤回编辑和发送协议。刷新后重新打开该会话,引用和已输入的草稿一起恢复。

手机端粘贴后,引用留在输入框上方,正文继续编辑:

![手机端的引用与草稿](images/reference-pasted-note-phone.png)

## 侧边追问

选择文字并打开侧边追问后,可以在发送前选择模型与思考档位。追问建立后,切换模型仍使用同一追问会话;切回某个模型时恢复记住的思考档位,源会话不受影响。模型目录的加载、失败和重试可见,附件入口遵循所选模型的图片能力。

模型控制位于追问输入框右下角,来源会话仍保留在背景:

![侧边追问的独立模型选择](images/reference-sidechat-model.png)

## 作为上下文

输入框的 `@` 入口分成协作对象、会话和目录三个页签。消息上下文保存所选正文的快照;会话引用固定在选择时的历史范围,正文按需读取;目录引用不会切换会话工作目录。引用和编号注释分别保存,可以一起发送。

「交给助手」先把所选回复带入助手草稿,用户补充要求后再发送。取消或发送失败保留草稿,不修改来源会话。

## 验证范围

`pasted-quote.test.ts`、`copy-quote.test.ts` 和 `context-references.test.ts` 检查转换与协议。浏览器用例 `quote-paste.spec.mjs`、`quote.spec.mjs`、`context-references.spec.mjs`、`message-actions.spec.mjs` 覆盖粘贴、追问、上下文与菜单。以上截图来自构建后的界面、隔离服务和测试 agent,不代表已部署到日常使用环境。用例使用相同边界;粘贴事件为合成事件,不代表实体手机系统剪贴板已经验证。

迁入来源:Calli `b456a10`、`80eb16e`,以及本机 SideChat 的模型偏好和目录加载修正,授权声明见 [第三方声明](../THIRD_PARTY_NOTICES.md)。
7 changes: 5 additions & 2 deletions apps/workbench/packages/daemon/src/adapters/acp.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@ import type { PlanQuota, QuotaWindow, WorkMode } from './types.js';
import { acpUsage } from './usage.js';
import { timedUsage, type LiveUsage } from './live-usage.js';
import type { UsageSample } from '../telemetry.js';
import { cliDiagnostic, probeWithDeadline } from './diagnostics.js';
import { agentLoginRequired, cliDiagnostic, probeWithDeadline } from './diagnostics.js';
import { isCompaction, trackCompaction } from './compaction.js';
import { sessionEnvironment } from './types.js';
import { spawn } from 'node:child_process';
import { existsSync } from 'node:fs';
import { tmpdir } from 'node:os';
import type { EmittedEvent } from '../events.js';
import { textOf, commandExists } from '../util.js';
import { JsonRpcPeer } from './jsonrpc.js';
import { JsonRpcPeer, RpcError } from './jsonrpc.js';
import type {
AgentAdapter,
AgentSession,
Expand Down Expand Up @@ -596,6 +596,9 @@ export abstract class AcpAdapter implements AgentAdapter {
if (refresh) this.modelProbe = null;
this.modelProbe ??= this.readModels().catch((err) => {
this.modelProbe = null;
// ACP's auth_required code is shared by Claude, TRAE and DeepSeek Harness.
// An explicitly unsupported subscription cannot be fixed by signing in again.
if (err instanceof RpcError && err.code === -32000 && err.data?.reason !== 'claude_subscription_not_supported') throw agentLoginRequired(this.label);
throw err;
});
return this.modelProbe;
Expand Down
Loading
Loading