Skip to content

docs: refresh CLAUDE.md + localize empty-ASR capsule message#411

Merged
appergb merged 1 commit into
betafrom
pr/docs-and-empty-asr-zh
May 11, 2026
Merged

docs: refresh CLAUDE.md + localize empty-ASR capsule message#411
appergb merged 1 commit into
betafrom
pr/docs-and-empty-asr-zh

Conversation

@appergb
Copy link
Copy Markdown
Collaborator

@appergb appergb commented May 11, 2026

User description

Summary

  • CLAUDE.md 同步:补 coordinator 拆分(dictation/qa/resources)、coordinator_state、qa_hotkey、三套并行 hotkey 监听
  • 新增 Q&A pipeline 章节(panel 路由 / capsule sweep / selection 3-tier fallback / 4000 char 截断 / 多轮 messages)
  • 新增 Insertion paths 章节(跨平台默认路径 vs Windows IME-IPC 路径)
  • 顶部 adjacent docs 段落补 AGENTS.md / README.zh.md / USAGE.md 指引
  • 空转写 capsule 文案 "ASR returned empty transcript" → "没有识别到语音"(line 907 内部 Err 字符串保留英文)

Test plan

  • `cargo check` pass
  • 真机:录音不说话立即停止 → 胶囊错误状态应显示中文 "没有识别到语音"

PR Type

Documentation, Bug fix


Description

  • Refresh CLAUDE.md architecture guidance

  • Document Q&A and insertion pipelines

  • Localize empty-ASR capsule error text


Diagram Walkthrough

flowchart LR
  PR["PR changes"] --> DOCS["Update CLAUDE.md guidance"]
  PR --> ASR["Localize empty-ASR capsule message"]
Loading

File Walkthrough

Relevant files
Documentation
CLAUDE.md
Expand architecture and workflow docs                                       

CLAUDE.md

  • Added an Adjacent docs section linking AGENTS.md, README.zh.md, and
    USAGE.md.
  • Expanded the architecture map to cover dictation, QA, resources,
    hotkeys, audio/ASR, insertion, and selection modules.
  • Documented the Q&A pipeline, selection fallback behavior, truncation
    rules, and multi-turn memory.
  • Added an insertion-paths section describing the cross-platform default
    flow and the Windows IME IPC route.
+68/-17 
Bug fix
dictation.rs
Localize empty transcript capsule message                               

openless-all/app/src-tauri/src/coordinator/dictation.rs

  • Changed the empty-transcript capsule error text from English to
    Chinese.
  • Preserved the internal Err string behavior for upstream logging and
    consumers.
+1/-1     

CLAUDE.md:
- 模块表加上 coordinator 拆分(dictation/qa/resources)、coordinator_state、qa_hotkey
  与三套并行 hotkey 监听(hotkey / combo_hotkey / qa_hotkey + global_hotkey_runtime)
- 新增 Q&A pipeline 章节,记录 panel 路由、capsule sweep、selection 3-tier fallback、
  selection 4000 char 截断与多轮 messages 行为
- 新增 Insertion paths 章节,区分跨平台默认路径与 Windows IME-IPC 路径
- 顶部 adjacent docs 段落补 AGENTS.md / README.zh.md / USAGE.md 指引

dictation.rs:
- 空转写场景 capsule 文案 "ASR returned empty transcript" → "没有识别到语音",
  与界面其他位置一致。line 907 的内部 Err 字符串保留英文(属于上层日志/调用方
  消费的内部 error code,不直接对用户显示)
@github-actions
Copy link
Copy Markdown

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪
🧪 No relevant tests
🔒 No security concerns identified
⚡ No major issues detected

@appergb appergb merged commit 080fd9c into beta May 11, 2026
4 checks passed
@appergb appergb deleted the pr/docs-and-empty-asr-zh branch May 11, 2026 16:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant