Lab隨記

中文版 → Duetsheet：給研究者與 AI Agent 協作的互動式研究報告  AI agents are becoming useful for data analysis and scientific reporting, but one problem remains: Humans still have a poor interface for telling AI exactly what is wrong. Instead of describing “the points in the upper-left of Figure 2” in a chat window, I built Duetsheet . Duetsheet is an open-source interactive HTML report where humans and AI agents work on the same document. Researchers can: edit text and charts directly click or lasso data points and leave comments track human and AI revisions trace figures back to datasets, scripts, and raw data Chart annotations can store the actual data range and point IDs, not just screen coordinates, so an AI agent can understand exactly which measurements the researcher is referring to. Reports are stored as plain JSON with a published JSON Schema and AGENTS.md , making Duetsheet compatible with file-capable agents such as Claude Code, Codex, Gemini CLI, and Cursor. The main use case is simple:...

English version → Duetsheet: An Interactive Research Report for Human–AI Collaboration 近年我常使用 AI agent 協助資料分析、繪圖與研究報告整理，但實際使用後，我一直遇到一個問題： AI 很會產生報告，但人類很難精確告訴它「哪裡錯了」。 例如一張圖裡某幾個資料點有問題，在聊天視窗裡只能說「左上角那幾個點不太對」，但 AI 並不知道你實際指的是哪些資料。 因此我做了 Duetsheet 。 Duetsheet 是一個開源的 interactive HTML report，讓研究者和 AI agent 直接在同一份報告上工作。 研究者可以： 直接修改文字與圖表 點選或圈選資料點並留下註解 查看 human / AI 每一次修改 追蹤 figure、dataset、script 與 raw data 的來源關係 對圖表的 annotation 不只保存畫面座標，也可以保存實際的 data range 與 data point IDs，因此 AI 能更準確理解研究者指出的問題。 Duetsheet 的 report 使用 plain JSON，並提供 JSON Schema 與 AGENTS.md ，因此不綁定特定模型，可與 Claude Code、Codex、Gemini CLI、Cursor 等 agent 搭配。 它最適合的情境是： AI 先產生 data-heavy report，再由 domain expert 逐張圖、逐項資料檢查與修正。 這個專案最初就是從我的 scientific research workflow 出發，目前仍持續在實際研究工作中測試與改進。 GitHub： https://github.com/Ashur5457/duetsheet