alanpaul1969/dsh-agent-sticky-note

dsh-agent-sticky-note 📌

DSH npm License: MIT

schematic

适配 DSH 0.1.1-rc.2（开发与验证版本；插件只用 settings.section slot + ctx.webServer 稳定 API，预期向前兼容）。上图为示意图。

这是什么？

一个 DeepSeek Harness 插件，将你的 agent 的便条纸文件以设置标签页的形式显示在
DSH Web GUI 中——这样待决事项、通知和版本
更新就不会被聊天消息洪流淹没，即使你
从一台无法看到服务器桌面的机器远程访问 harness（例如通过 Tailscale）时也依然可见。

便条文件位于 harness 机器上（默认 ~/Desktop/DSH-便條紙.md），
由你的 agent（后台监听器、无头 worker，
或 agent 本身）写入/维护。本插件只是将其渲染在 GUI 中：

- 🟡 便条纸样式，适配深色模式
- 🔄 打开时每 30 秒自动刷新 + 手动刷新按钮
- 🔌 零依赖——纯 Node ESM + 来自 DSH 模块表的浏览器 React
- 🙈 只读，无遥测，无外部调用

这是什么？

一个 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#
systemctl --user restart dsh.service

Requires pnpm ≥ 11 on the host for profile installs.
主机需有 pnpm 11+（自动尝试 corepack pnpm）。

然后打开 DSH Web GUI 中的 Settings → 📌 便条纸。
安装后打开 DSH Web GUI 的 设置 → 📌 便条纸。

Configuration 设置

| Env | Default | 说明 |
|---|---|---|
| STICKY_NOTE_FILE | ~/Desktop/DSH-便條紙.md | Note file path / 便条文件路径 |

将 agent 的写入端指向同一路径，GUI 就会始终显示
最新状态。想换路径：主机端环境变量 + agent 写入端设同一个文件即可。

Note format 便条格式（建议）

任何 Markdown 都可以。我们 A2A 流水线使用的约定：

📌 DSH 便條紙

⏳ 待 Alan 決策 / 注意
-  : （需要：）

ℹ️ 通知（不需動作）
- ...
Agent 协议 — 让 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