@ondevplann/remotetype 0.1.3 → 0.2.1

package/bin/index.js

@@ -5,8 +5,8 @@
  * RemoteType PC 客户端 CLI 入口。
  *
  * 子命令：
- *   remotetype serve                  启动守护进程，连接公网 Serve，等待远程文本注入
- *   remotetype serve --align --key K  对齐模式：端到端加密 + 输入框实时对齐（含删除）
+ *   remotetype serve                  启动守护进程（默认对齐模式：端到端加密 + 输入框实时对齐）
+ *   remotetype serve --plain          兼容旧普通模式：只接收整句明文推送（无对齐）
  *   remotetype test "文本"             本地直接测试 Rust 注入，不走公网服务
  *   remotetype doctor                 环境自检（平台/二进制/权限/网络）
  *   remotetype binary                 打印解析到的 Rust 二进制路径
@@ -58,8 +58,8 @@ ${C.bold}用法${C.reset}
   npx remotetype <command> [options]
 
 ${C.bold}命令${C.reset}
-  ${C.cyan}serve${C.reset}               启动守护进程：连接公网服务，等待远程文本注入
-  ${C.cyan}serve --align${C.reset}       对齐模式：端到端加密 + 输入框实时对齐（含删除）
+  ${C.cyan}serve${C.reset}               启动守护进程：对齐模式（端到端加密，手机输入框与电脑实时对齐，含删除）
+  ${C.cyan}serve --plain${C.reset}       兼容旧普通模式：只接收整句明文推送（/push 接口、外部脚本）
   ${C.cyan}test${C.reset} "<文本>"        本地测试：直接调用注入引擎，不连公网
   ${C.cyan}doctor${C.reset}              环境自检：平台支持 / 注入二进制 / 权限 / 网络
   ${C.cyan}binary${C.reset}              打印解析到的注入引擎路径
@@ -67,8 +67,9 @@ ${C.bold}命令${C.reset}
 ${C.bold}选项${C.reset}
   --url <ws://...>       公网服务地址（默认 ${require('../lib/config').DEFAULT_SERVE_URL}）
   --client-id <id>       本机唯一标识，服务端按此路由（默认自动生成并持久化）
-  --align                对齐模式：只接受 RT1 加密信封，手机输入与电脑实时对齐
   --key <KEY>            对齐模式配对 key（不传则自动生成强随机并打印；手机端输入同一 key）
+  --plain                切回旧普通模式：接收整句明文推送（无对齐、无加密）
+  --align                （已默认开启，保留兼容；与 --plain 同给时 --plain 优先）
   --token <TOKEN>        注册门禁 token（服务器设 RT_TOKEN 后两端都必须携带同一值）
   --log-level <level>    debug | info | warn | error（默认 info）
   --max-queue <n>        本地消息队列上限（默认 100）
@@ -78,9 +79,9 @@ ${C.bold}选项${C.reset}
   --version              显示版本
 
 ${C.bold}示例${C.reset}
