前言¶
在 DeepSeek Harness 的插件化使用场景中，有些需求并不是新增一个 agent runtime，而是把已有的 longgraph prompt library 接到会话的 skill seam 上。dsh-plugin-longgraph 属于这类社区插件：它把 longgraph、loop-graph、loop-converge 这三个 authoring skills 注册到 ctx.skills。
这是什么¶
dsh-plugin-longgraph 是一个社区插件，由 levi-qiao 维护，MIT 许可。它只服务于 DeepSeek Harness，不会在其他产品上安装或启动节点。资料说明，它与 DeepSeek AI 无官方从属或维护关系，也不是官方 Harness bundle。
这个插件不添加 agent runtime。它通过 DeepSeek Harness 的 skill seam 暴露 longgraph prompt library，并用 resourceBase 指向打包好的技能目录，使 templates 和 references 可以解析。
核心能力¶
插件提供三个技能：
1、longgraph：先做 fit check，再交给 loop-graph。
2、loop-graph：访谈、编译 .longgraph/<date-slug>/，然后启动或打印 DSH prompts。
3、loop-converge：应用 code-convergence preset，然后执行同样的编译。
实现上，它没有 runtime config，并通过 ctx.skills.registerProvider 注入技能。
它还会声明 dsh.bundle.patch，并随包提供 cordis.patch.yml，其中插入一个名为 dsh-plugin-longgraph 的行。
dsh.bundle.patch
cordis.patch.yml
dsh-plugin-longgraph
安装与启用¶
DeepSeek Harness 处于 developer preview。资料给出的安装命令如下：
dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph
dsh --profile web
安装完成后，可以调用以下技能：
invoke skill({ name: "longgraph" })
也可以调用 loop-graph 或 loop-converge。
如果需要固定一个 commit，可以使用：
dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph#<commit>
需要说明的是，资料中的安装命令使用 --profile web；资料未说明该 profile 是否在所有环境都必需。
Git 安装会拉取源码，prepare 会运行 tsdown。如果使用 pnpm 10+ 且 pnpm 阻止 prepare，可以把该包加入 profile 的 pnpm-workspace.yaml build allowlist，然后重试。
资料也给出 Direct Cordis row：
- id: longgraph-skills
name: dsh-plugin-longgraph
典型用法¶
先根据目标选择入口：
1、使用 longgraph：先做 fit check，再交给 loop-graph。
2、使用 loop-graph：进入访谈流程，编译到 .longgraph/<date-slug>/，然后启动或打印 DSH prompts。
3、使用 loop-converge：先应用 code-convergence preset，再执行同样的编译。
如果涉及 timers，资料给出以下约束：
- 使用两个独立的 root sessions。
every_seconds下限是 300。- schedule 是 session-local，两个 sessions 都必须保持 live。
- 若某个 session 正忙，它会等空闲后再
followup()；timer 不会打断 fire。 - 不要
followup()或inject()另一个 session。
依赖与兼容性¶
资料给出的 peerDependencies 范围如下：
@deepseek-ai/cordis >=4.0.1 <5
@deepseek-ai/dsh-skill >=0.1.0-rc.5 <0.2.0
由于 DeepSeek Harness 仍在 developer preview，兼容性破坏性变化会要求新的插件版本。
开发命令¶
如果需要本地验证，资料给出的命令是：
pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm integration
适用场景与注意¶
适合在 DeepSeek Harness 中使用 longgraph prompt library 的开发者，尤其希望只注册技能、不引入额外 agent runtime 的场景。
不适合作为以下替代方案：
dsh-agent-loopScheduleJobsWeb UI
它也不是 multi-host skill pack。
安装前请注意：插件会以当前 dsh 进程权限运行，并且会注册可被会话调用的技能。建议先检查 GitHub 源码、MIT 许可证、peerDependencies 范围，以及 cordis.patch.yml 中插入的行。
链接¶
- GitHub：https://github.com/levi-qiao/dsh-plugin-longgraph
- 目录页：资料未提供。
结尾¶
dsh-plugin-longgraph 的价值比较具体：把 longgraph、loop-graph、loop-converge 这几个编写技能接到 DeepSeek Harness 的 ctx.skills 上，让模型可以通过 skill seam 使用对应指令。对于想在 DSH 中使用 longgraph prompt library 的场景，它是一个轻量的社区接入点。
