@archipelagolab/lobi 1.0.1 → 1.0.6

package/SPEC-SUPPORT.md

@@ -1,116 +0,0 @@
-# Matrix Spec Support
-
-Current Matrix spec/event support tracked for the bundled Matrix plugin.
-
-Scope:
-
-- code-backed today-state only
-- plugin behavior only; not a claim of full Matrix spec coverage
-- update this file when adding or removing Matrix event/spec support
-
-Legend:
-
-- `in`: inbound handling
-- `out`: outbound send/edit/emit
-- `tools`: CLI/action/runtime tooling built on that surface
-
-## Support Matrix
-
-| Surface                  | Spec / event ids                                                                                   | Support      | Notes                                                                    | Evidence                                                                                                                   |
-| ------------------------ | -------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
-| Core messages            | `m.room.message`                                                                                   | in/out/tools | base text/media message surface                                          | `src/matrix/send/types.ts`, `src/matrix/actions/messages.ts`                                                               |
-| Rich text                | `org.matrix.custom.html`                                                                           | out          | Markdown rendered to Matrix HTML                                         | `src/matrix/send/formatting.ts`                                                                                            |
-| Replies                  | `m.in_reply_to`                                                                                    | in/out       | reply relation support                                                   | `src/matrix/send/formatting.ts`                                                                                            |
-| Edits                    | `m.replace`                                                                                        | in/out/tools | Matrix edit flow; edit body uses `* <text>` fallback format              | `src/matrix/send/types.ts`, `src/matrix/draft-stream.test.ts`                                                              |
-| Threads                  | `m.thread`                                                                                         | in/out/tools | thread send, routing, session/thread policy                              | `src/matrix/send/types.ts`, `src/matrix/monitor/types.ts`, `src/matrix/monitor/threads.test.ts`                            |
-| Direct rooms             | `m.direct`                                                                                         | in/out/tools | DM routing, cache, repair, outbound target selection                     | `src/matrix/send/types.ts`, `src/matrix/sdk.ts`, `src/matrix/send/targets.test.ts`, `src/matrix/direct-management.test.ts` |
-| Reactions                | `m.reaction`, `m.annotation`                                                                       | in/out/tools | send, summarize, inbound reaction routing                                | `src/matrix/reaction-common.ts`, `src/matrix/monitor/reaction-events.test.ts`                                              |
-| Read receipts            | `m.read`                                                                                           | out          | sent on inbound message receipt                                          | `src/matrix/sdk.ts`, `src/matrix/monitor/handler.ts`                                                                       |
-| Typing                   | typing API                                                                                         | out          | typing keepalive while reply runs                                        | `src/matrix/sdk.ts`, `src/matrix/send.ts`, `src/matrix/monitor/handler.ts`                                                 |
-| Mentions                 | `m.mentions`                                                                                       | in/out/tools | stable mention metadata on sends/edits/media captions/poll fallback text | `src/matrix/send/formatting.ts`, `src/matrix/monitor/mentions.ts`, `src/matrix/send.test.ts`                               |
-| Mention link compat      | `https://matrix.to/#/...`                                                                          | in/out       | emit + validate visible-label mentions in formatted HTML                 | `src/matrix/format.ts`, `src/matrix/monitor/mentions.ts`                                                                   |
-| Polls                    | `m.poll.start`, `m.poll.response`, `m.poll.end`                                                    | in/out/tools | stable poll create/read/vote/summary flow                                | `src/matrix/poll-types.ts`, `src/matrix/actions/polls.ts`, `src/matrix/poll-summary.ts`                                    |
-| Poll compat              | `org.matrix.msc3381.poll.start`, `org.matrix.msc3381.poll.response`, `org.matrix.msc3381.poll.end` | in/out       | unstable poll compat still emitted/parsed where needed                   | `src/matrix/poll-types.ts`, `src/matrix/send.test.ts`                                                                      |
-| Poll relations           | `m.reference`                                                                                      | in/out/tools | poll votes/results linked to root poll event                             | `src/matrix/poll-types.ts`, `src/matrix/actions/polls.ts`, `src/matrix/poll-summary.ts`                                    |
-| Extensible text fallback | `org.matrix.msc1767.text`                                                                          | in/out       | poll text fallback/compat                                                | `src/matrix/poll-types.ts`                                                                                                 |
-| Voice messages           | `org.matrix.msc3245.voice`                                                                         | out          | voice-bubble marker on compatible audio sends                            | `src/matrix/send/media.ts`, `src/matrix/send/types.ts`                                                                     |
-| Voice audio metadata     | `org.matrix.msc1767.audio`                                                                         | out          | duration metadata for voice sends                                        | `src/matrix/send/media.ts`, `src/matrix/send/types.ts`                                                                     |
-| Location                 | `m.location`, `geo:`                                                                               | in           | inbound parse to text/context; no outbound location send tracked here    | `src/matrix/monitor/types.ts`, `src/matrix/monitor/location.ts`, `src/matrix/monitor/handler.ts`                           |
-| E2EE room events         | `m.room.encrypted`                                                                                 | in/out/tools | encrypted event hydration, decrypt, encrypted media send                 | `src/matrix/monitor/types.ts`, `src/matrix/sdk.ts`, `docs/channels/matrix.md`                                              |
-| Encrypted media previews | `file`, `thumbnail_file`                                                                           | out          | encrypted thumbnails for encrypted image events                          | `src/matrix/send/media.ts`, `docs/channels/matrix.md`                                                                      |
-| Device verification      | `m.key.verification.*`, `m.key.verification.request`                                               | in/tools     | request/ready/start/SAS/done/cancel notices and CLI flows                | `src/matrix/monitor/verification-utils.ts`, `src/matrix/monitor/events.test.ts`, `docs/channels/matrix.md`                 |
-| Streaming/live markers   | `org.matrix.msc4357.live`                                                                          | out          | live draft/edit markers for partial streaming                            | `src/matrix/send/types.ts`, `src/matrix/send.ts`, `src/matrix/draft-stream.ts`                                             |
-
-## Explicit MSCs In Use
-
-These MSCs are explicitly referenced in the plugin today:
-
-- `MSC3381`: polls
-- `MSC1767`: extensible-events fallback fields used for polls and voice metadata
-- `MSC3245`: voice message marker
-- `MSC4357`: live streaming marker
-
-Evidence:
-
-- `src/matrix/poll-types.ts`
-- `src/matrix/send/media.ts`
-- `src/matrix/send/types.ts`
-- `src/matrix/draft-stream.ts`
-
-## Non-goals
-
-This file does not claim:
-
-- full client-server API coverage
-- full room-state/event coverage inherited from `matrix-js-sdk`
-- outbound support for any surface not listed above
-
-If a new Matrix feature lands, add a row with:
-
-1. exact event/spec id
-2. support shape (`in`, `out`, `tools`)
-3. at least one code path proving it
-
-## Missing / Candidate Specs
-
-Recommended next additions, prioritized by user-visible value and closeness to current code:
-
-| Priority | Surface                       | Spec / event ids                              | Why add it                                                                                         | Current gap                                                                      |
-| -------- | ----------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
-| high     | Sticker messages              | `m.sticker`                                   | stable spec; common client surface; we already classify sticker attachments on read paths          | no explicit inbound `m.sticker` event handling and no outbound sticker send path |
-| high     | Outbound location messages    | `m.location`, `geo_uri`                       | stable spec; docs already say Matrix supports location, but current implementation is inbound-only | no outbound location send/action API                                             |
-| medium   | Private + richer read markers | `m.read.private`, `m.fully_read`              | stable spec; better privacy and cleaner read-state behavior than public-only `m.read`              | current code only sends public `m.read` receipts                                 |
-| medium   | Thread-aware receipts         | `m.read` with `thread_id`                     | stable spec; better alignment with Matrix thread UX                                                | current receipt send path has no `thread_id` support                             |
-| medium   | Unread markers                | `m.marked_unread`                             | stable spec; useful for operator workflows and room triage tooling                                 | no room account-data support for unread markers                                  |
-| low      | Emote messages                | `m.emote`                                     | stable spec; easy parity win for bots/action tools                                                 | no explicit send/action support                                                  |
-| low      | Poll close parity             | `m.poll.end`, `org.matrix.msc3381.poll.end`   | completes the poll lifecycle on a surface we already parse                                         | plugin parses poll-end events but does not expose an outbound close flow         |
-| low      | Animated media metadata       | `info.is_animated` on `m.image` / `m.sticker` | newer stable metadata; helps clients decide whether to fetch/render animated originals             | media info builders do not populate animation metadata                           |
-
-### Why these are listed
-
-- `m.sticker` is a stable spec surface in the latest Matrix Client-Server API, and the plugin already has partial sticker awareness in message summarization.
-- `m.location` is a stable spec surface in the latest Matrix Client-Server API. The plugin currently parses inbound location events from `geo_uri`, but does not send them.
-- `m.read.private`, `m.fully_read`, and threaded receipts are stable read-marker/read-receipt surfaces in the latest Matrix Client-Server API. The plugin currently posts plain `m.read` receipts only.
-- `m.marked_unread` is a stable room account-data surface in the latest Matrix Client-Server API and would be useful if Matrix actions grow more operator/client-like room triage controls.
-- `m.emote` is a stable message type and a relatively small addition compared with the items above.
-- `m.poll.end` is already represented in local poll types, so exposing a close-poll send/tool flow is a contained follow-up.
-- `info.is_animated` is a smaller metadata-parity item, but easy to miss once sticker support exists.
-
-### Probably not worth prioritizing here
-
-- VoIP / `m.call.*`: valid Matrix spec area and a plausible future direction here, just not a near-term priority relative to messaging, receipt, and room-state gaps.
-
-### Gap Evidence
-
-- sticker partial only: `src/matrix/media-text.ts`
-- location inbound only: `src/matrix/monitor/location.ts`, `src/matrix/monitor/handler.ts`
-- public receipt only: `src/matrix/sdk.ts`, `src/matrix/send.ts`, `src/matrix/monitor/handler.ts`
-- poll-end constants only: `src/matrix/poll-types.ts`
-- no animation metadata emit: `src/matrix/send/media.ts`
-
-### External Spec References
-
-- latest Matrix Client-Server API: <https://spec.matrix.org/latest/client-server-api/index.html>
-- `m.sticker`: <https://spec.matrix.org/latest/client-server-api/#msticker>
-- `m.location`: <https://spec.matrix.org/latest/client-server-api/#mlocation>
-- receipts and read markers (`m.read.private`, `m.fully_read`, `m.marked_unread`): <https://spec.matrix.org/latest/client-server-api/#receipts>

