hoyyang/dsh-plan-board 预览 preview

hoyyang/dsh-plan-board

思维导图式项目规划可视 + 最强防跑偏:计划→模块→任务树/DAG、执行序号、Agent GPS 站位、改图人审门、git 交叉核对、阻断级漂移防护(DeepSeek Harness 插件)

Project Overview项目介绍

dsh-plan-board is a DSH-native web plugin distributed via dsh plugin --profile web add github:hoyyang/dsh-plan-board, requiring dsh ≥ 0.1.5-rc.1 with no API key and zero configuration; after restart, a 31×31 circular PlanBoard button appears on the right side of the session header, expanding leftward into a capsule on hover or focus, and all planning data lives inside the user's project at <project>/.plan-board/ (committed to git), so no external service is involved.

The product renders a live three-level mind map (plan → module → task) with auto-laid-out horizontal branches, purple dashed cross-module dependencies, real-time topological execution numbers, and a 4s-polled NDJSON /stream overlay; five Agent tools drive the workflow — plan_map (read state), plan_next (issue the single ready task via L1 hard lock), task_update (status transitions requiring evidence under L3), plan_edit (queued for human approval under L2), and plan_link (bidirectional sync with the ~/.ai memory layer).

It targets solo developers who want a single machine-authoritative plan file for one project, enforced by seven anti-drift layers including L4 git cross-check, L5 drift blocking, L7 write-scope interception, and module-level dependencies that bubble down to subtasks; v0.2.0 ships the host and client builds pre-compiled, supports React + custom SVG with native non-passive zoom and drag-pan, excludes Kanban / Gantt / multi-user collaboration, and is released under BSD-3-Clause.

dsh-plan-board 是一款面向 DSH 的 Web 端原生插件,安装命令为 dsh plugin --profile web add github:hoyyang/dsh-plan-board,需 dsh ≥ 0.1.5-rc.1;装完后在会话头部右侧出现可展开的 PlanBoard 入口按钮,零配置、无需 API Key,规划数据完全落地在用户项目目录中(<项目>/.plan-board/),不依赖外部服务。

核心能力是把项目计划渲染成一张会动的三层思维导图(计划 → 模块 → 任务),Agent 通过五个工具与图交互:plan_map 读图、plan_next 领取当前唯一可做任务、task_update 推进状态、plan_edit 提交改动等待人工审批、plan_link 与 ~/.ai 项目记忆双向对账;改图必须过 L2 人审门、done 必须附证据走 L3 证据门、commit 越界触发 L4 漂移告警、tool 越界由 L7 当场 deny。

定位为单人单项目的计划权威层,不替代看板或 issue tracker;提供 React + 自绘 SVG 面板与 NDJSON /stream 实时刷新,BSD-3-Clause 许可,预编译产物随仓库提交,安装即可用,不强制 LLM 仲裁或甘特视图等未排期功能。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:hoyyang/dsh-plan-board

把 hoyyang/dsh-plan-board 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plan-board

banner

把整个项目画成一张会自己动的「任务思维导图」,并且让 Agent 真的照着它走——跑偏当场拦下。

计划 → 模块 → 任务三层展开,跨分支依赖画成紫色箭头,拓扑执行序号实时刷新,Agent 在图上 GPS 站位前行;改图必须过「人审门」才生效,任务完成必须附证据,工具越界被当场 deny,git 里出现计划外改动立即漂移阻断。

English · Releases · 更新日志 · 设计文档

release dsh license stars

安装

dsh plugin --profile web add github:hoyyang/dsh-plan-board
# 构建产物随仓库提交,免本地构建

重启 dsh web:会话头部右侧(「⋯ 更多操作」左边)出现 PlanBoard 按钮即成功。点它打开面板,填项目根绝对路径即可。

dsh plugin --profile web remove @dsh-external/dsh-plan-board   # 卸载

最低 dsh >= 0.1.5-rc.1(实测版本)。零配置:不需要 API Key,规划数据全部落在你自己的项目目录里。

看看长什么样

plan board panel

  • 左:面板(561×720)——计划 → 模块 → 任务三层思维导图,模块间紫色虚线是依赖,任务前的 #N 是拓扑执行序号,绿色=done;顶部横幅是 L7 越界拦截,底部是事件时间线(status_changed / human_edit / guard_alert 全量留痕)。
  • 入口按钮:静止收成 31×31 正圆(左),悬停向左展开成完整胶囊(右)——两态圆角同为 15.5px(= 高度一半),所以弧度全程不变;右缘固定,右邻「⋯ 更多操作」不动。

button collapsed    button expanded

它解决什么问题

Agent 跑偏不是「不听话」,是没有可执行的计划权威:计划活在对话里,压缩一次就没了;任务做到哪一步没人知道;说「做完了」也没有证据;改计划不留痕。dsh-plan-board 把计划变成项目里的一份机器权威文件(<项目>/.plan-board/plan.board.json),再用七层机制让 Agent 只能顺着它走。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-superpowers 下一个 Next dsh-mem0 →