Persistproc

🚀 persistproc

persistproc 是一個用於多智能體開發工作流的共享進程層工具，它能讓智能體和人類查看並控制像 Web 服務器這樣的長時間運行的進程，減少編碼時的複製粘貼操作，便於使用多個智能體，且與具體工具無關。

完整文檔：steveasleep.com/persistproc。

🚀 快速開始

1. 安裝 persistproc

pip install persistproc

2. 啟動服務器並配置智能體

在一個專用終端中運行以下命令並保持其運行：

persistproc serve

persistproc serve 輸出的第一部分是針對各種智能體的配置說明，如果還未配置，請按照這些說明操作。

3. 啟動進程

在另一個終端中，切換到項目目錄並通過 persistproc 運行命令：

# 示例：啟動一個 Node.js 開發服務器
cd /path/to/your/project
persistproc npm run dev

該命令會被髮送到服務器，其輸出會流式傳輸到你的終端。你可以安全地關閉此終端，進程將繼續運行。

💡 使用建議

你也可以直接要求你的智能體“使用 persistproc 運行開發服務器”，它可能會通過查看你的 package.json 文件找到正確的命令並使用 persistproc 運行它。

通過以上步驟，你的智能體現在可以使用可用的工具來管理你的開發環境。

✨ 主要特性

多智能體協作

persistproc 允許智能體和人類共同查看和控制長時間運行的進程，減少了編碼過程中複製粘貼錯誤信息的繁瑣操作，提高了與 AI 協作編碼的效率。

運行時管理

無需配置文件，進程完全在運行時進行管理，這與 supervisord 不同。

工具無關性

persistproc 是工具無關的，不依賴特定的開發工具或 IDE。

標準協議支持

persistproc 公開了一個標準的 Model Context Protocol (MCP) 服務器，可使用任何兼容 MCP 的客戶端以編程方式與之交互。

📦 安裝指南

使用 pip 安裝 persistproc：

pip install persistproc

💻 使用示例

基礎用法：基礎 Web 開發

假設你正在開發一個待辦事項列表應用，通常使用 npm run dev 啟動開發服務器。這個服務器會監視代碼更改、進行類型檢查、代碼檢查並熱重載頁面。當出現錯誤時，會在終端打印錯誤信息。

如果使用像 Cursor 或 Claude Code 這樣的大語言模型（LLM）智能體，當你看到錯誤時，可能需要將錯誤信息從終端複製粘貼給智能體並詢問如何修復。有了 persistproc，可以直接讓智能體查看錯誤信息。

persistproc npm run dev

智能體可以立即讀取其輸出，甚至重啟它。你仍然可以在原始終端中看到其輸出，並像往常一樣使用 Ctrl+C 終止它。

graph TB
    User[用戶] -->|"persistproc npm run dev"| PP[persistproc 服務器]
    PP <-->|"管理 / 記錄日誌"| NPM["npm run dev<br/>(Web 服務器)"]
    PP -.->|"流式輸出"| User
    
    Agent[Cursor] -.->|"output()<br/>restart()"| PP
    
    style PP fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    style NPM fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style User fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    style Agent fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px

高級用法：複雜 Web 開發

假設你需要運行四個進程才能在本地運行你的 Web 應用，例如 API 服務器、前端服務器、SCSS 構建器和 Postgres 數據庫。每個服務都會輸出自己的日誌。

如果你在本地測試時遇到錯誤，需要查看四個日誌文件才能找出問題所在。但如果你使用 persistproc 啟動這些進程，智能體可以一次性讀取所有日誌並可能更快地給出診斷結果。

graph TB
    User[用戶] -->|"啟動進程"| PP[persistproc 服務器]
    
    subgraph processes["管理的進程"]
        API[API 服務器]
        FE[前端服務器]
        SCSS[SCSS 構建器]
        DB[Postgres]
    end
    
    PP <-->|"管理 / 記錄日誌"| processes
    
    Agent1[Claude Code] -.->|"讀取日誌<br/>診斷問題"| PP
    Agent2[Cursor] -.->|"讀取日誌<br/>診斷問題"| PP
    
    style PP fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    style API fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style FE fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style SCSS fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style DB fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style User fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
    style Agent1 fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
    style Agent2 fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px
    style processes fill:#f5f5f5,stroke:#999,stroke-width:1px,stroke-dasharray: 5 5

📚 詳細文檔

可用工具

persistproc 服務器公開了以下工具：

這個列表有意保持簡短，因為大語言模型在工具過多的情況下表現會變差，一些 IDE（如 Cursor）對可用工具的數量有限制。

示例智能體交互

一旦你的智能體連接成功，你可以要求它管理你的進程。假設你已經使用 persistproc npm run dev 啟動了一個 Web 服務器（進程 ID 為 12345），你可以進行以下交互：

• 你：“列出正在運行的進程。”

  • 智能體：調用 list() 並向你顯示正在運行的 npm run dev 進程。

• 你：“Web 服務器似乎卡住了。你能重啟它嗎？”

  • 智能體：識別正確的進程並調用 ctrl(action="restart", pid=12345)。

• 你：“顯示 Web 服務器的任何錯誤信息。”

  • 智能體：調用 output(pid=12345, stream="stderr") 以檢索最新的錯誤日誌。

📄 許可證

本項目採用 MIT 許可證。