-  npx remotetype serve --url ws://1.2.3.4:8790/ws
-  npx remotetype serve --align                 # 自动生成 key，复制到手机
-  npx remotetype serve --align --key MYKEY123  # 两端用同一个 key
+  npx remotetype serve --url ws://1.2.3.4:8790/ws   # 对齐模式，自动生成 key，复制到手机
+  npx remotetype serve --key MYKEY123               # 两端用同一个 key
+  npx remotetype serve --plain                      # 旧普通模式（接收 /push 整句推送）
   npx remotetype test "你好，这是一条本地注入测试"
   npx remotetype doctor
 `);
@@ -273,8 +274,14 @@ async function cmdServe(cfg) {
       }
 
       // type：常规文本注入（serve 与 relay 共用，relay 的 text 是 diff 出的增量）
-      // 二次预处理：即便上游已过滤，这里仍是最后一道防线
-      const cleaned = sanitize(item.text, { maxLength: cfg.maxTextLength });
+      // 二次预处理：即便上游已过滤，这里仍是最后一道防线。
+      // 对齐模式保留纯空白：换行/空格是手机输入框的真实内容（IME 自动插入的
+      // 换行不该被判失败挂起整批计划），见 sanitize 的 keepWhitespace。
+      const isAlignSource = meta.source === 'align';
+      const cleaned = sanitize(item.text, {
+        maxLength: cfg.maxTextLength,
+        keepWhitespace: isAlignSource,
+      });
       if (!cleaned.ok) {
         logger.warn('文本预处理后丢弃', { reason: cleaned.reason, clientId: item.clientId });
         if (meta.source === 'align' && item.seq !== undefined) failedAlignSeqs.add(item.seq);
@@ -288,6 +295,11 @@ async function cmdServe(cfg) {
         });
         return;
       }
+      if (isAlignSource && cleaned.text.length === 0) {
+        // 整条只含不可见字符：无可注入内容，也不算失败——commit 仍会推进 mirror
+        logger.debug('对齐空操作（仅不可见字符），跳过注入', { seq: item.seq });
+        return;
+      }
       if (cleaned.truncated) {
         logger.warn('文本超长已截断', {
           originalLength: cleaned.originalLength,

package/lib/config.js

@@ -124,8 +124,8 @@ function loadConfig(flags = {}) {
     requestTimeoutMs: num(flags.requestTimeoutMs ?? env.REMOTETYPE_REQUEST_TIMEOUT ?? file.requestTimeoutMs, 30000),
     // 二进制
     agentPath: flags.agent ?? env.REMOTETYPE_AGENT ?? file.agentPath ?? null,
-    // 对齐模式（--align 开关：加密 + 输入实时对齐；--key 传配对 key）
-    align: flags.align === true,
+    // 对齐模式（serve 默认开启；--plain 切回旧普通模式，--align 保留兼容）
+    align: flags.plain === true ? false : true,
     alignKey: flags.key ?? env.REMOTETYPE_KEY ?? file.alignKey ?? null,
     // 注册门禁 token（服务器设 RT_TOKEN 后必须携带同一值才能注册）
     token: flags.token ?? env.REMOTETYPE_TOKEN ?? env.RT_TOKEN ?? file.token ?? null,

package/lib/sanitize.js

@@ -32,10 +32,14 @@ function isInvisible(c) {
  * @param {string} raw
  * @param {object} [opts]
  * @param {number} [opts.maxLength]
+ * @param {boolean} [opts.keepWhitespace] 保留纯空白文本（对齐模式用：
+ *   换行/空格是手机输入框的真实内容，整条空白不算「空文本」；
+ *   返回 ok:true 且 text 可能为空串，由调用方决定是否为无操作）
  * @returns {{ok:boolean, text:string, reason?:string, truncated?:boolean, originalLength?:number}}
  */
 function sanitize(raw, opts = {}) {
   const maxLength = opts.maxLength ?? DEFAULT_MAX_LENGTH;
+  const keepWhitespace = opts.keepWhitespace === true;
 
   if (typeof raw !== 'string') {
     return { ok: false, text: '', reason: 'not_a_string' };
@@ -52,8 +56,8 @@ function sanitize(raw, opts = {}) {
   // 2) 统一换行，避免 \r\n 造成目标程序出现多余字符
   text = text.replace(/\r\n?/g, '\n');
 
-  // 3) 空文本丢弃
-  if (text.trim().length === 0) {
+  // 3) 空文本丢弃（keepWhitespace 时跳过：空白是对齐语义下的有效内容）
+  if (!keepWhitespace && text.trim().length === 0) {
     return { ok: false, text: '', reason: 'empty_after_clean', originalLength };
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ondevplann/remotetype",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "RemoteType PC 客户端：npx 一键启动，接收手机端语音识别文本并注入到当前焦点输入框",
   "bin": {
     "remotetype": "./bin/index.js"