@ckanner/flywheel 0.33.1 → 0.34.0

package/docs/validation/evidence/2026-11-14-native-harness-tower-candidate.json

@@ -0,0 +1,192 @@
+{
+  "candidate": {
+    "format_version": 2,
+    "version": "0.34.0",
+    "source": {
+      "commit": "1512b4b690a8d2b01edc70994ba4404b92659d79",
+      "tree": "1083a22b5177797fcde323480bda733b9042e06f",
+      "dirty": false,
+      "snapshot_sha256": "cd4d50eba9c2abe5c04d80d7059b3daf692127e5afcd51dd61c0b5a48d6bfc54"
+    },
+    "packages": [
+      {
+        "name": "@ckanner/flywheel",
+        "version": "0.34.0",
+        "filename": "ckanner-flywheel-0.34.0.tgz",
+        "bytes": 18873136,
+        "integrity": "sha512-1058P0psSstNlkzycB9HEeeCa/xmoGT4Th37/KTkApnmInUDUXnKIxECaWgWLQfp6NawoAoca8sJC7N1DVDH/g=="
+      }
+    ]
+  },
+  "sha256": "41f3db0ed3d5e50fc0b0825f8278d49b1d4653732f7f0f4758a7bf3b074e1ee8",
+  "native": {
+    "protocol": 1,
+    "version": "0.34.0",
+    "platforms": {
+      "darwin-arm64": {
+        "bytes": 10385074,
+        "sha256": "ef7f4bab41bcc599647580a955212b5c0eedb39ace0845c9d39965dba1e92698"
+      },
+      "darwin-amd64": {
+        "bytes": 11320736,
+        "sha256": "53f218a5d9209b7397cd1d184dbbf4401db6b88b0b40f7670b86e7eea0877aeb"
+      },
+      "linux-arm64": {
+        "bytes": 10158240,
+        "sha256": "312ccc6461ebfd0dc767b024cbb1e4a05b4d6ac8915c60d471a2952823ee0343"
+      },
+      "linux-amd64": {
+        "bytes": 11096224,
+        "sha256": "3c898627cff6a1ad703d883083e04388fea7df97d7b3d90bfaa1e7208af7eabd"
+      }
+    }
+  },
+  "kimiLauncherMode": "0o755",
+  "equivalentRemoteSource": {
+    "repository": "ckanner/flywheel",
+    "commit": "be4351fbb9fb54b450f3963b5065026434c592b0",
+    "tree": "1083a22b5177797fcde323480bda733b9042e06f"
+  },
+  "packedTowerModule": {
+    "path": "package/dist/kimi-tower-candidate.mjs",
+    "sha256": "985704d3ac5d3fdb7641ba4b63ffbf6c91ea3ecd17e0c192b881ec2ac26773a4",
+    "declaredSourceReceiptPresent": true
+  },
+  "recordVersion": 1,
+  "observedDate": "2026-11-14",
+  "reason": "Tower directory-alias and prompt-boundary runtime correction after macOS CI exposed noncanonical helper fixtures",
+  "previousCandidate": "2026-11-14-native-harness-candidate.json",
+  "companionPackages": "unchanged exact versions, source commits, trees and tarballs in previousCandidate.companionPackages",
+  "checks": {
+    "kimiTowerFocused": {
+      "passed": 22,
+      "failed": 0,
+      "skipped": 0,
+      "milliseconds": 27270.454965
+    },
+    "nodeMain": {
+      "passed": 395,
+      "failed": 0,
+      "skipped": 0,
+      "milliseconds": 165670.774883
+    },
+    "nodeLegacyHost": {
+      "passed": 10,
+      "failed": 0,
+      "skipped": 0,
+      "milliseconds": 2009.826984
+    },
+    "kimiGoNodeBridge": {
+      "result": "pass",
+      "seconds": 2.048
+    },
+    "packedHost": {
+      "passed": 10,
+      "failed": 0,
+      "skipped": 0,
+      "milliseconds": 4512.678864
+    },
+    "installedCandidate": {
+      "passed": 15,
+      "failed": 0,
+      "skipped": 0,
+      "milliseconds": 46653.651485,
+      "optionalClaudeTarballTested": true
+    }
+  },
+  "limits": {
+    "registryPublished": false,
+    "targetMacAcceptance": false,
+    "liveModelInference": false,
+    "dshMasterImageRuntimeTested": false
+  },
+  "finalCI": "The final PR head includes subsequent evidence and test-fixture changes, with no further runtime changes; PR #44 checks and body record its separately built exact-head candidate and Linux/macOS results.",
+  "ciThirdRun": {
+    "runId": 43585747595,
+    "head": "f4ac488fa58f267f619adbee6a07eba2621cee92",
+    "artifactId": 14109977482,
+    "archiveSHA256": "00cb9a51c85e46f7d771753ef2b4775c2a6d5f5c7d6db7fc2c14ea235af33def",
+    "candidate": {
+      "format_version": 2,
+      "version": "0.34.0",
+      "source": {
+        "commit": "1e6cb302eddfd950d67ea32f24719999cb690b67",
+        "tree": "a84f754fae398cd5f4fdb6c8ccc8df99ee645ae3",
+        "dirty": false,
+        "snapshot_sha256": "ee8de5ef55e2c2d615715362ef17aa882a1e80dbe7dfd90bdbe2a7d2b31d06c2"
+      },
+      "packages": [
+        {
+          "name": "@ckanner/flywheel",
+          "version": "0.34.0",
+          "filename": "ckanner-flywheel-0.34.0.tgz",
+          "bytes": 18899640,
+          "integrity": "sha512-QJSntAISp7l5WOOb+5yMnufeB8nw72rb+nbJntJi4ZJL6Yll4cuyTk1xHlql3cMIsypRIwhKJmlL8FvpsrEBHQ=="
+        }
+      ]
+    },
+    "tarballSHA256": "c1d5cabd85ce4d4a82c1cd2dfd69ff63c4577c3964682bb2f1c94469d527b345",
+    "result": "failure",
+    "npmCandidate": "success",
+    "linux": "success",
+    "macOS": {
+      "goQualityGate": "success",
+      "perFunctionStatementCoverage": 100,
+      "nodeMain": {
+        "passed": 395,
+        "failed": 0,
+        "skipped": 0
+      },
+      "nodeLegacyHost": {
+        "passed": 10,
+        "failed": 0,
+        "skipped": 0
+      },
+      "nodeBridges": {
+        "result": "failure",
+        "failedNativeCases": [
+          "ClaudeCodePro native child receipt",
+          "CodexPro native capability scope"
+        ],
+        "dsh": "pass",
+        "kimi": "pass",
+        "cause": "Two new Go test fixtures derived protocol 3 recovery journals from logical temporary-directory aliases instead of physical parents"
+      },
+      "laterNpmAndInstallGates": "not-run"
+    },
+    "fixtureCorrection": {
+      "linuxAliasedTMPDIRReproduced": true,
+      "productionCodeChanged": false,
+      "journalOwnershipGuardChanged": false,
+      "usageAndChildAssertionsPreserved": true,
+      "aliasedNativeCases": {
+        "before": {
+          "result": "failure",
+          "cases": 2,
+          "seconds": 0.204
+        },
+        "after": {
+          "result": "pass",
+          "cases": 2,
+          "seconds": 0.69
+        }
+      },
+      "aliasedAllFourBridges": {
+        "result": "pass",
+        "backends": [
+          "DSH",
+          "CodexPro",
+          "ClaudeCodePro",
+          "KimiNative"
+        ],
+        "seconds": 44.975
+      },
+      "localGoQualityGate": {
+        "result": "pass",
+        "perFunctionStatementCoverage": 100,
+        "log": "native-quality-pro-fixture-fix.log"
+      }
+    },
+    "finalExactHeadResult": "recorded in PR #44 checks and body; this historical run remains a failure"
+  }
+}

