DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zszzlzm /

zszzlzm/dsh-context-compactor

Topic repository only

L0-L5 context compaction pipeline for DSH + Ollama

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@d1c9f767

DSH Context Compactor

一个跑在本地 Ollama 上的长会话上下文压缩管道(L0–L5):把 DSH 会话压成分段摘要、锚点与稳定的状态 JSON,并在每轮增量合并时做确定性校验。

本仓库是从一个私有中文小说写作工作区中抽出的工具代码,不含小说正文、图片、模型权重或真实会话日志。代码按 Windows 优先设计,其他平台可参考 src/qwen_client.py 的 HTTP 客户端。

它做什么

session.v4.jsonl.zstd
   │  L0 瘦身(工具流水过滤/分块)
   ▼
   │  L1 锚点(路径/编辑/CMD,kind-aware normalization)
   ▼
   │  L2 分段摘要(facts/quotes 逐字校验、薄摘要重摘)
   ▼
   │  L3 变更集合并(JSON Schema 约束解码)
   ▼
   │  L4 校验/两阶段提交(idx+expect、base_hash、fail-closed)
   ▼
   │  L5 垃圾回收(字节预算 + 归档守恒)
   ▼
02_文档/会话状态/状态.json  +  每轮 changes.json

核心模块(src/_试作/,保留原项目目录名以兼容相对路径):

模块 作用
compact_context.py 驱动:跑 L0–L5、锁、checkpoint、后台续跑、pending 排队
qwen_client.py 本地 Ollama HTTP 客户端(JSON/约束解码、done_reason、自动拉起)
slim_v2_27b.py / anchors_v2_27b.py L0/L1 瘦身与锚点提取
sum_v3_27b.py / thin_check.py L2 摘要与空壳检测
l4_v3_27b.py / schema_contract.py L3/L4 校验、契约常量与 schema 比对
gc_v2_27b.py L5 预算回收与归档
merge_budget.py / job_marker.py / pending_queue.py / service_wait.py 预算、任务标识、排队、服务等待
delegate.py / delegate_checks.py 本地 27B 派活(契约 lint + 验收反馈)

快速开始

  1. Python 3.12+
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
  1. Ollama + 模型
# 模型目录按你的实际位置改
$env:OLLAMA_MODELS='C:\path\to\ollama-models'
$env:QWEN_MODEL='qwen3.8:27b-mtp-q4_K_M'   # 换成你本地有的模型
.\\.venv\\Scripts\\python.exe src\qwen_client.py --ensure-service
.\\.venv\\Scripts\\python.exe src\qwen_client.py --ping
  1. 跑一轮压缩
.\\.venv\\Scripts\\python.exe src\_试作\compact_context.py --last-turns 1 --dry-run
# 去掉 --dry-run 才会写 02_文档/会话状态/
  1. DSH 插件(可选)

plugins/dsh_plugin_compactor/ 是 DSH Host 插件;把 plugins/dsh_plugin_compactor/cordis.patch.yml 里的 projects 改成你的工作区路径后安装。插件默认用 pythonw.exe,避免 GUI 宿主弹出控制台窗口。

配置

环境变量 默认 说明
QWEN_URL http://127.0.0.1:11434/api/chat Ollama chat 地址
QWEN_MODEL qwen3.8:27b-mtp-q4_K_M 模型名
OLLAMA_MODELS Ollama 默认 模型目录;自动拉起 ollama serve 时继承
QWEN_NO_AUTOSTART 未设置 设为 1 禁用自动拉起

测试

.\\.venv\\Scripts\\python.exe tests\run_offline.py

离线测试不需要 Ollama/GPU;覆盖 L4 契约、预算裁剪、排队、任务标识、GBK 控制台、摘要空壳检测等。src/_试作/test_pipeline.py 用合成会话跑端到端(不调模型)。

不包含

  • 小说正文、插图、素材、模型 LoRA 权重
  • 真实会话日志、会话状态、日志、备份
  • 项目问题清单与审查报告(内部数据)

设计文档

  • 上下文压缩
  • 开发约定
  • 委托协议
  • 审查规程
  • DSH 环境注入上游补丁方案

License

Apache License 2.0,见 LICENSE。文档与代码同许可。

—/ 5

No ratings yet

Manifest verification required

Commit d1c9f767fd98

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout