dsh-plugin-longgraph

English · 简体中文

面向 DeepSeek Harness 的社区插件：把 longgraph 作者技能注册到 ctx.skills。

社区插件，与 DeepSeek AI 无隶属关系，亦非其维护。

本包 只适配 DeepSeek Harness，不会在其他产品上安装或拉起节点。

longgraph 是一套长周期 智能体提示词库：执行节点、台账、干净上下文的监督节点，只通过单向 directives 边相连。每个节点自己有一口钟，彼此不唤醒。本插件不加运行时， 只通过 Harness 的 skill 缝把这份库暴露出去。

技能

插件加载后，ctx.skills.list() / snapshot() 会列出：

名称	作用
longgraph	适配检查，然后交给 loop-graph
loop-graph	面试 → 编译 .longgraph/<日期-slug>/ → 拉起或打印 DSH 提示词
loop-converge	代码收敛预设，再走同一套编译

get / 模型侧的 skill({ name }) 返回完整指令正文。resourceBase 指向打包进去的技能目录，这样模板和 references/deepseek-harness.md 可以按相对路径解析。

安装

DeepSeek Harness 目前是开发者预览。本插件将 @deepseek-ai/dsh-skill 钉在 >=0.1.0-rc.5 <0.2.0，并对照公开的 0.1.0-rc.6 线验证。

Profile bundle（推荐）

dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph
dsh --profile web

然后调用 skill({ name: "longgraph" })（或 loop-graph / loop-converge）。

package.json 声明了 dsh.bundle.patch。随包的 cordis.patch.yml 插入一行 name: dsh-plugin-longgraph。Profile 组合先应用这一层，再应用 profile 自己的 patch。

需要冻结版本时钉 commit：

dsh plugin --profile web add github:levi-qiao/dsh-plugin-longgraph#<commit>

从 Git 安装会拉源码，因此 prepare 会跑 tsdown。pnpm 10+ 若拦截 prepare，把该包装进 profile 的 pnpm-workspace.yaml allowBuilds 后再试。

直接写 Cordis 行

- id: longgraph-skills
  name: dsh-plugin-longgraph

插件 inject 的是 skills，调用 ctx.skills.registerProvider。没有运行时配置。

DeepSeek Harness 上的定时器

两个独立的 根会话，两口 schedule_create 钟：

• every_seconds 下限是 300（五分钟）。
• Schedule 是 session-local——两个会话都要保持在线。
• 会话正忙时，到期的 every 会等到空闲再 followup()，不会打断当次 fire。
• 绝不对另一个会话 followup() / inject()。执行节点在下一次 fire 读新的 directives。

见 宿主 reference。

兼容性

Peer	范围
@deepseek-ai/cordis	>=4.0.1 <5
@deepseek-ai/dsh-skill	>=0.1.0-rc.5 <0.2.0

Harness 仍是开发者预览。破坏性变更需要发新的插件版本。

开发

pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm integration

pnpm test 用真实的 @deepseek-ai/dsh-skill SkillRegistry 加载随包的 apply，并读取打包进去的 SKILL.md。pnpm integration 用公开的 Cordis Loader 再启动同一份插件。

这不是什么

• 不是 DeepSeek AI 产品，也不是官方 Harness bundle。
• 不替换 dsh-agent-loop、Schedule、Jobs 或 Web UI。
• 不是多宿主技能包。多宿主提示词库仍在 longgraph-skill。

许可证

MIT © 2026 levi-qiao