P02-1010751281/dsh-project-context ↗★ 1

dsh-project-context

DeepSeek Harness plugins for project-level persistent context: memory consolidation (MEMORY.md + CONTEXT.md), low-frequency autolearn for project skills, session archives with a mechanical index, and automatic handoff. 适合需要项目级记忆固化、技能沉淀和自动交接任务的开发团队。

Package
dsh-project-context
Compatibility
Unverified
Harness peer range
>=0.1.7-rc.2
Cordis peer range
^4.0.2
Version
0.2.1
License
MIT
Last updated
Sep 27, 2026

Other repositories with this package name

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:P02-1010751281/dsh-project-context

配置

Settings → Plugins → 已安装列表里的 dsh-project-context 一行(打开后是记忆整理 / 技能沉淀 / 自动交接三区,共享的辅助模型路由在记忆整理区末尾),host 侧实时生效。卡片挂在插件页的 plugins.bundle.config 槽位、键为 bundle 包名 dsh-project-context(该槽位按包名分派; plugins.item 归官方插件卡片),经宿主的 configForms 服务读写本命名空间,并由 whileServed 门控——profile 没装 host 半时页面上不会留下痕迹。

卡片本身不是自绘的:框架、保存按钮、文本/数字行、只读与未加载提示都来自平台的 @deepseek-ai/dsh-client-ui-primitives(SettingsForm / SettingsValueField / Switch / Pill / Tag / Button),暂存写入用平台的 SettingsFormModel,本仓库只提供一张字段表 (client/card-fields.ts:21 行 = spec + 投影 + 渲染行三者共同的唯一来源)和一份纯几何、零颜色 的排版样式表。因此保存语义也是平台的:一次原子 mutate(带 revision fence)、Host 拒绝时保留草稿, 离开页面即丢弃草稿——所以卡片上没有「放弃」按钮(与官方设置页一致)。

命名空间就是 Loader 条目 id project-context:dsh 0.1.7-rc.2 起,设置表单由归属插件模块导出的 Config schema 投影而来(SettingsForms.schema(entry) 读 entry.fiber.runtime.Config), 不再有 settings.register / installSection 这类运行时注册 API。所以 host 半边把 PluginSettingsSchema 作为 Config 从 project-context 入口导出;四个插件共享同一个命名空间 (该入口发布自己 fiber 的 live config,其余三个读取它),base 层因此恒为 cordis.patch.yml 里 project-context 那一行的 config:,改其余三行不生效。

新增字段必须带 volatile 标记(.extra("volatile", true),见 src/shared/settings.ts): describe() 用 volatileForm() 过滤,一份没有该标记的 schema 会让整个条目从被服务命名空间里 消失,卡片随之无错误、无日志地不渲染(test/settings-form.test.mjs 逐个字段钉住这条)。标记同时让 这些字段以活引用交给插件,所以 resolvePluginConfig 会按 cosmokit 的共享协议解引用,而共享设置 是读取器而非快照——loader 对只改 volatile 字段的写入是原地提交引用、不重启条目。

设置值写在当前 profile 的 patch 文档里(SettingsForms.documentPath),不再是 ~/.dsh/settings.yaml:rc.2 在 Loader 安定后把该文件里的旧段一次性导入 profile(文件改名为 settings.yaml.imported),既有配置因此自动接续。面板未覆盖的字段回落到 profile 配置,再回落到默认值。

字段默认说明
archiveEnabledtrue关掉后不再自动写会话存档与索引(/session-log 仍可用)
autoConsolidatetrue关掉后不再自动整理(命令仍可用)
consolidateTurns6较上次整理新增的用户消息数达到后在 idle 触发
consolidateIntervalMs300000自动整理最小间隔
forceDedupeMs15000强制调用去重窗口
autoLearntrue关掉后不再自动沉淀技能(命令仍可用)
autolearnTurns20自上次沉淀累计的用户消息数阈值
autolearnIntervalMs1800000自动沉淀最小间隔;仅在有新 MEMORY/CONTEXT 内容时执行
maxTokens8192辅助模型调用的起始输出上限;整理会按「记忆+上下文需回吐的 token 数」自适应上调
maxOutputTokens32768自适应上调的边界(≥256):输入很大时把单次输出上限往它上调。它是自适应上调的边界而不是绝对天花板:maxTokens 更大时以 maxTokens 为准;若适配器自己给出更小的模型上限,则以模型上限为准。交接摘要的失败重试同样被该边界压住(min(2×maxTokens 或 32768 的较大者, max(maxTokens, maxOutputTokens));边界低于起始上限时重试被取消,只发一次原请求)
provider / model空辅助调用路由覆盖;默认用 agent 最近一次请求的路由
handoffEnabledtrue关掉后不再自动交接,/handoff 仍可用
handoffAdaptivetrue自适应阈值 = 护栏取小:质量层(autoCompactTokenLimit ?? knee(window)——宿主暴露可用输入上限时优先用它,目前 dsh 只暴露 contextWindow,故恒回退膝曲线)与可用窗口;基线/保留量只决定可行性下限。false 时用固定比例
handoffThresholdRatio0.4handoffAdaptive: false 时的固定比例(0.1–0.95);被 4K 安全边际压掉时阈值标签会写明实际值
handoffTargetTokens64000自适应模式:每次摘要移交的对话量(8000–200000)。这是手动设定的阈值请求,触发点由护栏决定;一旦被护栏压掉,/handoff status 点名被覆盖的值与压住它的那条护栏,不静默
handoffKeepTokens20000最近对话原文带入新会话(0–200000,0 = 只带摘要)。切点按消息而不是按轮,且至少要保留一条消息,所以实际带入量最多比它多一条消息(每条渲染后 ≤ 4000 字符)
handoffSummaryThinkingoff摘要调用思考级别:off 或 session
handoffLanguageauto交接语言:auto 按对话判定(CJK≥2 → zh;纯拉丁≥20 字母 → en;否则沿用上一条交接提示的语言,兜底 en),也可固定 zh / en
handoffPendingQuestiondefer最后一条助手消息是未答问题时:defer 让自动交接等回答(手动 /handoff 始终执行),wait 照常交接并把问题作为独立段落带进新会话,且该段落取代常规的「先做下一步」结尾(= pi 侧 handoffGuard: wait)