From 2d1d4ad406228ef62ab078724cb7d1556e003d01 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Mon, 13 Jul 2026 16:03:19 +0800
Subject: [PATCH] chore: point independent project metadata to unified root
---
CODEGRAPH.md | 111 ++++++++++++-------------------------------------------
1 files changed, 25 insertions(+), 86 deletions(-)
diff --git a/CODEGRAPH.md b/CODEGRAPH.md
index 359f71b..3e554e7 100644
--- a/CODEGRAPH.md
+++ b/CODEGRAPH.md
@@ -1,95 +1,34 @@
-# CODEGRAPH
+# PrivateVoice-independent-developer CODEGRAPH
-## Project
+最后整理：2026-07-11
-- Product: Wails v3 / Go desktop dictation app.
-- Current branch purpose: Round 6 Cantonese language version real-user test package based on `v2.2.0-build20260702.0303`.
-- Protected macOS behavior: existing macOS App Store / local DMG build lines are not changed by this branch.
+## 工程范围
-## Core Entrypoints
+- 项目根：`/Users/ar/Projects/PrivateVoice`
+- Git 根：`/Users/ar/Projects/PrivateVoice/03-O`
+- 分支：`independent-developer`
+- 源码冻结基线：`a075aec123e1f7118f138738f196c2995aa96f98`；项目初始化元数据提交见 `git log`。
+- 基线标签：`v2.2.2-build20260703.0335-real-user-test`
+- 源码根：`/Users/ar/Projects/PrivateVoice/03-O/C1.source/privatevoice.src`
+- 自动图谱：`/Users/ar/Projects/PrivateVoice/03-O/.codebase-memory/`；只辅助定位。
-- `privatevoice.src/main.go`: process startup, data migration, logger, single-instance guard.
-- `privatevoice.src/app.go`: Wails app wiring, settings window, tray, recorder, hotkey loop, ASR init, paste orchestration.
-- `privatevoice.src/embed.go`: embeds frontend assets and app/tray icons.
+## 核心入口
-## Language And Model Registry
+- 启动与应用 wiring：`C1.source/privatevoice.src/main.go`、`app.go`。
+- macOS 文字输出：`C1.source/privatevoice.src/internal/input/paste_darwin.go`。
+- 音频：`C1.source/privatevoice.src/internal/audio/recorder.go`。
+- macOS 热键：`C1.source/privatevoice.src/internal/hotkey/hotkey_darwin.go`。
+- 本地 ASR：`C1.source/privatevoice.src/internal/engine/engine_darwin.go`。
+- 本地 DMG：`C1.source/privatevoice.src/scripts/build-local-macos.sh`。
+- Developer ID / notarization：`C1.source/privatevoice.src/scripts/build-release-macos.sh`。
-- `privatevoice.src/internal/model/profile.go`: model and language IDs, model profile shape, install status types.
-- `privatevoice.src/internal/model/registry.go`: language profile order, model profiles, language profiles, and normalization.
-- `privatevoice.src/internal/modelselection/selection.go`: resolves current language and model, including manual-model fallback.
-- Round 6 Cantonese path:
- - Language ID: `yue-HK`, displayed as `粤语`.
- - Default model: `sensevoice-yue-2025-09-09`.
- - Backend: SenseVoice with `LanguageParam="yue"`.
- - The Cantonese language profile intentionally has no upgrade models, so Qwen3-ASR and X-ASR are not shown as Cantonese-specific options.
+## 当前基线保护
-## Platform Modules
+- 本项目当前只代表 2.2.2 / 20260703.0335 旧代码；不得把后续 MAS AX router、MAS sandbox 实验或 2.2.3 改造直接复制进来。
+- 既有 macOS、Windows preview、模型下载安全、paste/clipboard 保护行为未经独立任务和 QA 计划不得改动。
+- Developer ID 直接输入、签名、公证、安装、更新与回滚是后续独立任务，不得从历史文档直接宣称已完成。
-- Audio: `privatevoice.src/internal/audio/recorder.go`
- - Uses `github.com/gen2brain/malgo`.
- - Cross-platform capture target: 16 kHz, 16-bit, mono.
-- Hotkey:
- - macOS: `privatevoice.src/internal/hotkey/hotkey_darwin.go`
- - Windows: `privatevoice.src/internal/hotkey/hotkey_windows.go`
-- Text input:
- - macOS: `privatevoice.src/internal/input/paste_darwin.go`
- - Windows: `privatevoice.src/internal/input/paste_windows.go`
-- ASR engine:
- - macOS: `privatevoice.src/internal/engine/engine_darwin.go`
- - Windows: `privatevoice.src/internal/engine/engine_windows.go`
- - Linux: `privatevoice.src/internal/engine/engine_linux.go`
- - SenseVoice profiles may set `Profile.LanguageParam`; Cantonese uses `yue`.
-- Overlay:
- - macOS: `privatevoice.src/internal/overlay/overlay_darwin.go`
- - Windows: `privatevoice.src/internal/overlay/overlay_windows.go`
+## 自动图谱与维护
-## Windows Preview Scope
-
-- Windows preview supports `SenseVoice` only.
-- Non-SenseVoice models remain visible in settings but are disabled through `model.IsModelSupportedInCurrentBuild`.
-- Windows unsupported reason: `windows_preview_unsupported`.
-- Windows overlay remains native Win32/GDI+, with a larger translucent spectrum-style capsule indicator for recording states.
-- Build script: `privatevoice.src/scripts/build-windows-preview.sh`.
-- Evidence verifier: `privatevoice.src/scripts/verify-windows-qa-evidence.sh`.
-- Runtime package includes:
- - `PrivateVoice Dictation.exe`
- - `onnxruntime.dll`
- - `sherpa-onnx-c-api.dll`
- - `sherpa-onnx-cxx-api.dll`
- - `RUN-WINDOWS-QA.cmd`
- - `QA-WINDOWS-PREVIEW.ps1`
- - `README-WINDOWS-PREVIEW.txt`
-
-## macOS Local Package Scope
-
-- Local DMG script: `privatevoice.src/scripts/build-local-macos.sh`.
-- Universal DMG script: `privatevoice.src/scripts/build-local-macos-universal.sh`.
-- Local macOS package set for this branch:
- - `arm64` DMG for Apple Silicon.
- - `x86_64` DMG for Intel Mac.
- - `universal` DMG for Intel + Apple Silicon.
-- Mainline macOS local packages keep `LSMinimumSystemVersion=14.0` and the default Qwen3-capable dependency line.
-- Monterey-compatible packages remain a separate build line through `privatevoice.src/scripts/build-local-macos-monterey.sh`.
-
-## Standard Verification Commands
-
-Run from `privatevoice.src`:
-
-```bash
-npm --prefix frontend run build
-go test ./...
-GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ go test -exec=/usr/bin/true ./...
-./scripts/build-windows-preview.sh
-./scripts/build-local-macos.sh arm64
-./scripts/build-local-macos.sh x86_64
-./scripts/build-local-macos-universal.sh
-./scripts/verify-windows-qa-evidence.sh /path/to/qa-evidence-YYYYMMDD-HHMMSS.zip
-```
-
-## Known Gaps
-
-- Windows runtime QA must still be performed on Windows 10/11 hardware.
-- Run `RUN-WINDOWS-QA.cmd` from the extracted preview package to collect WebView2/audio preflight, startup, engine, recording, recognition, paste, and Notepad target text evidence.
-- After evidence is returned, run `verify-windows-qa-evidence.sh` and require `WINDOWS_QA_EVIDENCE_PASS` before claiming the goal complete.
-- The Windows preview zip is unsigned and not an installer.
-- SmartScreen / Defender prompts are expected for local testing.
+- 生成命令：`codebase-memory-mcp cli index_repository '{"repo_path":"/Users/ar/Projects/PrivateVoice/03-O"}'`
+- `CODEGRAPH.md` 是人工代码地图；每次源码冻结、版本冻结或发布候选前更新并记录 indexed commit。
--
Gitblit v1.9.3