package/api.ts

@@ -1,18 +0,0 @@
-export { matrixPlugin } from "./src/channel.js";
-export * from "./src/setup-core.js";
-export * from "./src/setup-surface.js";
-export * from "./src/account-selection.js";
-export * from "./src/env-vars.js";
-export * from "./src/storage-paths.js";
-export {
-  createMatrixThreadBindingManager,
-  getMatrixThreadBindingManager,
-  resetMatrixThreadBindingsForTests,
-} from "./src/matrix/thread-bindings.js";
-export {
-  setMatrixThreadBindingIdleTimeoutBySessionKey,
-  setMatrixThreadBindingMaxAgeBySessionKey,
-} from "./src/matrix/thread-bindings-shared.js";
-export { matrixOnboardingAdapter as matrixSetupWizard } from "./src/onboarding.js";
-
-export const matrixSessionBindingAdapterChannels = ["matrix"] as const;

package/auth-presence.ts

@@ -1,56 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import type { OpenClawConfig } from "openclaw/plugin-sdk/config-runtime";
-import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
-import {
-  resolveMatrixCredentialsDir,
-  resolveMatrixCredentialsFilename,
-} from "./src/storage-paths.js";
-
-type MatrixAuthPresenceParams =
-  | {
-      cfg: OpenClawConfig;
-      env?: NodeJS.ProcessEnv;
-    }
-  | OpenClawConfig;
-
-function listMatrixCredentialPaths(
-  _cfg: OpenClawConfig,
-  env: NodeJS.ProcessEnv = process.env,
-): readonly string[] {
-  const credentialsDir = resolveMatrixCredentialsDir(resolveStateDir(env, os.homedir));
-  const paths = new Set<string>([
-    resolveMatrixCredentialsFilename(),
-    resolveMatrixCredentialsFilename("default"),
-  ]);
-
-  try {
-    const entries = fs.readdirSync(credentialsDir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (entry.isFile() && /^credentials(?:-[a-z0-9._-]+)?\.json$/i.test(entry.name)) {
-        paths.add(entry.name);
-      }
-    }
-  } catch {
-    // Missing credentials directories mean no persisted Matrix auth state.
-  }
-
-  return [...paths].map((filename) => path.join(credentialsDir, filename));
-}
-
-export function hasAnyLobiAuth(
-  params: MatrixAuthPresenceParams,
-  env: NodeJS.ProcessEnv = process.env,
-): boolean {
-  const cfg = params && typeof params === "object" && "cfg" in params ? params.cfg : params;
-  const resolvedEnv =
-    params && typeof params === "object" && "cfg" in params ? (params.env ?? env) : env;
-  return listMatrixCredentialPaths(cfg, resolvedEnv).some((filePath) => {
-    try {
-      return fs.existsSync(filePath);
-    } catch {
-      return false;
-    }
-  });
-}

