前言¶

在 DSH 里跑智能体时，「记忆」往往混在一堆上下文里：该淡忘的占字数，真正该每轮都带着的反而没有单独入口。常见做法是整段历史或大块 RAG 一起塞进去，成本高，也难区分「本人认定必须记住」和「聊过就过」。dsh-pin 把「怎么存、怎么忘」里较硬的一层拆出来：极少数事由用户显式钉住并每轮注入；工具、插件、资料类条目用完可删，库里只留一句「它能解决什么」，需要时再按关键词查。

这是什么¶

dsh-pin 是维护者 xiaole3349 发布的 DSH 插件，社区目录分类为「记忆」。一句话定位：DSH 插件——钉住重要事，图书馆只留工具标签。源码与说明见 GitHub，目录页见 SkillHub。当前 package 版本为 0.1.0，许可证 MIT。

钉与图书馆¶

README 把能力分成两块，职责不同。

钉（pin）
大部分记忆按时间淡忘；只有极少数、用户认为值得的，由本人显式钉住，并在每轮对话里注入提示词。没有钉内容时不注入，不占字数。

图书馆（library）
看完就用的东西（工具、插件、资料）用完可以删，持久层只保留一句「它能解决什么」；要用时通过搜索按关键词找回。

私聊才能改本体
群会话里对钉、图书馆以及人格/配置文件的写操作一律拒绝，由 tools.guard 拦截。群聊里仍可读、可搜，但不能通过工具改存储。

核心功能¶

下面介绍插件在 DSH 里实际提供的能力，均来自仓库 README。

• 设置页「钉」：两个页签——「钉」与「图书馆」，可在 Web 端增删改。
• 五个工具：pin_add、pin_list、pin_remove、library_add、library_search。
• HTTP 接口：/dsh-pin/{list,add,update,delete,candidates,lib/list,lib/add,lib/delete}。
• 每轮将钉住的内容注入提示词；无钉则不注入。

数据落在本机纯文本 JSON，可手改、可备份：

• ~/.dsh/jingjing/state/pins.json
• ~/.dsh/jingjing/state/library.json

安装与启用¶

先在 DSH 环境中取得插件目录（例如从 GitHub release 或本地 bundle），再按官方方式安装。不要凭插件名自行拼接未在文档出现的安装命令。

在 DSH 里执行：

# 在 DSH 里
plugin_manager install_bundle <本目录>

或将下列片段放进 profile 的 cordis.patch.yml：

- insert:
    - id: pin
      name: dsh-pin

经过上面的步骤，bundle 会通过 cordis.patch.yml 挂进 Cordis；Web 客户端按 package 配置注入 slots，React 为 external 依赖。

典型用法¶

通过工具
在私聊会话中，让智能体调用 pin_add 写入需要每轮携带的条目，用 pin_list / pin_remove 维护；临时用过的工具说明用 library_add 登记，用 library_search 按关键词检索。群聊中写操作会被 guard 拒绝。

通过设置页
打开设置里的「钉」页签，分别在「钉」「图书馆」里编辑，与 JSON 文件内容一致，适合人工批量整理。

通过 HTTP
若你在同一 DSH 进程上集成了 HTTP 路由，可按 README 列出的路径做 list/add/update/delete 以及 library 的 list/add/delete、candidates 等操作；具体请求体以实现为准，以仓库源码为准核对。

直接改文件
备份后编辑 pins.json 或 library.json，重启或按 DSH 状态加载机制生效即可。

适用场景与注意¶

适合已经在用 DSH、希望把「必须每轮记住的几件事」和「可检索的工具摘要」从泛泛上下文里拆出来的开发者。图书馆模型适合「用过就删、只留一句用途」的插件与资料清单，而不是整份文档仓库。

安装前请自行阅读 仓库源码 与 MIT 许可证。插件以当前 DSH 进程的权限读写 ~/.dsh/jingjing/state/ 下的 JSON；群聊写保护降低误改风险，但不替代你对会话渠道与备份策略的判断。DSH 生态是「一切皆插件」；SkillHub 目录为社区站点，与 DeepSeek、幻方无官方从属关系。

结尾¶

dsh-pin 把长期必记与可删可搜的工具标签分开管，并用私聊 guard 限制写本体。需要试用或二次开发时，可从目录页 xiaole3349/dsh-pin 进入，或直接查看 GitHub 仓库。