package/docs/zh-CN/claude-code-pro.md

@@ -7,7 +7,7 @@ Flywheel 通过 `harness: "claude-code-pro"` 调用
 的公开 machine API。插件运行用户已安装的 Claude Code CLI，使用该 CLI 的原生工具
 循环与登录环境。Go 仍负责阶段调度、角色会话、验证、预算和交付。
 
-适配器要求 **`dsh-subagent-claude-code-pro@0.4.0`**、machine protocol 1
+适配器要求 **`dsh-subagent-claude-code-pro@0.5.0`**、machine protocol 1
 及其公开 lifecycle/recovery 接口。旧桌面工具接口和旧 machine 契约不能替代这些
 接口。默认阶段和路由均未选择 Claude。源码兼容性与包可用性需要分别核对；
 发行流程见[发布指南](releasing.md)。
@@ -19,7 +19,7 @@ Flywheel 通过 `harness: "claude-code-pro"` 调用
 
 Flywheel 包含 `flywheel-claude-code-pro-worker`，把 Claude 插件作为精确版本的
 **optional peer**。没有选择这个后端时无需安装插件，也不会启动 Claude。选择后必须
-让 worker 的 Node 依赖解析能找到 `dsh-subagent-claude-code-pro@0.4.0`。仅在 DSH
+让 worker 的 Node 依赖解析能找到 `dsh-subagent-claude-code-pro@0.5.0`。仅在 DSH
 desktop profile 安装插件，不保证独立 worker 能访问该目录。
 
 registry 已有该精确版本时，将它装到 Flywheel 所在的同一全局 npm prefix 或同一项目依赖树。

package/docs/zh-CN/configuration.md

@@ -62,6 +62,15 @@ DSH 桌面在登录后且没有任何 provider API key 时，可以自动选择
 
 需要继续用 API Key 的自定义配置仍受支持：在完整配置的相关绑定及其 channel 中一致选择 `deepseek-official`，按 DSH API provider 的正常方式配置凭证。不要仅改 channel 名却保留冲突的显式 provider；也不必为账号路径额外添加 API key。
 
