titanwings/dsh-plannotator
DSH 计划批注插件：选中计划原文、逐条批注，并把结构化反馈送回 Agent。 / A DSH plan-review plugin for anchored annotations and structured Agent feedback.
Listed
7
Workflow
Bundle verified
What it does
Plan review with anchored annotations and structured feedback back to the agent.
Best for
- Architecture, migration, API, security, or rollout plans that need precise review before implementation.
- Reviewers who need several comments anchored to exact passages in one coherent response.
- Teams that want plan feedback recorded through DSH's existing response flow and Session Log.
Not ideal for
- Ordinary conversations or implementation work without an active DSH Plan Review request.
- Simple plans where a binary approve or reject decision already provides enough precision.
- Workflows requiring an external review service, telemetry, or a separate persistence backend; the plugin deliberately uses the existing DSH response path and browser-local draft storage.
README
📝 dsh-plannotator
Review the plan before your coding agent writes the code.
|
① The plan sounds plausible, but one sentence hides a migration risk? ② You found several independent problems, but the only choices are Approve or Reject? ③ You want every comment to stay attached to the exact text the agent must revise? |
✨ Turn a binary plan gate into a precise, multi-comment review.
Select exact plan text, collect precise comments, and return one structured review—without leaving DeepSeek Harness.
Why it exists · Features · Install · How it works
English · 简体中文
“Change the third step” is vague. A comment attached to the exact sentence preserves the context the agent needs to revise the plan correctly.
Select exact text → comment on several risks → send one review → approve when ready.
🎯 Why dsh-plannotator
Coding agents are good at producing plans, but a binary Approve / Reject decision is too coarse for serious work. Architecture migrations, API changes, security fixes, and rollout plans often need several independent corrections before implementation begins.
dsh-plannotator turns DSH’s native Plan Review into a compact gate plus a
responsive companion panel. On a wide screen, the conversation and review
occupy separate columns, so opening the panel never covers chat text. Collapse
it to a slim edge rail and reopen it without settling the request. Your comments
still travel through DSH’s existing response flow as structured Markdown, so the
agent can revise the proposal in plan mode and ask for review again.
This is an unofficial integration inspired by Plannotator.
🧰 Features
Comment on the exact claim—not “somewhere in the plan”
Drag over text for a precise annotation, or double-click a paragraph, list item, heading, bold phrase, or code fragment. The review keeps the quote and comment together within the current plan revision.
Review the whole plan in one pass
Collect multiple comments across compatibility, security, rollback, and tests; add overall feedback; click an annotation in the review panel to return to its source; then send one coherent review. This keeps the review compact and less ambiguous than a sequence of detached chat messages.
Collapse the review without losing your place
The review panel can shrink to a blue edge rail while the compact composer gate remains visible. Reopen either control to continue with the same comments and overall feedback.
Return actionable feedback to the agent
Send feedback answers the real exit_plan_mode interaction. DSH records the
quoted plan text, each requested change, and the overall feedback in the tool
result and Session Log. The agent remains in plan mode and can immediately
produce a revised proposal.
Protect unfinished reviews
Unsent comments are saved locally in the browser, isolated by Session, pending request, and plan revision. If you try to approve while feedback is still pending, the plugin requires an explicit second confirmation instead of silently discarding your work.
| Capability | What you get |
|---|---|
| Precise annotations | Text selection plus a reliable double-click block fallback |
| Multi-comment review | Anchored comments, source navigation, deletion, and overall feedback |
| Responsive review column | Side-by-side on wide screens, an on-demand drawer on narrower desktops, and a bottom sheet on phones |
| DSH response loop | Approve, request changes, or return to chat through the existing pending interaction |
| Draft recovery | Best-effort local recovery without a plugin server or third-party service |
| Review safeguards | Stale-plan draft rejection and explicit confirmation before discarding feedback |
| UI fit | English and Chinese copy, keyboard shortcuts, responsive layout, and DSH theme tokens |
📦 Install
Install the GitHub bundle into the DSH Web profile, then restart dsh web:
dsh plugin --profile web add github:titanwings/dsh-plannotator#v0.1.3
The repository ships its built Host and Web bundles, so installation runs no
package build script and needs no allowBuilds entry. Pin a reviewed commit SHA
instead of the release tag when you need an exact source revision.
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:titanwings/dsh-plannotator in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.