Skip to content

LoopX 个人工作区控制台（Personal Workspace Console）使用指南

LoopX 控制台是为工程师与 Agent 深度协作打造的统一本地工作台。它将分散在不同会话、话题与后台运行中的 Agent 任务统一汇聚，提供「LoopX 管家全局总览」、「Goal 4 列任务看板」、「轻量悬浮会话托盘」、「先预览后确认安全门禁」与「Lark / 飞书话题直连」。

🎬 30 秒产品发布演示视频

💡 视频高光：终端一键启动 ➔ 管家 4 泳道任务流 ➔ 快捷指令浮动托盘 ➔ 4 列看板与智能「转为 Task」清洗 ➔ 飞书话题直连 ➔ Brutal 野兽派主题切换。

🚀 1. 快速启动与访问

在本地仓库或已安装 LoopX 的终端中执行：

# 启动本地 Dashboard 控制台（默认自动打开浏览器）
loopx dashboard

安装版会在同一个进程中启动打包后的工作区、状态投影和 Agent Chat，不需要另开 终端运行 loopx serve-status。命令默认自动打开浏览器；无界面启动可使用 loopx dashboard --no-open，并访问命令实际打印的 URL。默认地址为 http://127.0.0.1:8767/chat/。

可用下面两条命令验证页面和状态投影都来自同一个进程：

curl -fsS http://127.0.0.1:8767/chat/ >/dev/null
curl -fsS http://127.0.0.1:8767/status.json

💡 两种入口可共存：loopx dashboard（浏览器 / PWA）与 Tauri 原生桌面壳 都会复用已经在运行且版本匹配的 LoopX Chat 服务。先开 dashboard 再开桌面壳， 或先开桌面壳再执行 loopx dashboard，两种顺序都可以；当桌面壳已经启动时， 也可以直接访问 http://127.0.0.1:8767/chat/ 使用浏览器 / PWA，无需再启动一套 服务。

🧭 2. 控制台核心架构

graph TD
    A["LoopX 控制台"] --> B["LoopX 管家模式 (全局总览)"]
    A --> C["Goal 频道模式 (单一目标深度)"]

    B --> B1["你不在的时候 (离线统计)"]
    B --> B2["4 泳道任务流 (需要你 / 执行中 / 观察中 / 已安排)"]
    B --> B3["全局快捷问询与创建 Goal"]

    C --> C1["Tasks 4 列看板"]
    C --> C2["Chat 完整对话流"]
    C --> C3["Files 产出交付物"]
    C --> C4["Context 诊断抽屉 (仓绑定 / Lark 状态)"]

🏠 3.「LoopX 管家」全局总览模式

点击左侧侧边栏顶部的 「LoopX 管家」，进入全局总览模式。

LoopX 管家总览与 4 泳道流

核心功能区

  1. 「你不在的时候」离线概览：
  2. 聚合展示你离开期间所有 Agent 的运行结果：已完成 数量、异常/失败 数量以及当前 等你确认 的阻塞项。
  3. 4 泳道全局任务流（Swimlanes）：
  4. 🛑 需要你（Needs You）：高亮展示当前所有正等待你审批、确认或提供输入的问题（如权限审批、环境授权）；
  5. ⚡ 执行中（In Progress）：展示当前正在被自主推进的 Agent Todo 与 Goal；
  6. 👀 观察中（Observing）：展示正在运行的持续监控与定时巡检任务；
  7. 📅 已安排（Scheduled）：展示挂起的周期性计划。
  8. 全局快捷指令（Quick Prompts）：
  9. [询问全局待办 (草稿)]：一键将「有哪些 Goal 正在等我？优先处理什么？」填入输入框；
  10. [汇总所有 Goal 进展 (立即发送)]：带有蓝色高亮标识，点击后立即发送并在右下角弹出托盘展示全局总结；
  11. [创建新 Goal (草稿)]：快速填入目标模板草稿。

问答中的等待与失败

