DeepSeek Harness (DSH) 采用插件化架构，支持通过配置扩展能力。在多会话开发或长时间任务中，开发者需要在所有后续会话中保持某些长期约定，比如“回答使用中文”、“不要修改 main 分支”等。dsh-plugin-pinboard 插件通过将便签注入系统提示来解决这一问题，实现一次置顶，全局生效。
这是一个跨会话置顶便签插件，支持将便签注入所有会话的系统提示，并内置标签管理与事实库。
安装与启用¶
安装需要执行以下步骤：
1、使用官方命令安装插件包：
dsh plugin --profile web add github:121212165/dsh-plugin-pinboard
2、将仓库根目录的 cordis.patch.yml 内容合并到 $DSH_HOME/profiles/web/cordis.patch.yml。该文件默认为空数组，建议整份替换或合并数组，不要直接追加，否则会导致 YAML 解析错误。
3、重启 DSH。配置层与客户端均需重启才生效。
核心功能¶
插件主要提供以下能力：
- 跨会话注入：在任何会话通过
/pin置顶便签，该便签会进入之后所有会话的系统提示。 - 标签元数据：支持为便签添加标签，标签仅用于列表与检索，不进入注入正文。
- 内置事实库：通过
/facts命令与fact_search工具管理事实，事实存储在同一个文件中，但不占用注入预算。 - 模型自主调用：模型可自主调用
pin_add工具进行置顶。
常用命令¶
插件提供以下命令与工具：
- 置顶便签：
/pin <一句话> [#标签...]
重复内容不会重复入库。
- 取消置顶：
/unpin <id>
- 列出便签：
/pins
输出中 `●` 表示会注入，`○` 表示因超出预算被挤出。
- 事实库管理：
/facts save|find|list|rm|import
其中 `import` 为只读操作，不会修改源文件。
- 模型工具：
pin_add：模型自主置顶。fact_search：模型自查事实库，按标签/正文命中打分。
配置与注意事项¶
便签与事实存储在 ~/.dsh/pinboard/pins.jsonl。注入受限于 limit（默认 12）和 maxChars（默认 1200）。
- 便签按
at时间戳倒序注入，最新优先。单条便签超长时会截断，保证最新一条一定到达。 - 配置错误（如
limit: -1）会导致启动失败并点名 pinboard，不会拖垮 Harness。 /facts import为只读操作，源文件字节不变。- 重复内容不重复入库。
总结¶
该插件通过注入机制解决了跨会话上下文丢失的问题，适合需要长期固定指令的场景。插件维护者：121212165，许可证：MIT。
