# context64

**Repository Path**: liupima/context64

## Basic Information

- **Project Name**: context64
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-29
- **Last Updated**: 2026-10-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Context64：DeepSeek Harness 本地小上下文插件

当前插件版本：**1.2.0**。支持插件市场开关，并覆盖 `hh` 及 Vision Router 自动生成的 `hh-vision` 路由。

针对 DeepSeek Harness **0.2.1-rc.3 Windows 桌面版**开发。安装器修正本地模型的容量配置，在四个内置 Agent preset 的隔离压缩组中安装插件，使用 Harness 自带的压缩、工具输出裁剪、持久化记录及溢出恢复机制。

## 快速安装

先在 Harness 配好 OpenAI 兼容的本地模型，再在 PowerShell 中执行：

```powershell
git clone https://gitee.com/liupima/context64.git
cd context64
.\install.ps1 -HarnessPath 'D:\develop\DeepSeek Harness' -Provider hh -Model deepseek-v4-flash -CheckOnly
.\install.ps1 -HarnessPath 'D:\develop\DeepSeek Harness' -Provider hh -Model deepseek-v4-flash
```

把 `HarnessPath` 改成实际安装目录，`Provider` 改成 `llm-pi-ai` 中已经配置的路由名称。默认值 `hh` 是示例，不是服务器地址或账号。`Model` 必须与该路由的显式 `models` 列表一致。自动识图路由默认按 `<Provider>-vision` 一并保护。此版本仅支持四个内置模式，已有自定义模式覆盖时安装器会拒绝覆盖。

**不要只在插件市场直接安装 Git 地址就开始使用。** 完整安装脚本还会校正本地模型容量，并按当前安装版本生成模式配置；仅安装软件包不能替代这些步骤。

## 安装后验证

1. 保存正在进行的工作，完全退出并重新打开 DeepSeek Harness。
2. **新建一个会话**，选择已配置的本地模型。已有 Agent 可能继续使用旧 preset 修订。
3. 输入 `/context64`，应显示版本 1.2.0、当前路由“保护已覆盖”、容量 64000、压缩阈值约 35200、输出上限 4096。
4. 再运行原来的任务。需要时可在会话空闲时使用内置 `/compact`。

安装以本地链接方式注册，请保留此文件夹的位置。`installation.json` 记录本机备份位置，已加入 `.gitignore`。插件加载测试和模拟压缩测试通过；本仓库不宣称已经验证任意本地服务的真实长任务完成率。

## 界面开关

重启后，插件市场的 `dsh-context64` 卡片会显示启用开关。关闭或开启后，按市场提示重启 Harness，再新建会话；已有会话可能保留旧工作模式修订。

开启时挂载四个模式的 Context64 压缩策略、请求保护和 `/context64` 命令；关闭时移除整个插件配置层，恢复内置模式，插件不再参与。模型的 64000 容量声明和 4096 输出配置属于真实部署设置，会保留；关闭插件并不会把学校模型变成大窗口模型。

1.0.0 把模式配置写在用户 profile 中，且自身 bundle 为空，导致市场无法独立切换。1.1.0 已迁移为非空 bundle 和 Host 生命周期入口，模式声明依赖 `context64Ready`，使市场识别为需整体启停的配置包。迁移仅移除完全匹配旧版生成内容的行；检测到手动修改过的模式会停止，避免覆盖用户设置。

## 修复内容

1.2.0 修复了实际失败日志发现的路由遗漏：会话走 `hh-vision`，旧版仅配置 `hh` 的压缩策略，导致摘要请求回落到不适合小窗口的默认输出预算。现在同时给两条路由配置 4096 摘要预算，并在路由确定后的发送阶段再检查压力。`/context64` 显示当前路由是否覆盖，避免只显示基础路由而掩盖遗漏。

已经报错的旧会话：保存工作并完全重启 Harness，回到原会话，先用 `/context64` 确认 1.2.0 和“保护已覆盖”，再在空闲时执行 `/compact`；成功后继续任务。不要连续重复发送“继续”来堆积待处理输入。

原始故障环境中的自定义模型没有 `contextWindow` 和 `maxTokens`。在测试版本中，自定义模型容量默认按 262144 tokens 处理，而内置压缩的默认 headroom 为 65536 tokens。直接用于约 64K 的服务端容量，会造成压缩时机和预算不匹配。

