severin-ye/uagent-sync#packages/dsh

uagent-sync 的 DeepSeek Harness bundle 形态。注册 16 个 sync_* 工具（与 opencode plugin 的 opencode_sync_*、CLI 的 16 命令一一对应），全部通过 uagent-sync CLI 桥接执行——与 Codex 形态（skills + hooks）保持同一"CLI 单一执行通道"架构。

插件加载时还会把共享 skills（uagent-sync-backup/restore/update）注册为 DSH runtime skills——从 CLI 所在 checkout 的 skills/ 目录读取，与 opencode/Codex 是同一份，正文中的 <uagent-sync> 占位符自动替换为真实路径，Agent 可直接执行。skills 目录缺失时静默跳过（工具不受影响）。

中文名：U同步（别名 优同步）。语音命令：

• "U同步，更新所有扩展" → sync_update
• "U同步，备份" → sync_push（配合 init/create_repo/api_keys/guide）
• "U同步，恢复" → sync_pull（配合 init/setup/api_keys）
• "U同步，检查环境" → sync_verify

工具清单（16 个）

工具	CLI 命令	用途
sync_export	export	导出工作区状态 JSON
sync_import	import	从 JSON/URL 恢复
sync_diff	diff	对比当前与已保存状态
sync_push	push	导出 + 提交 + 推送到 GitHub
sync_pull	pull	拉取 + 应用状态
sync_status	status	子模块状态
sync_verify	verify	环境健康检查
sync_setup	setup	安装工作区依赖
sync_init	init	初始化（backup/sync）
sync_create_repo	create-repo	创建私人 GitHub 仓库
sync_api_keys	api-keys	密钥模板 detect/generate/add
sync_guide	guide	生成 SYNC-GUIDE.md
sync_log	log	安装溯源日志 read/add/export
sync_crystallize	crystallize	记录安装 + 文档 + 导出 + 一键提交
sync_update	update	更新 coding-agent 生态
sync_changelog	changelog	从更新报告提取变更证据

安装

DeepSeek Harness 目前是 Developer Preview，以下命令以当前版本为准。

方式一：从 GitHub 安装（本仓库 monorepo 子包）

dsh plugin --profile <name> add "github:severin-ye/uagent-sync#main&path:packages/dsh"

本包是纯 JavaScript，无需 prepare 构建授权（pnpm ≥10 的 allowBuilds 步骤不会出现）。

方式二：本地 checkout 安装

# 在 uagent-sync 仓库内先构建 CLI：
npm install && npm run build

dsh plugin --profile <name> add ./packages/dsh

本地安装时插件自动通过相对路径发现 dist/cli.js，无需配置。

方式三：npm 发布后

dsh plugin --profile <name> add uagent-sync-dsh

CLI 定位与配置

工具执行前按以下顺序定位 dist/cli.js：

1. cordis.yml 配置：config: { cliPath: '/abs/path/to/uagent-sync/dist/cli.js' }
2. 环境变量：OPENCODE_SYNC_UAGENT_SYNC_CLI
3. 本地 checkout 相对路径（方式二自动命中）
4. 工作区递归：从 cwd 向上找 .gitmodules，在其下找 uagent-sync/dist/cli.js

全部失败时工具返回可操作的错误指引（fail loud）。

# 在 profile 的 cordis.patch.yml 里覆盖配置示例
- id: uagent-sync
  name: uagent-sync-dsh
  config:
    cliPath: 'C:/Users/you/Codelib/2_Business/uagent-sync/dist/cli.js'
    commandTimeoutMs: 1800000   # update 全量可能 30 分钟，默认 10 分钟

三端对照

	opencode	Codex	DeepSeek Harness
形态	plugin（16 opencode_sync_* 工具）	skills + hooks	bundle（16 sync_* 工具）
执行通道	进程内调用业务函数	CLI	CLI 桥接
共享资产	skills/ 目录	skills/ 目录	skills/ 目录 + CLI
分发	dist/plugin.js	marketplace	dsh plugin add