plannotator-tui

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

plannotator-tui: hand a document to the human for review

plannotator-tui：将文档交由人工审阅

Only when

HERDR_ENV=1

(you are running inside Herdr). Otherwise tell the human where the file is and ask them to review it.

Write the document to a file. Do not paste it into chat as well.
Open it for review, from your own pane:
bash
```
plannotator-tui herdr open docs/plans/auth.md
```
plannotator-tui opens beside you (or wherever the user configured it), already knowing that feedback comes back to this pane.
End your turn. Do not wait, poll, or read the pane. The review arrives as the next user message, as numbered feedback:
```
## 1. (line 12) Feedback on: "Rotate the token on every…"
> Rotation on every privilege change will log people out…
```
Address every item, then continue.

When you list files you want the human to open, print them as

file://

hyperlinks (OSC 8) so Ctrl-click in Herdr opens them in plannotator-tui:

bash

printf '\e]8;;file://%s\e\\%s\e]8;;\e\\\n' "$PWD/docs/plans/auth.md" "docs/plans/auth.md"

plannotator-tui

is not on

PATH

, the raw Herdr command is:

bash

herdr plugin pane open --plugin plannotator-tui --entrypoint doc --placement split \
  --direction right --target-pane "$HERDR_PANE_ID" --focus --cwd "$PWD" \
  --env PLANNOTATOR_TUI_FILE="$PWD/docs/plans/auth.md" --env PLANNOTATOR_TUI_DELIVER_TO="$HERDR_PANE_ID"

仅当

HERDR_ENV=1

（你在Herdr环境中运行）时使用此方法。否则，请告知用户文件位置并请求他们进行审阅。

将文档写入文件。请勿同时粘贴到聊天窗口中。
在你自己的面板中打开它以供审阅：
bash
```
plannotator-tui herdr open docs/plans/auth.md
```
plannotator-tui会在你的面板旁打开（或用户配置的其他位置），并且已设置好将反馈送回此面板。
结束当前操作回合。请勿等待、轮询或查看面板。审阅反馈会作为下一条用户消息以编号形式送达：
```
## 1. (line 12) Feedback on: "Rotate the token on every…"
> Rotation on every privilege change will log people out…
```
处理每一条反馈项后，再继续操作。

当你列出希望用户打开的文件时，请将其打印为

file://

超链接（OSC 8格式），以便在Herdr中按住Ctrl点击即可在plannotator-tui中打开：

bash

printf '\e]8;;file://%s\e\\%s\e]8;;\e\\\n' "$PWD/docs/plans/auth.md" "docs/plans/auth.md"

如果

plannotator-tui

不在

PATH

环境变量中，可使用原始Herdr命令：

bash

herdr plugin pane open --plugin plannotator-tui --entrypoint doc --placement split \
  --direction right --target-pane "$HERDR_PANE_ID" --focus --cwd "$PWD" \
  --env PLANNOTATOR_TUI_FILE="$PWD/docs/plans/auth.md" --env PLANNOTATOR_TUI_DELIVER_TO="$HERDR_PANE_ID"