English | 简体中文
DeepSeek Harness（DSH）Windows 部署基线、运维工具箱与社区插件验证目录。
本仓库沉淀在真实 Windows 环境中验证过的 DSH Desktop/Copilot 部署、诊断、修复和集成经验。它不分发 Desktop、DSH 或第三方插件；正式支持范围由精确锁和验收契约定义。
定时/自动化状态：Official Schedule first。 Windows Ops 后续常规任务优先采用官方
Schedule；dsh-cron 暂停功能演进，仅在迁移阻断或严重回归时作为临时回退参考，
不是默认方案。官方能力目前公开可核实于 Harness dsh-v0.2.0-rc.1 的可选
experimental bundle，并非当前已验证的 Desktop 部署基线。
差异、迁移和回退边界见调度决策。
统一入口是有界发布排障清单。 其 UI fixture 附录补充真实 renderer 导航、Slot 物理布局容器 与同次不可变验收证据检查，不另立发布流程，也不授权本机安装、激活或重启。
ZIP／成员离线审计指南介绍只读、仅依赖 Python 标准库的
审计工具，以及在既有 Linux repository-content CI job 中执行的 59 项惰性数据测试。
Run 35648331069
在 Linux／Python 3.12.10／zlib 1.3 上 59/59 通过，绑定受测 head 88cc734
（tree e558600）；精确检出与哈希见指南，不代表后续文档提交已通过检查。
Windows 验证失败，仍为 HOLD USE；Linux 证据不能替代 Windows／产品验收，
也不授权实际制品使用。工具不下载、解压、安装、执行归档代码或激活 Desktop。
以后要求“做 DSH Core 新版本适配”时，先按官方优先适配流程
执行：逐项审视 Core fork、Copilot、cron、Playwright 是否已有官方替代，验证等价后
优先迁移。组件清单在 core-upgrade-scope.json；
node tools/plan-core-upgrade.mjs --tag dsh-v<version> --commit <full-SHA> 只输出计划，
不安装或重启。此入口不是新版本已通过兼容验证的声明，也不修改当前部署锁。
产品/通道优先验收与不可变 Release 安全撤回，见 Desktop 发布边界。 下一次昂贵运行前，按有界发布调试清单 冻结候选范围、收齐同轮失败、检查真实 UI／原生前置条件，并分开记录各验收阶段。 这些是流程经验，不代表新版本合格、已建立制品复用流程或获得本机激活权限。
本次 0.1.6-alpha.2 官方对照与迁移决定记录已审视的
官方替代、必须保留的差异和已发现的接口问题；源码评估不是新部署基线。
后续合并、发布、哈希与验收范围见适配交付证据；Cron、Playwright 与 Copilot alpha.28 的历史发布证据继续保留。当前已发布 Ops 目标为已独立核验发布制品的 Desktop 0.1.6-alpha.1.cloga.17 / sequence 28 / bundled Core alpha.1 / Copilot alpha.33；全新 hosted Native Ops run 35595040585 attempt 1 已在精确 code head bb7a0a366e789b19918be6d8a6e40266c46a94f9 通过，见外链维护发布记录。Alpha.33 虽兼容官方 Core alpha.2，但另行负责、仍为 draft 的 Desktop PR 68 尚未合格，本维护发布不提升 Core。正式发布与来源验收不代表本机已安装/激活，也不证明真实 compaction、OAuth、model 或 search。
另见原生加载依赖与镜像验证：
node-addon-require-builtin@0.1.6 属于官方启动层；旧版 0.1.5 虽通过独立 Node 测试，却在 Electron 44 的实际原生调用中失败；历史已验证部署中的 0.1.6 文件在同一载体通过主线程及两个 Worker 对照，因此保留 0.1.6。这不等于取得 npm 原始包或完成整个 Core 验收。该节也区分可选 CUA 测试依赖与 Desktop 运行需要，并记录 pnpm 11 筛选安装仍包含根项目的限制。
另见 pnpm 11.7 调度与离线策略边界：
pm 必须是首参数，--offline 不保证供应链校验不请求 registry 元数据；不得靠关闭校验来消除失败。
远端适配时使用资格验证清单： 公司本机 npm 限制不单独阻断发布，不反复重试或要求用户解禁/供包；依赖型检查与发布走获准 CI。 有真实环境失败证据的本地 hook/check 已获长期授权按 PR 窄范围转至等价必需远端检查， 不豁免代码错误或远端门禁。保留完整 lint/精确 head 与 lock 制品证据及隔离原生验收； Desktop 仍交付既有 installer，不用 tarball 替代，不暗增启动时访问受限 public npm 的要求。 Core 候选证据仍未达到发布资格； 不得因此更新锁、安装或重启当前 Desktop。
Alpha.2 兼容准备仍独立： native descriptor 校验仅对精确 Core
0.1.6-alpha.2 要求 Host protocol 4，保留旧版 protocol 3 与 synthetic-only 检查。
当前已发布 Ops 目标 Desktop .cloga.17 仍内置 Core alpha.1；Alpha.33 的 alpha.2 admission
不等于 draft alpha.2 Desktop 已合格或已部署。详见严格准备边界。
组合证据准备不代表提升基线： Ops #181 准备工作
区分导入的正式 functional/failure/observer/suite 证据（普通 acceptance 必须缺席），
与清理完成后通过普通验收路径成功返回的全新 Ops resolver observer。
显式 combined-suite-v2 准备要求功能／普通验收 schema 2，以及由原始哈希绑定、遵守已评审
Copilot alpha.33 Client 策略的 positive-usage.json；v1 与旧 alpha.1 读取器及历史证据保留。
合成 Client 单元测试不等于在托管环境中执行实际已发布 Client。
真实 Ops 调用方身份与经过验证的 Core 检出身份分开保留；私有 Ops 源码归档不是 Git 检出目录。
精确且成功的 Core CI 摘要可以证明执行过未完整归档根记录的安装检查，但不能提供完整离线重放。
此 alpha.2 准备工作不修改六资产公开契约，也不改变当前 .cloga.17/alpha.33
目标的 Core alpha.1 范围；该目标已由全新 hosted Native Ops run 35595040585 attempt 1
在精确 code head bb7a0a366e789b19918be6d8a6e40266c46a94f9 独立验收。
历史 .cloga.16 的正式/Ops 证据见原 owning record，
不能移用到 .cloga.17。Alpha.2 尚未发布、尚未合格；此准备工作不授权安装、激活或重启。
另见 dual-v2 composer 证据准备： 显式51输入／functional3／settings3／native2／seed6与固定alpha35 Client策略，保留21键正向证明、 各自原始哈希及 fresh Ops 真实身份。旧格式与当前锁不变，不代表已提升、原始ZIP已核验或允许激活。
已有新版 Copilot、需要从两条路由统一到账号自动识别目录时，使用先检查的配置维护流程与独立的 copilot-managed-route.policy.json。它只允许经过确认的路径级配置 CAS，不安装组件、不重启、不自动修改 Session 或默认模型；不会为了下述独立部署目标替换或降级现有 Desktop。策略中的 Release 必须已验证、指定插件版本必须实际加载；冷历史影响需明确确认。该维护策略不是新的完整 Desktop/Core 验证声明。
参见 Desktop 版本识别：
记录原生“关于”菜单中的完整版本，区分 Core 与可用更新，并为旧版提供只读的可执行文件
元数据检查。该功能首次随已验证的不可变 Desktop 0.1.6-alpha.1.cloga.12 发布；正式来源证据不代表本机安装或激活。
机器可执行契约以 deployments/windows-copilot.lock.json 为准。发布制品与正式证据已于 2026-09-21 独立核验；.cloga.17 的全新 hosted Native Ops run 35595040585 attempt 1 已通过，验收只绑定下列精确 code head，不继承旧目标的成功，也不把后续文档/证据提交或合并提交称为 native-qualified。
| 组件 | 目标身份 |
|---|---|
| DeepSeek Harness Desktop | fork-owned 0.1.6-alpha.1.cloga.17，sequence 28，不可变 Release 392847203，source f25506b4ad190ce090b8a4e9602c7ad36179db6b |
| Desktop 管理的 DSH runtime | bundled @deepseek-ai/dsh@0.1.6-alpha.1；descriptor SHA-256 eca8a91da4737f625716323d0be8a51156b24934183904a41d06599ffafe36bd；ASAR root 跟随实际 EXE |
必需的 dsh-github-copilot |
不可变 0.4.0-alpha.33，source aa90fe434da8b2172faa1446afa0a0fd006afe00；由 desktopNativeVerifiedRelease 接管 |
| 正式 packaged 证据 | run 35583602522 attempt 1 SUCCESS；来源绑定的 initial/restart settings/version-menu、signed-out usage 与 synthetic positive usage proof |
| Native Ops qualification | run 35595040585 attempt 1 SUCCESS，精确 code head bb7a0a366e789b19918be6d8a6e40266c46a94f9；native job 106318363183 与全部 4 个 jobs 通过；原始 summary及来源记录独立绑定 |
本次为 runtime-only Desktop 外链维护，Core 与 Copilot 版本不变；不提升 Core alpha.2，也不采用 Copilot alpha.34。
外链维护发布记录保存六资产、来源/哈希和验收边界。
新 Ops summary 为 1,073 bytes，SHA-256 6ad0298788578353c6ef306ddeec225c785d335631f06b7d38c1f879cc526fee；
whole-carrier/model-response/installer-upgrade flags 仍为 false。首次 native run 35590167413
的启动失败原因仍未知，原始 not-ready 证据保留；后续诊断不证明已修复其原因。
普通 CI 35593395998 的 LF/CRLF 测试提取缺陷由 bb7a0a3… 的 test-only 修改修复，不能说成 runtime 故障。
实际 Electron DOM 激活的外链 fixture 使用替代 OS opener，不证明真实浏览器导航或 OAuth。
保持 stage-only，不在本机安装、激活或重启。
历史 run 35577921833 attempt 1 SUCCESS，精确组合 Ops code head cd384495ac2fd0c850b3c8cd93223d35c4bc83a0；native job 106264308921 与全部 4 个 jobs 通过。
初始 a59f586… 验收与 c868c689… 文档/证据提交保留为历史。合入 protected master
43630e4… / PR #212 后，组合 head cd384495… 已通过上述独立的新 native run，未继承之前的成功。
该次最终提交只更新 provenance，保留 code/lock/raw evidence 字节，不冒称自身为 native run 的 head。
参见并行 master 集成记录。
1,073-byte raw summary SHA-256 为 26c85a04e6be4616168bba93d08e838e21c45077dd3043e27855c2b51ba096d1；
fresh positive proof 由该精确 driver 强制校验，不是新增 summary flags。Whole-carrier、model-response、
installer-upgrade flags 仍为 false，历史 .cloga.14/alpha.32 run 35553019059 不能移用。
正式验收在首次启动与重启验证只读 current workspace、Model roles、相同的
deepseek-official/github-copilot-hosted 目录、provider-only routing、Fallback
label、精确 Desktop About-menu identity 与 account readiness 后缺席的 signed-out usage surface。
新增的 schema-1 usagePositiveAcceptance 使用已发布 Client 与实际 renderer、SessionProvider/Slot，
但 Session/quota/test mount 为 synthetic；canonical/preview 两条路由只在 restart graph 后执行一次。
正式证据与哈希已经认证，不再是待提供制品；
它不证明 live account/network。正式发布 run 35569892548 attempt 1 的 EBUSY helper cleanup 失败仍保留为历史。
未执行 Host request instrumentation、live quota、OAuth、verification navigation、
model/search、save/create、本机安装或重启；external-navigation success 仍未合格。
Lock 更新表示经过评审的目标，不代表本机状态；.cloga.17 hosted Native Ops 成功仅绑定精确 bb7a0a366e789b19918be6d8a6e40266c46a94f9 code head。已安装 Desktop 仍为 .cloga.10
时，不得针对 future lock 运行 current-machine Check；预期 drift 不是发布缺陷。
Managed helper 仍是交互式流程，需要单独确认 active Sessions 影响及 Windows/UAC，
本次明确选择 stage-only：不在本机安装、激活或重启；live account 验证留待未来人类请求，
不是发布/CI 完成后的自动下一步。
Legacy-compatible update manifest 保持 automaticProvisioning=false；独立 hash-bound
build receipt/capability 管理精确 startup provisioning。Native dependency registry
仍由 lock 固定为 https://packagefeedproxy.microsoft.io/npm/ 并使用正常 TLS，冻结
source build 使用 https://registry.npmjs.org/。不得修改 live plan 或放宽 TLS。
历史 formal/Ops fixtures 与失败记录均保持不变。
每次升级必须执行官方优先检查清单。
Alpha.33 正式验收记录列出精确来源/资产、
positive proof 与 synthetic/downstream 边界；PR #157 通过官方 useSession selector
契约修复插件，不改 Core。Alpha.32 历史记录
继续保留 official/delegated primitives 与 plugin/Desktop gaps。Alpha.33 不是“官方 Core”；
兼容 alpha.2 不等于提升另行负责、仍为 draft 的 Desktop PR 68。
Historical 0.1.5-rc.3.cloga.1/.cloga.2 copied helpers cannot bootstrap because of an
unresolved semver import. They cannot repair themselves by discovering a newer
release. Recovery requires the independently verified lock-selected installer,
that target's exact-head qualification (.cloga.17 run 35595040585 at bb7a0a366e789b19918be6d8a6e40266c46a94f9), explicit interruption consent and a clean Desktop/Host exit, coordinated by the
operator outside the broken helper. Do not patch live files or install missing
dependencies into an update operation. Generic direct registry probe failures
are not evidence that the supported provisioner failed.
Native Check separates exact installed files/receipts from functional evidence.
The Electron Host uses parent-owned byte pipes, not 127.0.0.1:3080; Web checks
cannot prove native Models readiness. Verify reports
manual-verification-required (exit 2); independently record Desktop UI and real
model-response acceptance outside this CLI. Missing native Remote
access is unknown, never success. Legacy Apply/rollback/restart are blocked for
the native lock; use the native managed updater and its live Session impact
confirmation instead.
| 目标 | 从这里开始 |
|---|---|
| 检查或安装锁定的 Windows + Copilot 基线 | docs/local-core-desktop-copilot.md |
查找 Desktop 持久更新提示并安全使用 Review update（保留历史 .cloga.8 发布证据；不代表当前 .6 本机激活） |
提示位置、使用方式与安全边界 |
从官方 dsh-v0.1.5-rc.2 源码构建并并排安装 Electron Desktop 本地构建；选择默认隔离 Home 或显式复用已有 Home，并了解手动更新通道 |
docs/official-desktop-local-build.md |
| 运行版本、配置、端口、模型和补丁自检 | docs/windows-replay-tooling.md |
| 诊断安装问题并执行定点修复 | tools/README.md |
| 只读诊断手动压缩复发：模型选择与请求头、输出截断及证据边界（非已发布修复） | docs/manual-compaction-diagnostics.md |
| 选择或评估社区插件 | docs/plugins/choosing-a-plugin.md |
| 区分 Desktop 注册表包、已验证 Release 与已发布但未在本机激活的源码快照安装能力；了解重新安装和损坏快照恢复 | docs/plugins/desktop-source-installation.md |
| 理解插件验证等级 | docs/plugins/plugin-validation.md |
| 评估 Computer Use / 浏览器自动化 | docs/plugins/computer-use.md |
| 官方 Schedule 优先决策与旧版 Cron 迁移 | docs/plugins/scheduling.md |
| 一次检查或安装 Copilot、Cron 与 Playwright 可选套件 | docs/plugins/optional-companion-suite.md |
| 查看机器可读插件目录 | catalog/plugins.json |
| 查看改进归属、PR 状态和验证证据 | docs/improvement-portfolio.md |
| 提交变更或私密报告安全问题 | CONTRIBUTING.md / SECURITY.md |
- 插件目录：
catalog/plugins.json记录发现、源码审查、入口兼容、组合挂载、功能冒烟、部署验证和锁定基线等级。 - 兼容检查：
tools/dsh-compat-check.mjs检查已放入 Profile 的社区插件依赖和 host 入口 import；通过仅表示 import-compatible，不证明功能或安全性。 - 部署锁：
deployments/*.lock.json锁定精确版本、commit、制品哈希、安装步骤、验收和回滚；这是正式支持范围。
安装社区插件前，先使用一次性测试 Profile：
node tools\dsh-compat-check.mjs <profile> --probe=<package>
node tools\validate-plugin-catalog.mjs然后在隔离 DSH_HOME 中验证 Cordis 激活、工具注册和代表性功能，再提升目录等级。不要直接拿维护中的 web Profile 做首次试装。
用户反馈候选： csyangwen/dsh-memory-evolve 被用户评价为“对跨会话记忆/演化工作流有用”（User-reported useful for cross-session memory/evolution workflows），但本仓库仅对 commit c337dc1af7b5c8a5578e03150bf5c4d6133f66f9 / tag v26091501 完成 L1 源码审查，目录推荐为 experimental。其 Release 无资产/校验清单，未声明 DSH peer 范围，也未完成隔离挂载或功能/安全验证；详见插件选择指南。它涉及长期记忆、后台演化、技能/提示词修改、自更新及可选外部 CLI、Git 同步和消息发送，首次使用必须隔离 Profile 并审查数据保留与自动修改边界；不属于 Windows locked baseline、Desktop 必需插件或默认自动安装。
Desktop 源码快照安装说明保留核心 issue #50 / PR #53 首次随历史 Desktop .cloga.7（sequence 9、PR #57）发布的证据。历史 lock 曾选择 0.1.6-alpha.1.cloga.2 / Core .6 / Copilot alpha.24，其正式来源验收已通过，且该历史基线的 Native Ops qualification 已通过 run 35278350619；本机仍未安装或激活。固定 Memory Evolve commit 的原始获取/打包、隔离 renderer 与 pnpm fixture 不会因此变成 .6 运行证据或插件激活，也不提升 L1/experimental 等级；使用前仍须完成目标机器的检查和单独授权的原生安装流程。
| 类别 | 主要工具 | 用途 |
|---|---|---|
| 部署 | tools/install-windows-copilot.ps1 |
默认只读检查；当前 native lock 拒绝外部 Apply/重启，原生安装须另行授权 |
| 官方源码本地 Desktop | tools/install-official-desktop-local.ps1 |
Check by default; explicit -Apply -AcknowledgeUnsignedLocalBuild runs the exact PackageLocal flow and installs side-by-side. The single desktopProvisioning adapter preserves native delegation; Windows Ops does not populate the reserved profile. New installs use an isolated Harness home; -SharedHome <existing-home> opts into an existing home and Electron user data remains separate |
| 本地 Desktop 更新通道 | tools/manage-official-desktop-update-channel.ps1 |
Check 只读检查远端 manifest；一次显式 Install 自动下载、验证并暂存后启动交互式 NSIS 安装器，保留 Windows/UAC 确认，再严格 Complete 回读并运行同一插件 provisioning adapter；不是 silent/automatic update，仍不发布、不嵌入 app-update.yml，并保留独立 Package/Stage/Complete 恢复路径 |
| Bootstrap | tools/enable-copilot-search-vision.ps1（历史兼容文件名） |
安装直连 Copilot 插件、选择 hosted search，并报告 UI 登录要求；不安装视觉 fallback |
| 可选套件 | tools/install-optional-companion-suite.ps1 |
依据已安装 Core/Cordis/API 而非 Desktop 补丁版本，单独 Check/Apply/Verify 锁定的 Copilot、Cron 与 Playwright Bundle；不替换 Desktop/Core、全局包或运行中进程 |
| 重放与验收 | tools/dsh-replay.ps1 |
自检、严格标记补丁、dry-run、备份和回滚 |
| 插件兼容 | tools/dsh-compat-check.mjs |
静态依赖清单和真实 host import probe |
| 插件目录 | tools/validate-plugin-catalog.mjs |
验证 schema 关键约束、证据引用和基线一致性 |
| 诊断与修复 | tools/dsh-doctor.mjs |
安装健康检查、定点修复、隔离启动和插件清单 |
| 会话安全 | tools/check-session-duplicates.ps1、tools/dsh-move-session.mjs |
重复 ID 检查和原子迁移 |
| Agent-native 运维 | tools/dsh-dev-tools/ |
会话内状态、补丁、构建、升级和 doctor 工具 |
所有脚本的详细参数以文件头和对应文档为准。Desktop 身份检查通过受限的原生 ASAR 审计验证虚拟 descriptor，并传递明确的 Harness home；不会将 PowerShell 无法直接读取归档子路径误判为产物损坏，也不会跳过 EXE／元数据／签名或 Host 参数绑定。此检查修正不安装、升级或重载插件。
ASAR 入口边界（历史 Native Ops qualification 已通过 run 35278350619）： 可选 Web 安装器针对 ASAR 默认目标明确要求已存在、兼容的物理 -RuntimeRoot，不会额外安装或复制 Core；已有用户 Agent Presets 的 ASAR target 校验仍明确报告未支持，不会跳过并宣称通过。Replay 使用受审计的只读原生状态，并拒绝不可变归档补丁和原生变更。详见工具边界；.cloga.2/alpha.24 正式来源验收和真实 Ops run 35278350619 在各自限定范围内已通过；当前及历史 Ops 证据均不扩大未支持的入口范围；本说明不代表本机安装或激活。
- 部署与集成：
local-core-desktop-copilot.md、vision-dual-channel.md（当前为 DSH 原生附件与read_image架构） - 官方源码本地 Desktop：
official-desktop-local-build.md（PackageLocal默认无更新通道；另有远端 Check、显式 one-click Install 和 Package/Stage/Complete 恢复流程） - 插件治理与可选 overlays：
docs/plugins/（包括computer-use.md、scheduling.md、better-sidebar.md）及catalog/ - 诊断与迁移：
tools/README.md、windows-replay-tooling.md、session-move-workspace-groups.md - 事故与平台问题：
startup-60s-timeout.md、升级后 Desktop 启动与设置恢复、powershell-5.1-pitfalls.md、github-network.md - 维护状态：
improvement-portfolio.md、windows-replay-tooling.md
- GitHub 操作默认使用现有 CLI 登录，
.env可选，不是前置条件。额外凭据只从用户明确指定的可信来源加载到当前进程或 DSH credential service；绝不打印、跨仓库复制或提交其值。 - 社区 MCP 默认 read-only；明确需要副作用后再启用写操作。
- Computer Use、真实浏览器控制和视觉插件可能接触屏幕、Cookie、聊天、密码和本机应用；推荐状态必须与功能验证等级分开。
- 所有 runtime/配置改动先备份，补丁必须幂等并提供回滚。
- 重启 Desktop/Host 前必须查询 live Sessions；存在 running Session 时必须先取得用户对中断列表的明确确认。
- 保留并校验 active lock mode 声明的 Desktop plugin surface；在
desktopNativeVerifiedRelease下，Windows Ops 只做 native delegation，不再物化 reserved Desktop profile。 - 插件分三层治理：locked managed baseline 继续严格失败；用户自行安装的插件只进入 inventory/warning，不能贡献 baseline 健康；仅精确命中目标 Core denylist 且处于活动或状态不明时阻断 cutover。
本仓库不分发 Desktop、DSH 或 Copilot 插件；它锁定经过验证的版本和 commit，编排安装、迁移、验收与回滚。以下描述当前 fork-owned Desktop release 与受控 Copilot 插件的职责和精确 pin。
| 项目 | 在本仓库部署中的职责 | 当前关系 |
|---|---|---|
cloga/deepseek-harness |
fork-owned Windows Desktop release channel、生命周期、Desktop-managed bundled DSH runtime，以及 desktopNativeVerifiedRelease generic plugin capability |
历史 lock 使用已发布 dsh-desktop-v0.1.6-alpha.1.cloga.2，commit 65a236bd65f2971f98b11a0efd020b8860144924；正式来源 run 35271210350 与该基线 Native Ops run 35278350619 已通过，未本机激活；当前目标见上文部署锁 |
cloga/dsh-github-copilot |
复用内置 @deepseek-ai/dsh-llm-pi-ai 的 Copilot companion：提供登录 UI、Host-only grant 规范化、账号感知的 models/strict-mode 叶节点同步、Copilot-scoped Tool Schema 过滤，以及 Responses/Anthropic inline search 与 Responses-only ctx.web search；插件保留已有 profile 的非归属字段，Windows deployment 负责清理 legacy connection reference；不包含第二套 adapter、网关或 ACP |
历史不可变 Release source commit e49bf7c9307cf22dd9ea720bed8750101fc986ed；Release v0.4.0-alpha.24，修复 alpha.23 的搜索路由 Client injection；当前目标见上文部署锁 |
cloga/dsh-windows-ops |
精确锁、check-first 安装器、迁移、验收和回滚 | 默认分支维护当前 Windows + Copilot 部署基线 |
历史 ACP 子代理实践仍保留在
docs/copilot-acp-subagent.md，但它是独立的可选集成，
不属于 dsh-github-copilot 的统一主代理模型路径。
“All-in-one”指一个 DSH 插件复用内置 llm-pi-ai 服务，并不表示内嵌网关：
当前基线不需要本地网关进程、端口 7777、粘贴 GitHub token、占位 API key
或独立搜索插件。
改进归属、外部上游状态和验证证据统一维护在 docs/improvement-portfolio.md。发布或升级前以 deployment lock 和兼容矩阵为准，不要根据 README 中的版本字符串自行混搭组件。
- Windows 10/11；
- 锁定基线要求 Node
^22.19.0 || >=24.0.0； - 修改正式基线时必须同步更新 lock、fixture、测试和说明文档。
本仓库的社区插件目录仍会包含实验或历史项目；只有标记为 baseline 且能对应到 deployment lock 的组件属于当前正式支持配置。