gxx950224/SapBuddy-dsh
SapBuddy 的 DeepSeek Harness（DSH） 底座版：41 个 SAP 工具、技能集、写门禁等核心价值 以 Cordis 工具插件 + agent preset 的形态嵌入 DSH，通过 Web GUI 与 headless 单次问答使用。
catalog 简介 / catalog descriptioncatalog description：SapBuddy-dsh
安装Install
dsh plugin --profile web add github:gxx950224/SapBuddy-dsh把 gxx950224/SapBuddy-dsh 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
SapBuddy × DeepSeek Harness
SapBuddy 的 DeepSeek Harness（DSH） 底座版：41 个 SAP 工具、技能集、写门禁等核心价值 以 Cordis 工具插件 + agent preset 的形态嵌入 DSH，通过 Web GUI 与 headless 单次问答使用。
需求与实施路径见
docs/。
仓库结构
sapbuddy-dsh/
├── packages/
│ ├── sapbuddy-tools/ # 41 个 SAP 工具（vendored from SapBuddy）+ DSH 注册层 + 写门禁 + 连接存储 + 提示词注入
│ │ ├── src/sap-tools/ # 业务实现（tools/、adtManager、config、taskTransport、auditLog、register、gate…）
│ │ └── test/ # 工具层 + 转换器 + 插件加载 + 门禁 + 连接存储 + 提示词注入单测（172 用例全绿）
│ ├── sapbuddy-settings/ # DSH 设置宿主 API：webServer 路由（SAP 连接管理）
│ │ └── src/index.ts # （list/upsert/activate/delete/test，inject:['webServer']）
│ └── sapbuddy-settings-ui/ # DSH 设置界面 "SAP 连接" 页（客户端 settings.section）
│ └── client/index.ts # 浏览器：SAP 连接管理页（esbuild → dist/client.js）
├── preset/ # sapbuddy agent preset 模板（agent.cordis.yml + preset.yml + skills/ + prompts/ + AGENTS.md + 配置示例）
├── overlays/
│ └── headless.sapbuddy.yml # headless 单次问答 overlay
├── scripts/
│ ├── install.mjs # 一键安装器（构建/插件/preset/配置收口；模型复用 DSH）
│ └── recover.mjs # 恢复脚本（仅移除 sapbuddy 设置行，保留用户其他自定义行）
├── docs/
│ ├── REQUIREMENTS.md # 需求文档 v1.0
│ └── SYNC.md # 与上游 SapBuddy 的同步工作流
└── test/ # (后续) 集成测试
配置自包含：SapBuddy 的一切配置（connections/settings/logs/output/uploads）与提示词（prompts/SYSTEM.md、AGENTS.md、prompts/Memory.md，随会话注入）收口在 已安装 preset 目录
~/.dsh/.agent-presets/sapbuddy/，随 preset 一起分发/升级；工具层经sapbuddy-home.ts（SAPBUDDY_HOME可覆盖）解析，不再使用~/.SapBuddy（安装器负责一次性迁移）。
安装（快速开始）
git clone https://github.com/gxx950224/sapbuddy-dsh.git && cd sapbuddy-dsh
pnpm install && pnpm -r build # 全新 clone 需要先构建（dist 不入库）
node scripts/install.mjs # 安装插件到 web profile、复制 preset（模型走 DSH 模型页）
安装器会：把 sapbuddy-tools / sapbuddy-settings / sapbuddy-settings-ui 装进 web profile、
复制 preset 到 ~/.dsh/.agent-presets/sapbuddy/。不配置模型/凭据——模型直接复用 DSH 自身配置（Web 设置 → 模型页选择 provider/模型并填 key）。
然后：
- 模型：直接复用 DSH 配置（Web 设置 → 模型页选 provider/模型，需要时填 key）
- 填写 SAP 连接：编辑
~/.dsh/.agent-presets/sapbuddy/connections.json（参考仓库preset/connections.example.json；ADT 需在 SICF 激活/sap/bc/adt）； - 启动：
dsh web→ 浏览器打开 → 侧边栏选择 SapBuddy preset → 开始会话； - 单次问答：
dsh --profile headless --patch <sapbuddy-dsh>/overlays/headless.sapbuddy.yml "解释 ZPPR006"（headless 需先dsh plugin --profile headless add sapbuddy-tools）。
恢复：设置页出问题可 node scripts/recover.mjs（只移除 sapbuddy 设置行，保留你在
patch 里的其他自定义行）。
让 AI 一键安装（提示词，可直接复制给 AI 助手）
不想手动敲命令？把下面这段完整粘贴给任意 AI 编码助手（DeepSeek Harness 会话等）， 它会按步骤下载、构建、安装：
下载并安装 sapbuddy-dsh 到本机 DeepSeek Harness：
1. git clone https://github.com/gxx950224/SapBuddy-dsh.git 到工作区，进入目录
2. pnpm install && pnpm -r build # 全新环境也能编译（peer 依赖自动装）
3. 运行 node scripts/install.mjs # 装 sapbuddy-tools / sapbuddy-settings / sapbuddy-settings-ui
# 到 DSH web profile，复制 preset 到 ~/.dsh/.agent-presets/sapbuddy/
⚠️ 这一步要写 ~/.dsh/（profile patch、preset 目录），在你的沙箱权限之外：
如被沙箱拒绝，申请权限升级并等待用户批准；不要绕过、不要用其他方式偷偷写这些文件。
4. 安装器不配置模型和 API Key——模型由用户到 DSH 的 Web 设置 → 模型页选择（含填 key）。
5. 完成后向用户报告：
- 重启 dsh web（需用户自己执行）
- 侧边栏选择 "SapBuddy" preset
- 编辑 ~/.dsh/.agent-presets/sapbuddy/connections.json 填 SAP 连接
- （可选）MCP 服务器按本仓库 README 用 dsh-mcp-client 配置
注意事项：
- 前提：机器有 git、Node ≥ 22、pnpm（缺 pnpm 先 npm i -g pnpm，同样需批准）
- 不要修改 preset 里已存在的 connections.json / Memory.md（用户数据）
- 全程不要动 ~/.dsh/settings.yaml 的模型段和 ~/.dsh/.credentials.yaml
MCP（可选）
MCP 服务器由你直接在 DSH 内置 dsh-mcp-client 配置（在 ~/.dsh/profiles/web/cordis.patch.yml
加一个 - insert: 行），注册的工具名为 mcp__<server>__<tool>（双下划线）。本仓库不提供
程序化写 MCP 配置的代码。示例：
- insert:
- id: mcp-sap-mcp-dev
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: sap_mcp_dev
transport: streamable-http
url: https://<host>:44300/sap/bc/zsx_intf_serv/zsx_mcp?sap-client=100
headers:
X-API-Key: "<key>"
MCP 自签名证书（重要）
SAP 内网 MCP 端点通常用自签名证书，而 dsh-mcp-client 经 MCP SDK 的 fetch 连接，
默认 TLS 会拒绝（DEPTH_ZERO_SELF_SIGNED_CERT）→ 连接失败、MCP 工具不出现（静默，无报错）。
解决：在启动环境放开 TLS 校验（.env 缝被 DSH 安全策略拒绝，只能在启动环境设）：
# ~/.zshrc 加一行（或每次启动前缀）
export NODE_TLS_REJECT_UNAUTHORIZED=0
更安全：导出 SAP 证书并用 NODE_EXTRA_CA_CERTS=/path/sap-cert.pem（只信任该证书，验证保持开启）。
阶段进度
| 阶段 | 内容 | 状态 |
|---|---|---|
| 0 | 机制验证（动态插件 + headless 物化） | ✅ |
| 1 | 仓库骨架 + 工具源码移植 + 原测试跑绿 | ✅ |
| 2 | 注册适配层（zod→spec + ctx.tools.register） | ✅ |
| 3 | 写门禁（guard + ask 门 + 授权窗口 + 知识库只读） | ✅ |
| 4 | agent preset（persona + skills 挂载 + standingKeyFor） | ✅ |
| 5 | 安装器（插件/preset，模型复用 DSH） | ✅ |
| 6 | headless overlay + 文档 + 端到端验证 | ✅ |
开发
pnpm install # 正常环境直接安装（沙箱内可 --store-dir 指定本地 store）
# dev 依赖解析：@deepseek-ai/dsh-tools / @deepseek-ai/cordis 为 peerDependencies，由 pnpm 自动安装
# （npm 上已有匹配版本）；运行时由宿主 DSH profile 提供
pnpm -r build
pnpm -r test # sapbuddy-tools：172 用例（门禁/转换器/插件加载/连接存储/提示词注入）全绿
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…