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。
