从第一步，到你的工作方式。
从工作台、Agent 到多设备与语音，按你要完成的事找到说明。产品设计中的关键原则也整理在这里，方便直接阅读。
开始了解 Bruce
从一个想法，到可以审查的成果。
Bruce / 布鲁斯把专业开发工作台、Agent 管理和多设备协作放在一起。你可以自己编辑，也可以把目标交给 Agent，持续查看执行、回答问题，并在审查改动后确认结果。
正式安装包和 IDE 插件的公开获取方式正在准备中，将在本站发布入口统一说明。这里先介绍产品能力、使用方式和平台范围；拿到可用版本后，再按对应版本说明完成安装和连接。
- 选择项目，向 Agent 说明目标、边界和验收标准。
- 在会话、工具记录和真实终端中查看进展，需要时补充指令。
- 结合 Git 差异与测试结果验证交付，保留重要决定和项目经验。
> Bruce 产品定位与工作原则: 基础能力要扎实；任务、角色和工作流由用户与项目定义。
工作台、布局与键位
保留专业 IDE 的习惯，也保留自己的工作空间。
Bruce 以 IDEA 风格为当前交互标尺：外层标题栏、活动条和状态栏形成连续底板，编辑器和工具窗口作为内容岛放在其上。面板之间的空间用于分隔与调整布局，让文件、Git、Agent、运行与终端各有位置。
可以按任务调整工具窗口的位置与大小，选择浅色、深色或跟随系统，并使用和调整熟悉的键位。当前文件、编辑选区、Git 状态与终端输出，也能成为 Agent 理解任务的上下文。
- 在文件树和多标签编辑器里阅读与修改项目。
- 按需要展开 Git、Run、Terminal 和 Agent 工具窗口。
- 在保持工作习惯的同时，把更多重复执行交给 Agent。
> 工作台内容岛设计: 工具窗口与编辑器是连续底板上的内容岛；布局服务于工作，而不替项目固定工作流。
Git 与代码审查
从本地更改，到分支、历史与合并。
Git 是 Bruce 的核心工作台。我们按 IDEA 的实际交互持续打磨本地更改、暂存与提交、提交历史和分支图，并把 Diff、三方合并、操作反馈和 Console 连成完整的审查过程。
面对 Agent 生成的代码，先看文件与差异，再检查测试和运行结果。需要调整时，可以把具体改动和问题带回会话；分支操作与提交结果仍由真实 Git 执行。
- 查看本地更改、暂存范围、提交内容与文件历史。
- 使用分支、Fetch / Pull / Push、Rebase、Cherry-pick、Stash 和 Shelf 等工具。
- 通过双栏差异与三方合并理解和解决冲突，按实际版本支持范围使用各项操作。
> Git 交互对标原则: 以专业 Git 工作流的界面与语义为标尺，让人能认真验证每一次改动。
Agent、原生会话与终端
理解原生会话，让执行过程清楚可读。
Bruce 组织不同 Agent 的会话，也能发现支持来源中从外部终端启动的会话。消息、公开的思考摘要、工具参数与结果、问题和执行状态，会根据来源协议整理为可读视图。
真实终端仍然保留。PTY、终端屏幕和 ANSI/TUI 解析让原生命令可以继续交互；恢复会话、排队输入、模型、思考强度和权限的控制，依赖对应 Agent 与适配器实际支持的能力。
- 按项目和会话管理上下文，查看正在进行和需要你处理的事项。
- 在支持的会话中追加指令、回答原生问题或停止执行。
- 使用各 Agent 已有的账号或模型配置，具体订阅由对应服务提供方管理。
> 原生会话适配原则: 保留原生消息、工具与结束状态的语义；未知或不完整的结果不能冒充成功。
工作组设备与手机协作
多个项目和设备，共同进入一个视野。
连接自己的 Mac、Windows 工作站或 Linux 主机后，可以从手机查看各设备的任务与会话，进入相应项目，继续处理消息、文件、Git 和终端。局域网优先直连，离开局域网后通过配置的中继连接。
iOS、Android 和 HarmonyOS NEXT 都有原生客户端。高级能力按客户端和主机支持范围提供：iOS 有锁屏实时活动、配置后的推送，以及支持主机上的屏幕查看与控制。电脑需要保持唤醒、开机并联网。
- 扫码或通过账号连接设备，再选择需要处理的项目或会话。
- 用状态和待处理事项了解哪台电脑需要你，无需一直守在终端前。
- 屏幕与输入控制需要主机支持和系统授权；电脑离线时如实显示离线。
> 设备互联与会话归属设计: 设备之间保持清楚的连接关系；每个项目和会话都属于明确的主机。
独立服务、无头与浏览器
界面可以离开，执行与状态仍由主机持有。
Bruce 的 Agent 主机拥有任务、终端、文件、会话和工具执行。它可以独立于桌面窗口运行，供手机和其他受支持客户端连接，适合长期在线的开发机或无头主机。
浏览器客户端通过独立前端连接同一主机。自动注册系统后台服务目前主要在 macOS 提供；先装服务、按需下载 UI 和独立更新等渐进分发体验，仍属于产品演进方向。
- 选择合适的主机部署方式，确保设备在线与客户端连接可用。
- 关闭客户端界面不应被理解为暂停远端任务，具体行为以运行模式为准。
- 当前公开安装入口准备中，正式部署步骤将随可用版本提供。
> 服务与客户端的职责划分: 服务持有行为和状态，客户端说明消息属于哪个项目、会话和设备。
JetBrains 与 VS Code 接入插件
继续使用原有 IDE，连接其中的 Agent 会话。
Bruce 有面向 JetBrains 和 VS Code 系编辑器的接入插件。它们重点连接 IDE 内终端中的 Agent 会话，让来自手机或 Bruce 的消息继续进入原来的对话，而不另起一份无关会话。
JetBrains 插件按适配的 IDE 版本提供，覆盖支持的 IDEA、WebStorm 等环境；VS Code 的接入也面向 Cursor 等兼容编辑器。插件获取与安装方式将随公开版本提供，具体能力取决于 IDE、终端和 Agent 的适配。
- 保留已有的编辑、调试、项目设置和原生终端习惯。
- 在支持的终端会话中定位原对话、发送消息及处理选择提示。
- 未来可选 VS Code / Cursor 风格的 Bruce 主 UI，是另一项后续考虑的界面选择。
> IDE 接入插件设计: 连接用户已在 IDE 中运行的进程，让消息回到同一段原生会话。
应用内语音与 AI 整理
原话、改口和最后的意图，都有位置。
桌面和 iOS 的应用内语音可以直接在对话里录入，不必切换到外置语音输入法或其他 App。语音服务需要按版本要求配置；Android 与 HarmonyOS 目前以系统听写为基础。
iOS 可以在一段话说完后整理任务或聊天内容：去掉口头语和重复，应用后来的纠正，并保留原话供核对。发送时使用你确认的内容，再由 Agent 结合会话和项目上下文理解任务。
- 自然补充与改口，整理稿关注最后确认的意图。
- 整理稿与原话可以切换，发送前仍由你决定。
- 首次使用遵循系统麦克风授权；具体转写与整理范围以客户端支持为准。
> 应用内 AI 语音输入设计: 保留最终意图，不增加说话人未表达的内容；不确定时保留原话。
额度、Token 与成本
看清已经用掉什么，以及何时恢复。
支持的 Agent 来源可以提供订阅窗口、剩余额度与恢复时间；按量付费、余额和订阅窗口会按实际计费信息区分。没有可用数据时，界面不编造额度。
会话用量还包含 Token、上下文与缓存信息。有模型报价时可进行成本估算，估计值与服务商实际账单可能不同。容量预测和按空闲额度自动分配工作，仍是进一步的产品方向。
- 结合剩余额度与恢复时间安排下一段工作。
- 查看会话上下文和缓存，理解一次任务的消耗。
- 模型服务和 CLI 订阅由各提供方计费，Bruce 相关服务以正式发布信息为准。
> 用量与额度呈现原则: 额度读数与会话 Token 账分开；缺少报价时不把未知费用显示成零。
Skills、MCP 与项目规范
工具提供基础能力，项目决定怎么工作。
Bruce 可加载 Skills 和项目约定，连接 MCP 工具，并通过插件提供工具、事件和面板。也能向外部 Agent 暴露支持的项目状态、任务和记忆能力。
角色、流程、模型与工具由用户或项目配置。会话默认在项目目录中工作，需要隔离并行任务时再选择工作树。更广泛的插件能力以实际版本支持为准。
- 用 AGENTS.md 等项目约定表达开发规则，用 SKILL.md 组织可复用能力。
- 按项目选择 MCP、插件和模型来源，保留适合团队的工作方式。
- 按需要启用工作树隔离，而不强制采用固定的角色与流程。
> 通用基础能力的产品原则: 底层能力做扎实；任务、角色和工作流交给配置。
项目记忆、时间线与创作
从做成一件事，到讲清它的价值。
项目的决定、踩坑与里程碑可以留下来，供后续会话检索。结合项目记忆、任务与 Git 历史，Bruce 可以帮助回顾时间线、梳理进展并形成开发日记、博客、发版说明和分享草稿。
创作内容以已有项目证据为基础，不凭空生成发生过的日期和结果。更丰富的素材时间轴与视频等创作能力会继续演进，公开分享和发布由你决定。
- 回顾一段时间的产出、决定、问题与下一步。
- 把版本改进整理成可读的更新说明，或把一次踩坑写成博客草稿。
- 让独立开发者、OPC 和团队复用项目经验，减少重复整理。
> 项目记忆与创作提示设计: 先检索任务、记忆与版本记录，再写具体、诚实的草稿。
产品方向与界面选择
保留习惯，向持续推进的项目伙伴演进。
当前工作台以 IDEA 风格持续打磨。后续考虑提供可选的 VS Code / Cursor 风格编辑器主 UI，尽量保留原有开发习惯，降低迁移与学习成本。
进一步的方向包括：一句话准备环境、安装和配置 Agent；预测可用容量并调度空闲额度；渐进安装与独立 UI 更新；更完整地沉淀项目创作素材。这些方向会按具体版本逐步交付。
- 现有 IDE 接入插件已有自己的能力范围，未来主 UI 风格选择单独演进。
- 自动化围绕项目规则、可用资源和明确的任务边界组织。
- 以正式发布说明确认某项能力是否已经可用。
> Bruce 产品演进思考: 让人更好地表达目标、判断结果，把重复执行交给可理解、可管理的工具。