本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugins（sessions / dsh-sessions）

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-sessions

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Codex Terminal documentation
• Coding Plan core
• Codex Coding Plan documentation
• Grok Coding Plan documentation
• Loop documentation

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装好之后怎么用？

安装后重启 DSH 并新建会话即可使用，无需额外配置。Agent 可在自然语言里调用 session_status / session_read / session_create / session_send / session_open_sidechat 五个工具；用户也可直接在输入框打 /sessions status|read|create|send|sidechat 命令做同样操作。

session_create 会等模型生成完才返回吗？

不会。它只创建新会话并把初始 prompt 投到收件箱就立即返回（README §5 / SPEC §2 session_create），返回的 status 是 queued；想看生成结果请用 session_status 或 session_read。

session_send 的 steer 和 followup 有什么区别？

steer（默认）会唤醒空闲 agent，并对运行中 agent 投到最近一个步骤边界；followup 则排队成普通的下一轮（src/send-service.ts:50-51、SPEC §2 session_send）。两者都不会打断 agent 当前正在跑的步骤。

侧边聊天 / sessions sidechat 跟 session_create 是一回事吗？

不是。sidechat 走 Harness 自带的 continuable subagent，返回的是真实可继续的 subagent_id（src/sidechat/sidechat-service.ts:33-49、SPEC §2）；session_create 返回的是新的顶层 session_id。sidechat 在 Web 端有专门的可关闭+多标签 panel（src/ui/SideChatPanel.tsx），主会话不会被导航走。

怎么选择 session_create 的模型或工作目录？

在创建时显式传 model: { provider, model, reasoningEffort? }、preset、cwd 即可；不传时新建子会话继承调用方 agent 的模型路由/preset/cwd，根调用则回落到部署默认（SPEC §2 session_create 的解析顺序）。cwd 必须是已存在的绝对目录，会被 canonicalize。

session_read 能读整段历史吗？

不能。它是有界读取：limit 默认且上限 200 条 message block（src/service.ts:16），offset 1-based 超出范围会被拒；只投影会话规范消息块，跳过 token 流、生命周期记录等 trace 事件（src/service.ts:153-162）。

跟 dsh-loop 是什么关系？

dsh-sessions 拥有跨会话的发现/读取/创建/发送能力（SPEC §1），dsh-loop 拥有当前会话内的循环闹钟；dsh-loop 用本插件的会话列表能力填它面板上的"已有会话"选项（SPEC §5），两者职责互补不重叠。

怎么卸载？

用 dsh plugin --profile web remove 对应的安装源即可；卸载后这五个工具名和 /sessions 命令从新会话的工具表中消失，已创建/已发送的会话和侧边聊天仍保留在 DSH 会话存储里。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.7（peerDependencies 中 dsh-agent-presets/dsh-agent-default-model/dsh-workspace/dsh-subagent 要求 >=0.1.0-rc.7，其余 dsh-* >=0.1.0-rc.5，cordis >=4.0.0）
• Node: 未声明（package.json 无 engines 字段；devDependencies 仅声明 @types/node ^22.20.0）
• Platforms: 跨平台（DSH Web）

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则