+## 原生能力配置
+
+`native-profiles` 定义版本化 harness options，绑定使用 `native-profile` 引用。
+模型 profiles、loops、routes、judge-panel 和 execution-policy 的允许绑定均支持，
+引用必须与实际 harness 匹配。省略可继承模型 profile，显式空字符串关闭继承。
+静态能力不依赖 JEV 开关；工作台按当前 harness 选择配置，高级 JSON 编辑定义。
+实际 options 进入历史及冻结策略身份，准入、用量和清理仍取决于运行回执。
+完整示例、LCU、Tower 和独立 Review/Team 入口见[原生能力](native-capabilities.md)。
+
 ## 从完整模板开始
 
 查看默认内联表或可复用 profiles 表：
@@ -298,8 +307,9 @@ null、错拼字段和不完整对象在模型启动前拒绝。字段信源为
 
 `sessions.mode` 控制历史复用，不关闭调用安全记录。Codex Pro、Claude Code Pro、DSH 和 Kimi 的主任务
 Plan／Execute／Review／Judge 调用在两种模式下都先记录调用意图，再保存可信终态回执。
-`fresh` 不复用通用的角色历史，保持后端原有的新调用方式，并保留既有 Kimi Plan
-`resident-session` 行为；`scoped` 在身份兼容且终态满足条件时延续同角色历史。
+`fresh` 不复用通用的角色历史，保持后端原有的新调用方式；仅未配置 `native-profile` 的
+旧 Kimi CLI 路径保留 Plan `resident-session` 行为。原生 Agent/Swarm 历史使用 scoped
+角色账本，Tower 始终 fresh；`scoped` 在身份兼容且终态满足条件时延续同角色历史。
 其他适配器及 mock 仍使用原有调用路径；Intake／Garden 不在该角色会话策略内。
 
 | 角色 | 历史作用域与责任 |
@@ -314,8 +324,11 @@ Quick 的正常首次成功路径仍只有 Execute 和最终 Review 两次阶段
 会话选择、恢复、重建和计量；技能、模型与桌面控制面不扫描后端历史来猜测会话。
 
 Plan 显式 `resident-session:false` 在 scoped 下仍关闭该角色的历史复用；省略该字段
-不等于明确关闭。`resident-session:true` 是既有 Kimi Plan 选项，不是跨 harness 开关，
-Codex Pro 仍拒绝它；为 Codex Pro 选择 scoped 应使用 `sessions`。
+不等于明确关闭。未选择 `native-profile` 时，`resident-session:true` 保留旧 Kimi CLI
+Plan 行为。原生 Agent/Swarm 在全局 `fresh` 下将这个显式 resident 意图映射为 scoped
+角色账本；显式 `sessions.roles.plan:"fresh"` 仍优先关闭复用。旧 CLI Session 不会导入，
+Tower 始终 fresh。该选项不启用跨 harness 历史复用；Codex Pro 仍拒绝它，为 Codex Pro
+选择 scoped 应使用 `sessions`。
 
 复用身份包含实际任务／工作目录、角色／作用域、harness、provider、channel、model、
 thinking、权限及后端运行配置引用。home/profile、worker 和命令引用取实际子进程所用
@@ -344,7 +357,7 @@ thinking、权限及后端运行配置引用。home/profile、worker 和命令
 派发、结果或清理有任何一项未知时，原调用阻止继续执行；换成 fresh、改变适配器或
 重启不能绕过。子进程退出只解决进程事实，不证明模型结果已知。`resume-candidate`
 只是允许适配器尝试正常续接，不是历史已持久化或任意崩溃后都可恢复的证明。
-Codex Pro 0.9.0 与 Claude Code Pro 0.4.0 的主任务调用使用外层 worker v3，
+Codex Pro 0.10.0 与 Claude Code Pro 0.5.0 的主任务调用使用外层 worker v3，
 接通公开 typed lifecycle、等待 Go 持久化后返回的 ACK，以及不发送新 turn 的只读
 recovery。Codex 可以在配置核对后的 `thread-ready` 阻止新 turn；Claude 原生 init
 发生在 prompt 已派发之后，不能提供同等的派发前配置证明。两个后端都保留未知窗口，
