MindOS_CLI

lidf/MindOS_CLI

Fork 0

Commit Graph

Author	SHA1	Message	Date
lidf	5aa8fbc284	docs: SPEC v1.1 — 同步实施结果 + Bug 修复记录 + Cloud→CLI 链路优化 - 状态从 Draft → 已实施（Phase 1-4 完成） - §1.1 改为改造前状态（保留作设计依据） - §3.5 文件结构更新为实际行数（1928 行/10 文件） - §5 路线图标记完成状态 + 实际执行顺序 3→1→2→4 - §7 决策记录新增 D7-D11（执行顺序/pipx 检测/防降级/cli_info/主 loop 复用） - §8 新增：实施过程中发现并修复的 6 个 Bug - §9 新增：Cloud→CLI 工具调用链路优化（可观测性+快速路径+handler 复用）	2026-07-01 17:25:49 +08:00
lidf	aecd81ec8b	feat: 无状态原子化改造 v0.2.0 — pipelines/ 分层 + 双工录音 + pipx 自动更新修复 ## 架构改造将 recorder/tunnel/managed_mcp 三个有状态单例模块拆成 mindcli/pipelines/ 下的无状态管线 + health.py 调用方持有状态。参照 hermes-overlay/infra/pipelines/anyfile2md.py 的分层模式。 ### pipelines/ 层（无状态） - audio_capture.py: capture() 工厂函数返回独立 CaptureHandle，无单例无互斥，双工模式（system+mic 并行）在代码层面可用 - tunnel_session.py: connect() 工厂函数 + on_status 回调，消除 health ⇄ tunnel 循环耦合（单向数据流） - tool_proxy.py: ToolProxy 替代 ManagedMCP，非单例 ### health.py 改造 - _active_captures dict 按 chatId 索引，可多实例并存 - _tunnel_handle 由调用方持有，on_status 回调更新状态 - /record/stop 支持 ?chatId= 停单路或全停 - /record/status 返回所有活跃录音列表 ### cli.py 改造 - chat/ask 走 run_agent headless + Cloud Gateway JWT（铁律 A） - 保留 --offline 走 vendor TUI（铁律 C：断开即自治） - mind update 修复 pipx 场景： - 检测 pipx venv → pipx reinstall - 非 pipx → sys.executable -m pip（修复 venv 里 pip 找不到） - 防降级保护（远端版本低于本地时不升级） - 远端 upgradeCmd 字段下发 ### 顺手修复 - health.py / capability.py 的 HERMES_COMMIT → VENDOR_COMMIT - 版本号 0.1.0 → 0.2.0（__init__.py + pyproject.toml） - 新增 versions.json 仓库模板（installCmd 改为 pipx，新增 upgradeCmd） ### 删除 - recorder.py → 逻辑迁入 pipelines/audio_capture.py - tunnel.py → 逻辑迁入 pipelines/tunnel_session.py - managed_mcp.py → 逻辑迁入 pipelines/tool_proxy.py SPEC: docs/SPEC_mindcli_atomization.md	2026-07-01 14:56:16 +08:00

Author

SHA1

Message

Date

lidf

5aa8fbc284

docs: SPEC v1.1 — 同步实施结果 + Bug 修复记录 + Cloud→CLI 链路优化

- 状态从 Draft → 已实施（Phase 1-4 完成）
- §1.1 改为改造前状态（保留作设计依据）
- §3.5 文件结构更新为实际行数（1928 行/10 文件）
- §5 路线图标记完成状态 + 实际执行顺序 3→1→2→4
- §7 决策记录新增 D7-D11（执行顺序/pipx 检测/防降级/cli_info/主 loop 复用）
- §8 新增：实施过程中发现并修复的 6 个 Bug
- §9 新增：Cloud→CLI 工具调用链路优化（可观测性+快速路径+handler 复用）

2026-07-01 17:25:49 +08:00

lidf

aecd81ec8b

feat: 无状态原子化改造 v0.2.0 — pipelines/ 分层 + 双工录音 + pipx 自动更新修复

## 架构改造

将 recorder/tunnel/managed_mcp 三个有状态单例模块拆成
mindcli/pipelines/ 下的无状态管线 + health.py 调用方持有状态。
参照 hermes-overlay/infra/pipelines/anyfile2md.py 的分层模式。

### pipelines/ 层（无状态）
- audio_capture.py: capture() 工厂函数返回独立 CaptureHandle，
  无单例无互斥，双工模式（system+mic 并行）在代码层面可用
- tunnel_session.py: connect() 工厂函数 + on_status 回调，
  消除 health ⇄ tunnel 循环耦合（单向数据流）
- tool_proxy.py: ToolProxy 替代 ManagedMCP，非单例

### health.py 改造
- _active_captures dict 按 chatId 索引，可多实例并存
- _tunnel_handle 由调用方持有，on_status 回调更新状态
- /record/stop 支持 ?chatId= 停单路或全停
- /record/status 返回所有活跃录音列表

### cli.py 改造
- chat/ask 走 run_agent headless + Cloud Gateway JWT（铁律 A）
- 保留 --offline 走 vendor TUI（铁律 C：断开即自治）
- mind update 修复 pipx 场景：
  - 检测 pipx venv → pipx reinstall
  - 非 pipx → sys.executable -m pip（修复 venv 里 pip 找不到）
  - 防降级保护（远端版本低于本地时不升级）
  - 远端 upgradeCmd 字段下发

### 顺手修复
- health.py / capability.py 的 HERMES_COMMIT → VENDOR_COMMIT
- 版本号 0.1.0 → 0.2.0（__init__.py + pyproject.toml）
- 新增 versions.json 仓库模板（installCmd 改为 pipx，新增 upgradeCmd）

### 删除
- recorder.py → 逻辑迁入 pipelines/audio_capture.py
- tunnel.py → 逻辑迁入 pipelines/tunnel_session.py
- managed_mcp.py → 逻辑迁入 pipelines/tool_proxy.py

SPEC: docs/SPEC_mindcli_atomization.md

2026-07-01 14:56:16 +08:00

2 Commits