新增仓内独立密语 CLI 子项目

添加 CipherTalk-CLI 子项目、斜杠交互模式、独立 CI/发布工作流，并确保桌面端打包排除 CLI 目录。

Author: ILoveBingLu

.github/workflows/ciphertalk-cli.yml

@@ -0,0 +1,83 @@
+name: CipherTalk CLI
+
+on:
+  pull_request:
+    paths:
+      - 'CipherTalk-CLI/**'
+      - '.github/workflows/ciphertalk-cli.yml'
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - 'CipherTalk-CLI/**'
+      - '.github/workflows/ciphertalk-cli.yml'
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: '是否发布 ciphertalk-cli 到 npm 官方公开包仓库'
+        required: true
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    working-directory: CipherTalk-CLI
+
+jobs:
+  validate:
+    name: 验证 CLI
+    runs-on: windows-latest
+    steps:
+      - name: 拉取代码
+        uses: actions/checkout@v5
+
+      - name: 设置 Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22.12.0
+          cache: npm
+          cache-dependency-path: CipherTalk-CLI/package-lock.json
+
+      - name: 安装 CLI 依赖
+        run: npm ci
+
+      - name: 类型检查
+        run: npm run typecheck
+
+      - name: 测试
+        run: npm test -- --run
+
+  publish-npm:
+    name: 发布 CLI
+    runs-on: windows-latest
+    needs: validate
+    if: github.event_name == 'workflow_dispatch' && inputs.publish == true
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: 拉取代码
+        uses: actions/checkout@v5
+
+      - name: 设置 Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22.12.0
+          registry-url: https://registry.npmjs.org
+          cache: npm
+          cache-dependency-path: CipherTalk-CLI/package-lock.json
+
+      - name: 安装 CLI 依赖
+        run: npm ci
+
+      - name: 构建 CLI 包
+        run: npm run build
+
+      - name: 发布到 npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public

.gitignore

@@ -67,3 +67,9 @@ xkey
 .claude/
 .tmp
 Agent示例UI/
+
+# Embedded CLI local outputs
+CipherTalk-CLI/node_modules/
+CipherTalk-CLI/dist/
+CipherTalk-CLI/coverage/
+CipherTalk-CLI/.miyu-test/

CipherTalk-CLI/.gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+coverage/
+.miyu-test/
+*.log

CipherTalk-CLI/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ILoveBingLu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

CipherTalk-CLI/README.md

@@ -0,0 +1,71 @@
+# CipherTalk-CLI
+
+`ciphertalk-cli` 提供 `miyu` 命令，用于在命令行、脚本和自动化任务中读取 CipherTalk 兼容的微信本地数据。
+
+这是密语仓库内的独立 Node/TypeScript 子项目。它和桌面版共享同一个 Git 仓库，但拥有自己的 `package.json`、锁文件、依赖、测试、构建产物和发布工作流。CLI 不启动 Electron，配置文件存放在 `~/.miyu/config.json`。
+
+桌面版和 CLI 在运行时互不依赖。需要同步数据层能力时，通过 `npm run sync:upstream` 做人工移植，不直接引用 Electron 模块。
+
+## 开发
+
+```bash
+npm install
+npm run dev -- status
+npm run typecheck
+npm test -- --run
+```
+
+从密语仓库根目录运行：
+
+```bash
+npm run cli -- status
+npm run cli:typecheck
+npm run cli:test
+```
+
+除非明确要做 CLI 发布构建，否则不要运行 `npm run build`。
+
+## 交互模式
+
+在终端中执行 `miyu status` 会先检查状态，然后进入交互式 CLI。进入后所有命令都使用 `/命令` 形式：
+
+```bash
+miyu status
+miyu> /sessions --limit 20
+miyu> /messages "张三" --limit 50
+miyu> /exit
+```
+
+输入 `/` 会自动显示所有可用命令供选择；输入 `/help` 也可以再次查看命令列表。脚本或管道场景可以显式指定 `--format` 或 `--quiet`，此时 `status` 只输出结果，不进入交互模式：
+
+```bash
+miyu --format json status
+miyu --quiet status
+```
+
+## 发布
+
+CLI 的验证和发布由父仓库中的 `.github/workflows/ciphertalk-cli.yml` 单独处理。该工作流只监听 `CipherTalk-CLI/**` 相关改动，不参与桌面版打包。
+
+发布目标是 npm 官方公开包仓库：`https://registry.npmjs.org`。手动触发工作流并启用 `publish` 后，会以公开 npm 包 `ciphertalk-cli` 发布，用户安装后使用 `miyu` 命令。国内用户可以等待 npmmirror 等镜像同步，或配置 npm 官方源安装。
+
+## 命令
+
+当前已注册的命令入口：
+
+- `/status`：检查配置和数据库连接状态
+- `/sessions`：列出会话
+- `/messages <session>`：查询会话消息
+- `/contacts`：列出联系人
+- `/contact <contact>`：查看联系人详情
+- `/key get|test|set`：密钥管理
+- `/search`：全文搜索
+- `/stats global|contacts|time|session|keywords|group`：统计分析
+- `/export`：导出聊天数据
+- `/moments`：朋友圈数据
+- `/report`：年度报告数据
+- `/mcp serve`：独立 MCP Server 模式
+- `/help`：显示命令列表
+- `/exit`：退出交互模式
+
+部分高级命令目前只保留公开接口，会返回 `NOT_IMPLEMENTED`，等待对应服务完成移植。

CipherTalk-CLI/bin/miyu.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const distEntry = join(root, 'dist', 'index.js')
+
+if (existsSync(distEntry)) {
+  await import(pathToFileURL(distEntry).href)
+} else {
+  await import('tsx/esm')
+  await import(pathToFileURL(join(root, 'src', 'index.ts')).href)
+}