@@ -551,10 +564,10 @@ Quick 复用现有 Execute 与 Review 绑定，不自动改变 thinking、账户
 ```
 
 完整 profiles 模板使用 `profiles.codex-pro`，hard 路由引用它。插件精确消费
-`dsh-subagent-codex-pro@0.9.0` 的公开 `dsh-subagent-codex-pro/machine` API。
+`dsh-subagent-codex-pro@0.10.0` 的公开 `dsh-subagent-codex-pro/machine` API。
 精确依赖由插件 package 和 lockfile 锁定；生命周期开发时使用的源码包见
 [vendor 来源记录](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/vendor/README.md)。内部仍使用 Codex app-server 和用户已有登录，不需要父模型二次委派；缺包、
-版本或回执不符会失败，不自动回退 `codex exec`。Claude 另为精确 `0.4.0` optional peer，
+版本或回执不符会失败，不自动回退 `codex exec`。Claude 另为精确 `0.5.0` optional peer，
 未选择该后端时无需安装。
 
 已有配置不自动改写。要从旧路径迁移，在 `config inspect` 显示的有效文件中修改 inline harness 或其 profile，保留所选 model／thinking／channel，然后重启引擎。保留 `harness: "codex"` 则明确继续使用旧 CLI。`codex-pro` 必须提供 model 和 channel，不沿用旧 Codex driver 的隐式模型；`resident-session: true` 会在加载时拒绝。thinking 省略时为 high。
@@ -645,7 +658,7 @@ doctor 不接收运行时的 `--mode` 覆盖，只反映 Spec／已保存状态
 
 DSH 的 `ready.reasoningEffort` 是 SDK 接受配置之后的 worker 回显，不是模型服务独立证明的实际推理强度。没有模型请求的检查不能证明更高档位提高质量；GPT、Kimi 和 Flash 也不共用同一套档位枚举，详见[推理等级说明](model-policy.md)。
 
-Codex Pro 本地检查额外实际导入公开 machine API，核对精确 0.9.0／协议 1、typed
+Codex Pro 本地检查额外实际导入公开 machine API，核对精确 0.10.0／协议 1、typed
 lifecycle／recovery 导出、Node >=22.18.0 与 Codex 命令版本；同一 worker 只查一次。
 绑定的 `durableJournal`、`readOnlyRecovery`、`threadReadyBeforeDispatch` 表示锁定
 适配器的静态能力；Claude 最后一项为 false。`historyRecoveryTested` 保持 false。

package/docs/zh-CN/contributing.md

@@ -70,12 +70,14 @@ Worktree 隔离 checkout 文件和 index，不是安全沙箱。串行执行保
 make quality-gate
 npm --prefix plugins/dsh ci --ignore-scripts
 npm --prefix plugins/dsh run check
-FLYWHEEL_TEST_NODE_BRIDGE=1 go test ./internal/drivers -run '^Test(DSH|CodexPro|ClaudeCodePro)NodeWorkerOfflineBridge$' -count=1
+FLYWHEEL_TEST_NODE_BRIDGE=1 go test ./internal/drivers -run '^Test(DSH|CodexPro|ClaudeCodePro|KimiNative)NodeWorkerOfflineBridge$' -count=1
 npm test
 npm run build:npm
 FLYWHEEL_NPM_PACKAGES_DIR=dist-npm npm run test:install
 ```
 
+`make test` 与 `make coverage` 使用有限的 15 分钟 Go 包级测试预算（`FLYWHEEL_TEST_TIMEOUT`）。machine 包包含数百个真实 Git 与持久化状态场景，macOS 需要这份累计预算；生产 watchdog、单项测试保护和每函数 100% 覆盖率门禁保持原有要求。
+
 | 改动 | 必需验证 |
 |---|---|
 | Go 引擎 | `make quality-gate`：vet、格式、测试和覆盖率 |
@@ -83,9 +85,9 @@ FLYWHEEL_NPM_PACKAGES_DIR=dist-npm npm run test:install
 | npm 安装或发行 | 根 npm 测试、单包候选构建、安装同一个 tarball |
 | 文档 | 链接、锚点、代码围栏、可运行示例、翻译一致性，以及受影响的内嵌／包内容 |
 
-Claude 桥接要求 worker 的依赖树中存在精确 0.4.0 optional machine API；因未安装 peer
+Claude 桥接要求 worker 的依赖树中存在精确 0.5.0 optional machine API；因未安装 peer
 而跳过不能算该后端通过。使用源码候选时保留已审查 source／tarball 身份。Codex Pro 的
-0.9.0 bundled 源码包同样由实际 integrity 与 [vendor 记录](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/vendor/README.md)
+0.10.0 bundled 源码包同样由实际 integrity 与 [vendor 记录](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/vendor/README.md)
 固定。
 
 生命周期、状态或进程改动还应复现 Linux CI 的 race 检查：

package/docs/zh-CN/getting-started.md

@@ -46,7 +46,7 @@ Full 需要所配置的 Plan／Execute／Review／Judge 后端；合格 Quick
 运行前提。
 
 Claude 为可选后端。选择 `claude-code-pro` 时，还需在 worker 能解析的依赖树中安装
-匹配的 0.4.0 配套包，并准备已登录的 Claude CLI，详见[Claude Code Pro](claude-code-pro.md)。
+匹配的 0.5.0 配套包，并准备已登录的 Claude CLI，详见[Claude Code Pro](claude-code-pro.md)。
 
 ## 2. 安装
 
@@ -124,7 +124,7 @@ dsh plugin --profile sdk add dsh-plugin-chatgpt@0.1.17
 这是兼容基线，不代表当前最新版本。按该 adapter 的正常授权流程操作，保持 `DSH_HOME`
 一致，不把凭证放进任务文件或 Git。
 
-hard 路由直接导入精确锁定的 Codex Pro 0.9.0 公开 machine API，需要本机 Codex 程序
+hard 路由直接导入精确锁定的 Codex Pro 0.10.0 公开 machine API，需要本机 Codex 程序
 与登录，不需要父模型通过 `subagent_codex_pro` 工具二次委派。可选 Claude 有独立的
 依赖与登录。
 