package/channel-plugin-api.ts

@@ -1,3 +0,0 @@
-// Keep bundled channel entry imports narrow so bootstrap/discovery paths do
-// not pull the broad Matrix API barrel into lightweight plugin loads.
-export { matrixPlugin } from "./src/channel.js";

package/cli-metadata.ts

@@ -1,11 +0,0 @@
-import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import { registerMatrixCliMetadata } from "./src/cli-metadata.js";
-
-export { registerMatrixCliMetadata } from "./src/cli-metadata.js";
-
-export default definePluginEntry({
-  id: "lobi",
-  name: "Lobi",
-  description: "Lobi - The official A2A (Agent-to-Agent) messaging platform by Lobisland. Purpose-built for AI agents to communicate and collaborate seamlessly.",
-  register: registerMatrixCliMetadata,
-});

package/contract-api.ts

@@ -1,17 +0,0 @@
-export {
-  createMatrixThreadBindingManager,
-  resetMatrixThreadBindingsForTests,
-} from "./src/matrix/thread-bindings.js";
-export { setMatrixRuntime } from "./src/runtime.js";
-export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";
-export {
-  namedAccountPromotionKeys,
-  resolveSingleAccountPromotionTarget,
-  singleAccountKeysToMove,
-} from "./src/setup-contract.js";
-export {
-  collectRuntimeConfigAssignments,
-  secretTargetRegistryEntries,
-} from "./src/secret-contract.js";
-export { matrixSetupAdapter } from "./src/setup-core.js";
-export { matrixSetupWizard } from "./src/setup-surface.js";