Codex 上游声明仍会重试时，会话显示「Codex 正在重试」并继续等待最终结果。若上游明确终止，LoopX 保存失败回执，不把已经出现的部分文字当成完整回答。明确的策略拦截、用量限制、频率限制、上下文超限和身份验证失败会保留各自类别；未知错误仍显示通用失败，不从报错正文猜测原因。

策略拦截是本轮已结束，不是仍在安全检查中。LoopX 不会自动重放该请求；重启或重复提交同一个请求编号也会返回原失败回执。界面提示只说明上游给出的类别，不解释其未提供的具体触发原因，也不公开上游原始错误详情。

3.1 停止暂时不活跃的 Goal

当 Goal 较多时，主列表只展示仍处于 active 状态的 Goal。点击 Goal 右侧的暂停按钮后，LoopX 会先展示 Typed Action 预览；只有你明确确认，Goal 才会进入 「已停止」 折叠区。

  • 停止会暂停该 Goal 的自动 Agent Turn，并从「需要你」等活跃聚合中移除；
  • 退出 active attention 后，该 Goal 的有效 quota 会投影为 0，调度器据此停止 Codex App heartbeat 等宿主自动化；原 quota 配置仍被保留；
  • Goal 的 Todo、历史、证据和配置全部保留，不会被标记成「已完成」，也不会删除；
  • 展开「已停止」，点击恢复按钮并确认，即可重新获得调度资格；恢复后仍需通过 quota、Gate 和 Todo 约束。

stop 与手动设置 quota.compute=0 共用同一条自动停机通道，但恢复权限不同：前者只能由显式 Goal resume 恢复，后者由显式提高 compute quota 恢复。这样 quota 操作不会意外复活一个被 owner 停止的 Goal。

该操作不会强杀正在执行的工具调用；下一次 quota should-run 会返回宿主停机指令，由 Codex App 等宿主暂停或删除当前 heartbeat，阻止后续自动 Turn。

CLI 提供同一套可预览、可验证的生命周期操作：

# 零写入预览
loopx goal-lifecycle --goal-id <goal-id> --operation stop

# 确认执行，再读取 quota 验证自动推进已暂停
loopx goal-lifecycle --goal-id <goal-id> --operation stop --execute
loopx quota status --goal-id <goal-id>

# 恢复；不会绕过其他运行门禁
loopx goal-lifecycle --goal-id <goal-id> --operation resume --execute

执行时，LoopX 会写入权威 source registry、同步全局 registry，并验证两端 readback；任一端未验证成功时不会宣称操作完成。

切换到 SSH 状态来源后，只有来源与本机 OpenSSH 配置中的精确 Host alias 绑定时， 侧边栏才显示停止/恢复按钮。操作通过 SSH 在目标主机执行同一个 goal-lifecycle typed contract，并验证远端投影；不会回退修改本机同名 Goal。 手工 URL 以及创建、删除、Todo、会话等其他远端操作继续保持只读。

🎯 4. Goal 深度工作区

在侧边栏点击具体的 Goal（例如 Apollo Spacecraft Telemetry Pipeline），进入该 Goal 的独立工作台。

4.1 Tasks 列表与看板视图

