john-walks-slow/dsh-session-state ↗★ 0

dsh-session-state

Visual session state badges for DeepSeek Harness: mark a session's project state by prefixing its title with customizable emoji or text badges (default wip 🚧, blocked ⏸️, review 👀, done ✅, plan 💡, bug 🐛), with configurable default state for new sessions, a model tool (session_state), a user slash command (/state), and a Web settings panel. dsh-session-state:用会话标题前缀(默认 Emoji,可自定义)标记项目状态,支持新会话默认状态(默认 wip,可选 none)、Agent 工具 session_state、用户命令 /state 与 Web 设置页(纯视觉区分,无其他行为副作用)。 适合需要对大量会话进行分类(如进行中、已完成、有Bug)的项目管理任务。

패키지
dsh-session-state
호환성
미검증
Harness peer 범위
^0.1.5-rc.3 || ^0.2.0-rc.1
버전
0.1.0
라이선스
MIT
최근 업데이트
2026. 10. 13.

같은 패키지 이름의 다른 저장소

설치

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:john-walks-slow/dsh-session-state

使用方法

1. 用户命令 /state

/state              # 查看当前会话状态、标题、新会话默认状态及可用状态列表
/state list         # 同上,列出所有可用状态预设
/state wip          # 设为「🚧 进行中」
/state review       # 切换为「👀 待验收」(自动剥离旧前缀,绝不叠加)
/state done         # 切换为「✅ 已完成」
/state none         # 清除状态前缀,恢复原始标题(同 /state clear)

状态只用 key 选择(如 wip、review、done);名称与前缀只用于展示,不作为入参。

2. 模型工具 session_state

  • state(必填):状态 key(如 "wip"、"review"、"done"),或 "none" / "clear" 清除状态前缀。
  • session_id(可选):目标会话 ID,省略时作用于当前会话(仅限当前进程内的 live 会话)。

无需任何配置:工具描述本身就把「按阶段自主维护状态标记」写成明确预期,并给出每个状态的适用场景(取自状态项的「说明」字段)。模型会在开始实施、等待你确认、待验收、完工等阶段自行切换;只有想追加额外偏好(例如「没有我的确认不要设 done」)时才需要在设置页填写指令。

3. Web 设置面板

打开 Settings → 会话状态:

  • 选择新会话默认状态(默认 wip,可选 none 或任意自定义状态);
  • 开关 session_state 工具并配置给 Agent 的自定义触发指令(如:开始实施时设为 wip,等待用户验收时设为 review,完工后设为 done);
  • 增、删、改状态预设列表(每项含 key、前缀、名称、说明),或一键恢复默认状态集。所有修改在保存后的下一个回合立即生效。