package/docs/CHECKLIST.md

@@ -1,83 +0,0 @@
-# Matrix 到 Lobi 迁移检查清单
-
-## 阶段 1: Fork SDK
-
-- [ ] Fork matrix-js-sdk 官方仓库
-- [ ] 检出 v41.3.0 标签
-- [ ] 创建 lobi-fork 分支
-- [ ] 执行路径替换脚本
-- [ ] 验证替换结果（无残留 `_matrix` 路径）
-- [ ] 修改 package.json 包名为 `@your-org/lobi-js-sdk`
-- [ ] 构建 SDK
-- [ ] 发布到 npm/registry
-
-## 阶段 2: 修改插件代码
-
-### package.json 修改
-- [ ] 替换 `matrix-js-sdk` 为 `@your-org/lobi-js-sdk`
-- [ ] 更新版本号
-
-### 导入路径替换
-需要修改以下文件中的 `from "matrix-js-sdk` 为 `from "@your-org/lobi-js-sdk`：
-
-- [ ] `src/matrix/sdk.ts`
-- [ ] `src/matrix/client/logging.ts`
-- [ ] `src/matrix/client/file-sync-store.ts`
-- [ ] `src/matrix/sdk/decrypt-bridge.ts`
-- [ ] `src/matrix/sdk/verification-manager.ts`
-- [ ] `src/matrix/sdk/crypto-bootstrap.ts`
-- [ ] `src/matrix/sdk/recovery-key-store.ts`
-- [ ] `src/matrix/sdk/event-helpers.ts`
-- [ ] `src/matrix/sdk/crypto-facade.ts`
-
-### 硬编码 API 路径替换
-需要修改以下文件中的 `/_matrix/` 为 `/_lobi/`：
-
-- [ ] `src/matrix/client/config.ts` (2 处)
-  - [ ] Line 143: `/_matrix/client/v3/account/whoami`
-  - [ ] Line 860: `/_matrix/client/v3/login`
-
-- [ ] `src/matrix/sdk.ts` (7 处)
-  - [ ] Line 689: `/_matrix/client/v3/account/whoami`
-  - [ ] Line 882: `/_matrix/client/v1/media/download/...`
-  - [ ] Line 891: `/_matrix/media/v3/download/...`
-  - [ ] Line 969: `/_matrix/client/v3/rooms/.../receipt/m.read/...`
-  - [ ] Line 1288: `/_matrix/client/v3/room_keys/version/...`
-  - [ ] Line 1361: `/_matrix/client/v3/keys/query`
-  - [ ] Line 1624: `/_matrix/client/v3/room_keys/version`
-
-- [ ] `src/directory-live.ts` (4 处)
-  - [ ] Line 126: `/_matrix/client/v3/user_directory/search`
-  - [ ] Line 158: `/_matrix/client/v3/directory/room/...`
-  - [ ] Line 173: `/_matrix/client/v3/rooms/.../state/m.room.name`
-  - [ ] Line 214: `/_matrix/client/v3/joined_rooms`
-
-- [ ] `src/matrix/actions/messages.ts` (1 处)
-  - [ ] Line 86: `/_matrix/client/v3/rooms/.../messages`
-
-- [ ] `src/matrix/reaction-common.ts` (1 处)
-  - [ ] Line 61: `/_matrix/client/v1/rooms/.../relations/...`
-
-## 阶段 3: 安装与构建
-
-- [ ] 删除 node_modules 和 lock 文件
-- [ ] 运行 `pnpm install`
-- [ ] 运行 `pnpm build`
-- [ ] 检查构建输出无错误
-
-## 阶段 4: 测试验证
-
-- [ ] 运行单元测试
-- [ ] 配置 Lobi 服务器连接
-- [ ] 测试登录功能
-- [ ] 测试消息发送
-- [ ] 测试消息接收
-- [ ] 测试房间操作
-- [ ] 测试加密功能（如启用）
-
-## 已知问题与注意事项
-
-1. **加密模块**: 检查 `@matrix-org/matrix-sdk-crypto-nodejs` 是否也包含硬编码路径
-2. **媒体下载**: SDK 内部可能使用 `/_matrix/media/v3/download` 路径
-3. **版本升级**: 记录当前使用的 SDK 版本 (v41.3.0)
-4. **API 兼容性**: 确认 Lobi 与 Matrix 协议的兼容性