Goal Tasks 4 列看板

  • 默认显示四列看板；可切换到分组列表，列表中空分组隐藏、已完成分组默认折叠。
  • 看板与列表共享已完成历史（包含归档，排除持续监控任务），按工作 Agent 筛选。列表的已完成组默认折叠；展开并滚动可按需加载，每页 40 条，使用五分钟快照保持翻页稳定。两种视图均只渲染可见区域附近的记录，切换视图保留历史和总数。快照过期可重试，读取失败保留当前记录。只读远端来源不调用本机历史接口。本机历史详情保留 Todo 读取层返回的文本、路径和证据，不额外截断或替换路径；Markdown 读取层原有的 500 字符规范化上限仍适用。
  • 初次连接先显示加载状态，不把示例任务当作实时数据。执行会话连接失败时显示重连提示并退避轮询，隐藏页面暂停新的会话查询。

  • Files 的“前往会话”进入 Goal 会话；“导出摘要”导出安全摘要 Markdown，不下载原始文件。

  • 分组含义：

  • 待确认（Attention Required）：需用户决策或授权的卡片（黄色/红色标红，显示等待时间）；
  • 待执行 / 进行中（In Progress）：按 P0 / P1 优先级排列的 Agent 待办事项；
  • 定时与持续（Scheduled & Continuous）：绑定的周期性检查与监控；

  • 已完成（Completed）：已标记完成的工作任务；摘要总数与当前可查询明细的范围分别展示。

  • 💬 对话建议一键「转为 Task」：

  • 看板顶部横幅会展示 Agent 最新的进度报告与下一步建议；
  • 点击 [转为 Task] 按钮，系统会自动清洗掉无关客套文案，将核心行动项智能转换为结构化草稿回填到底部输入框，供你确认后创建！

点击「转为 Task」草稿提取并回填

4.2 Goal 概览与交付依据 / Goal overview

Goal 顶部直接提供 概览、任务、对话、成果，分别用于判断进展、推进工作、 与 Agent 沟通和查看产出。选择一个 Goal 后仍默认进入四列任务看板； 看板与列表保持原有任务范围。切换页面后，任务筛选、已加载历史和各页滚动位置保留。 右上角设置直接打开既有能力配置；返回后保留工作区。切换 Goal 或数据源则重新建立页面上下文。

点击一次 概览，即可查看当前进展、需要处理的决定、执行记录和用量。 决定与执行记录直接打开原有详情；「查看任务」「查看成果」前往对应页面。 低频仓库、连接和运行信息保留在「Goal 信息」中，不再充当查看进展的必经路径。

交付与依据：概览直接展示当前交付链、责任、关联关系和验收观察， 不需要额外打开复盘弹窗。可按标题、负责人或引用搜索，选择节点沿关系追溯， 并打开当前工作区中的任务、决定或执行记录。桌面支持关系图，手机默认列表。

范围与刷新：交付链覆盖当前选中工作及有限前序，不是完整 Goal 依赖图。 缺失前序、来源裁剪与未展开决定可展开查看；任务完成或缺口列表为空都不代表通过验收。 仅进入概览或点击「刷新快照」时读取交付链；离开概览取消未完成请求， 不增加普通状态读取的图计算。状态变化后旧快照的来源跳转和导出暂停，刷新后继续。 读取失败保留其他概览内容并显示重试提示，不将失败视为工作已完成。

导出：「导出交付快照」下载包含读取时间、完整当前链、关系、证据引用和验收观察的 Markdown。搜索筛选不会裁剪导出；不包含原始日志、文件正文或对话正文。 成果与报告继续由成果页统一展示，不在概览建立第二份成果清单。

显式验收合同：若本地所有者已为使用 canonical authority 的 Goal 启用合同， 交付链下方可展开「Goal 验收合同」，查看条件、任务关联与独立的产物检查结果。 「任务关联已确认」不等于「产物检查通过」，后者也不自动批准或完成 Goal。 缺失、停用保持原界面；旧检查显示其原版本，刷新失败不会作为最新结果导出。 配置入口是本地所有者 CLI：先 loopx goal-acceptance inspect --goal-id example-goal， 再按配置与回滚指南（v0） 使用 configure --document --expected-provider-revision、verify 或 disable； 变更与执行检查需要 --execute。不新增网页配置入口，不自动提升 provider。

边界：原有交付链观察无需模型调用或新配置。远端只读来源可查看同步的概览和验收观察， 不回退查询本机同名 Goal 的交付链。所有阅读、筛选与导出均不改变任务、租约、预算或 审批；来源操作仍使用既有预览和权限检查。本次没有状态迁移，回滚沿用原安装流程。

English: Use the direct Overview / Tasks / Chat / Files navigation. Goal selection still opens Tasks. Switching views or returning from settings retains task filters, loaded history and scroll; a different Goal or source starts a new view session. Settings opens the existing capability editor directly.

