DeepSeek Harness Tauri 桌面版 | Only 8mb installer, zero environment setup, preset plugins, Windows / macOS / Linux.
该文档已被固定,禁止修改
上游同步规范与管理索引
目的:定期核对本项目从上游参考实现移植或派生的能力,及时采纳有价值的修复与新特性。 铁律:先汇报、后实施。未经用户逐条明确同意,严禁修改代码、推进子模块基线或落成功能。
本文档为「对应关系 + 基线 + 待评估项」的唯一全局索引。具体实现细节、提交范围、验证记录及未采纳原因,详见各包内的 sync-log.md(参见 §1 表格)。
1. 范围定义
1.1 纳入范围(上游对应关系)
| 本项目实现模块 | 上游仓库 / 对应逻辑 | 本地路径 | 已采纳基线 | 包内同步日志 |
|---|---|---|---|---|
dsh-tauri-pet |
PC2005-cloud/dsh-pet |
source/dsh-pet |
v0.2.6 (e1ff8c1) |
sync-log.md |
| └─ 气泡文案 / 状态优先级 | QCYTSN/dsh-dafeiyu |
source/dsh-dafeiyu |
v0.1.9 (f4f4482) |
同上 |
| └─ Codex 图集 / 会话状态 | Skylarking/dsh-plugin-codex-pets |
source/dsh-plugin-codex-pets |
22e93f4 |
同上 |
| └─ 原生拖动 / DPI / 穿透 | ayangweb/BongoCat |
source/BongoCat |
v1.1.0-5 (44f44bc) |
同上 |
dsh-tauri-extension |
qinyre/dsh-plugin-capabilities |
source/dsh-plugin-capabilities |
v0.3.11 (52e3f66) |
sync-log.md |
dsh-tauri-scheduler |
MichengAI/dsh-automation |
source/dsh-automation |
f1bc91a (跟进 c426c3d) |
sync-log.md |
连带跟随依赖(非独立上游,须同步提升基线)
preset-pets.json预设ref(含platforms.macos镜像产物 commit):必须与source/dsh-pet的 HEAD 保持同步,否则 macOS 端将停留在旧动画集。hairyf/dsh-pet-component(npm 渲染层):走常规依赖升级流程。Signalight/codex-to-dsh-pet:Codex v2 图集与状态映射的文字参考,按需拉取核对。
1.2 排除范围
- DSH 内核 (
deepseek-ai/deepseek-harness):属于“必须兼容”的运行时依赖,非择优采纳。若需巡检另设章节,不得与本流程混用。 - 上游纯文档改动(README / 注释 / 翻译 / License / Release Notes)。
- 上游 CI / CD、发布流水线与脚手架配置。
- 第三方适配:上游针对其自身宿主或第三方生态(如 Electron Helper、特定插件)的专属逻辑。
- 已在包内日志中登记并以其他方式实现的逻辑(防重复评估)。
2. 判定标准
2.1 需汇报(有价值)
- 缺陷修复:崩溃、失败、状态异常、兼容性修复,且本项目存在相同或相似缺陷。
- 特性扩展:补齐本插件功能短板,且与包内“有意保留的差异”不冲突。
- 协议/宿主对齐:上游针对 DSH 内核升级所作的宿主 API 适配。
- 资产/素材更新:新预设、新动画或字段扩展(需连带更新预设与 macOS 镜像 ref)。
2.2 直接归档(无价值)
- 纯文档、注释、翻译、License 或脚手架/CI 修改。
- 针对 Electron Helper 等特定宿主的专属适配。
- 依赖本项目未提供之宿主能力的功能(如 Session Folder、市场模块等)。
- 包内日志已明确结论且前提条件未变更的提交。
2.3 判定原则
- 核心标准:“本项目是否存在同类问题 / 能否直接受益”,不视版本号大小或 Issue 热度而定。
- 存疑提交统一标记为
待定提请裁决,严禁直接剔除修复类提交。 - 评估前须核对包内日志中的历史归档项,避免重复评估。
3. 标准同步流程
3.1 步骤 1:只读取证
按需执行以下命令更新远端引用(仅抓取 Commit History,严禁使用 pull / checkout 改动工作区):
# 批量拉取并查看待评估 Commit Log
git -C source/dsh-pet fetch --all --tags && git -C source/dsh-pet log --oneline e1ff8c1..origin/main
git -C source/dsh-dafeiyu fetch --all --tags && git -C source/dsh-dafeiyu log --oneline f4f4482..origin/main
git -C source/dsh-plugin-codex-pets fetch --all && git -C source/dsh-plugin-codex-pets log --oneline 22e93f4..origin/main
git -C source/BongoCat fetch --all --tags && git -C source/BongoCat log --oneline 44f44bc..origin/main
git -C source/dsh-automation fetch --all --tags && git -C source/dsh-automation log --oneline f1bc91a..origin/main
git -C source/dsh-plugin-capabilities fetch --all --tags && git -C source/dsh-plugin-capabilities log --oneline 52e3f66..origin/main
3.2 步骤 2:分类与优先级划分
- 打标分类:
修复|Feature|协议对齐|资产 - 确定结论:
建议采纳|不采纳|待定 - 设置优先级:
- P0:破坏性变更、崩溃修复或内核兼容性更新
- P1:明确的功能补齐
- P2:可选的体验优化
3.3 步骤 3:汇报待批 (唯一交付点)
严格按 §4 模板生成报告并提交裁决,不得修改任何代码。
3.4 步骤 4:用户裁决
- 采纳与否按条目独立生效,概括性或批量同意一律视为无效。
- 未获明确同意的条目标记为“拒绝/暂缓”,回填至包内日志并附带日期与原因。
3.5 步骤 5:实施与日志回填
- 代码变更:遵循“一事一 Commit/PR”原则,PR 必须关联上游 SHA 与汇报条目。
- 基线隔离:严格保护各包“有意保留的差异”,防止被合并覆盖。
- 校验机制:按顺序执行代码格式、类型、单元测试及构建校验:
pnpm run lint && pnpm typecheck && pnpm test -- --run
pnpm --filter <TargetPackage> build
cargo check --manifest-path src-tauri/Cargo.toml --lib
cargo test --manifest-path src-tauri/Cargo.toml --lib
git diff --check
- 数据回填:同时更新对应包内
sync-log.md与本文档 §5 登记表。
3.6 安全红线
- 严禁越权:未经同意不得合并代码、升级子模块基线或变更待定状态。
- 阻断机制:实施过程中若发现与已有“有意差异”冲突或超出汇报影响面,必须立即停止并重新汇报。
4. 汇报模板
上游仓库:<owner/repo> (<本地路径>)
基线状态:<当前基线/SHA> → 拟推进至:<目标版本/SHA>
评估结论:建议采纳 N 项 / 不采纳 M 项 / 待定 K 项
【逐项明细】
- [<P0|P1|P2>] <SHA> <上游提交标题>
- 类别:修复 | Feature | 协议对齐 | 资产
- 改动说明:<变更原因及内容>
- 本地影响:<逐一列出影响的文件路径>
- 处理建议:采纳 (<具体动作>) | 不采纳 (<说明原因>)
- 风险提示:<冲突风险或无>
【不采纳汇总】
- <SHA> <一句话原因>
【需裁决项】
- <列出需用户决策的争议点,若无填“无”>
5. 基线与状态登记表
5.1 当前基线与同步状态
| 实现模块 | 上游仓库 | 本地路径 | 已采纳基线 | 本地最新 Tag/Commit | 待评估项 / 备注 | 包内日志 |
|---|---|---|---|---|---|---|
dsh-tauri-pet |
PC2005-cloud/dsh-pet |
source/dsh-pet |
v0.2.12 (631c531) |
v0.2.12 (631c531) |
v0.2.7–v0.2.12 已评估并采纳 2 项(db73c36 goal 续跑轮不判成功、bf7c4fb 任务文案取末位 in_progress 并按码点截断),其余不采纳(渲染层归 dsh-pet-component、helper 专属适配不适用);资产 ref 保持 e1ff8c1(区间内 assets/webm、assets/mov 零新增);无待评估项 |
日志 |
dsh-tauri-pet |
QCYTSN/dsh-dafeiyu |
source/dsh-dafeiyu |
v0.1.14 (9c0588c) |
v0.1.14 (9c0588c) |
v0.1.10–v0.1.14 已评估:零可移植(文案表几无变化;其 includeSubagents opt-in 与本仓硬排除子代理会话有意相反);无待评估项 |
日志 |
dsh-tauri-pet |
Skylarking/dsh-plugin-codex-pets |
source/dsh-plugin-codex-pets |
22e93f4 |
- | 未评估 main 分支更新 | 日志 |
| 桌宠窗口 | ayangweb/BongoCat |
source/BongoCat |
44f44bc |
v1.1.0 |
HEAD 已超前 Tag 5 个 Commit | 日志 |
dsh-tauri-extension |
qinyre/dsh-plugin-capabilities |
source/dsh-plugin-capabilities |
v0.3.11 (52e3f66) |
v0.3.11 |
暂无待评估项(该上游的 Market 模块确定不移植,扩展面板也不再消费 dshmarket 的 market 服务) |
日志 |
dsh-tauri-scheduler |
MichengAI/dsh-automation |
source/dsh-automation |
ecfe1e6 (+c426c3d) |
v0.1.51 (ecfe1e6) |
v0.1.33–v0.1.42 全部不采纳(2026-09-16);v0.1.43–v0.1.51 已评估并采纳 3 项(116c953+a0c4cc6 增量摘要、0bde1a4 插件卸载记 cancelled),其余不采纳/归档(2026-09-28);无待评估项 |
日志 |
dsh-tauri(内核载体契约) |
deepseek-ai/deepseek-harness |
source/deepseek-harness |
dsh-v0.2.0-rc.2 (639ed015397) |
dsh-v0.2.0-rc.2 (639ed015397) |
区间 187 commits(140 非 merge,1022 文件):宿主契约(鉴权闸门 / index 注入行 / dshDesktop 标记 / __DSH_BOOT__)10 份源文件 blob SHA 逐字节相等,仅基线推进;FALLBACK_DSH_TAG 保留最后已打包的 rc.1 tag(打包仓库未产出 rc.2 前不杜撰 buildId);Windows 标题栏/全屏 DOM 契约、新可选包、Electron 专属适配、上游 pi-ai 0.87.1 升级归档不实施(本地不枚举 pi-ai compat 字段,无待办;rc.2 的模型选择器搜索能力已择优落到 dsh-tauri-model 候选选择器,登记见该包 THIRD_PARTY_NOTICES.md);无待评估项 |
日志 |
5.2 已知配置与异常记录
- 子模块绑定:
source/*下参考仓库均已引入.gitmodules。source/dsh-market曾为扩展面板的市场标签页临时引入(上游render()只存在于 main 分支),该标签页已在 #1167 移除,对应的 gitlink 与.gitmodules条目一并删除。 - 内核参考仓库:
source/deepseek-harness(deepseek-ai/deepseek-harness,基线639ed015397=dsh-v0.2.0-rc.2)是只读对照基线,为 Issue #496(非 Electron 壳可复用的无端口嵌入式宿主)提供契约比对依据。按 §1.2,DSH 内核排除在本同步流程之外:此子模块不参与择优采纳,只用于核对宿主契约与登记核心版本基线(登记见 §5.1 末行,明细见packages/dsh-tauri/docs/sync-log.md)。桌面端载体鉴权适配的实现见packages/dsh-tauri/src/host/service/gate.ts(DSH_TAURI_EMBEDDED=1时覆写两道鉴权闸门)。 - 路径纠偏记录:
source/dsh-automation已纠正 gitlink 配置,子模块 HEAD 指向f1bc91a。source/dsh-automationgitlink 为f1bc91a,但工作区 checkout 停在e75499e(git submodule status前缀+, 父仓库表现为未暂存的source/dsh-automation变更)。2026-09-16 裁决不采纳v0.1.33–v0.1.42任何代码, 基线不推进、工作区不回落。- 2026-09-28 纠偏完成:
v0.1.43–v0.1.51已评估并采纳 3 项后,gitlink 与子模块工作区一并推进到ecfe1e6(v0.1.51),不再存在「gitlink 与工作区不一致」的未暂存变更。 dsh-tauri-extension文档中引用的上游路径已更正为source/dsh-plugin-capabilities。- 修复了
dsh-tauri-extension/README.md中soruce的拼写错误。 dsh-tauri-pet的「资产 ref 与代码基线解耦」:src-tauri/resources/manifest.jsonc的素材 URL 内嵌source/dsh-pet的 ref,但它不必等于已采纳代码基线。2026 本轮把代码基线推进到v0.2.12的同时 把资产 ref 留在e1ff8c1:e1ff8c1..v0.2.12期间assets/webm、assets/mov零新增,升级只会让config指向含whisperImageEnabled/chatImageEnabled/memes(本地渲染层不消费)的新config.jsonc。 只有出现新 WebM/mov 时才升该 ref。同理,src-tauri/resources/preset-pets.json是已失效的旧路径, 现为manifest.jsonc的pets.built-in;src/host/reducer.ts现为src/host/service/session-stream.utils.ts。
6. 维护约定
- 职责分离:本文档负责维护全局对应关系、基线与待评估索引;包内日志记录具体的移植细节与未采纳项。
- 状态词汇集中:仅使用以下标准词:
待评估|已汇报待批|已同意|已实施|不采纳|暂缓。 - 双向更新:每次同步完成后,必须同时刷新包内日志与本文档 §5 登记表。