前言¶
在 DeepSeek Harness（DSH）的工作流中，智能体产生的决策和通知往往淹没在对话流里。当通过 Tailscale 等方式远程访问 Harness 主机时，主机桌面上的文件往往不可见，导致关键状态难以追踪。dsh-agent-sticky-note 插件将 Agent 维护的便条纸文件直接集成到 Web GUI 的设置页中，解决了远程状态下状态可见性问题。
插件介绍¶
这是一个 DeepSeek Harness 插件，用于在 Web GUI 的设置区域展示由 Agent 维护的便条纸文件。它不改变文件内容，只负责渲染。默认文件路径为 ~/Desktop/DSH-便條紙.md，由 Agent 负责写入与维护。
核心功能¶
- 便条纸样式与深色模式：界面采用便条纸风格，并适配深色模式。
- 自动与手动刷新：打开页面时每 30 秒自动刷新内容，并提供手动刷新按钮。
- 零依赖：使用纯 Node ESM 和 DSH 模块表提供的浏览器 React，无额外依赖。
- 安全与隐私：只读模式，无遥测数据，无外部网络调用。
安装与启用¶
- 确保宿主机已安装 pnpm 版本 >= 11。
- 执行安装命令：
dsh plugin --profile web add dsh-agent-sticky-note
- 重启 DSH 服务以加载插件。
- 在 DSH Web GUI 中打开「设置」页面，找到「便條紙」分页。
典型用法¶
Agent 需要维护便条文件的内容。Agent 可以使用命令行工具（如 sed）向文件追加待决策事项。示例命令如下：
sed -i "/^## ⏳ 待 Alan 決策/a - $(date +'%m-%d %H:MM') openrouter: 新版本發佈（需要：說「升級」）" ~/Desktop/DSH-便條紙.md
插件会读取该文件并在 GUI 中渲染，保持界面内容的实时同步。
适用场景与注意¶
该插件适合需要在远程 Web GUI 中实时查看 Agent 决策进度的场景。插件以 Harness 进程权限运行，因此 Agent 需要拥有对默认文件路径（~/Desktop/DSH-便條紙.md）的写入权限。注意这是一个只读插件，Agent 必须自行负责文件的写入与维护逻辑。许可证为 MIT。
结语¶
通过将状态文件可视化，该插件降低了远程协作的门槛。相关目录与源码见下方链接。
