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