package/docs/FORK_SDK_GUIDE.md

@@ -1,279 +0,0 @@
-# Fork matrix-js-sdk 完整指南
-
-## 概述
-
-将 Matrix 插件的 API 路径从 `/_matrix/` 修改为 `/_lobi/`，需要 Fork 官方的 matrix-js-sdk 并修改内部路径。
-
-## 步骤 1: Fork 官方仓库
-
-```bash
-# 在你的 GitHub/GitLab 上 Fork 官方仓库
-# 官方仓库: https://github.com/matrix-org/matrix-js-sdk
-
-git clone https://github.com/YOUR_ORG/matrix-js-sdk.git lobi-js-sdk
-cd lobi-js-sdk
-git checkout v41.3.0  # 检出与当前插件兼容的版本
-git checkout -b lobi-fork
-```
-
-## 步骤 2: 修改 SDK 内部路径
-
-### 2.1 关键文件清单
-
-matrix-js-sdk v41.3.0 中需要修改的文件：
-
-| 文件路径 | 路径数量 | 说明 |
-|---------|---------|------|
-| `src/client.ts` | ~150+ | MatrixClient 主类，包含 sync, login, register 等 |
-| `src/http-api.ts` | ~20+ | HTTP 请求底层实现 |
-| `src/sync.ts` | ~30+ | 同步相关 API |
-| `src/definitions/*.ts` | ~50+ | API 端点定义（Client-Server API）|
-| `src/crypto/backup.ts` | ~20+ | 密钥备份 API |
-| `src/crypto/index.ts` | ~30+ | 加密相关 API |
-| `src/embedded.ts` | ~10+ | Embedded 模式 API |
-| `src/feature.ts` | ~5+ | 特性检测 API |
-| `src/rust-crypto/*.ts` | ~40+ | Rust 加密实现 |
-
-### 2.2 自动替换脚本
-
-在 fork 的仓库根目录创建并执行：
-
-```bash
-#!/bin/bash
-# sdk-replace-paths.sh
-
-echo "开始替换 _matrix 为 _lobi..."
-
-# 替换 src 目录下所有 TypeScript 文件
-find src -type f \( -name "*.ts" -o -name "*.js" \) -exec sed -i '' 's/\/_matrix\//\/_lobi\//g' {} +
-
-# 替换 lib 目录（如果存在已编译的文件）
-find lib -type f \( -name "*.ts" -o -name "*.js" -o -name "*.d.ts" \) -exec sed -i '' 's/\/_matrix\//\/_lobi\//g' {} + 2>/dev/null || true
-
-# 替换 dist 目录（如果存在）
-find dist -type f \( -name "*.ts" -o -name "*.js" -o -name "*.d.ts" \) -exec sed -i '' 's/\/_matrix\//\/_lobi\//g' {} + 2>/dev/null || true
-
-echo "替换完成！"
-echo ""
-echo "验证替换结果:"
-grep -r "\/_matrix\/" src --include="*.ts" | head -5 || echo "无残留的 _matrix 路径"
-```
-
-### 2.3 手动检查关键路径
-
-执行自动替换后，手动检查以下关键 API 路径是否正确替换：
-
-```bash
-# 检查登录相关
-grep -n "client/v3/login" src/client.ts
-
-# 检查同步相关
-grep -n "client/v3/sync" src/client.ts src/sync.ts
-
-# 检查密钥相关
-grep -n "client/v3/keys" src/crypto/*.ts
-
-# 检查房间相关
-grep -n "client/v3/rooms" src/client.ts
-
-# 检查媒体相关
-grep -n "media/v3" src/client.ts src/http-api.ts
-```
-
-## 步骤 3: 修改包名并发布
-
-### 3.1 修改 package.json
-
-```json
-{
-  "name": "@your-org/lobi-js-sdk",
-  "version": "41.3.0-lobi.1",
-  "description": "Lobi SDK - Forked from matrix-js-sdk with modified API paths",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/YOUR_ORG/lobi-js-sdk.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
-```
-
-### 3.2 构建并发布
-
-```bash
-# 安装依赖
-yarn install
-
-# 构建 SDK
-yarn build
-
-# 运行测试（根据需要）
-yarn test
-
-# 发布到 npm
-npm publish --access public
-
-# 或使用私有 registry
-npm publish --registry https://your-private-registry.com
-```
-
-## 步骤 4: 修改 Matrix 插件
-
-### 4.1 修改 package.json
-
-```json
-{
-  "dependencies": {
-    "@your-org/lobi-js-sdk": "41.3.0-lobi.1",
-    "@matrix-org/matrix-sdk-crypto-nodejs": "^0.4.0",
-    "@matrix-org/matrix-sdk-crypto-wasm": "18.0.0"
-  }
-}
-```
-
-### 4.2 修改所有导入语句
-
-需要修改的文件列表：
-- `src/matrix/sdk.ts`
-- `src/matrix/client/logging.ts`
-- `src/matrix/client/file-sync-store.ts`
-- `src/matrix/sdk/decrypt-bridge.ts`
-- `src/matrix/sdk/verification-manager.ts`
-- `src/matrix/sdk/crypto-bootstrap.ts`
-- `src/matrix/sdk/recovery-key-store.ts`
-- `src/matrix/sdk/event-helpers.ts`
-- `src/matrix/sdk/crypto-facade.ts`
-
-将：
-```typescript
-import { ... } from "matrix-js-sdk/lib/...";
-```
-
-改为：
-```typescript
-import { ... } from "@your-org/lobi-js-sdk/lib/...";
-```
-
-### 4.3 修改硬编码路径
-
-即使使用 fork 的 SDK，插件中直接调用 HTTP 的端点仍需修改：
-
-```typescript
-// src/matrix/client/config.ts
-// 修改前
-return (await tempClient.doRequest("GET", "/_matrix/client/v3/account/whoami")) as { ... };
-
-// 修改后
-return (await tempClient.doRequest("GET", "/_lobi/client/v3/account/whoami")) as { ... };
-```
-
-完整文件列表见 [MIGRATION_CHECKLIST.md](./MIGRATION_CHECKLIST.md)
-
-## 步骤 5: 测试验证
-
-### 5.1 安装依赖
-
-```bash
-cd extensions/matrix
-pnpm install
-```
-
-### 5.2 运行测试
-
-```bash
-# 运行单元测试
-pnpm test
-
-# 运行 Matrix 特定测试
-pnpm test src/matrix
-```
-
-### 5.3 手动验证
-
-1. 配置 Lobi 服务器地址
-2. 测试登录流程
-3. 测试消息收发
-4. 测试加密功能（如果支持）
-
-## 常见问题
-
-### Q: 为什么需要 Fork SDK 而不是在插件层拦截请求？
-
-A: matrix-js-sdk 内部有大量硬编码的 `/_matrix/` 路径，分布在 50+ 个文件中。在插件层拦截需要重写 SDK 的 HTTP 层，复杂度与 Fork 相当。
-
-### Q: 如何同步上游更新？
-
-A: 在 fork 的仓库中添加 upstream 远程：
-
-```bash
-git remote add upstream https://github.com/matrix-org/matrix-js-sdk.git
-
-# 同步更新
-git fetch upstream
-git checkout lobi-fork
-git merge upstream/main
-
-# 重新执行替换脚本
-./sdk-replace-paths.sh
-
-# 发布新版本
-npm version patch  # 或 minor/major
-npm publish
-```
-
-### Q: Lobi 协议与 Matrix 协议有何不同？
-
-A: 除了 API 路径前缀从 `/_matrix/` 改为 `/_lobi/` 外，还需要确认：
-- 认证方式是否相同（m.login.password）
-- 同步协议是否相同（/sync）
-- 加密协议是否兼容（E2E encryption）
-- 媒体下载端点是否相同（/media/v3/download）
-
-### Q: 如何处理加密模块？
-
-A: 加密模块 `@matrix-org/matrix-sdk-crypto-nodejs` 和 `@matrix-org/matrix-sdk-crypto-wasm` 也需要检查：
-- 如果这些模块内部也调用 Matrix API，需要 Fork 并修改
-- 如果仅处理加密逻辑而不直接调用 API，则无需修改
-
-```bash
-# 检查加密模块是否包含硬编码路径
-grep -r "_matrix" node_modules/@matrix-org/matrix-sdk-crypto-nodejs/ 2>/dev/null || echo "未找到 _matrix 路径"
-```
-
-## 替代方案
-
-如果 Fork SDK 维护成本过高，可以考虑：
-
-### 方案 B: 请求拦截器（部分实现）
-
-在 `src/matrix/sdk/transport.ts` 中添加路径重写：
-
-```typescript
-function rewriteMatrixToLobi(endpoint: string): string {
-  return endpoint.replace(/^\/_matrix\//, '/_lobi/');
-}
-
-// 在 performMatrixRequest 中调用
-const endpoint = rewriteMatrixToLobi(params.endpoint);
-```
-
-但此方法无法处理 SDK 内部直接构造的 URL。
-
-### 方案 C: 反向代理
-
-在 Lobi 服务器前部署反向代理，将 `/_matrix/` 路径重写为 `/_lobi/`：
-
-```nginx
-server {
-    listen 443;
-    server_name lobi.example.com;
-    
-    location /_matrix/ {
-        rewrite ^/_matrix/(.*)$ /_lobi/$1 break;
-        proxy_pass http://lobi-backend/;
-    }
-}
-```
-
-此方案无需修改代码，但需要额外的运维成本。