| 设置 | 本插件值 |
|---|---:|
| 模型容量声明 | 64000 tokens，保守兼容用户报告的约 65535 上限 |
| 压缩比例 | 0.55，正常阈值约 35200 tokens |
| 单次输出上限 | 4096 tokens，保留调用方更小的上限 |
| 压缩额外预留 | 8192 tokens |
| 摘要输出上限 | 4096 tokens |
| 最近历史保留预算 | 4000 tokens，按完整消息/工具配对边界选择 |
| 压缩额外尝试 | 最多 2 次，由官方引擎管理 |
| 已识别溢出重试 | 最多 2 次，由官方引擎管理 |

压缩使用当前配置的模型。插件没有外部 AI 接口，不读取或上传 API Key，不修改模型服务。安装保留原来的 endpoint、凭证引用和其他模型配置。

标准、PTC、最小和 Creator（`cordis`）四个内置 preset 均已适配。桌面版禁用了顶层压缩器，因此仅修改顶层 `compaction-basic` 不够；bundle 保留每个 preset 的完整定义及 `!!js` 表达式，在其隔离组内部设置策略并挂载插件。自定义 preset 需要单独适配。安装后的 preset 是当前版本的配置快照，升级 Harness 时应重新评估，不应直接沿用到未测试版本。

## 重新安装或迁移

在此目录打开 PowerShell：

```powershell
.\install.ps1 -CheckOnly
.\install.ps1
```

不同机器可指定安装目录和模型路由：

```powershell
.\install.ps1 -HarnessPath 'D:\develop\DeepSeek Harness' -Provider hh -Model deepseek-v4-flash -ContextWindow 64000
```

请使用完整安装脚本；单独 `dsh plugin add` 只注册软件包，不能修正模型容量和四个 preset。安装器只接受已测试的 `0.2.1-rc.3`，会先备份配置，再通过官方 CLI 安装，并检查是否存在并发配置修改。插件更新不终止正在运行的桌面进程。

## 回滚

```powershell
.\uninstall.ps1
```

回滚会移除 Context64 软件包并恢复首次安装前的 profile patch。若配置在安装后又被修改，脚本会拒绝整文件恢复，避免覆盖后续设置；此时依据 `installation.json` 中的 `originalBackup` 手动合并。不会删除会话记录。

## 测试

```powershell
node --test .\tests.test.cjs
$env:ELECTRON_RUN_AS_NODE = '1'
& 'D:\develop\DeepSeek Harness\DeepSeek Harness.exe' --expose-internals .\integration.cjs | Out-Host
Remove-Item Env:ELECTRON_RUN_AS_NODE
```

9 项单元测试验证预算、幂等安装、配置保留、路由覆盖、发送前压力检查、输出限制、错误配置识别和取消行为。集成测试使用本机真实 Cordis、TokenMeter、Session、压缩器和插件加载器，模型响应为模拟；42192 tokens 的测试历史压缩至 5408。精确复现用户报告的 65535 上限错误后，`hh-vision` 返回重试且摘要预算为 4096。另使用真实失败会话的内存副本测试，较长模拟摘要下估算 57346 → 33877，原始文件哈希不变。详见 `TEST-RESULTS.md`。

## 边界与排错

- 这不是扩大模型窗口。旧历史会被摘要，可能丢失细节；重要代码和数据应保留在文件中。
- 计量由 Harness 提供，未接入学校服务的精确 tokenizer。35200 是估算触发阈值，不能保证任意中文、代码或工具返回都绝不超限。
- 单条巨大输入、系统提示或工具参数无法总被自动切分；建议分批读取文件，避免一次粘贴整个仓库。已严重超限的旧会话可能连摘要请求都无法提交，建议在新会话中附上目标、当前进展和文件位置。
- 网络超时、认证错误、服务端故障和模型摘要失败不属于本插件可以修复的范围。出现新错误时保留完整错误文本。
- `/context64` 的容量检查读取部署配置，不是服务端容量探测。若真实上限不是 tokens，需要重新设计预算。

参考：[官方压缩器文档](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/compaction/compaction-basic/README.md)、[官方 preset 文档](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/preset/agent-preset/README.md)。本插件按本机已安装代码测试，在线 master 的接口和默认值可能不同。

## 许可证

本项目采用 [MIT License](LICENSE)。预设配置和部分测试结构基于 DeepSeek Harness，归属与许可证见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。