chore(desktop): bump oasf lock to 0.2.0 from crates.io

.github/workflows/release-orchestrate.yml

@@ -0,0 +1,86 @@
+name: release-orchestrate
+
+# One command publishes everything for tag vX.Y.Z:
+#   gh workflow run release-orchestrate.yml --ref vX.Y.Z -f version=X.Y.Z
+# Resolves the release-build run for the tag, then serially dispatches:
+#   crates -> npm -> pypi -> latest-json -> post-release-verify
+# Each child keeps its own context validation; this workflow only sequences them.
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Version without leading v (must match tag vX.Y.Z and Cargo.toml)"
+        required: true
+        type: string
+
+permissions:
+  contents: read
+  actions: write
+
+concurrency:
+  group: release-orchestrate-${{ inputs.version }}
+  cancel-in-progress: false
+
+jobs:
+  orchestrate:
+    name: orchestrate release v${{ inputs.version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    env:
+      GH_TOKEN: ${{ github.token }}
+      VERSION: ${{ inputs.version }}
+    steps:
+      - name: Checkout release tag
+        uses: actions/checkout@v4
+
+      - name: Install Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Validate release context
+        run: python3 scripts/validate_release_context.py
+
+      - name: Resolve release-build run
+        run: |
+          TAG="v$VERSION"
+          RUN_JSON=$(gh run list --workflow=release-build.yml --branch "$TAG" --event push --json databaseId,status,conclusion,headSha --limit 1)
+          echo "$RUN_JSON"
+          RUN_ID=$(echo "$RUN_JSON" | jq -r '.[0].databaseId // empty')
+          STATUS=$(echo "$RUN_JSON" | jq -r '.[0].status // empty')
+          CONCLUSION=$(echo "$RUN_JSON" | jq -r '.[0].conclusion // empty')
+          HEAD_SHA=$(echo "$RUN_JSON" | jq -r '.[0].headSha // empty')
+          [ -n "$RUN_ID" ] || { echo "::error::No release-build run found for tag $TAG"; exit 1; }
+          [ "$STATUS" = "completed" ] || { echo "::error::release-build run $RUN_ID is still $STATUS"; exit 1; }
+          [ "$CONCLUSION" = "success" ] || { echo "::error::release-build run $RUN_ID concluded: $CONCLUSION"; exit 1; }
+          [ "$HEAD_SHA" = "$GITHUB_SHA" ] || { echo "::error::release-build headSha $HEAD_SHA != checkout $GITHUB_SHA"; exit 1; }
+          echo "BUILD_RUN_ID=$RUN_ID" >> "$GITHUB_ENV"
+
+      - name: Publish (crates → npm → pypi → latest-json → verify)
+        run: |
+          TAG="v$VERSION"
+          dispatch_and_wait() {
+            local workflow="$1"; shift
+            echo "=== dispatching $workflow ==="
+            gh workflow run "$workflow" --ref "$TAG" "$@"
+            sleep 10
+            local run_id=""
+            for _ in 1 2 3 4 5 6; do
+              run_id=$(gh run list --workflow="$workflow" --branch "$TAG" --event workflow_dispatch --json databaseId,status \
+                --jq '[.[] | select(.status != "completed")][0].databaseId // empty')
+              [ -n "$run_id" ] && break
+              sleep 10
+            done
+            [ -n "$run_id" ] || { echo "::error::$workflow run not found after dispatch"; exit 1; }
+            gh run watch "$run_id" --exit-status
+          }
+          dispatch_and_wait release-publish-crates.yml
+          dispatch_and_wait release-publish-npm.yml -f build_run_id="$BUILD_RUN_ID"
+          dispatch_and_wait release-publish-pypi.yml -f build_run_id="$BUILD_RUN_ID"
+          dispatch_and_wait release-update-latest-json.yml -f version="$VERSION"
+          dispatch_and_wait post-release-verify.yml -f version="$VERSION"
+
+      - name: Release summary
+        run: |
+          gh release view "v$VERSION" --json tagName,isDraft,assets --jq '{tag: .tagName, draft: .isDraft, assets: (.assets | length)}'

.gitignore

@@ -2,7 +2,6 @@
 *
 
 # Keep directory traversal so whitelisted paths below can be reached.
-!*/
 
 # Always ignore local-only directories and artifacts.
 /.claude/
@@ -21,6 +20,7 @@
 /desktop/tauri/gen/
 /desktop/tauri/target/
 **/__pycache__/
+local/*
 
 # Root project metadata.
 !/.gitignore
@@ -33,15 +33,18 @@
 
 # Rust workspace.
 !/rust/
+!/rust/crates/**/
 !/rust/Cargo.toml
 !/rust/Cargo.lock
 !/rust/crates/
 !/rust/crates/**/Cargo.toml
 !/rust/crates/**/*.rs
+!/rust/crates/**/CHANGELOG.md
 !/rust/crates/**/assets/
 !/rust/crates/**/assets/*.json
 /rust/crates/**/assets/web/
 !/rust/apps/
+!/rust/apps/**/
 !/rust/apps/**/Cargo.toml
 !/rust/apps/**/*.rs
 !/rust/apps/**/assets/
@@ -53,13 +56,6 @@
 !/.github/workflows/
 !/.github/workflows/*.yml
 
-# Local draft documentation.
-/docs/*
-# 规范文档作为架构验收标准,纳入版本控制
-!/docs/架构文档-重要架构设计v1.md
-!/docs/项目骨架设计v1.md
-!/docs/重构计划-v1.md
-!/docs/技术文档-LIB说明v1.md
 
 # Web app source.
 !/apps/
@@ -109,20 +105,6 @@
 !/python/packages/memorph/src/memorph/
 !/python/packages/memorph/src/memorph/*.py
 
-# Research notes (not part of the project source).
-/headroom的调研报告.md
-/memorph基于headroom完善压缩机制。md
 
 # Provider-native test fixtures.
-!/rust/crates/memorph/src/providers/kimi/fixtures/
-!/rust/crates/memorph/src/providers/kimi/fixtures/**
-!/rust/crates/memorph/src/providers/kiro/fixtures/
-!/rust/crates/memorph/src/providers/kiro/fixtures/**
-!/rust/crates/memorph/src/providers/cursor/fixtures/
-!/rust/crates/memorph/src/providers/cursor/fixtures/**
-
-# Project-wide Codex experience instructions.
-!AGENTS.md
-!.agent/
-!.agent/config.toml
-!docs/codex-experience.md
+!/rust/crates/memorph/src/providers/**/fixtures/**

README.md

@@ -88,151 +88,138 @@ npx memorph
 
 ### CLI
 
-CLI模式更多的是结合`SKILLS`之后利用agent帮你管理会话的迁移与管理
+CLI 可用于脚本、Agent 和人工操作。无参数运行直接打开 TUI；所有命令支持全局 `--json`。
 
-#### 查看当前工作区的可用会话-list
+#### 会话列表与过滤：list
 
 ```bash
 memorph list [OPTIONS]
 ```
 
 | 参数 | 说明 |
 |------|------|
-| `--all` | 显示所有工作区的会话 |
-| `--claude` | 仅显示 Claude Code 会话 |
-| `--codex` | 仅显示 Codex 会话 |
-| `--opencode` | 仅显示 OpenCode 会话 |
+| `--all` | 显示所有工作区会话 |
+| `-p, --provider <PROVIDER>` | 限定 Provider，可重复 |
+| `--sort <recent/title>` | 排序方式 |
+| `--limit <N>` / `--offset <N>` | 分页 |
+| `-d, --dir <DIR>` | 匹配项目目录或源路径 |
+| `-s, --session <PATTERN>` | 匹配会话 ID 或标题 |
+| `--title <PATTERN>` | 匹配会话标题 |
+| `--text <PATTERN>` | 搜索消息正文 |
+| `--since <TIME>` / `--before <TIME>` | 时间过滤：日期、RFC3339、`7d`、`24h`、`30m` |
+| `--min-bytes <BYTES>` / `--max-bytes <BYTES>` | 大小过滤：字节、`K`、`M`、`G` |
+| `--providers` | 显示 Provider 能力矩阵 |
+| `--json` | 输出 JSON，可放在命令前或命令后 |
 
-##### 示例
 ```bash
-$ memorph list
+memorph list
+memorph list --all --title "登录" --since 7d
+memorph --json list --text "错误" | jq .
+memorph list --providers --provider codex
 ```
-   ![列出会话](assets/zh/show-list.png)
 
+   ![列出会话](assets/zh/show-list.png)
 
-#### 将指定会话迁移-switch
+#### 会话迁移：switch
 
 ```bash
-memorph switch --<from>2<to> [OPTIONS]
+memorph switch <FROM> <TO> [OPTIONS]
+memorph migrate <FROM> <TO> [OPTIONS]  # switch 别名
 ```
 
 | 参数 | 说明 |
 |------|------|
-| `--claude2codex` | Claude → Codex |
-| `--codex2claude` | Codex → Claude |
-| `--claude2opencode` | Claude → OpenCode |
-| `--opencode2claude` | OpenCode → Claude |
-| `--codex2opencode` | Codex → OpenCode |
-| `--opencode2codex` | OpenCode → Codex |
-| `-s, --session-id <ID>` | 源会话 ID，**省略则取当前工作区最近会话** |
-| `-d, --to-dir <DIR>` | 目标目录，**默认：当前目录** |
-
+| `FROM` / `TO` | 源 Provider / 目标 Provider |
+| `-s, --session-id <ID>` | 源会话 ID；省略则使用当前工作区最近会话 |
+| `-t, --to-dir <DIR>` | 目标项目目录 |
 
-##### 示例
 ```bash
-$ memorph switch --claude2codex --session-id abc-123-session-id
+memorph switch claude codex --session-id abc-123-session-id
+memorph migrate claude codex --session-id abc-123-session-id
 ```
 
    ![迁移会话](assets/zh/show-list.png)
 
----
-
-#### CLI 表格
+#### CLI 命令
 
 | 命令 | 说明 |
 |------|------|
-| [`list`](#查看当前工作区的可用会话-list) | 列出会话（默认仅当前工作区） |
-| [`export`](#export) | 导出会话为 `.json` / `.md` / `.html` 文件 |
-| [`import`](#import) | 将 `.json` / `.md` / `.html` 文件或已有会话导入目标工具 |
-| [`remove`](#remove--rename--find) | 删除指定会话 |
-| [`rename`](#remove--rename--find) | 重命名指定会话 |
-| [`switch`](#将指定会话迁移-switch) | 跨 Provider 迁移会话 |
-| [`find`](#remove--rename--find) | 按目录、标题或 ID 搜索会话 |
-
-
----
+| `list` | 列出并过滤会话，或显示 Provider 能力 |
+| `switch` / `migrate` | 跨 Provider 迁移会话 |
+| `export` | 导出会话 |
+| `import` | 导入会话 |
+| `remove` | 删除会话 |
+| `rename` | 重命名会话 |
+| `web` / `api` / `tui` | 启动 Web、API 或 TUI |
+| `doctor` | 输出只读环境诊断 |
+| `update` | 按安装来源更新 memorph |
 
 #### 导入与导出
 
-##### 导出
-
 ```bash
-memorph export <PROVIDER> <SESSION_ID> [OPTIONS]
+memorph export <PROVIDER> <SESSION_ID> [-o PREFIX] [-f FORMAT]
+memorph import <PROVIDER> <FILE_OR_ID> [-t DIR]
 ```
 
-| 参数 | 说明 |
-|------|------|
-| `PROVIDER` | 目标 Agent：`claude` / `codex` / `opencode` |
-| `SESSION_ID` | 会话 ID |
-| `-o, --output <PREFIX>` | 输出文件名前缀，**默认：`SESSION_ID`** |
-| `-f, --format <FORMAT>` | `json` / `md` / `html`，**默认：`json`** |
-
 ```bash
-memorph export claude abc-123-session-id
 memorph export claude abc-123-session-id -f md
-```
-
-##### 导入
-
-```bash
-memorph import <PROVIDER> <FILE_OR_ID> [OPTIONS]
-```
-
-| 参数 | 说明 |
-|------|------|
-| `PROVIDER` | 目标 Agent：`claude` / `codex` / `opencode` |
-| `FILE_OR_ID` | `.json`/`.md`/`.html` 文件路径，或已有会话 ID |
-| `-d, --to-dir <DIR>` | 目标项目目录，**默认：当前目录** |
-
-```bash
-memorph import codex ./my-session.md
 memorph import claude ./backup.json --to-dir ~/projects/my-app
-memorph import claude xyz-456-session-id
 ```
 
----
-
 #### 删除与重命名
 
-| 命令 | 语法 | 说明 |
-|------|------|------|
-| `remove` | `memorph remove <PROVIDER> <SESSION_ID>` | 删除会话 |
-| `rename` | `memorph rename <PROVIDER> <SESSION_ID> <NEW_TITLE>` | 重命名会话 |
-
 ```bash
-# 删除
-memorph remove claude abc-123-session-id
-
-# 重命名
-memorph rename claude abc-123-session-id "修复登录 bug"
+memorph remove <PROVIDER> <SESSION_ID>
+memorph rename <PROVIDER> <SESSION_ID> <NEW_TITLE>
 ```
 
----
-
-#### 查询
-
 ```bash
-memorph find [OPTIONS]
+memorph remove claude abc-123-session-id
+memorph rename claude abc-123-session-id "修复登录 bug"
 ```
 
-| 参数 | 说明 |
-|------|------|
-| `-d, --dir <DIR>` | 按项目目录路径模糊搜索 |
-| `-s, --session <PATTERN>` | 按会话 ID 或标题模糊匹配 |
-| `-p, --provider <PROVIDER>` | 限制 Provider（可多次使用） |
-
-**查询约束：** 至少需提供 `--dir`、`--session`、`--provider` 中的一个。
-
-```bash
-# 按目录搜索
-memorph find --dir ~/projects/my-app
-
-# 按标题或 ID 搜索
-memorph find --session "登录 bug"
-
-# 只在 Claude 和 Codex 中搜索
-memorph find --session "refactor" -p claude -p codex
-```
+### Provider 支持矩阵
+
+memorph 支持 23 个 AI 编程 Agent 的会话管理。各 Provider 的能力存在差异：
+
+| Provider | 导入 | 导出 | 管理/恢复 |
+|---|---:|---:|---:|
+| Claude | ✅ | ✅ | ✅ |
+| Codex | ✅ | ✅ | ✅ |
+| OpenCode | ✅ | ✅ | ✅ |
+| DeepSeek | ✅ | ✅ | ✅ |
+| Kimi | ✅ | ✅ | ✅ |
+| Cursor | ✅ | ✅ | ✅ |
+| Gemini CLI | ✅ | ❌ | ✅ |
+| Kiro | ✅ | ❌ | ✅ |
+| Hermes | ✅ | ❌ | ✅ |
+| Cline | ✅ | ❌ | ❌ |
+| Copilot | ✅ | ❌ | ❌ |
+| Droid | ✅ | ❌ | ❌ |
+| CodeBuddy | ✅ | ❌ | ❌ |
+| Qoder | ✅ | ❌ | ❌ |
+| Trae | ✅ | ❌ | ❌ |
+| WorkBuddy | ✅ | ❌ | ❌ |
+| Pi | ✅ | ❌ | ❌ |
+| Antigravity | ✅ | ❌ | ❌ |
+| OpenClaw | ✅ | ❌ | ❌ |
+| Augment | ✅ | ❌ | ❌ |
+| Windsurf | ✅ | ❌ | ❌ |
+| Amazon Q | ✅ | ❌ | ❌ |
+| Qwen | ✅ | ❌ | ❌ |
+
+> **导出**：将 OASF canonical Session 回写为 Provider 原生格式。  
+> **管理/恢复**：支持 delete / rename / resume 中至少一项。  
+> 导入侧使用统一的 OASF Session 模型，导出侧的保真度取决于目标 Provider 的原生格式能力。
+
+### OASF 兼容性
+
+memorph 基于 [OASF (Open Agent Session Format)](https://crates.io/crates/oasf) v2（crate `oasf` 0.2.0）构建。
+
+- 所有会话文件（`.morph`、`.json`、`.md`、`.html`）在 meta 行携带 schema name/version，导入时校验，拒绝不兼容版本
+- 导入侧：23 个 Provider 的原生格式统一转换为 OASF canonical Session
+- 导出侧：6 个 Provider 支持将 canonical Session 回写为原生格式（Claude、Codex、OpenCode、DeepSeek、Kimi、Cursor）
+- 保真度模型：每个 Provider × Block 类型声明 `Preserved` / `Normalized` / `Downgraded` / `Dropped` / `Unsupported`，通过 `export_report` 在导出时生成损失报告
 
 ---