package/docs/zh-CN/model-policy.md

@@ -49,7 +49,7 @@ ChatGPT 与 Kimi 订阅同样需要相应适配器或 CLI，以及其支持的
 
 | 已核对的集成 | 可请求的值 | 说明 |
 |---|---|---|
-| GPT-6.1 Sol／Codex Pro 0.9.0 | `low`、`medium`、`high`、`xhigh`、`max` | machine API 传递指定 effort |
+| GPT-6.1 Sol／Codex Pro 0.10.0 | `low`、`medium`、`high`、`xhigh`、`max` | machine API 传递指定 effort |
 | Sol、Astra／DSH ChatGPT provider | `low`、`medium`、`high`、`xhigh`、`max` | provider 序列化为 `reasoning.effort` |
 | Kimi K3.1 Pro／原生 CLI | `low`、`high`、`max` | 不能关闭 thinking；兼容别名 `xhigh`、`max`、`ultra` 都映射到原生 `max` |
 | DeepSeek Flash／已核对的 DSH adapter | `off`、`low`、`high`、`max` | 此适配器拒绝 `medium` 和 `xhigh` |
@@ -124,5 +124,5 @@ DSH `initialize` 校验配置，但回复只包含 server 信息。Flywheel 的
 `ready.reasoningEffort` 是初始化成功后的请求回显，不是模型服务独立证明。
 Codex Pro 区分 `requestedEffort`、`accepted` 和未知的 `effectiveEffort:null`。
 依据见 [DSH SDK server](https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/sdk/server/src/server.ts)
