為了新版 beads_viewer (bv)，我真的下了血本。最初的 bv 版本只花了一天就寫完了，只有不到 7000 行 Go 程式碼。而這個新版本……足足有 8 萬行！我添加了大量強大的功能。你的代理商一定會喜歡它（你也會）。
以下是一些截圖，展示如何使用 gh 工具將你的珠子自動匯出到 GitHub Pages 上的靜態網站：
您可以在這裡嘗試 beads_viewer 專案的實際範例（真是太元了！）： https://t.co/UhboFtbSdZ
TUI也進行了大量改進，並新增了許多實用功能：
但就實際用途而言，最大的改進根本不是為了你們人類！而是為了你們的編碼代理。 他們只需要執行一個簡單的指令，bv --robot-triage，就能立即獲得大量關於下一步工作內容的見解。
請務必更新 AGENTS.md 檔案中的描述資訊（儘管該工具現在會自動偵測並詢問您是否要為其新增！）。新的描述資訊更長，但絕對值得佔用額外的上下文視窗標記： ### 將 bv 當作 AI 邊車 bv 是 Beads 專案（.beads/beads.jsonl）的圖感知分類引擎。它無需解析 JSONL 或進行虛擬的圖遍歷，而是使用 robot 標誌來產生確定性的、依賴感知的輸出，並預先計算指標（PageRank、介數中心性、關鍵路徑、循環、HITS、特徵向量、k-core）。 **範圍邊界：** bv 負責處理*工作內容*（分類、優先順序、計畫）。對於代理商之間的協調（訊息傳遞、工作認領、文件預留），請使用 [MCP 代理郵件](https://t.co/vi3HxBUknU)。 **⚠️ 重要提示：請僅使用 `--robot-*` 參數。直接使用 `bv` 會啟動一個互動式 TUI，從而阻塞您的會話。 ** #### 工作流程：從分診開始 `bv --robot-triage` 是您的唯一入口點。它只需一次調用即可返回您所需的所有資訊： - `quick_ref`：一目了然的計數 + 前 3 名精選 - `推薦`：按評分、理由和解鎖資訊排序的可操作項目 - `quick_wins`：投入少、影響大的物品 - `blockers_to_clear`：用於解除下游工作阻塞的項目 - `project_health`：狀態/類型/優先分佈，圖表指標 - `commands`：複製貼上 shell 指令以執行後續步驟 bv --robot-triage # 超級指令：從這裡開始 bv --robot-next # 最簡配置：僅包含單一頂部拾取 + 認領指令 #### 其他指令 **規劃：** | 命令 | 返回 | |---------|---------| | `--robot-plan` | 使用 `unblocks` 清單進行並行執行 | | `--robot-priority` | 優先權錯位偵測（信賴度） | **圖表分析：** | 命令 | 返回 | |---------|---------| | `--robot-insights` | 完整指標：PageRank、介數中心性、HITS（樞紐/權威）、特徵向量、關鍵路徑、循環次數、k-core、銜接點、Slack | | `--robot-label-health` | 每個標籤的健康狀況：`health_level`（健康|警告|嚴重），`velocity_score`，`staleness`，`blocked_count` | | `--robot-label-flow` | 跨標籤依賴關係：`flow_matrix`、`dependencies`、`bottleneck_labels` | | `--robot-label-attention [--attention-limit=N]` | 以以下方式對標籤進行注意力排名：（pagerank × staleness × block_impact）/ velocity | **歷史記錄與變更追蹤：** | 命令 | 返回 | |---------|---------| | `--robot-history` | 珠子到提交的相關性：`stats`、`histories`（每個珠子的事件/提交/里程碑）、`commit_index` | | `--robot-diff --diff-since ` | 自參考文獻以來的變更：新增/關閉/修改的問題，引入/解決的循環 | **其他命令：** | 命令 | 返回 | |---------|---------| | `--robot-burndown ` | 迭代燃盡圖、範圍變更、風險項目 | | `--robot-forecast ` | 基於依賴關係的調度預測預計到達時間 | | `--robot-alerts` | 過期問題、阻塞級聯、優先權不符 | | `--robot-suggest` | 衛生：重複、缺失依賴項、標籤建議、循環中斷 | | `--robot-graph [--graph-format=json\|dot\|mermaid]` | 依賴關係圖匯出 | | `--export-graph ` | 獨立的互動式 HTML 視覺化 | #### 範圍界定與篩選 bv --robot-plan --label backend # 範圍限定到標籤的子圖 bv --robot-insights --as-of HEAD~30 # 歷史時間點 bv --recipe actionable --robot-plan # 預先過濾：準備就緒（無阻塞程式） bv --recipe high-impact --robot-triage # 預篩選：PageRank 分數最高的 bv --robot-triage --robot-triage-by-track # 以平行工作流程分組 bv --robot-triage --robot-triage-by-label # 依域分組 #### 了解機器人輸出 **所有機器人 JSON 都包含：** - `data_hash` — 來源 beads.jsonl 的指紋（驗證不同呼叫之間的一致性） - `status` — 每個指標的狀態：`computed|approx|timeout|skipped` + 經過的毫秒數 - `as_of` / `as_of_commit` — 使用 `--as-of` 時存在；包含引用和已解析的 SHA。 **兩階段分析：** - **第一階段（即時）：** 度數、地形排序、密度 — 隨時可立即取得 - **第二階段（非同步，500毫秒超時）：** PageRank、介數中心性、命中次數、特徵向量、循環次數 — 檢查 `status` 標誌 **對於大型圖（>500 個節點）：**某些指標可能會被近似計算或跳過。請務必檢查 `status`。 #### jq 快速參考 bv --robot-triage | jq '.quick_ref' # 概覽摘要 bv --robot-triage | jq '.recommendations[0]' # 最高推薦 bv --robot-plan | jq '.plan.summary.highest_impact' # 最佳解除阻塞目標 bv --robot-insights | jq '.status' # 檢查指標就緒狀況 bv --robot-insights | jq '.Cycles' # 循環依賴（必須修復！） bv --robot-label-health | jq '.results.labels[] | select(.health_level == "critical")' 效能參數：第一階段即時執行，第二階段非同步執行（逾時時間為 500 毫秒）。如果速度至關重要，建議使用 `--robot-plan` 參數，而不是 `--robot-insights` 參數。結果按資料哈希值快取。 使用 bv 而不是解析 beads.jsonl——它可以確定性地計算 PageRank、關鍵路徑、迴圈和平行軌道。
總之，請告訴我你的想法！你可以在這裡獲取 bv，它始終免費，始終 100% 採用 MIT 許可的開源軟體，並且是我用於代理編碼的 7 個工具飛輪的一部分： https://t.co/pGNHTEqQHH
你可以造訪我重新設計的個人網站，了解飛輪效應。我很享受我的經紀人幫我精心打造這個網站，而我可以安心地去做其他事情，他們使用的正是他們向我介紹的工具： https://t.co/2usm1h4hUf