dsh-agent-sticky-note

dsh-agent-sticky-note 📌

適配 DSH 0.1.1-rc.2（開發與驗證版本；插件只用 settings.section slot + ctx.webServer 穩定 API，預期向前相容）。上圖為示意圖。

English | 中文

What is this?

A DeepSeek Harness plugin that shows your agent's sticky-note file inside the
DSH Web GUI as a Settings tab — so pending decisions, notices and version
updates are never buried in chat message floods, and stay visible even when you
access the harness remotely (e.g., over Tailscale) from a machine that cannot
see the server's Desktop.

The note file lives on the harness machine (~/Desktop/DSH-便條紙.md by default)
and is written/maintained by your agent (background watchers, headless workers,
or the agent itself). This plugin simply renders it in the GUI:

• 🟡 Sticky-paper styling, dark-mode aware
• 🔄 Auto-refresh every 30 s while open + manual refresh button
• 🔌 Zero dependencies — plain Node ESM + browser React from DSH's module table
• 🙈 Read-only, no telemetry, no external calls

這是什麼？

一個 DeepSeek Harness（DSH）插件：把 agent 維護的「便條紙便條紙檔案」顯示在 DSH
Web GUI 的設定分區裡。重要決策事項、通知、版本更新不再被對話訊息淹沒——
透過 Tailscale 遠端連回 GUI 時也看得到。

便條檔案預設在 harness 主機的 ~/Desktop/DSH-便條紙.md，由你的 agent
（背景 watcher / headless worker / 對話中的 agent）負責寫入與維護；本插件
只負責在 GUI 呈現：

• 🟡 便利貼樣式，支援深色模式
• 🔄 開啟時每 30 秒自動更新 + 手動重新整理
• 🔌 零依賴 — 純 Node ESM + DSH module table 的瀏覽器 React
• 🙈 唯讀、無遙測、無外部連線

---

Install 安裝

From npm 從 npm（建議，最快）

dsh plugin --profile web add dsh-agent-sticky-note
systemctl --user restart dsh.service

From a local directory 從本地目錄

git clone https://github.com/alanpaul1969/dsh-agent-sticky-note.git
dsh plugin --profile web add /path/to/dsh-agent-sticky-note
systemctl --user restart dsh.service   # or restart your harness

From GitHub 固定 commit（建議）

dsh plugin --profile web add github:alanpaul1969/dsh-agent-sticky-note#<40-char-commit>
systemctl --user restart dsh.service

Requires pnpm ≥ 11 on the host for profile installs.
Host 需有 pnpm 11+（自動嘗試 corepack pnpm）。

Then open Settings → 📌 便條紙 in the DSH Web GUI.
安裝後打開 DSH Web GUI 的 設定 → 📌 便條紙。

Configuration 設定

Env	Default	說明
STICKY_NOTE_FILE	~/Desktop/DSH-便條紙.md	Note file path / 便條檔案路徑

Point the agent's writer at the same path, and the GUI always shows the
latest state. 想換路徑：host 端環境變數 + agent 寫入端設同一個檔即可。

Note format 便條格式（建議）

Any Markdown works. The convention used by our A2A pipeline:

# 📌 DSH 便條紙

## ⏳ 待 Alan 決策 / 注意
- <MM-DD HH:MM> <from>: <one-line summary>（需要：<what decision>）

## ℹ️ 通知（不需動作）
- ...

Agent protocol — 讓 agent 會寫便條

本插件只是唯讀顯示器；便條的內容由你的 agent 維護。
完整的寫入約定（檔案結構、插入格式、多 writer 共存、結案流程）見
AGENT-PROTOCOL.md。

最小範例——agent 有事需要主人決策時：

sed -i "/^## ⏳ 待 Alan 決策/a - $(date +'%m-%d %H:%M') openrouter: 新版本發佈（需要：說「升級」）" \
  ~/Desktop/DSH-便條紙.md

How it works 運作原理

• Host half (lib/index.js): registers GET /api/sticky-note on
  ctx.webServer, returning { ok, content, mtime, path }.
• Client half (lib/client.js): injects a settings.section slot
  (id sticky-note) rendering the note; polls every 30 s while open.

Uninstall 移除

dsh plugin --profile web remove dsh-agent-sticky-note

License

MIT