-与 [Codex Pro machine 协议](https://github.com/ckanner/dsh-subagent-codex-pro/blob/37da3d75de32b809c4fb1a631ccc15191f3d87f9/docs/machine.md)。
+与 [Codex Pro machine 协议](https://github.com/ckanner/dsh-subagent-codex-pro/blob/9c7d724cb19dc29457a56f4a4269c24278595d2f/docs/machine.md)。
 无推理 doctor 不能证明账号余额、真实调用或更高档位的收益。

package/docs/zh-CN/native-capabilities.md

@@ -0,0 +1,184 @@
+# 使用原生 Agent、Team、Swarm 与 LCU
+
+[文档](../README.zh-CN.md) · 简体中文 · [English](../en/native-capabilities.md) · [完整设计](../plans/2026-11-13-native-harness-capabilities.md)
+
+Flywheel 0.34.0 的实现候选可以在正式 loop 中调用各 harness 的原生协作能力。先定义 `native-profiles`，再把某个 profile 绑定到需要它的阶段。静态配置无需开启 JEV；模型、账号 channel、权限和角色历史仍由原有绑定决定。
+
+本页描述源码候选。配套包身份见 [vendor 记录](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/vendor/README.md)，不能仅凭这里的版本号假设 npm 已发布或本机已经安装。
+
+## 1. 选择实际后端
+
+| harness | loop 内能力 | 依赖与权限 |
+| --- | --- | --- |
+| `dsh` | PTC、子 Agent、Team、Workflow、显式 Web、LCU | 本机 DSH；实际 PTC probe；LCU 另需 0.5.0 peer 和 full-access |
+| `kimi` | Server Agent / Swarm / Tower | 已登录 Kimi；当前 Server API；显式 full-access |
+| `codex-pro` | 原生 agents 与子线程 | 内置 Codex Pro 0.10.0；已登录 Codex CLI；实际 sandbox/approval 回执 |
+| `claude-code-pro` | Agent 定义、Workflow、Advisor | 可选 Claude Code Pro 0.5.0；已登录 Claude CLI；显式 full-access |
+
+在 DSH 中选择 ChatGPT 模型仍然使用 DSH 的工具循环，不自动获得 Codex 的 app-server 能力。桌面的 `heavy` Agent Preset 也不自动成为独立 SDK worker 的组合；worker 使用与生成器共享策略的 PTC overlay，并验证实际运行结果。
+
+### 对齐独立 worker 的依赖
+
+桌面、全局 CLI worker 和选中的 SDK profile 是不同的 Node 解析树。只更新桌面不会更新其他位置。先从受管安装记录（`~/.config/flywheel/installation.json`）确认 Flywheel 的实际 prefix；需要可选 Claude 或 LCU 后端时，将精确 peer 安装到同一 prefix：
+
+```sh
+npm install --global --prefix /absolute/flywheel-node-prefix --ignore-scripts dsh-subagent-claude-code-pro@0.5.0 dsh-plugin-lcu@0.5.0
+dsh plugin --profile sdk add --save-exact --ignore-scripts dsh-plugin-chatgpt@0.1.20
+```
+
+自定义了 `FLYWHEEL_DSH_PROFILE` 时，将 `sdk` 换成实际名称，并继续与 `desktop` 分离。这些命令只对齐软件依赖，不更改模型凭据、权限或原生 profile 开关。之后运行 `flywheel doctor --json`；可导入不等于已验证真实原生准入或模型视觉。
+
+### DSH 桌面插件的默认配置与 PTC 调用
+
+Codex Pro 和 Claude Code Pro 自身提供原生能力配置页。打开插件管理器中对应插件的配置，设置 `native` 默认值；DSH 的 PTC 工具 `subagent_codex` 和 `subagent_claude_code` 会在每次调用开始时读取这些设置。已经启动的调用保留自己的配置快照，后续保存不会改变它的执行参数。
+
+| 普通工具的 `native` 参数 | 实际含义 |
+| --- | --- |
+| 省略 | 读取插件当前默认值；插件也未配置时，沿用 CLI 原有行为 |
+| 对象 | 以这个完整对象替换该次调用的 native 默认值；不与默认值逐字段合并 |
+| `null` | 明确关闭该次普通调用的原生协作能力，不退回 CLI 的隐式启用状态 |
+
+Codex 的设置包括 Agent 启用状态、并发子线程数、子 Agent 默认模型和 effort，以及可选 V2 backend。Claude 的设置包括 Agent 定义、并发与深度、Workflow 和 Advisor；启用 Advisor 时必须指定其模型。工具也支持相应的逐次覆盖。原生能力设置遵守现有权限和模型选择策略。
+
+这里的 `native` 指 Codex/Claude 内部的能力，DSH 仍然可以用 PTC 编排这些工具。独立原生 Review 和真正的交互 Team 使用专门入口；保存普通 Agent 默认值不会启动这些任务。
+
+这些桌面默认值只属于桌面插件。Flywheel 的直接 `codex-pro` / `claude-code-pro` worker 使用所选 `native-profile` 的确定快照，不读取另一份 DSH profile 的动态设置；独立 `/machine` 入口也不会为此加载桌面 UI 或 DSH 服务。正常重生成 daily/heavy preset 会保留单独保存的插件配置。
+
+## 2. 定义与绑定
+
+先运行 `flywheel config inspect --cwd /absolute/repo --json` 找到真正命中的完整配置。Flywheel 按任务→项目→全局→默认选择一个完整文件，文件之间不做字段合并。
+
+把下面**片段**合入完整文件；需要的定义可单独选用：
+
+```json
+{
+  "native-profiles": {
+    "heavy-team": {
+      "harness": "dsh",
+      "options": {
+        "version": 1, "preset": "heavy",
+        "agents": {"enabled": true, "maxConcurrent": 4, "maxDepth": 2},
+        "team": {"enabled": true},
+        "workflows": {"enabled": true},
+        "web": {"search": true, "fetch": true}
+      }
+    },
+    "swarm": {
+      "harness": "kimi",
+      "options": {"version": 1, "mode": "swarm", "agents": {"enabled": true}}
+    },
+    "tower": {
+      "harness": "kimi",
+      "options": {"version": 1, "mode": "tower", "agents": {"enabled": true}}
+    },
+    "codex-team": {
+      "harness": "codex-pro",
+      "options": {"version": 1, "agents": {"enabled": true, "maxConcurrentThreads": 4, "backend": "v2"}}
+    },
+    "claude-flow": {
+      "harness": "claude-code-pro",
+      "options": {"version": 1, "agents": {"enabled": true}, "workflows": {"enabled": true}, "advisor": {"enabled": true, "model": "opus"}}
+    }
+  }
+}
+```
+
+在当前阶段绑定上加入 `native-profile`，保留它原来的其他字段。例如默认 Execute 仍然是 DeepSeek account + DSH：
+
+```json
+{
+  "routes": {
+    "default": {
+      "harness": "dsh", "provider": "deepseek-account",
+      "channel": "deepseek-account-sdk", "model": "deepseek-flash", "thinking": "high",
+      "native-profile": "heavy-team"
+    }
+  }
+}
+```
+
+模型 `profiles`、`loops`、`routes`、`judge-panel` 和 `execution-policy.bindings` 都可引用。引用必须与实际 harness 匹配。绑定省略字段可继承模型 profile；显式 `"native-profile":""` 关闭继承。`native-profiles` 的 options 改变后，原有不兼容角色历史不会继续复用。
+
+桌面工作台的“模型与会话”增加“原生能力”选择器，只列当前 harness 的配置；在高级 JSON 中编辑定义。保存仍需要当前文件 revision，配置从下次启动生效。选择 profile 只是配置意图，实际准入仍以运行回执为准。
+
+## 3. 用在不同阶段
+
+Plan 可以让 Team/Swarm 并行调查，root 最后输出正式 Spec 和 packets。Execute 可以使用原生 Agent、Workflow 或 Tower，结果仍要通过原有验证和独立 Review。Review 和 Judge 使用自己的角色历史与子任务，永远不继承 Executor 的历史。Intake/Garden 可以使用同样能力生成建议，不能据此修改状态文件。
+
+开启 native profile 不新增第二个循环控制器：Go 继续决定是否重试、预算是否允许、哪个 candidate 被验收以及何时交付。原生 task board 的完成状态不是 Flywheel completed。
+
+## 4. LCU 与截图
+
+给 DSH profile 增加以下 options 字段，并为对应角色明确选择 full-access：
+
+```json
+{
+  "lcu": {
+    "enabled": true,
+    "config": {"chrome": true, "audio": false}
+  }
+}
+```
+
+`config` 还支持实际 runtime 的 `app`、`command`、`allowedApps`、`allowedOrigins`。应使用本机真实 app/runtime 和已授权目标。LCU peer 必须能从 SDK worker 的实际 Node 依赖树解析；只在另一份桌面 profile 中安装不等于独立 worker 已可导入。
+
+worker 先取得整台桌面的受管 lease；root 和后代的 GUI 操作顺序执行。PTC 工具名为 `lcu_cua`，程序对象仍为 `cua`。对象 handle 只属于当前 runtime epoch，重启后需重新取得。未确认清理的 lease 不被其他调用自动接管；先核对原 owner 的终态与实际 runtime，不能仅删除锁来假装完成。
+
+图片和 manifest 保存在 `<taskDir>/reports/native/<invocationId>/`。归档 hash 对应实际 DSH AttachmentStore 的最终字节，capture hash 单独保留。图片存在不等于模型已经收到；`imageDeliveredToModel` 可以为 `unverified`。ChatGPT provider 0.1.20 修复真实图片到模型请求的投影，但尚未在用户账号上完成实机视觉验收。
+
+公开 Pro machine API 可以显式接收媒体与结构化输出设置；正式 Go loop 不会自动把所有归档图片注入下一轮，也不会把外部 JSON schema 或 native review 文本当作自己的验收 verdict。
+
+## 5. Kimi Tower 的候选工作目录
+
+Tower 在独立 Git 副本中运行，包括当前 dirty/untracked/binary/symlink/mode/deletion 状态。它不是 OS 沙箱；当前权限为完全访问。worker 对提示词中的精确执行目录做有边界映射，并记录摘要。
+
+仅 Execute 在完成与清理都确认后才尝试导回。导回前再次核对源 HEAD、文件内容与模式、外部 task 契约，并进行 binary patch check。源目录或 Spec/packet 有并发变化时保留 candidate 并返回冲突；其他角色只保留产物。导回仍要经过正常验证、Review 和 Git 交付。
+
+native Kimi 不读取或写回旧 `plan-session` 缓存。Agent/Swarm 使用角色账本；
+显式旧 `resident-session:true` 可保留续接意图，但 `sessions.roles.plan:"fresh"`
+明确优先。Tower 始终 fresh，不续接旧 Session。Kimi Server 模式缺乏已证明的整树 `agents.maxConcurrent` 硬上限，因此不要为这些模式填写这个字段；明确请求时会在派发前被拒绝。完整协议见 [Kimi native](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/KIMI_NATIVE_PROTOCOL.md)。
+
+## 6. 独立原生 Review 与交互 Team
+
+这些操作有单独的原生任务回执，不直接进入正式 loop 的 verdict：
+
+```sh
+flywheel native codex-review --request /absolute/codex-review.json
+flywheel native claude-review --request /absolute/claude-review.json
+flywheel native claude-team --request /absolute/claude-team.json
+flywheel native claude-recover --request /absolute/recovery.json
+flywheel native claude-control --request /absolute/control.json
+```
+
+请求是对应公开包 API 加私有绝对 `recoveryDirectory`；输入必须是 regular JSON 文件，最多 1 MiB。Codex 的最小示例：
+
+```json
+{
+  "protocol": 1, "requestId": "review-001", "cwd": "/absolute/repo",
+  "model": "gpt-6.1-sol", "effort": "high",
+  "prompt": "Review the selected changes.", "permissionMode": "read-only", "threadMode": "ephemeral",
+  "native": {"version": 1, "review": {"target": {"type": "uncommittedChanges"}}},
+  "recoveryDirectory": "/absolute/private/native-review-001"
+}
+```
+
+远端 Claude Review 的请求需 `protocol:1`、唯一 requestId、绝对 cwd、`consent:true` 和 recoveryDirectory。它运行 `ultrareview --json --no-post`；本地超时不会证明远端 job 已结束。使用原 requestId、runId 和 recoveryDirectory 只读原本地 journal，取回已持久化的回执；不查询云端状态，也不重新提交 Review。
+
+交互 Team 请求使用公开 `runInteractiveTeam` 的 prompt 和 permissionMode；tmux 必须可用。`claude-control` 支持 capture/send/resize/cancel/attach，使用 receipt 中的原 requestId/runId 和同一 recoveryDirectory。完整字段见 [Claude native API](https://github.com/ckanner/dsh-subagent-claude-code-pro/blob/d14ff8d8334fefd039c3d48ee2a969747d1e88c8/docs/native-capabilities.md)。
+
+Claude `recoverNativeJob` 只读本地 durable journal，不启动进程或向云端查询。当前回执明确 `jobId:null`、`querySupported:false`、`cancelSupported:false`。本地恢复 status 为 terminal 也不等于 remote 完成：若远端 state 仍为 unknown 或 native.cleanup.confirmed 为 false，不能自动重放或声称云任务已取消。
+
+## 7. 查看真实可用性与失败
+
+```sh
+flywheel doctor --cwd /absolute/repo --json
+flywheel doctor --cwd /absolute/repo --probe --json
+```
+
+native doctor 检查本地 worker、精确 public manifest 与 capability 版本，不发模型、启动 Team、创建云 job 或操作 GUI。DSH native profile 不拿 legacy SDK probe 冒充 native 准入；其实际 PTC、模型与目标能力要在正式 worker admission 时证明。`native.admission` 保持 unknown，`inferenceTested:false` 和 `admissionTested:false` 不等于失败的登录尝试。
+
+`native-receipt` 保存请求、实际配置、观察、children、usage、completion 与 cleanup。Pro 的 native-event 不是 durable lifecycle ACK。root 返回时仍有活跃子任务，不会因随后关进程而变成完成。清理不明、receipt 损坏或恢复不确定会继续阻断。
+
+预算和并发也保持真实语义：Flywheel scheduler 限根调用；Claude 的 requested limits 是 observed guard，`hard:false`；Kimi 没有该整树硬上限。外部子 Agent、Advisor、compaction 或 Tower 消耗无法精确归属时 total 保留 unknown。hard budget 不把 unknown 当成零。详细测试与尚未实机验证的范围见[验证记录](../validation/2026-11-14-native-harness-implementation.md)。
+
+桌面插件配置、PTC 参数类型和本轮真实包验证见[桌面配置跟进记录](../validation/2026-11-14-desktop-native-configuration.md)。

package/docs/zh-CN/releasing.md

@@ -20,8 +20,8 @@ worker 包。`plugins/dsh` 是 **private 源码／构建／测试区**，不是
 旧四个平台包及 `@ckanner/dsh-plugin-flywheel` 保留为历史版本；新流程不上传它们的
 新版本，也不撤销其已发布字节。
 
-Codex Pro 0.9.0 继续内置[已审查源码候选](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/vendor/README.md)，
-根目录与源码构建区锁文件都保持原 tarball integrity。Claude Code Pro 0.4.0 是外部
+Codex Pro 0.10.0 继续内置[已核对的正式发行包](https://github.com/ckanner/flywheel/blob/main/plugins/dsh/vendor/README.md)，
+根目录与源码构建区锁文件都保持原 tarball integrity。Claude Code Pro 0.5.0 是外部
 可选 peer。Provider CLI 和账号凭据不在包内。普通 npm 安装只放置文件，`install`／
 `setup` 才执行用户设置，禁止在 postinstall 隐藏 profile 或凭据修改。
 

package/docs/zh-CN/session-recovery.md

@@ -3,7 +3,7 @@
 [文档目录](../README.zh-CN.md) · [English](../en/session-recovery.md) · 简体中文
 
 Flywheel 分别处理角色对话历史续用和中断调用恢复。fresh 与 scoped 都保留调用安全
-检查。公开 journal 的持久化恢复要求 **Codex Pro 0.9.0** 或 **Claude Code Pro 0.4.0**；
+检查。公开 journal 的持久化恢复要求 **Codex Pro 0.10.0** 或 **Claude Code Pro 0.5.0**；
 DSH 与 Kimi 继续使用各自支持的恢复路径。
 
 ## 恢复已有任务

package/native/manifest.json

@@ -1,22 +1,22 @@
 {
   "protocol": 1,
-  "version": "0.33.1",
+  "version": "0.34.0",
   "platforms": {
     "darwin-arm64": {
-      "bytes": 10317010,
-      "sha256": "4efb5efab4fce7b6fd86d15d6fcc21530b4aee169613b5009e2cee452c277c9c"
+      "bytes": 10402066,
+      "sha256": "9bd8edc0c6f187c1f7d1e9ef108ad931d5dc0a2ec369d6f5ca8a4cc845ef0e07"
     },
     "darwin-amd64": {
-      "bytes": 11236784,
-      "sha256": "a93e2f8802fb4a1c258dc331546e0a0e56165aec92e90e3eb64e42d88ac49b15"
+      "bytes": 11333504,
+      "sha256": "4b383a1f5bc6bcbaac84be424b3cd5d4bdc78abbff6cd47562275abce1ab2ab8"
     },
     "linux-arm64": {
-      "bytes": 10092704,
-      "sha256": "82c611cbada4d1a8b932b619cfe1fb15b30aee2e35ba3fb1da527c000c19cffc"
+      "bytes": 10223776,
+      "sha256": "c6643be2090ed15454b7e3d936a09284b131c8de449935d5976cdaffdf7257bd"
     },
     "linux-amd64": {
-      "bytes": 11014304,
-      "sha256": "7f49ac00660cf97502d27f150e7969b04cac50c894c5f8b7149a05a19f681316"
+      "bytes": 11112608,
+      "sha256": "1bb2aedb76d4eeccf2ac807172cb976fa231ba0ca331153809ec1bf994a1b3c0"
     }
   }
 }