DSH 無法直接看到你運行在另一個窗口的 Claude Code、Codex 或 Cursor 的狀態。這個插件給 DSH 提供了兩個只讀工具，用來解析這些代理已經寫入磁盤的會話日誌，並將所有狀態歸一化爲統一的詞彙：needs you / running / done / idle。
安裝¶
在 DSH Desktop 中，進入 Settings → Plugins，搜索 dsh-plugin-dew 並安裝。
或者，手動將其接入 Profile：在對應的 package.json 中添加依賴並列爲 Bundle。
// ~/.dsh/profiles/web/package.json
{
"dependencies": { "dsh-plugin-dew": "^0.1.0" },
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-plugin-dew"] } }
}
安裝前請確保環境滿足依賴要求：
* Node.js 版本 >= 20
* 若要讀取 DSH 自身的壓縮轉寫，需要 Node 23.8+（支持 zlib.zstdDecompressSync）
核心功能¶
插件提供兩個工具，用於查詢會話和計劃任務。
agent_sessions¶
列出會話及其當前狀態。
| 參數 | 類型 | 說明 |
|---|---|---|
agents |
string[] | 限制掃描的代理，支持 claude_code、codex、cursor、dsh。留空則掃描全部。 |
state |
string | 狀態過濾，支持 needs you、running、done、idle，或 active（默認，排除 idle）或 all。 |
within_hours |
integer | 回溯時間窗口，默認 8 小時。 |
limit |
integer | 返回結果上限，默認 25。 |
agent_scheduled_tasks¶
列出代理的 recurring jobs 及其下次觸發時間，包括 Codex 的自動化（RRULE）和 Claude Code 的計劃任務（cron），均在本地計算。
| 參數 | 類型 | 說明 |
|---|---|---|
agents |
string[] | 限制掃描的代理。 |
include_disabled |
boolean | 是否包含已關閉的任務，默認 false。 |
使用場景¶
- 查詢是否有任務在等待你的確認（
needs you）。 - 檢查 Claude Code 的運行是否已完成。
- 查看哪個代理被阻塞。
- 在編輯代碼前，確認另一個代理是否正在處理同一個目錄。
隱私與配置¶
插件以只讀模式運行。它不會寫入其他代理的數據目錄，也不會觸碰密鑰鏈或進行網絡請求。
agent_sessions 會返回每個會話的一行摘要（對話片段）。這些摘要會像普通工具結果一樣發送給模型提供商。如果不需要對話文本，可以配置 redactSummaries。
config:
agents: [] # 限制掃描的代理，如 ["claude_code", "codex"]
defaultWindowHours: 8 # 默認回溯小時數
redactSummaries: false # 是否隱藏對話摘要，僅報告狀態和項目
數據來源¶
插件通過讀取各代理的本地日誌文件獲取信息。
| 代理 | 會話 | 計劃任務 | 源路徑 |
|---|---|---|---|
| Claude Code | ✅ | ⚠️ | ~/.claude/projects/**/*.jsonl、~/.claude/scheduled-tasks/ |
| Codex | ✅ | ✅ | ~/.codex/sessions/、~/.codex/automations/ |
| Cursor | ✅ | — | ~/.cursor/projects/<slug>/agent-transcripts/ |
| DSH | ✅ | — | $DSH_HOME（默認 ~/.dsh）及 DSH Desktop harness 目錄 |
⚠️ 注意：Claude Code 的計劃任務目前僅在文檔中有定義，尚未在真實環境中觀察到，解析器爲防禦性編程，未觸發時返回空。
生態與鏈接¶
dsh-plugin-dew 是社區插件，維護者：cinderzhan，許可證：MIT。
