开始使用
30 秒上手。下载、安装并启动你的第一个 AI 会话。
1. 下载并安装
从下载页面下载 PromptOps Manager，支持 macOS、Windows 和 Linux，安装程序自动完成全部配置，无需额外设置。
2. 登录或注册
创建账户或使用已有凭据登录。邮箱验证使用 6 位 OTP 码，你的设备将自动注册以保证安全。
3. 连接工作区
选择你的项目目录，PromptOps 自动检测结构、语言、配置文件和数据库连接，工作区与你的设备绑定。
4. 启动会话
选择 AI provider（Claude、Codex、Gemini、Antigravity、Copilot、Cursor、Grok、Hermes、OpenCode、PromptOps CLI——或一个普通 shell），输入 prompt，agent 即刻开始工作，内置 terminal 实时显示输出。
安装 provider CLI（可选）
PromptOps 驱动每个 provider 的官方 CLI。安装你想用的那个并登录——PromptOps 会自动检测。以 Claude Code 为例：
npm i -g @anthropic-ai/claude-code && claude login提示：使用 Claude Pro/Max 可获得完整体验——sub-agent、扩展思考和最大 100 万 token 上下文。
探索文档
会话
会话是 PromptOps Manager 的核心，每个会话都是独立环境，拥有自己的 AI provider、terminal 和上下文。
Sub-Agent
Sub-agent 是在主 agent 监督下并行工作的专属 AI agent。
AI Provider
PromptOps 支持 10 个 AI provider——外加一个普通 shell，各有其特点，可按会话或单个 sub-agent 切换。
Prompt Library
Prompt Library 是结构化的 prompt 管理系统，每个 prompt 都是版本化、可 fork 和可共享的资产。
内置 Git
PromptOps 在侧边栏集成了完整的 git 系统，无需离开应用即可管理版本控制。
Token 效率引擎
Token 优化系统实时减少消耗并追踪节省情况。
会话
会话是 PromptOps Manager 的核心，每个会话都是独立环境，拥有自己的 AI provider、terminal 和上下文。
创建会话
点击"新建会话"或使用快捷键，选择所需的 AI provider 和工作区，每个会话拥有独立的隔离 terminal 进程。
多个会话
你可以在同一工作区内同时运行多个会话，每个会话拥有独立的 terminal、上下文和状态，通过顶部 tab 栏在会话间切换。
生命周期
会话每 30 秒自动保存。崩溃或意外关闭后，下次启动时会话将自动恢复。你也可以为常用会话创建可复用模板。
会话历史
会话内的每个操作均被追踪：派生、prompt、输出、合并、错误。历史持久化保存于后端，以 git 风格时间线呈现。
Smart Context 注入
会话启动时，系统分析工作区并将项目地图（结构、入口点、近期文件）注入 agent 上下文。预计每会话节省 3 万至 10 万 token。
Sub-Agent
Sub-agent 是在主 agent 监督下并行工作的专属 AI agent。
可用角色
每个 sub-agent 都有带专属系统 prompt 的预定义角色：
- 安全审计——漏洞分析、安全代码审查
- 测试运行——单元测试和集成测试的生成与执行
- 代码评审——代码质量、最佳实践和可维护性审查
- 文档生成——生成和更新项目文档
- 重构——改善代码可读性和性能的结构优化
- 性能优化——瓶颈分析和性能调优
派生与管理
在快速 Agent 面板中一键派生 sub-agent，每个 sub-agent 获得独立 terminal、经过优化的上下文（包含 git diff 中实际修改的文件）以及精简的作用域指令。
Agent 间通信
Agent 通过 Agent Relay 自动相互通信。主 agent 修改文件，安全 agent 随即审查，测试 agent 更新测试。异步消息传递，带确认机制。
结果合并
每个 sub-agent 的结果汇总后呈现在主会话时间线中，你可以单独查看每个 sub-agent 的输出。
AI Provider
PromptOps 支持 10 个 AI provider——外加一个普通 shell，各有其特点，可按会话或单个 sub-agent 切换。
Claude Code
推荐集成最深。无限并行 sub-agent、扩展思考、最大 100 万 token 上下文。需要 Anthropic Pro 或 Max 计划，推荐体验。
OpenAI Codex
流式输出的多文件代码生成，支持 prompt library、会话追踪和持久历史。
Gemini CLI
大上下文代码库分析，支持会话管理、prompt 版本控制和团队共享。
Antigravity
新Google 的 agentic 平台，用于多步骤编排。直接派生 agy，支持会话追踪、并行 sub-agent 和共享 prompt library。
GitHub Copilot
行内补全与上下文建议，集成 PR 工作流和 terminal 命令生成。
Cursor CLI
将 AI 优先编辑器引入 PromptOps。托管会话、并行 sub-agent 和共享 prompt library，同时保留你熟悉的 Cursor 工作流。
Grok CLI
新xAI 的 Grok，搭载实时推理模型。支持托管会话、并行 sub-agent 和共享 prompt library。
Hermes
新Nous Research 的自主 agent。自带模型（Nous、OpenRouter、OpenAI、Anthropic），无锁定——支持托管会话和共享 prompt library。
OpenCode
免费开源、本地优先的编程 CLI，直接派生 opencode 命令，支持会话追踪、prompt library 和物化项目上下文。
PromptOps CLI
免费免费、内置的编程 agent，由本地或免费 LLM 驱动。无需 Anthropic 密钥，零外部依赖。
Shell / 自定义 CLI
任意 CLI 工具均可作为 provider，支持自定义脚本、自动化和带集成日志的完整 terminal 访问。
如需切换 provider，打开会话设置并选择目标 provider，切换即时生效，不会中断当前会话。
Prompt Library
Prompt Library 是结构化的 prompt 管理系统，每个 prompt 都是版本化、可 fork 和可共享的资产。
创建 prompt
创建包含标题、内容、分类和标签的新 prompt，使用 {{variable}} 语法添加动态变量，使 prompt 可在任何项目中复用。
版本控制
对 prompt 的每次修改都会创建新版本，可通过 diff 查看器对比版本，随时恢复历史版本。
Fork 与共享
Fork 同事的 prompt 进行自定义，衍生链自动追踪。你可以将 prompt 共享给团队——变更请求经过类似 pull request 的审批流程。
AI 生成器
从任务描述生成结构化 prompt，自动创建标题、内容、变量和模板。
内置 Git
PromptOps 在侧边栏集成了完整的 git 系统，无需离开应用即可管理版本控制。
支持的操作
Stage、unstage、commit、diff、pull、push、stash、branch——所有基础 git 操作均可在 UI 中完成。Git Explorer 显示带实时状态的文件树。
AI Commit 与 Branch
系统分析已暂存文件、会话上下文和关联任务，以 Conventional Commits 格式生成 commit 信息。Branch 名称根据任务上下文自动生成。
Diff 查看器
带语法高亮的文件和 commit 差异查看，直接在会话中并排对比版本。
冲突解决
发生合并冲突时，AI 根据项目上下文提供最合适的解决方案建议。
数据库浏览器
数据库浏览器自动从项目检测连接，允许以只读方式浏览数据。
自动连接
PromptOps 通过分析项目配置文件自动检测数据库连接，支持所有主流关系型数据库。
数据浏览
浏览表、过滤排序数据、检查 schema。所有操作均为只读，防止意外修改数据。
Schema 检查器
查看表结构：列、类型、主键和关系。在 AI agent 处理数据库任务时，这对提供上下文信息非常有用。
Voice Control
无需触碰键盘，直接向 AI agent 发送语音指令。
工作原理
按下麦克风按钮（或专属快捷键）后说话，macOS 原生语音转文字系统将你的指令转写为 prompt 发送给 agent。目前仅支持 macOS。
使用技巧
请清晰、简洁地说话，系统在直接指令下效果最佳。你也可以口述复杂 prompt，转写系统会自动处理标点和格式。
团队协作
PromptOps Manager 支持团队级协作，包含角色、权限和结构化共享。
创建团队
在团队面板中创建团队，通过邮件邀请成员——邀请状态有追踪（待确认、已接受、已拒绝）。每个成员拥有一个角色：owner、admin 或 member。
角色与权限
Owner：完全控制，管理成员和设置。Admin：管理会话、prompt 和文档。Member：访问共享 prompt 和团队会话。
共享
Prompt、会话和文档可在团队层面共享，团队 lead 可查看组织内所有开发时间线和工作流。
文档与笔记
创建关联到会话、文件或任务的上下文笔记和文档，文档按分类标注，支持全文搜索，可跨项目复用。
Token 效率引擎
Token 优化系统实时减少消耗并追踪节省情况。
Smart Context 注入
会话启动时注入项目地图（结构、入口点、近期文件），agent 立即知道从何处着手，无需盲目探索。每会话节省 3 万至 10 万 token。
Sub-Agent Prompt 优化
Sub-agent prompt 注入实际修改的文件（来自 git diff）和精简的作用域指令，agent 阅读 5 个目标文件而非探索 30 个，每个 sub-agent 节省 5 万至 7 万 token。
文件读取缓存
追踪每次文件读取并记录 MD5 内容哈希，检测并标记冗余重复读取（内容未变的文件）。
仪表盘
仪表盘显示：总 token 用量、节省的 token、平均效率和按节省量排名的会话。数据聚合自所有会话，持久化保存于数据库。
优化标志
每个会话显示当前激活的优化项（Smart Context、Cache、Graph、Tool Filtering、Local Execution），并说明每项如何贡献节省。
Docker 与集成
PromptOps 与 Docker 及你开发栈中的其他工具集成。
Docker 状态
直接在应用内监控项目 Docker 容器，查看状态和元数据，无需切换上下文。监控功能内置于工作区面板。
Hook 与自动化
在会话事件上配置 hook：on_start、on_prompt、on_commit、on_end，每个 hook 运行一条 shell 命令，流水线可在团队层面共享。
代码编辑器
无需离开会话即可打开、编辑和保存文件，内置编辑器支持语法高亮和自动语言检测。
项目与工作区
工作区将本地目录与远程项目关联，跨多台设备保持一致性。
工作区
每个工作区将本地目录与远程工作区关联，系统使用设备硬件 ID 进行同步——你可以从不同机器处理同一项目。
项目
项目将工作区、会话、prompt 和文档整合在一起，每个项目拥有独立的成员、角色和权限，会话自动限定于当前活跃项目。
Sprint 看板
集成 Kanban 看板，支持 sprint（开始/结束日期、速度追踪），任务遵循状态机：backlog、in_progress、review、done。任务与会话为多对多关系，追踪哪些 AI 会话处理了哪些任务。
系统要求
运行 PromptOps Manager Desktop 的最低配置要求。
macOS：macOS 12 Monterey 或更高版本，Intel 或 Apple Silicon 芯片，最低 4 GB 内存。
Windows：Windows 10（64 位）或更高版本，最低 4 GB 内存。
Linux：Ubuntu 20.04+、Fedora 36+ 或同等发行版，最低 4 GB 内存。
AI provider 方面：需要所选 provider 的有效账户（Anthropic、OpenAI、Google、GitHub、xAI、Nous Research）。OpenCode 和 PromptOps CLI 在本地运行，无需 API 密钥。
需要网络连接以与 AI provider 通信和进行后端同步。