Overview brings progress, pending decisions, execution and usage into one page. Its delivery section reads the bounded current chain and acceptance observations on entry or explicit refresh, with search, map/list layouts, source navigation and Markdown export. Leaving Overview aborts pending reads. Export retains the entire validated delivery snapshot regardless of filtering, excluding raw logs and conversation/file bodies. Outputs remain in Files. Missing observations never certify acceptance. Remote sources show their synchronized observations without querying the local delivery API. The baseline delivery-chain read requires no model call or configuration and adds no write authority or migration.

When a local owner explicitly enables an acceptance contract on an already canonical Goal, expand Goal acceptance contract below the delivery chain. It separates confirmed task associations from artifact checks and shows both the current contract basis and recorded verification basis. Neither approves or completes the Goal. Missing or disabled contracts preserve the baseline view. Start with loopx goal-acceptance inspect --goal-id example-goal; the owner guide (v0) covers exact configure, verify and disable commands. Authoring stays in the explicit local-owner CLI; it does not automatically promote a provider or add a web configuration surface. Refresh the snapshot after a CLI operation.

CLI readback uses the same existing owners:

loopx --format json status --goal-id example-goal --include-task-graph
loopx --format json review-packet --goal-id example-goal

The local Chat HTTP read is GET /api/chat/delivery-review?goal_id=example-goal. Lark continues using its existing Goal Channel projection; this slice adds no Lark card or notification and does not qualify cross-channel presentation parity.

💬 5. 悬浮会话托盘（ManagerConversationTray）

无论你在浏览总览还是在处理看板，只要点击带有 立即发送 标识的快捷指令，页面右下角都会弹出抽屉式的轻量对话托盘：

轻量悬浮会话托盘

  • 非侵入式体验：托盘浮出时不会打乱或覆盖主看板的浏览位置；
  • 即时交互：阅读完毕后点击托盘右上角的 [×] 即可随手收起。

🔍 6. Goal 诊断与 Lark / 飞书话题连接抽屉

进入 概览，点击 Goal 信息，可从右侧滑出元数据诊断抽屉：

Goal 诊断与 Lark 连接状态抽屉

  • 执行健康度：展示 Session ID、是否可继续以及当前 Agent 状态；
  • 代码仓只读绑定：明确展示当前绑定的 GitHub / 本地仓库、生效分支及只读隔离属性；
  • 自适应子代理执行：按 Goal 展示当前开关、可选的 task_domain 限制与最多子代理数；
  • Lark / 飞书话题连接：
  • 展示当前绑定的飞书群组与 Topic 话题；
  • Capture scope：可选择只接收明确 @ / 回复 App 的消息，或接收该 Goal Topic 的全部消息；这只改变捕获范围，不扩大 Agent 权限；
  • Agent ingress：为 Goal 当前已注册的目标 Agent 选择一种明确的收信方式：
    • Steering (live_steering)：投递到该 Agent 当前精确的活跃 Turn；没有匹配的 活跃 Turn、Session 已过期或运行时不支持原生 steering 时安全拒绝；
    • Queuing (session_queue)：写入同一精确 Agent Session 的有界 FIFO，当前 Turn 完成后按顺序处理，并支持重启恢复；
    • Async inbox (async_inbox)：写入该 Agent 的本地私有收件箱，等待后续显式 lark-inbox drain；投递本身不会创建内联 Session，也不会提前回复或 ACK；
  • Reply mode：回复仍限定在来源 Topic 内，避免跨群或跨 Goal 投递。

6.1 按 Goal 体验自适应子代理执行

该控制面默认不对外暴露。先在 Goal 所在主机上显式启动带权威 opt-in 的本地 Dashboard；不带此参数启动时，配置 API、状态字段和界面卡片都会保持缺失：

loopx dashboard --enable-goal-subagent-configuration

