开发与源码运行#
宿主模块工厂保留动态导入的延迟语义,由原组件的 Loader 树在实际调用时解析。Windows 专用原生依赖不能出现在跨平台启动预加载清单中;scripts/host-factory-imports.mjs 与对应回归检查同时覆盖会话迁移、工具及计量工厂。
宿主客户端由 scripts/host-build-contracts.mjs 通过实际 SDK 解析并校验身份/版本,同时支持 pnpm 与离线平铺布局;原始摘要验证保持,注册结构、样式归属数量与关键替换有歧义即失败。实际归档检查进一步核对源包清单、声明入口、安装补丁与包内文档目标;仅源码提供的文档链接到公开仓库。
运行安装包保留源码、固定 vendor、构建/离线准备与诊断入口;网站图片、站点 HTML/CSS/JS、文档站构建及评测/性能工具只在源码仓库维护,文档插图通过公开资源链接查看。scripts/package-policy.mjs 同时校验 npm 清单与实际归档,已接入公开文件 CI、prepack 和交付检查。composer 统计元数据在 scripts/chat-style-adapter.mjs 校验上游摘要后由 AST 读取并随 factory 导出,前端直接导入;缺失、重复、未知 ID 或动态顺序会阻止构建,test/chat-style-adapter.test.mjs 纳入 core。
供源码试用和贡献者使用。普通用户用安装指南,无需跑工程测试。
本 checkout 保留固定 0.10.0 底座与后续成果,当前插件版本与精确宿主以 package.json 为准;构建入口精确核对完整宿主版本;旧宿主使用对应历史 tag 和工件。包元数据保留 private,使用 GitHub Release 分发而非 npm。匹配的公共 Chat、Conversation 与宿主组件来源见 DSH manifest;新版 OpenCU已整体内置,只装 OMD 即包含核心、工具与真实 REA 前端。0.2.1-rc.5 使用 Cordis 4.0.5、Schemastery 3.18.5 与冻结依赖锁,不放宽门禁。
OMD 发行包不重复携带 OpenCU 的独立注册包 vendor/opencu/lib/client.js:集成客户端已在 OMD 主包内,client.factory.mjs 由构建过程生成,连同独立注册包一起排除出最终安装包;工作区快照和独立 OpenCU 发行不受影响。
源码运行#
需要 Node.js ≥24.9.0、Git,以及 checkout 的 package.json 指定的 pnpm。
下面只演示已公开的固定 0.10.0 源码运行,不是当前源码版本的安装命令。
git clone --branch v0.2.1-alpha.1.omd.0.10.0 https://github.com/gulagala001/oh-my-dsh.git
cd oh-my-dsh
node scripts/prepare-host-sdk.mjs
pnpm install --frozen-lockfile
pnpm build
pnpm start
本地兼容构建: scripts/host-targets.mjs 集中定义已审阅宿主的官方提交与框架;scripts/align-host.mjs <完整宿主版本> <官方源码目录> 对齐清单、枚举来源和框架 overrides。scripts/sync-dsh.mjs 接收独立匹配源码及其真实浏览产物,scripts/sync-opencu.mjs 接收对应新版 tgz。每份构建单独生成并核对冻结锁、peer 与工件,不改版本号混装。独立聊天的草稿初始化集中在 src/client/projectless-state.mjs:rc.3 调用原生初始化接口并保留 keep/replace/append 语义,旧宿主使用同一目标 Session 的输入 facade,保留已有草稿、附件所有权及提交锁。准备过程共用导航与插件生命周期的取消信号,通过原生 retain({ signal }) 取消就绪等待;新聊天打开输入框前准备独立权限根与原生 Session,首次发送直接由同一原生输入 owner 处理。首发和后续对话保持该目录,标题命名不改变文件位置;手动切换和已有会话的目录恢复继续交由宿主,原始 cwd 继续限定权限。不要在提交时替换 Session 或增设逐插件设置迁移。取消保留创建请求身份供幂等重试,每个范围复用一份未发送草稿。无工作区目录的分配请求 ID 必须等于最终 Session ID;复用空白会话时同时核对该身份与目录分配记录,不能把“此目录由 OMD 创建”当作任意会话的归属证明。显式工作区还须匹配原生登记的实际目录。Finder 与打开目录快捷键保留 rc.3 原生 ui-open-in-app 客户端;scripts/build-open-in-app.mjs 核对原 bundle SHA256,只将两个初始 cwd 选择器改接原生 workingDirectory 投影,再由 OMD 挂载。原生菜单、快捷键注册、后端路径验证和打开动作不变;升级宿主须重新核对来源与替换点,并实跑首次发送、重启、权限及 Finder 定位。本地安装包使用 OMD_NPM_ENTRY="$NPM_CLI" node scripts/pack-local.mjs <输出目录>,保留内置 macOS helper 的执行位与原签名字节。最小定点检查使用隔离数据/profile;日常部署与重启另需明确授权。
默认数据目录为仓库内的 data/dsh/,profile 为 oh-my-dsh,端口为 3083;首次启动安装本地插件。
打开终端输出的完整登录链接,在 DSH 中配置模型。仓库不提供私人数据或凭据。
端口、数据和本地链接
macOS/Linux:
PORT=3090 pnpm start
DSH_HOME=/absolute/path/to/dsh-data pnpm start
PowerShell:
$env:PORT = '3090'
$env:DSH_HOME = 'C:\dsh-data'
pnpm start
构建后,用匹配宿主版本的 CLI 链接已有 Web profile:
dsh plugin --profile YOUR_PROFILE add link:/absolute/path/to/oh-my-dsh
重启生效;桌面用自带 CLI,普通 CLI 不写 desktop profile。源码路径建议无空格。
macOS 的 node scripts/launch-macos.mjs 使用默认数据目录和端口,后台启动并打开登录链接,日志在 data/dsh-stage.log。
关闭浏览器不会停止后台服务;前台 pnpm start 用 Ctrl+C 停止。
构建和职责#
产品边界、独立发行与共装行为见插件架构。发布包保留必要源码、对应编译资源与来源声明;普通用户从固定 Release 安装,源码主线不直接充当安装包。
| 路径 | 内容 |
|---|---|
cordis.patch.yml、presets/ |
宿主与预设组合 |
src/index.mjs、src/runtime.mjs、src/dsh-agent.mjs |
轻量启动入口/增强运行时/工具 |
src/context/ |
摘要、资料、替换、回查 |
src/tasks.mjs、src/todolist.mjs |
锚点、任务、证据 |
src/hub.mjs、src/hub-store.mjs、src/monitor-ledger.mjs |
后台/持久监控账本 |
src/dream/ |
隔离归属、来源、短记忆与续跑 |
src/temporary-chat.mjs、src/temporary-session-storage.mjs |
原生侧栏会话与临时存储生命周期 |
src/codegraph.mjs |
索引/查询;取消及初始化失败保留可读错误与原始 cause |
src/client/ |
对话、工作台、设置、主题 |
vendor/dsh/ |
匹配当前构建目标的公共 Chat、Conversation 与宿主组件 |
vendor/opencu/ |
OpenCU 分发快照;由同步脚本维护源码、构建产物与摘要,不手改 |
scripts/、test/ |
构建/启动/检查 |
自有工具经 src/tool-contract.mjs 使用同一份受宿主支持的参数定义进行展示和执行校验;npm run tools:check 检查 Native、TypeScript 与 Python SDK,已接入构建、CI 和 prepack。工具上下文优化复用原生执行器、请求投影及监控账本,参数定义、目录裁剪和计量必须一起检查 Native/PTC 路径。
修改组件或价格来源的 scripts/sync-*.mjs 在同步完成后调用同一个来源清单生成器,更新设置页与公开来源文档;其他手工修改来源清单输入后运行 npm run credits:write。npm run docs:check 检查生成内容是否一致。
OpenCU 同版本的服务端 ESM、宿主源码与文档可运行 node scripts/sync-opencu.mjs ../opencu --files src/dsh/downloads.mjs host/downloads.ts DEVELOPMENT.md docs/install.md docs/install_EN.md,只替换列出的已提交、已分发文件并保留现有构建产物。该模式拒绝未提交源文件、目标摘要不符、生成产物和新增文件。同版本客户端修改在完成受影响构建、更新扩展摘要并提交源码后,可用 node scripts/sync-opencu.mjs ../opencu --client 同步客户端、内容哈希分块和扩展光标/ZIP,校验资源摘要并清理被替代的分块,无需重新打完整包。两种模式均在 vendor/opencu.json 记录 sourceCommit 与逐文件摘要,并移除已不代表当前快照的 archiveSha256。其他文件成员、版本或构建输入变更仍同步匹配宿主的完整包。同步源码或客户端不等于已经重建或更新桌面。
完整包同步保留 native helper 的执行位与签名字节,并核对精确宿主/peer。archiveSha256 对应同步脚本恢复执行位后的实际解包归档,逐文件摘要对应内置快照;它不等于传入 tgz 的原始摘要,也不证明 Git 来源提交。打包源码提交须从实际构建来源核实。OMD 构建从已核验的 OpenCU 注册包生成 client.factory.mjs,再编入根客户端;宿主适配器、扩展和内容哈希分块仍使用同一快照。
Persona 在独立仓库维护,node scripts/sync-persona.mjs 按实际 npm 分发清单同步至 plugins/persona/,包含公开文档与检查输入。人格设置写入仅使用 /api/dsh-persona/settings:GET 返回配置和 ETag,POST 通过 If-Match 提交读取时的标记;冲突返回 409 和当前配置,缺少标记返回 428。旧 OMD /settings 不再接受人格字段,已有配置字段仍用于迁移和读取。
Extensions 自定义命令在独立仓库维护,经 scripts/sync-dsh-extensions.mjs 同步。每代原生命令服务拥有自己的文件操作队列和注册记录,个人与项目命令按同一规则增量同步;原生 definitionId 区分自身注册和其他插件的同名命令,不借用无关会话判断冲突。注册表只保留菜单元数据,发送时读取当前文件并再次检查取消及注册归属;读取或解析失败不能使用旧模板。停用撤销全部所属注册,宿主重启从文件恢复。独立仓库检查模板与取消,OMD core 检查真实 rc.2 注册器的作用域、并发、启停与恢复。
Skill 管理同样在独立 Extensions 维护。固定 rc.2 的 SkillRegistry.listLayerCandidates 提供全部原生候选,保留被同名条目覆盖的文件;默认预设经 agentPresets.acquireScope 读取并释放,不创建 Agent。文件系统提供方的 roots/get 统一目录、解析及候选发布检查,正文读取和新建/导入不再另维护发现规则或等待文件监听器。更新宿主时须同时核对这几个接口和 FileSystemSkillProvider 类型识别;不支持的宿主明确失败。文件替换、整包发布及注册归属检查由同一写队列收尾,直接使原生目录缓存失效。原生作用域、冷预设、只读正文、根目录保护和发布失败回归在 test/extensions-skills-native.test.mjs,进入 core CI;网页检查还应核对技能与指令保存后正文立即刷新。
指令管理通过声明的 Loader 依赖导入宿主 dsh-agent-instructions 与 dsh-scope,从 Cordis 活跃 fiber 读取已校验配置,并调用 discoverBaselineInstructionFiles;不读取 profile 的首个声明或另设默认配置。默认预设租约及所选项目主会话的 scope chain 限定候选来源,提交前复查预设版本与取消状态。尚未创建的文件仍需同目录名称校验,项目根沿用共用的标记查找;这是公开发现接口只返回已有文件所需的适配。保存/删除共用一个队列和原子文件写入,链接编辑保留链接、删除不删目标;正文按编辑上限有界读取,JSON 请求预算覆盖转义膨胀。原生源文件上限与本页 1 MiB 编辑上限分别展示,总上下文预算与内容去重仍由宿主控制。test/extensions-instructions-native.test.mjs 在 core CI 检查配置、路径、启停、预设替换与恢复;宿主升级须复核 Loader/fiber/scope 和发现接口。
pnpm build 构建前端,并从 presets/oh-my-dsh/agent.cordis.yml 生成普通与 OMD-PTC 预设;修改源配置,不手改生成文件。
侧栏聊天由原生 AgentHandle 和 SessionReference 承载,渲染宿主子会话的 Conversation 内容,复用消息、输入、附件和停止流程。独立原生 JSONL 后端只接收已登记的临时会话与子会话,其他存储调用原样透传。关闭时停止并等待原生任务、清理 OMD 会话附属记录,最后释放存储并删除对应临时目录;清理失败保留关闭入口供重试。
推荐插件更新与 OMD 自更新都在 withPluginPreflight 的执行回调中复用各自的准入规则,覆盖排队、预检与人工继续之间的等待。原生安装清单、当前配置/任务和版本服务仍是权威来源;回调重读后才能开始变更,不根据预检前的启用状态覆盖新选择。自动更新不再满足条件时直接结束,手动冲突保留明确错误。预检仍只运行一次,原生方法负责自己的文件锁、失败恢复与 HMR;移除和安装仍是宿主的两个操作,不提供跨进程整包替换事务。自更新复用版本服务当前快照,不增加第二次网络查询。
会话总览的来源、输出和 Workflow 事实统一由 omdOverview 原生投影维护,前端不再扫描已加载历史或合并第二份工作流状态。原生投影存储负责序号、新旧回执、读取状态与重连;完整空值也不会从旧列表摘要补回。子会话目录和运行状态沿用宿主,当前回合结果与历史工作流结果分别展示;阶段键区分省略与空字符串。投影版本变更由宿主从原始日志重建缓存,不修改日志或新设存储。读取错误需明确重试,历史迁移仍由打开会话触发。
独立聊天在临时目录准备完成后,将其设备、inode 和出生时间写入请求记录,再以文件系统的排他改名操作发布到最终路径。重试先核对请求、占名记录和目录身份;同名占用时选用下一个编号,已确认路径被替换时返回错误。旧版分配记录继续用于历史会话归类,缺少物理身份的记录不能授权接管当前目录。
文件位置统一通过 src/file-paths.mjs 解析。omdOverview 投影记录完整日志中的原生目录变更及初始目录,输出文件在工具调用/交付事件时固定路径;投影版本更新由宿主重建缓存,不修改历史日志。src/client/file-context.jsx 使用现有 slot 适配层为聊天、工具、引用和内嵌图片提供消息当时的目录,为输入框引用提供当前目录;打开前转为绝对路径,保留原生资源读取、行号、错误对话框、权限和外链处理。共享会话列表和权限根不变,目录信息未就绪时不猜测历史文件位置。旧版 workingName 只用于识别已有目录归属,不再提供命名或首发切换入口。test/projectless-directory-native.test.mjs 与 test/file-context.test.mjs 在 core CI 检查固定目录首发、原生队列、目录恢复、实际文件写入与 shell、历史图片/文件/引用,以及目录信息未就绪和路径编码。
宿主构建通过 host-const-enums.mjs,使用根 devDependencies 显式锁定、经来源清单核验的 TypeScript 6.0.3,按 AST 与真实符号绑定内联官方 const enum 成员并消除运行时枚举引用。DSH/Cordis 复用宿主 SDK 单例,不打包第二份;官方来源提交、SHA-256 与完整枚举声明/成员按枚举 manifest校验。默认构建不依赖桌面 SDK 路径中的未声明编译器 fallback。
CodeGraph 的 codegraph.json 排除规则只作用于当前项目根,不会自动继承到独立子仓库。工作区与各子仓库分别排除隔离宿主、构建产物和 REA 提取包,查询保留手写适配层;调查提取包原件用定点文件读取。索引异常膨胀时先确认无活动写入者,再清理可重建的 .codegraph 数据库,执行 codegraph_index 并以实际查询确认;不得删除用户数据或源文件。
CodeGraph 目录探测与原生 MCP 适配器由运行时的同一个 catalog 作业持有,同一 revision 共用成功或失败回执;显式准备或重新启用才开启新 revision。Agent 只等待和注册工具,退出不取消共享探测。查询连接按项目/会话共享,握手失败由生产者移除,即使等待者已取消;已观察到断开的连接先收尾再替换,旧调用的迟到失败不能移除新连接,也不自动重放查询。
内置回合撤回: node scripts/sync-rewind.mjs ../rewind 从已完成构建的独立 @gulagala001/dsh-undo-plugin 包同步实际发布文件,核对精确宿主并生成 vendor/rewind.json。服务端通过 oh-my-dsh/rewind 加载同一模块,客户端直接编译快照入口;独立插件与内置方使用共同运行时所有权,不能额外注册另一套回退引擎或按钮。同步后运行 OMD 构建;不在构建期间隐式拉取或重写快照。
运行边界: 基础 Chat/Conversation 与可选客户端增强分开挂载,后台增强由轻量入口建立;依赖失败保留错误与恢复入口。任务状态从原生事件恢复,结果精简只投影请求并保存原文;共享模型回复处理保留取消、失败与原始回执。CommandCode 的请求兼容集中处理特定渠道的 reasoning/工具历史重放,保留原始会话日志,不改变其他提供方的请求。
按需测试#
专注实现和交付,尽量少做测试。按需做最小构建/启动检查,仅为具体问题或用户明确要求做定点验证(含 CU)。依据用户实际使用反馈改进体验。贡献与发行要点见贡献说明。
CU/BU 的长期验证机在独立 OpenCU 源码 checkout 运行 npm run cu:verify(默认 full),操作、故障重放及覆盖边界见独立开发说明。先完成受影响构建并准备匹配的 Playwright Chromium;已生成当前产物时无需重复构建。OMD 同步后,在 OMD checkout 用同一版本的源码验证机检查实际内置副本:
node ../opencu/scripts/cu-liveness.mjs check --root ./vendor/opencu
node ../opencu/scripts/cu-liveness.mjs verify --root ./vendor/opencu --profile matrix
node ../opencu/scripts/cu-liveness.mjs verify --root ./vendor/opencu --profile browser
--root 的内置副本只运行 matrix/browser;源码的完整适配测试在独立 checkout 运行一次。检查同时记录被消费源码与验证机身份,报告留在验证机 checkout 的 .local/cu-liveness/。登记漂移、运行中源码变化、外部监督超时、取消或缺失回执均不能算通过;有限场景及真实浏览器通过不证明任意网页或操作系统永无错误。OMD 自有薄适配仍按受影响的 test/opencu-*.test.mjs 定点检查。
完成 OMD 构建并提交内置来源清单后,对将实际安装的包运行 node scripts/check-opencu-delivery.mjs /absolute/path/to/actual-package.tgz。该入口只读核对包内源码与逐文件摘要、native 执行位、根客户端字节、入口及文档;不会修复传入的包。无参模式仅为自建临时包恢复 helper 执行位后自检,不能代替实际安装包校验。包检查不替代嵌入副本的动态验证或真实宿主生效检查。
DeepSWE 的本地适配器位于 scripts/deepswe/,通过固定版本的 Pier 在官方 Linux 任务环境中运行实际 DSH/OMD PTC。snapshot.mjs <已安装 profile> <本地私有 bundle 目录> 保存模型、插件和配置快照,不复制聊天或记忆;run.py <评测目录> doctor 核对环境,run --task <任务名>、run --sample 10 --seed 0 或 run --all 选择范围,report 查看回执。评测目录须包含固定的任务集、Pier 虚拟环境、Linux 运行包和 config/local.json;凭据、任务原文、参考答案、镜像与运行结果全部留在工作区 .local/。每题独立配置与数据,模型运行前比对实际 OMD 配置,官方评分器只在独立干净容器中验证提交的补丁。保留插件配置,但 Linux 环境不提供 macOS 桌面或 Blender 服务;网络遵循任务隔离规则,仅放行已选推理端点。Apple Silicon 上的本地 Colima 环境使用 QEMU,避免 Rosetta 执行宿主原生扩展时卡住;start/stop 管理专用评测虚拟机。默认串行、一次尝试,失败单列;真实调用消耗所选渠道额度,单题结果不代表全量成绩。该流程按需运行,不接入日常 CI。
order 冻结仅依公开题面需求规模预估的难/易交替顺序;run --concurrency 2 按此顺序每批最多同时运行两题,已评分题只运行一次。执行异常时清理未评分结果并保留用量汇总,自动重跑一次;再次异常则停止派发,已启动的另一题允许完成。用户明确要求后也可用 --retry-errors 重跑未评分的异常或取消题,已评分题不重跑。monitor 启动仅监听 127.0.0.1 的只读看板(默认 8765,也可用 --port 指定),report 输出同口径 JSON。每题结束后独立审计,实时显示阶段通过率、费用/Token 趋势、缓存、耗时和队列;网关保留百炼 Session Cache 请求头;仅当本题已知续传返回特定 InvalidParameter 500 时,使用内存中本题已完成的上下文回退完整请求,保留模型、工具与强度;上下文缺失时拒绝回退。2 并发或异常重跑必须通过实际多轮续传及至少一次 500 回退检查。历史连通试跑与合成检查单列,不进入正式成绩。网关 POST 回执按请求去重,GET 回读不重复计费,缓存包含在输入、思考包含在输出;执行异常、取消及待审题不进入通过率分母,缺失用量单列,费用依据 config/monitor.json(默认 monitor-defaults.json)冻结的公开费率估算,不等同账户实扣。官方 max 为外部参考;图读成本、未公开 Token 及渠道差异明确标记,不冒充同条件实测。轻量离线验证:python -m unittest discover -s scripts/deepswe -p test_monitor.py。
防作弊边界位于独立 TLS 网关和容器层:真实凭据不进入任务容器,只放行指定模型的 Responses 请求与本题响应回读;阻止托管搜索、远程媒体、跨题响应、更换主 PTC 强度及普通外网/DNS 出站。任务不能访问控制器、参考答案或 Docker 接口。配置与插件文件在结束时再次核验;官方测试报告在另一个无网络、只读容器中复算,可疑补丁、分数不一致和缺失证据单列待复核,不计可信通过,原始结果保留。可信通过率以请求的全部任务为分母。probe.py <评测目录>、--positive、--scoring 分别验证攻击边界、真实 OMD 调用及评分审计。此流程不保证识别所有运行时测试取巧。
pnpm test(或pnpm test:smoke):运行scripts/test-ci.mjs列出的核心回归,不反复安装宿主、不启动完整桌面。- 单项回归:
node --test test/<name>.test.mjs,仅指定实际保留的文件。 pnpm test:all:兼容入口,运行同一组最小检查,不再另设重型全量套件;结果只说明这些检查的有限范围。- 需要运行检查时,使用隔离数据/profile,保持当前工作 DSH 原状。
工具执行性能可用 npm run perf:tools -- --root <源码根> --out <本地 .local/report.json> --repeats 7 按需评测。先准备匹配 SDK 依赖及计量生成物;真实宿主 Workflow 场景还需模拟器已有构建,截图场景使用已安装 Chromium,不自动下载。基线和候选使用同一份评测工具、宿主、环境及 size/repeats/idle-ms,候选附 --baseline <基线 JSON>;--cases 可限定场景。报告分列新进程初始化后的首次操作与热操作,记录完整耗时、首个有效回执、局部阶段、事件循环延迟、CPU、采样进程树 RSS、闲置、取消清理和结果等价性;没有观测到的指标保留 null。21 个系列逐项注明实际覆盖层级,隔离宿主使用本地协议模型,不代表远端模型或 GUI 性能。嵌套阶段不可相加,小样本 p95 只描述本次样本,未清空操作系统缓存。--idle-ms 31000 --cases article 可观察正文计算 worker 的自动回收,显式关闭耗时另列;AST 场景会先执行取消检查,其闲置数据不单独证明自动回收。node scripts/tool-performance/native-candidates.mjs --root <源码根> --out <本地 .local/candidates.json> 单独测原生写入/编辑的大差异回执与持久 Bash 的实际轮询、就绪等待和取消;其中 worker 只是等价计算候选,不会安装到宿主。
工具内部优化保持模型工具契约、提示词、agent loop、跨工具调度及 PTC 状态模式不变。大段 AST 和所有正文解析使用同一算法的单个懒加载计算 worker,闲置 30 秒回收;小段 AST 直接计算。正文依赖检查也执行同一个 worker 入口,避免桌面宿主的模块路由干扰 jsdom 内部加载。AST 树按内容和语言有界复用,取消会结束当前纯计算。原文查询仅缓存已确认深冻结的日志前缀,按原算法匹配和校验游标;缓存不保持整个 Session,最多三个有界前缀并在闲置后释放,可变快照仍完整扫描。DSH 0.2.2-rc.3 的匿名网页读取已使用原生共享 Undici dispatcher;OMD 不再包装 provider 或建立第二套连接池,连接复用、代理、跳转、字节上限、取消与超时均遵循当前原生实现。
图片、上下文预算和空闲预处理见上下文整理与原文回查;来源与许可见第三方声明。
内置 BTW 使用 node scripts/sync-btw.mjs ../dsh-btw-plugin 按 npm 实际分发清单同步独立插件的完整构建、文档清单和检查脚本;vendor/btw.json 记录来源提交、精确宿主及文件哈希。服务端与前端直接使用同一插件入口,匹配的独立与内置版本共用注册生命周期。
当前 token 计量由一个 tokenMeter 服务负责原生上下文/用量投影,OMD 预处理、压缩收益、工具结果、Dream 和预算共用 src/metering 的请求与回执契约。真实回执、估算、保守预占和未知字段分别处理;输出属于累计消费,但不直接加进下一次请求的上下文。压缩和回退使旧前缀回执失效,模型路由及图片投影沿用原生 LLM 服务。原生压缩继续使用 BasicCompactionEngine 的事务、工具配对和恢复;公开摘要钩子负责把超窗输入分段为完整、受预算约束的请求。没有缓存快照时也可整理。
node scripts/build-metering.mjs 只构建受影响的宿主计量与摘要适配。原生函数来源固定于 src/metering/native/source.json;工厂通过原有 Loader 解析 SDK,原注册项由 bundle 暂停,卸载后恢复。投影版本由计量源码和原生来源摘要生成,避免算法更新后继续读取旧缓存。pnpm metering:check 检查估算/回执解析归属、原生来源摘要和内置 Workflow 同源清单,已接入宿主构建、CI 与 prepack;test/metering-contract.test.mjs 覆盖部分回执、实测基准失效、原生日志重放、小窗口及分段摘要。改动后先执行上述受影响构建,再运行定点测试。
插件预检的页面适配位于 src/plugin-preflight/page.mjs,按原生加载清单和实际可交互页面判断,不把可选账号引导作为必经步骤。改动此处可定点运行 test/plugin-preflight-page.test.mjs(已有浏览器,OMD_TEST_BROWSER 指定路径);通常无需重复完整宿主矩阵。第三方适配包使用固定输入构建器,保持精确宿主声明、完整功能与来源许可。