M-of-N 多签应用扩展 v1（v1.2 prep #3）

状态：Phase 1/2a/4a Layer 1 已落地 / 2026-05-15 / 含 core-multisig 包 + CLI surface + web-shell 入口 + 跨链桥 outbound gating
范围：把已有的 MTC publisher_signature M-of-N 多签 (Phase 4 federation MTCA) 复用到 MTC 之外 的其它高价值原子操作
不替代：MTC 联邦治理 v1 仍是 MTC 内部治理的权威文档

实施进度 (2026-05-15)

Phase	状态	实现
Phase 0	✅ 设计文档（本文）	docs/design/MofN_多签_应用扩展_v1.md (`24d168739`)
Phase 1	✅ 核心库 + CLI	`packages/core-multisig/` + `packages/cli/src/commands/multisig.js` (`3c890dcac`)
Phase 2a	✅ marketplace.purchase 接线 (CLI)	`packages/cli/src/commands/marketplace.js` purchase/consume + `lib/multisig-runtime.js`
Phase 2b	✅ Desktop V6 multisig plugin	`packages/web-panel/src/views/Multisig.vue` + `desktop-app-vue/src/main/web-shell/handlers/multisig-handlers.js` (#21 B.2)
Phase 3	⬜ DID rotate + Android UI + air-gapped QR	GA 后续 scope (#21 B.3 + B.4)
Phase 4a	✅ 跨链桥 outbound Layer 1（多签 gating）	`cc crosschain bridge --require-multisig` + `bridge-consume` + web-shell `crosschain.bridge.consume` + Multisig.vue 执行跨链桥按钮（#21 B.5 Layer 1，PR1 `d36b4eb3c` / PR2 `69ca0a770` / PR3 `ccd0a89df`）
Phase 4b	⬜ Layer 2 bridge envelope m-of-n signing	需 schema 升级 `cc_bridges` 表（multisig_proposal_id / signers_did_json / partial_sigs_json），详 `B5_Crosschain_Outbound_Multisig_spike.md` Layer 2
Phase 4c	⬜ Layer 3 真链上 broadcast	external-blocked（Q-COMP-3 测试网充值 + 合约审计 + KYC）；详同 spike doc Layer 3
Phase 5	⬜ PQC 强制策略 + air-gapped QR sign	GA 后续 scope (#21 B.6 producer-side 默认 + B.4 air-gapped)

Phase 4a 落地清单 (2026-05-15)

代码位置：

packages/cli/src/commands/crosschain.js：
- MULTISIG_BRIDGE_OUTBOUND_DOMAIN = "crosschain.bridge.outbound"
- cc crosschain bridge <from> <to> <amount> --require-multisig --initiator <did> --key <hex|path> — 加 flag 后改走 multisig propose 路径，不直接 insert cc_bridges
- cc crosschain bridge-consume <proposalId> — multisig 达 threshold 后 finalize + 真 insert cc_bridges row + 返 bridgeId
- 4 个错误路径：缺 --initiator / 缺 --key / 缺 policy / pending state，全部 exit code 2 + structured JSON
desktop-app-vue/src/main/web-shell/handlers/multisig-handlers.js：
- 加 MULTISIG_BRIDGE_OUTBOUND_DOMAIN 常量
- 新 WS topic crosschain.bridge.consume：mirror marketplace.consume，domain gate + state gate + finalize + 返 {status:"consumed", proposalId, payload}
- 设计注：web-shell 不持 crosschain DB，不做 cc_bridges 真 insert；真 insert 仍由 CLI 端 cc crosschain bridge-consume 执行
packages/web-panel/src/views/Multisig.vue：
- 列表 / 详情各加 "执行跨链桥" 按钮（state === 'reached' && domain === 'crosschain.bridge.outbound'）
- 新 onBridgeConsume() 双路径 UX：isEmbedded 走 in-process topic → Modal 提示 CLI follow-up；cc serve 走 subprocess → inline 显示 bridgeId
- fix 老 typo：loadAll 探测域从 crosschain.outbound 改 crosschain.bridge.outbound

CLI 流程：

$ cc multisig policy set crosschain.bridge.outbound --m 2 --members members.json
$ cc crosschain bridge ethereum polygon 100 --require-multisig --initiator A --key A.hex
  ↪ Routed through multisig (domain crosschain.bridge.outbound)
  proposalId: msp_xxx, needs 2 of 2 signatures
$ cc multisig sign msp_xxx --signer B --key B.hex
  ✓ Threshold reached
$ cc crosschain bridge-consume msp_xxx
  ✓ Bridge consumed — ethereum → polygon, amount 100 native
  bridgeId: <id> (fee 0.05), proposalId: msp_xxx

E2E 测试（packages/cli/__tests__/integration/crosschain-multisig-e2e.test.js，11 个全 green，HOME/USERPROFILE 隔离）:

happy 2-of-2 全 walkthrough（policy → propose → sign → consume → cc_bridges row exists + governance.log 事件）
1-of-1 reaches threshold immediately
缺 --initiator → exit 2 missing_initiator
缺 --key → exit 2 missing_key
缺 policy → exit 2 no_policy
consume pending → proposal_state_pending
consume not_found → proposal_not_found
consume wrong_domain（拿 marketplace.purchase 提案试 bridge consume） → wrong_domain
consume already-consumed → proposal_state_consumed
非 --require-multisig path 仍走原 direct path（0 regression）
text output（无 --json）

PR2 / PR3 单测：

desktop-app-vue/.../multisig-handlers.test.js — 8 新 unit tests（happy / not_found / wrong_domain / state pending / state consumed / finalize-fail / INVALID_ARGS proposalId 缺失 + 非 string）
web-panel 1867/1867 测试 0 regression（Multisig.vue 本身无单测，逻辑由 PR2 + PR1 覆盖）

设计参考：B5_Crosschain_Outbound_Multisig_spike.md — 三层分解 Layer 1（本节）/ Layer 2 envelope m-of-n / Layer 3 真 broadcast（external-blocked）。

Phase 2a 落地清单 (2026-05-12)

代码位置：

packages/cli/src/lib/multisig-runtime.js (新) — shared SQLite cascade + manager loader，commands/multisig.js 与 commands/marketplace.js 共享
packages/cli/src/commands/marketplace.js：
- LARGE_PURCHASE_THRESHOLD_FEN = 100_000 (¥1000) — 默认大额阈值
- MULTISIG_DOMAIN = "marketplace.purchase"
- cc marketplace purchase <itemId> --amount-fen N --buyer <did> --key <hex> — 大额自动 propose multisig，小额走 direct
- cc marketplace consume <proposalId> — multisig 达到 threshold 后 finalize + 执行（CLI stub 仅 echo payload）

CLI 流程（设计文档 §6.1 落地）：

$ cc multisig policy set marketplace.purchase --m 2 --members members.json
$ cc marketplace purchase item-001 --amount-fen 150000 --buyer A --key A.hex
  ↪ Routed through multisig (¥1500 ≥ ¥1000 threshold)
  proposalId: msp_xxx, needs 2 of 2 signatures
$ cc multisig sign msp_xxx --signer B --key B.hex
  ✓ Threshold reached
$ cc marketplace consume msp_xxx
  ✓ Purchase consumed — order item-001 for ¥1500

E2E 测试 (packages/cli/__tests__/integration/marketplace-multisig-e2e.test.js，8 个全 green):

¥1500 大额 2-of-2 full walkthrough（policy set → purchase → sign → consume → governance.log 4 类事件）
¥500 小额走 direct path，不创 proposal
--threshold-fen override 行为
大额无 policy → exit 2 blocked
consume pending 提案 → exit 2 proposal_state_pending
consume 错域提案 → exit 2 wrong_domain
--help 文本验证

Phase 1 落地清单

代码位置：

packages/core-multisig/lib/policy.js — validatePolicy / normalizePolicy / SUPPORTED_ALGS
packages/core-multisig/lib/signing.js — canonicalizeForSigning (JCS + DOMAIN_PREFIX) / signRaw / verifyOne / verifyThreshold（dispatch by alg，requirePqc 检查）
packages/core-multisig/lib/schema.js — SQLite DDL: multisig_proposals / multisig_signatures / multisig_policies
packages/core-multisig/lib/store.js — better-sqlite3-style API wrapper
packages/core-multisig/lib/proposals.js — createProposalsManager 状态机 (pending → reached → consumed | cancelled | expired)
packages/core-multisig/lib/governance-log.js — append-only JSONL audit trail
packages/cli/src/commands/multisig.js — cc multisig 命令簇

CLI surface（已实现）：

cc multisig policy set <domain> --m <M> --members <json|file> ✅
cc multisig policy show <domain> ✅
cc multisig propose <domain> --payload-file --initiator --key ✅
cc multisig sign <id> --signer --key ✅
cc multisig cancel <id> [--reason] ✅
cc multisig finalize <id> ✅ (Phase 2 业务侧标 consumed)
cc multisig list [--state --domain --limit] ✅
cc multisig show <id> ✅
cc multisig sweep ✅ (expire stale pending)

复用 MTC：

@chainlesschain/core-mtc/jcs — JCS RFC 8785 canonicalization
@chainlesschain/core-mtc/signers/ed25519 — Ed25519 keypair / sign / pubkey JWK
@chainlesschain/core-mtc/signers/slh-dsa — SLH-DSA-SHA2-128F (FIPS 205)

差异：

不与 MTC 共用 _stripSigsForPublisher（MTC 那个剥的是 landmark 特定字段；多签 producer/verifier 都喂 payloadCore，从设计上不含 sigs 数组，无需 strip）
域分隔 prefix "MULTISIG:" 防与 MTC tree-head 签名混用回放

测试：

packages/core-multisig/__tests__/policy.test.js — 14 个 policy 验证测
packages/core-multisig/__tests__/signing.test.js — 18 个签/验/threshold 测（含 PQC）
packages/core-multisig/__tests__/store.test.js — 14 个 SQLite store 测（用 sql.js 适配器）
packages/core-multisig/__tests__/proposals.test.js — 18 个 propose/sign/finalize/cancel/expire 测
packages/core-multisig/__tests__/governance-log.test.js — 7 个 JSONL append/read 测
packages/cli/__tests__/integration/multisig-cli.test.js — 10 个端到端 subprocess 测

合计 81 个 multisig 测，远超设计目标的 30 单元 + 集成测。

1. 背景与目标

v1.1 之前的多签实现仅存在于 MTC publisher_signature：跨 federation 成员对 batch 进行 M-of-N 联合签名（参见 MTC_联邦治理_v1.md §6 / 内部 memo mtc_publisher_sig_threshold.md）。

v1.2 起，下列场景也需要"必须 ≥ M 签名才生效"的语义：

场景	触发条件	推荐 M-of-N
marketplace.purchase 大额	商品 price ≥ ¥1000（约 $140）	2-of-2（买家 + 监护人 / 财务）
DID 关键属性变更	rotate signing key / change recovery DID	2-of-3（owner + 2 个 recovery）
跨链桥 outbound	单笔金额 ≥ 阈值（链上配置）	2-of-3（federation 子集）
企业租户 admin 操作	删除租户 / 改 RBAC 根策略	2-of-N tenant admins
MTC publisher_signature	已实现	N 自定义（v0.5 federation）

本文档聚焦"如何把 MTC 那套多签模式抽象成跨 feature 复用的中台模块"。

2. 复用 MTC 已有抽象

2.1 已可直接复用

组件	位置	复用方式
`_stripSigsForPublisher`	`@chainlesschain/core-mtc/publisher-signing`	message canonicalization 前对 sig 字段置零（producer / verifier 必须对称喂）
Threshold 计票	`core-mtc/lib/federation/threshold.js`	`Σ(成员签名通过 verifier) ≥ M`
异构验签	`core-mtc/lib/federation/verifiers/{ed25519,slh-dsa}.js`	dispatch by `alg` field
`governance.log` JSONL	`~/.chainlesschain/governance.log`	append-only audit trail

2.2 需新增

core-multisig/（新包，packages/core-multisig）
- MultiSigPolicy { domain, m, n, members[], algorithms[] }
- proposeAndSign(domain, payload, signerKey) → { proposalId, sig }
- accumulate(proposalId, sig) → { reachedThreshold: bool, sigs[] }
- verify(domain, payload, sigs[], policy) → boolean
持久层：multisig_proposals SQLite 表（schema in §4）
WS topics：multisig.propose / .sign / .status / .cancel

3. 协议

3.1 消息流

Client A (initiator)
  ├─ proposeAndSign(payload, A_sk)
  │     ↓ creates proposal { id, domain, payload, expiresAtMs, sigs: [{ memberDid: A, sig }] }
  ├─ broadcast via WS multisig.propose
  │
Client B (co-signer)
  ├─ receives proposal via WS subscription
  ├─ user reviews payload (UI: 弹审批框 with diff)
  ├─ accumulate(proposalId, B_sig)
  │     ↓ reachedThreshold: true (2-of-2)
  ├─ executor (initiator side) finalizes & runs the operation

3.2 Canonical message

复用 MTC 的 JCS (RFC 8785)：canonicalize(payload) → SHA-256 → 各成员对 hash 签名。与 MTC 一致：签名前剥离 sigs 字段（即 _stripSigsForPublisher 同款规则），producer / verifier 对称。

3.3 防重放

proposal 必带 nonce（uint64 timestamp + 随机后 32 bit）
proposal 必带 expiresAtMs（默认 now + 24h，domain 可覆盖）
一旦 reachedThreshold 成功执行：proposal 标 consumed，重复提交直接 reject

3.4 撤销 / 拒签

任一签名者可发 multisig.cancel(proposalId, reason)
一旦 cancel：proposal 状态 cancelled，所有 sig 作废
已 consumed 的 proposal 不能 cancel（操作已生效）

3.5 超时

后台 sweeper 每 5 分钟扫一次 expiresAtMs < now 且未 consumed 的 → 标 expired
expired proposal 同样不可 sign

4. SQLite Schema

sql

-- packages/core-multisig/migrations/001_proposals.sql
CREATE TABLE IF NOT EXISTS multisig_proposals (
    id              TEXT    PRIMARY KEY,           -- ULID
    domain          TEXT    NOT NULL,              -- 'marketplace.purchase' | 'did.rotate' | ...
    payload_jcs     TEXT    NOT NULL,              -- canonical JSON (JCS RFC 8785)
    payload_hash    BLOB    NOT NULL,              -- SHA-256(payload_jcs)
    nonce           TEXT    NOT NULL,              -- hex
    expires_at_ms   INTEGER NOT NULL,
    threshold_m     INTEGER NOT NULL,              -- snapshot at propose time
    member_set      TEXT    NOT NULL,              -- JSON [{did, alg}], snapshot
    state           TEXT    NOT NULL,              -- 'pending' | 'reached' | 'consumed' | 'cancelled' | 'expired'
    initiator_did   TEXT    NOT NULL,
    created_at_ms   INTEGER NOT NULL,
    updated_at_ms   INTEGER NOT NULL
);

CREATE TABLE IF NOT EXISTS multisig_signatures (
    proposal_id     TEXT    NOT NULL REFERENCES multisig_proposals(id),
    signer_did      TEXT    NOT NULL,
    sig             BLOB    NOT NULL,
    alg             TEXT    NOT NULL,              -- 'ed25519' | 'slh-dsa-128f'
    signed_at_ms    INTEGER NOT NULL,
    PRIMARY KEY (proposal_id, signer_did)
);

CREATE INDEX idx_multisig_state ON multisig_proposals(state, expires_at_ms);

Walker (mobile-bridge-sync.js) 仅同步状态变更，不同步 sig payload（私钥侧）。

5. CLI 表面（Phase 1）

cc multisig propose <domain> --payload <file>
cc multisig sign <proposalId>
cc multisig list [--state pending|reached|consumed|...]
cc multisig show <proposalId>
cc multisig cancel <proposalId> --reason <text>
cc multisig policy show <domain>
cc multisig policy set <domain> --m <M> --n <N> --members <comma-list>

policy.show/set 持久化在 multisig_policies 表（结构略，类比 §4）。

6. 集成点（feature 侧改造）

6.1 marketplace.purchase

// packages/cli/src/commands/marketplace.js (现：直接 execute)
async function purchase(args) {
  const policy = await multisig.getPolicy('marketplace.purchase');
  if (policy && args.amountFen >= policy.threshold) {
    const proposalId = await multisig.propose('marketplace.purchase', args, signerSk);
    return { needsCoSign: true, proposalId, requiredSigs: policy.m };
  }
  return await executePurchase(args);  // legacy path for small amounts
}

UI 端 marketplace 显示"等待 N 签名 (1/2)"占位卡。

6.2 DID 关键属性变更

// packages/core-did 现有 rotate(...) → wrap with multisig gate when policy exists
async function rotateKey(did, newPubkey) {
  const policy = await multisig.getPolicy('did.rotate');
  if (policy) {
    return await multisig.proposeAndExecute('did.rotate', { did, newPubkey }, sk, policy);
  }
  return doRotate(did, newPubkey);  // single-sig fallback for users without recovery DIDs
}

6.3 跨链桥 outbound 大额（Phase 4a ✅ landed 2026-05-15）

Layer 1（multisig gating）已实现，mirror marketplace.purchase 走法。Layer 2/3 详 B5_Crosschain_Outbound_Multisig_spike.md。

// packages/cli/src/commands/crosschain.js
const MULTISIG_BRIDGE_OUTBOUND_DOMAIN = "crosschain.bridge.outbound";

cc.command("bridge <from> <to> <amount>")
  .option("--require-multisig", "Route through m-of-n multisig")
  .option("--initiator <did>", "Initiator DID (required with --require-multisig)")
  .option("--key <hex|path>", "Initiator secret key")
  .action(async (fromChain, toChain, amount, opts) => {
    if (opts.requireMultisig) {
      // _bridgePropose: open multisig proposal with payload {fromChain, toChain, asset, amount, sender, recipient}
      // returns {status:"needs_co_sign", proposalId, requiredSigs, payload}
      return _bridgePropose({...});
    }
    // legacy: direct bridgeAsset insert
    return bridgeAsset(db, {...});
  });

cc.command("bridge-consume <proposalId>")
  .action(async (proposalId, opts) => {
    // _bridgeConsume: 4 gates (not_found / wrong_domain / state ≠ reached / finalize_fail)
    // then call bridgeAsset(db, payload) to insert cc_bridges row
    // returns {status:"consumed", proposalId, bridgeId, fee, payload}
    return _bridgeConsume({...});
  });

domain ↔ marketplace 对照：

marketplace	crosschain	备注
`marketplace.purchase` domain	`crosschain.bridge.outbound` domain	一对一
`cc marketplace purchase` 大额 propose	`cc crosschain bridge --require-multisig`	一对一
`cc marketplace consume` finalize	`cc crosschain bridge-consume`	一对一
web-shell `marketplace.consume` topic	web-shell `crosschain.bridge.consume` topic	一对一
Multisig.vue 执行购买	Multisig.vue 执行跨链桥	一对一

未做（Layer 2/3）：

envelope m-of-n signing：把 multisig 收集的 partial sigs 嵌入 bridgeAsset 写的 cc_bridges row（需 schema 加 multisig_proposal_id / signers_did_json / partial_sigs_json）
真链上 broadcast：ethers.js / cosmjs / @polkadot SDK 推到真链，external-blocked Q-COMP-3（测试网充值 + 合约审计 + KYC）

复用现有 MTC federation 路径：跨链桥 outbound 本身已有 federation watermark；Phase 4a 是把 "watermark 签名 → tx 提交" 的两步合一进 multisig 框架，Phase 4b 把 partial sigs 注入 envelope，Phase 4c 把签好的 envelope 推到真链。

7. 与 MTC publisher_signature 的关系

复用：canonicalization 规则、verifier dispatch、governance audit trail。
不复用：MTC publisher_signature 本身仍走 federation 路径（不迁移到 multisig_proposals 表，避免历史 batch 重新格式化）。

新模块 core-multisig 只覆盖"非 MTC"的多签场景。

8. 桌面 / 移动 UI

8.1 Desktop V6（web-shell 主路径）

新建 plugin packages/web-panel/src/plugins/multisig
- 列表页：proposal 卡片（domain icon + amount + 当前 sig 数 / threshold + 倒计时 expires）
- 详情页：JCS payload 折叠 diff + member 列表（已签 / 未签）+ Sign / Cancel 按钮
通知：proposal 触发 desktop notification（"N1 发起了一笔 ¥1500 的购买，等待你联签"）

8.2 Mobile（Android v1.2+）

feature-multisig 模块（新）：MultiSigListScreen, MultiSigDetailScreen
走 P2P sync via mobile-bridge-sync 的 SETTING walker（v1.2 prep #4）
Push notification（v1.1 P1 vendor push SDK 已具备）

三端 UI consistency 约束：m-of-n 进度展示 / DID 短显示 / 高风险二次确认形态应跨 surface 一致 — 详 三端_UI_Consistency_设计文档.md §2.2 / §2.3 / §2.4。现有 Multisig.vue 列表 tag ${m}/${n} 缺空格 + Marketplace.vue 等 4 处 DID short 不统一已列入该文档 §4 opportunistic sweep。

8.3 web-panel Multisig.vue（Phase 2b + 4a 接通 2026-05-15）

落地位置：packages/web-panel/src/views/Multisig.vue + desktop-app-vue/src/main/web-shell/handlers/multisig-handlers.js。

isEmbedded 检测分发 — useShellMode().isEmbedded 区分桌面 V6/V5/web-shell-embedded vs cc serve 浏览器：

路径	调用	真 insert?	渲染
isEmbedded=true	`ws.sendRaw({type: 'crosschain.bridge.consume', proposalId})` → web-shell in-process topic	❌ 只 finalize	Modal 提示用户 CLI follow-up
isEmbedded=false	`ws.executeJson('crosschain bridge-consume <id> --json')` → CLI subprocess	✅ 真 insert cc_bridges	inline 显示 bridgeId

性能：embedded 路径 ~20ms（SQLite WAL open + finalize）vs subprocess 路径 6-10s（asar:true 冷启 cc CLI）。#21 B.2 (b1c7cfd95) 60-100× 提速的同一模式延用到本 domain。

UI 元素：

列表 actions：state==='reached' && domain==='crosschain.bridge.outbound' → "执行跨链桥" 主按钮
详情 drawer：同条件 → "执行跨链桥 (cc crosschain bridge-consume)" 主按钮；fallback multisig.finalize 仍存在但 condition 排除 bridge / marketplace 域
alert 文案：明确 "marketplace.purchase / crosschain.bridge.outbound" 走捷径，其它 domain 用 cc multisig finalize

9. 安全考量

回放跨 domain：proposal 的 payload_jcs 必含 domain 字段，verifier 必须验 domain 与 policy 匹配
member 名单 race：proposal 创建时快照 member_set，事后改 policy 不影响进行中的 proposal
sig 重排攻击：sig 列表按 signer_did 排序后再 verify，防签名顺序构造重放
PQC 强制最低：domain policy 可强制要求至少 1 个 SLH-DSA 签名（同 MTC 联邦 §3.4）
私钥离线：sign 操作必须可在 air-gapped 设备完成（Phase 2：QR proposal 模式）

10. Phase 划分（v1.2 → GA 后续 scope）

Phase	范围	验收
Phase 0（设计） ✅	本文档	doc landed
Phase 1（v1.2）✅	core-multisig 包 + SQLite + CLI（propose/sign/cancel/list/show）	单元 + 集成测试 ≥ 30，governance.log 写入 — 81 测全过
Phase 2a（v1.2）✅	marketplace.purchase 大额接线（CLI 端）	E2E：2-of-2 走完一笔 ¥1500 购买 — 8 测全过
Phase 2b（v1.2）✅	Desktop V6 multisig plugin + in-process web-shell handlers	web-shell `multisig.` + `marketplace.consume` topics + Multisig.vue 列表/详情/执行 — #21 B.2* (`b1c7cfd95`)
Phase 3（GA 后续 scope） ⬜	DID rotate + Android UI + QR air-gapped propose	文档 §8.2 全实现（#21 B.3 + B.4）
Phase 4a（GA 后续 scope）✅	跨链桥 outbound Layer 1（multisig gating）	CLI propose + consume + web-shell topic + Multisig.vue UI — 11 + 8 测全过（#21 B.5 Layer 1，PR1+2+3）
Phase 4b ⬜	Layer 2 envelope m-of-n signing	cc_bridges schema 升级 + envelope 嵌入 partial sigs
Phase 4c ⬜	Layer 3 真链上 broadcast	ethers.js / cosmjs SDK；external-blocked Q-COMP-3
Phase 5 ⬜	PQC 强制策略（默认 producer-side）+ air-gapped QR sign	#21 B.6 producer-side + #21 B.4 air-gapped

11. 与现有文档关系

复用 MTC_联邦治理_v1.md §3-§6 的治理 / 审批流程
不影响 MTC_数据格式_v1.md（MTC 自己的 publisher_signature 格式不变）
Phase3d_Mobile_Sync_设计文档.md SETTING walker 用于 multisig_policies 同步（v1.2 prep #4 内）
与 Android_重新定位_设计文档.md §10 GA 后续 scope 对齐（v0.10 rebrand：Android 版本号随桌面 productVersion，不再起独立 semver）
B5_Crosschain_Outbound_Multisig_spike.md — Phase 4 三层分解（4a Layer 1 已落 / 4b Layer 2 schema 升级 / 4c Layer 3 真链上 broadcast external-blocked）的实施细节 single source

12. 已知未决（明确 v1.2 不做）

门限签名（threshold signature, FROST/BLS）：本设计是 M 个独立 sig 累加；不引入 threshold-aggregated single-sig（FROST 等），降复杂度。Phase 5+ 评估
链上结算：proposal 不上链；只在 SQLite + governance.log。链上结算属于 cross-chain bridge 范畴
Web-only co-sign UX：v1.2 仅 desktop + CLI，移动 v1.3 起
Recovery shard 备份：multi-sig key 的 Shamir 分片备份独立设计文档（v1.3）

附：与 v1.2 prep 其它 ticket 的依赖

prep #1 OfflineQueue TTL：无依赖
prep #2 TURN ephemeral：无依赖
prep #3 本文：design only
prep #4 SETTING walker：multisig_policies 表的同步走 SETTING walker（实现侧）

M-of-N 多签应用扩展 v1（v1.2 prep #3） ​

实施进度 (2026-05-15) ​

Phase 4a 落地清单 (2026-05-15) ​

Phase 2a 落地清单 (2026-05-12) ​

Phase 1 落地清单 ​

1. 背景与目标 ​

2. 复用 MTC 已有抽象 ​

2.1 已可直接复用 ​

2.2 需新增 ​

3. 协议 ​

3.1 消息流 ​

3.2 Canonical message ​

3.3 防重放 ​

3.4 撤销 / 拒签 ​

3.5 超时 ​

4. SQLite Schema ​

5. CLI 表面（Phase 1） ​

6. 集成点（feature 侧改造） ​

6.1 marketplace.purchase ​

6.2 DID 关键属性变更 ​

6.3 跨链桥 outbound 大额（Phase 4a ✅ landed 2026-05-15） ​

7. 与 MTC publisher_signature 的关系 ​

8. 桌面 / 移动 UI ​

8.1 Desktop V6（web-shell 主路径） ​

8.2 Mobile（Android v1.2+） ​

8.3 web-panel Multisig.vue（Phase 2b + 4a 接通 2026-05-15） ​

9. 安全考量 ​

10. Phase 划分（v1.2 → GA 后续 scope） ​

11. 与现有文档关系 ​

12. 已知未决（明确 v1.2 不做） ​

M-of-N 多签应用扩展 v1（v1.2 prep #3）

实施进度 (2026-05-15)

Phase 4a 落地清单 (2026-05-15)

Phase 2a 落地清单 (2026-05-12)

Phase 1 落地清单

1. 背景与目标

2. 复用 MTC 已有抽象

2.1 已可直接复用

2.2 需新增

3. 协议

3.1 消息流

3.2 Canonical message

3.3 防重放

3.4 撤销 / 拒签

3.5 超时

4. SQLite Schema

5. CLI 表面（Phase 1）

6. 集成点（feature 侧改造）

6.1 marketplace.purchase

6.2 DID 关键属性变更

6.3 跨链桥 outbound 大额（Phase 4a ✅ landed 2026-05-15）

7. 与 MTC publisher_signature 的关系

8. 桌面 / 移动 UI

8.1 Desktop V6（web-shell 主路径）

8.2 Mobile（Android v1.2+）

8.3 web-panel Multisig.vue（Phase 2b + 4a 接通 2026-05-15）

9. 安全考量

10. Phase 划分（v1.2 → GA 后续 scope）

11. 与现有文档关系

12. 已知未决（明确 v1.2 不做）