然后要为一个 Goal 开启运行时能力：

  1. 进入该 Goal 的 概览，点击 Goal 信息；
  2. 在「自适应子代理执行」中选择最多子代理数。任务领域限制是可选项：全部不选表示 不按领域过滤；需要进一步收窄时，再从当前 Goal 开放 advancement Todo 已声明的 task_domain 中多选。每个选项会显示当前匹配的开放 Todo 数量。控制台优先读取 完整 Todo index，压缩的 Goal 卡片 Todo 仅作兼容回退；
  3. 点击开关。此时只生成零写入预览；检查领域限制与并发上限后，再点击「确认」；
  4. 界面只有在 source registry 写入、共享 registry 同步和读回校验都成功后，才把 开关显示为「开启」。

可在终端读取同一权威配置和运行时决策：

loopx configure-goal --goal-id <goal-id>
loopx quota should-run --goal-id <goal-id>

要撤销 Dashboard 配置面的 opt-in，停止当前 Dashboard 后不带 --enable-goal-subagent-configuration 重新启动。这个启动参数只暴露本机 loopback 上的 preview-locked 配置合同，不授予 Agent 新的 Goal、仓库、凭证、发布或生产权限。

关闭时再次点击开关、检查预览并确认；也可以使用同一配置入口：

loopx configure-goal \
  --goal-id <goal-id> \
  --multi-subagent-feature off \
  --execute

如果当前没有开放 advancement Todo 声明 task_domain，界面会显示说明性空状态， 但不会阻止开启。此时只是不增加领域过滤，Todo 仍必须通过状态、依赖、quota、能力、 仓库、写入范围和冲突检查。选择了一个或多个领域后，未声明或不匹配领域的 Todo 会被 拒绝。控制台不会从 Todo 文本猜测领域，也不会提供与真实 Todo 无关的固定候选列表； 已保存但当前匹配数为 0 的领域仍会显示，方便审阅或移除既有边界。

这个开关只给运行时增加有界的临时子代理容量，不会强制并行，不会创建持久 Agent 层级，也不会绕过 Todo 归属、quota、能力、Gate 或写入范围。SSH 状态来源保持只读， 必须在 Goal 所在主机上修改。所选 allowed_domains 会进入 Goal 配置，不要填写凭证、 客户名或其他私密信息。完整执行语义见 Codex sub-agent orchestration。

在「通知设置 → Lark / 飞书 → Connections」中选择 Goal、Target Agent、群聊、 Capture scope 与 Agent ingress，保存后可在同一页读回当前模式、Session 绑定状态、 监听状态和最近事件结果。Steering 与 Queuing 要求该 Goal / Agent 已有工作 Session； Async inbox 不要求活跃 Turn，适合后台 Agent 稍后处理。发送一条新的 @ 消息验证所选 模式；若选择 Async inbox，可用以下命令读回待处理事件：

loopx lark-inbox drain --goal-id <goal-id> --agent-id <agent-id>

要停用该 Goal 的话题入站，在 Connections 中选择 Disconnect。断开只移除这个 Goal 的 Topic 路由，不删除 Goal、Agent Session、历史 Todo 或其他 Goal 的连接。

🎨 7. 双主题切换（温和 Paper ⇄ 硬朗 Brutal）

点击右上角的主题切换按钮，即可在两种主题间无缝流转：

  • 默认温和纸质主题 (Paper)：适合日常长时间工作，低饱和度护眼；
  • 野兽派主题 (Brutal)：粗黑边框、硬阴影、高对比亮黄与极客风格。

野兽派 Brutal 主题

🛡️ 8. 安全与不可逆操作保护

LoopX 控制台严格遵循 Human-in-the-Loop（人类介入）安全模型： 1. 先预览，后确认：任何会写入 Goal 状态、修改配置或执行外部变更的指令，都会先在界面弹出 Typed Action 预览卡片，明确展示影响范围与待填参数； 2. 用户点击确认后才下发：杜绝 Agent 自行执行未授权的高危操作； 3. 操作回执（Receipt）：每次操作执行完毕均会生成不可篡改的带时间戳回执，随时可溯源。