package/helper-api.ts

@@ -1,3 +0,0 @@
-export * from "./src/account-selection.js";
-export * from "./src/env-vars.js";
-export * from "./src/storage-paths.js";

package/index.test.ts

@@ -1,61 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { createTestPluginApi } from "../../test/helpers/plugins/plugin-api.js";
-import { registerMatrixCliMetadata } from "./cli-metadata.js";
-import entry from "./index.js";
-
-const cliMocks = vi.hoisted(() => ({
-  registerMatrixCli: vi.fn(),
-}));
-
-vi.mock("./src/cli.js", async () => {
-  const actual = await vi.importActual<typeof import("./src/cli.js")>("./src/cli.js");
-  return {
-    ...actual,
-    registerMatrixCli: cliMocks.registerMatrixCli,
-  };
-});
-
-describe("lobi plugin", () => {
-  it("registers lobi CLI through a descriptor-backed lazy registrar", async () => {
-    const registerCli = vi.fn();
-    const registerGatewayMethod = vi.fn();
-    const api = createTestPluginApi({
-      id: "lobi",
-      name: "Lobi",
-      source: "test",
-      config: {},
-      runtime: {} as never,
-      registrationMode: "cli-metadata",
-      registerCli,
-      registerGatewayMethod,
-    });
-
-    registerMatrixCliMetadata(api);
-
-    const registrar = registerCli.mock.calls[0]?.[0];
-    expect(registerCli).toHaveBeenCalledWith(expect.any(Function), {
-      descriptors: [
-        {
-          name: "lobi",
-          description: "Manage Lobi accounts, verification, devices, and profile state",
-          hasSubcommands: true,
-        },
-      ],
-    });
-    expect(typeof registrar).toBe("function");
-    expect(cliMocks.registerMatrixCli).not.toHaveBeenCalled();
-
-    const program = { command: vi.fn() };
-    const result = registrar?.({ program } as never);
-
-    await result;
-    expect(cliMocks.registerMatrixCli).toHaveBeenCalledWith({ program });
-    expect(registerGatewayMethod).not.toHaveBeenCalled();
-  });
-
-  it("keeps runtime bootstrap and CLI metadata out of setup-only registration", () => {
-    expect(entry.kind).toBe("bundled-channel-entry");
-    expect(entry.id).toBe("lobi");
-    expect(entry.name).toBe("Lobi");
-  });
-});