实用插件工具箱moon16u/dsh-pouch

dsh-pouch

License: MIT
npm
DeepSeek Harness
pnpm workspace

dsh-pouch 是一个专为 DeepSeek Harness (DSH) 打造的实用小插件工具箱（Pouch Toolkit）。
旨在提供小而美、轻量、开箱即用的实用微扩展，提升日常使用与开发体验。

📦 包含插件

| 插件 | 类型 | 描述 |
| :--- | :--- | :--- |
| @moon16u/dsh-plugin-restart | Host / CLI | 提供 /dsh-restart 命令与 dsh_restart Agent 工具，实现进程分离的安全 3 秒无损自愈重启。 |
| @moon16u/dsh-plugin-current-time | Host / Agent | 每轮对话开始时向 Agent 上下文注入宿主机的真实日期、时间与时区，长会话跨天也不会再按旧日期推理。 |
| @moon16u/dsh-plugin-session-id | Web UI | 在 Web 会话顶栏右侧显示当前 Session ID，支持一键快速复制到剪贴板。 |
| @moon16u/dsh-plugin-web-search-tavily | Capability Seam | 基于 Tavily REST API 的真实网络搜索提供方，无缝接入 DSH 官方 ctx.web 网络能力标准。 |
| @moon16u/dsh-plugin-llm-headers | LLM 接缝 | 请求头由 settings.yaml 说了算的供应方路由（含 DSH 保留的 User-Agent）：字面量、${env:NAME} 插值、按模型覆盖、null 删除，pi-ai 自带的 37 个供应方只写 headers 即可接入。 |
| @moon16u/dsh-plugin-mcp-console | Web UI + Host | 设置页「MCP 服务器」控制台：运行时增删改/启停/重连、工具级开关、SSE 实时状态、mcpServers JSON 导入。零 MCP 协议代码——全部复用官方 @deepseek-ai/dsh-mcp-client；profile YAML 里的 MCP 条目在启动/刷新时自动移植为动态管理（可逆回写）。 |

🚀 快速安装与使用

方式一：通过 DSH CLI 一行命令一键安装（推荐 ⭐️⭐️⭐️⭐️⭐️）

只需在终端执行一行命令，DSH 将自动下载并加载全部 6 个实用插件（0 手动配置，开箱即用）：

1. 一键安装整套工具箱（来自 npm）
dsh plugin --profile web add @moon16u/dsh-pouch

或直接通过 GitHub 仓库安装
dsh plugin --profile web add https://github.com/moon16u/dsh-pouch.git

方式二：通过 Git 源码本地链接安装

1. 克隆仓库到本地：
git clone https://github.com/moon16u/dsh-pouch.git ~/dsh-pouch

2. 在 DSH Profile 中一键引入 Bundle：
dsh plugin --profile web add file:~/dsh-pouch

DSH 将自动识别 dsh.bundle 并自动挂载内置的 cordis.patch.yml，无需手动编辑配置文件。

🛠️ 单个插件详解

1. @moon16u/dsh-plugin-restart
* 痛点：在修改插件或配置后，需要手动到外部终端重启 DSH 进程；如果在 Agent 内部直接 kill 自身会导致会话卡死。
* 解决：在 DSH 内部注册 /dsh-restart 斜杠命令与 dsh_restart Agent 工具，采用 detached setsid 异步工作进程，先正常返回响应再在 3 秒后平滑重启。

2. @moon16u/dsh-plugin-current-time
* 痛点：模型自己没有时钟，只能沿用启动时注入的那一次"今天"。会话跨过午夜后它仍按昨天的日期推理，而对话里没有任何东西会纠正它。
* 方案：挂载 agent/pre-step，在每轮第一步的提问之后追加一条真实时刻读数。按轮而非按步注入，工具调用循环不会把对话刷满几乎相同的时间戳。

3. @moon16u/dsh-plugin-session-id
* 痛点：排查问题、查看日志或跨环境关联时，需要获取当前会话的 UUID，但界面上没有直观的复制入口。
* 解决：在 Web 顶栏工具区优雅注入一个胶囊状的 Session ID 按钮，点击即可一键复制。

4. @moon16u/dsh-plugin-web-search-tavily
* 痛点：默认搜索引擎可能受限或无法获取高质量结构化检索结果。
* 解决：标准实现 DSH 的 ctx.web.registerSearchProvider 接口，支持通过环境变量 TAVILY_API_KEY 或 DSH Credentials 凭据管理服务安全解析密钥。

5. @moon16u/dsh-plugin-llm-headers
* 痛点：DSH 在每个供应方请求上最后合入自己的 attribution User-Agent，llm-pi-ai 里的 headers 无法覆盖这个保留名。按客户端标识鉴权的网关——腾讯 CodeBuddy 会返回 500 {"code":11128,"msg":"request illegal"}——单靠配置无法接入。
* 方案：用自己的 llm-headers 段落声明路由，仍交给官方 PiAiAdapter 承载，只把 pi-ai provider 包了一层，让配置的请求头在进入 socket 前拿到最后一次写权。另附一个请求头设置页（独立左侧栏入口）——官方提供方卡片没有对外 slot，且写进 llm-pi-ai 的请求头本就会被剥掉。包 provider 而不是协议对象，是为了让 pi-ai 自带的路由保留自己的 API 实现——这类路由两行就能接。未配置 headers 的路由照常发送 DSH attribution，且拒绝删除它。
* 版本跨度：为 DSH 0.1.5-rc.1 构建。设置页通过双代线缆读取提供方目录并写入设置——DSH 0.1.1 的 connection.api（APIProxy）或 remote.llm / remote.settings 命名空间——宿主提供哪个就用哪个。它必须遵守两条宿主契约：提供方 profile 校验的是路由的副本，settings provider 交出的 deepFreeze 段落因此保持原样；解析出的 profile 也带上 dsh-llm-pi-ai 的 PiAiAdapter.modelOf 读取的 modelErrors 映射。

6. @moon16u/dsh-plugin-mcp-console
* 痛点：官方接入 MCP 的方式是往 cordis.patch.yml 写静态条目——没有 GUI、不能运行时增删改，每次改动都要重启；声明出来的服务器在面板里只能是只读摆设。
* 方案：设置页新增完整的MCP 服务器管理页，基于 cordis 动态装配运行时编排官方 @deepseek-ai/dsh-mcp-client（每台一个 fiber，热更新配置、免重启 DSH）：主开关、工具级启停胶囊、SSE 实时状态与工具列表、mcpServers JSON 一键导入。外部 Agent 写进 cordis.patch.yml 的 MCP 条目由 Auto-Ingest 引擎接管：启动/刷新时连根移植进 ~/.dsh/dsh-mcp.json（含 fiber 接管与条目级 YAML 精确修剪），POST /export-yaml 可逆回写。所有 API 响应中的凭据一律打码。

🧪 运行测试

本仓库采用 pnpm workspace 管理，所有插件均包含基于 Node.js 原生测试运行器的单元测试与契约测试：

cd dsh-pouch
pnpm install
pnpm test

📄 开源协议与致谢

* MIT License © 2026 moon16u
* Logo 图标来源于 Icons8 的 Toolbox 图标。