LodyAI/acp-extension-dsh

acp-extension-dsh

面向 DeepSeek Harness 的 ACP 会话控制与固定编码配置。

该包是一个 Cordis 插件，而非 Harness 的替代品。它添加了 ACP 模型、推理强度、权限和代理预设选择器，当所选模型声明支持图像输入时接受内联图像（默认的 deepseek-flash / DeepSeek-V41-Flash 支持），并将 ACP 提供的 stdio 或 Streamable HTTP MCP 服务器挂载到每个 Harness Agent 作用域中。Harness 继续负责模型执行、沙箱强制、持久化、预设组合、工具执行和一次性审批。

该适配器声明 Core 的 _meta.lody.compaction 能力，并将 Harness 的 compaction/start 和 compaction/end 事件转换为携带 _meta.lody.activity 的标准 ACP 工具生命周期。手动和自动压缩保持可区分，失败的压缩保留 Harness 错误原因。已提交的助手图像通过附件存储读回，并作为 ACP 图像块发送。提示完成和取消在释放会话的提示槽之前，会等待准入、Harness 空闲和有序输出交付。

ACP 模型选项在每次创建会话时从 Harness 发现，并通过标准的 model 配置选项和旧版 ACP models 响应返回。精确的每模型元数据控制推理选择器和图像准入，旧版响应携带 model[effort] 条目，以便主机可以缓存每个模型的推理选项，而不仅仅是探测期间恰好处于活动状态的模型。权限选项使用组合后的 Harness 预设表。
当设置了 DEEPSEEK_BASE_URL 时，适配器每个 ACP 连接请求一次其 OpenAI 兼容的 GET /models 端点，通过 Harness 解析每个公布的 id，并最初选择第一个结果。发现过程是有界的，不跟随重定向，并在端点无法提供可用列表时报告可操作的启动失败。没有端点时，Harness 目录保持建议性质：显式配置或选择的模型即使未被列出也仍会被解析。

ACP 主机挂载 Harness 的基于文件的设置提供程序。它读取 $DSH_HOME/settings.yaml，回退到 ~/.dsh/settings.yaml，并向支持设置的插件公开用户部分。缺失的设置保留组合默认值；格式错误的设置文档会导致启动失败，而不是被静默忽略。
llm-deepseek.models 数组会完整替换本地目录，因此请保留任何应保持可选的默认模型及其视觉元数据。例如：

llm-deepseek:
models:
- id: deepseek-flash
name: DeepSeek-V41-Flash
inputModalities: [text, image]
- id: deepseek-v4-flash
name: DeepSeek-V4-Flash
- id: deepseek-v4-pro
name: DeepSeek-V4-Pro
- id: deepseek-v4-flash-vision-exp
name: DeepSeek-V4-Flash-Vision-Exp
inputModalities: [text, image]
- id: custom-model
name: Custom model

提供方会监视文件编辑，但 ACP 模型选择按连接缓存。
在目录编辑后，重新连接并刷新主机的模型能力。
DEEPSEEK_BASE_URL 仍用于选择端点发现：此设置不会将仅本地模型 ID 合并到端点的 /models 响应中。API 凭据保留在主机环境中；生成的组合不包含凭据。

Token 与 USD 计费

Core 的用量能力报告已提交请求用量、按模型累计总量以及已包含的增量。固定的 Harness 0.1.1-rc.2 在 assistant/message 上提供用量，并在 request/context 上提供实际路由元数据；原始流块不会再次计数。测试不需要模型请求或转录。仅统计 ACP 拥有的 Harness 会话中报告的活动；没有用量事件的独立后台代理或内部操作不会被虚构。

官方 DeepSeek 价格 于 2026-09-13 直接核对，在完成时按请求估算。
非高峰时段 USD/百万 token（缓存未命中 / 命中 / 输出）：Flash 0.15 / 0.003 / 0.6；
V4 Pro 0.66 / 0.022 / 1.98。工作日 UTC 01:00–04:00 和 06:00–10:00 为这些费率的两倍。deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 现在别名到新的 deepseek-flash 价格。未知模型/自定义端点没有估算成本。
这些是标价估算，不是发票；跨边界请求可能有所不同。
只有官方端点上的已注册 deepseek-official 路由会被计价；任意名为 deepseek 的提供方并不构成官方计费的证据。
在发布此适配器依赖之前，先发布 Core 0.1.5。

导出

- acp-extension-dsh 导出 Cordis 插件：apply、inject 和 name。
- acp-extension-dsh/capabilities 导出供主机 UI 使用的选择器词汇表。
- acp-extension-dsh/profile 导出固定的 Harness 版本、同版本 npx 包闭包，以及 createDeepSeekHarnessProfileFiles，后者渲染生成的 dsh 配置文件。

主机使用 --profile lody-acp 启动固定的 dsh 可执行文件，将生成的配置文件（@deepseek-ai/dsh-base 包加上 Lody cordis.patch.yml 覆盖层）写入
$DSH_HOME/profiles/lody-acp。它将该包的官方
standard/ptc/minimal/cordis 预设快照暂存到 ACP 适配器旁边。
Harness 按会话挂载所选预设，并且还会发现 $DSH_HOME/.agent-presets 下的用户预设。MCP 工具使用 Harness 原生的
mcp____ 命名，并随其所属的 ACP 会话一起移除。

生成的配置文件默认将会话持久化设置为上游的 zstd
编码。复用现有 Harness 会话根目录的主机只有在验证该根目录包含原始
session.jsonl 产物，且没有 session.jsonl.zstd 产物。Harness 根目录
是单一编码存储：宿主必须拒绝混合根目录，且不得移动、
重写或删除用户产物。

ACP 配置文件保持会话查询服务挂载以进行精确读取，但将其
全文 SQLite 索引设置为 openAt: never。此组合不会暴露
会话搜索工具，且不能假定公开的 Node 发行版
包含 SQLite FTS5。禁用未使用的索引可防止 ACP 启动
依赖于该可选的 SQLite 构建特性。

开发

npm install
npm run build
npm test
npm run format:check

需要 Node.js 22 或更高版本。

可选的真实运行时设置回归测试使用预安装的配置文件
闭包。首先在单独的目录中安装 createDeepSeekHarnessNpxSpecifiers() 返回的
每个说明符，然后运行：

DSH_TEST_RUNTIME_ROOT=/absolute/runtime/node_modules npm run test:settings-profile

该测试本身仅使用隔离的临时主目录、合成设置以及 ACP
初始化/会话创建。它不会安装包、使用 API 密钥、
发送模型请求或编辑用户的 Harness 主目录。它检查首次请求
目录可见性、缺失的设置、无效的 YAML、非映射设置文档，以及
设置文档的保留。该配置文件的 ACP 入口显式等待
settings，因此目录发现不会与初始文件读取发生竞态。

计划配置

Core 的布尔型 plan_mode 选项仅在当前 Agent 预设挂载原生 Plan 服务时可用。它调用 planMode.set，保留沙箱/审批设置，并将持久的 Plan 变更作为配置更新发布。待处理的选择会一直反映，直到其下一步提交；Plan 是指导，而非沙箱策略。