Ariver
2026-07-13 2d1d4ad406228ef62ab078724cb7d1556e003d01
chore: point independent project metadata to unified root
6 files modified
63 ■■■■ changed files
AGENTS.md 2 ●●● patch | view | raw | blame | history
C1.source/AGENTS.md 12 ●●●● patch | view | raw | blame | history
C1.source/CODEGRAPH.md 12 ●●●● patch | view | raw | blame | history
C2.builds/README.md 7 ●●●●● patch | view | raw | blame | history
CODEGRAPH.md 10 ●●●● patch | view | raw | blame | history
K2.项目管理/新窗口接手指南.md 20 ●●●● patch | view | raw | blame | history
AGENTS.md
@@ -1,6 +1,6 @@
# PrivateVoice-independent-developer 03-O 局部规则
- 本目录是 `/Users/ar/Projects/PrivateVoice-independent-developer` 的 Git 根,当前分支为 `independent-developer`。
- 本目录是 `/Users/ar/Projects/PrivateVoice` 的 Git 根,当前分支为 `independent-developer`。
- 当前源码根:`C1.source/`;代码地图:`CODEGRAPH.md`。
- 进入源码前先读取项目根 `AGENTS.md`、`PROJECT.md`、`02-P/进度地图.md` 和本目录代码地图。
- `C2.builds/` 放本地构建和发布候选,`K2.项目管理/` 放证据与门禁,`K3.运营与发布资料/` 放独立分发资料。
C1.source/AGENTS.md
@@ -6,19 +6,19 @@
涉及源码、测试、构建、模块边界或非平凡实现时,先读:
1. `/Users/ar/Projects/PrivateVoice-independent-developer/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice-independent-developer/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/README.md`
4. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/CODEGRAPH.md`
1. `/Users/ar/Projects/PrivateVoice/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice/03-O/README.md`
4. `/Users/ar/Projects/PrivateVoice/03-O/CODEGRAPH.md`
5. 当前 Round 的产品定义、技术方案和验收文档
6. 涉及 UI 时读 `/Users/ar/Projects/PrivateVoice-independent-developer/DESIGN.md`
6. 涉及 UI 时读 `/Users/ar/Projects/PrivateVoice/DESIGN.md`
## 代码规则
- 只实现当前任务直接需要的代码。
- 复用系统能力和现有模块,不为一次性需求创建抽象层。
- 不把输入资料中的功能直接当成已确认需求。
- Git 命令默认在 `/Users/ar/Projects/PrivateVoice-independent-developer/03-O` 执行,而不是本目录。
- Git 命令默认在 `/Users/ar/Projects/PrivateVoice/03-O` 执行,而不是本目录。
- 新增或移动源码后,同步更新上级 `../CODEGRAPH.md`。
- 构建、测试、QA 脚本优先放到 `../C3.tools/`,除非工程工具链要求必须随源码放置。
- 自动图谱结果只能辅助定位,不能替代对真实源码、测试和 QA 证据的回读。
C1.source/CODEGRAPH.md
@@ -10,11 +10,11 @@
## 计划源码根
`/Users/ar/Projects/PrivateVoice-independent-developer/03-O/C1.source`
`/Users/ar/Projects/PrivateVoice/03-O/C1.source`
## 与参考代码库的边界
- `/Users/ar/Projects/PrivateVoice-independent-developer/01-I/p.refNN.<name>/` 可保存开源项目、外部代码库和关键代码逻辑,供后续参考、对齐和分析。
- `/Users/ar/Projects/PrivateVoice/01-I/p.refNN.<name>/` 可保存开源项目、外部代码库和关键代码逻辑,供后续参考、对齐和分析。
- 参考代码库不是当前项目源码,不能直接登记为本文件的模块事实。
- 只有经过 `02-P/` 当前 Round 分析并被采纳的技术结论,才回写到本文件。
@@ -37,10 +37,10 @@
## 当前事实来源
- `/Users/ar/Projects/PrivateVoice-independent-developer/PROJECT.md`
- `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/进度地图.md`
- `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/Round00-Foundation/00-任务入口.md`
- `/Users/ar/Projects/PrivateVoice-independent-developer/01-I/`
- `/Users/ar/Projects/PrivateVoice/PROJECT.md`
- `/Users/ar/Projects/PrivateVoice/02-P/进度地图.md`
- `/Users/ar/Projects/PrivateVoice/02-P/Round00-Foundation/00-任务入口.md`
- `/Users/ar/Projects/PrivateVoice/01-I/`
## 后续维护要求
C2.builds/README.md
@@ -1,9 +1,10 @@
# C2.builds
本目录保存迁移时保留的当前候选包。
本目录保存 independent-developer 分支的本地候选包。
当前迁入:
当前保留:
- `PrivateVoice-Dictation-2.2.0-build20260702.0303/`
- `PrivateVoice-Dictation-2.2.2-build20260703.0335/`:2.2.1 修复内容冻结后的四包真实用户测试候选。
二进制 `.dmg` 和 `.zip` 默认不提交 Git;本地文件用于当前机器接手、校验和分发准备。长期事实以 `RELEASE_MANIFEST.md`、`SHA256SUMS.txt`、`K2.项目管理/发布地图.md` 和会话主题摘要为准。
二进制 `.dmg` 和 `.zip` 默认不提交 Git;本地文件用于当前机器接手、校验和分发准备。2.2.2 四包包括三个 macOS DMG 和一个 Windows preview ZIP。长期事实以各候选目录中的 `RELEASE_MANIFEST.md`、`SHA256SUMS.txt`、`K2.项目管理/发布地图.md` 和会话主题摘要为准。
CODEGRAPH.md
@@ -4,13 +4,13 @@
## 工程范围
- 项目根:`/Users/ar/Projects/PrivateVoice-independent-developer`
- Git 根:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O`
- 项目根:`/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-independent-developer/03-O/C1.source/privatevoice.src`
- 自动图谱:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O/.codebase-memory/`;只辅助定位。
- 源码根:`/Users/ar/Projects/PrivateVoice/03-O/C1.source/privatevoice.src`
- 自动图谱:`/Users/ar/Projects/PrivateVoice/03-O/.codebase-memory/`;只辅助定位。
## 核心入口
@@ -30,5 +30,5 @@
## 自动图谱与维护
- 生成命令:`codebase-memory-mcp cli index_repository '{"repo_path":"/Users/ar/Projects/PrivateVoice-independent-developer/03-O"}'`
- 生成命令:`codebase-memory-mcp cli index_repository '{"repo_path":"/Users/ar/Projects/PrivateVoice/03-O"}'`
- `CODEGRAPH.md` 是人工代码地图;每次源码冻结、版本冻结或发布候选前更新并记录 indexed commit。
K2.项目管理/新窗口接手指南.md
@@ -2,26 +2,26 @@
## 必读顺序
1. `/Users/ar/Projects/PrivateVoice-independent-developer/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice-independent-developer/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/进度地图.md`
4. `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/事件地图.md`
5. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/CODEGRAPH.md`
6. `/Users/ar/Projects/PrivateVoice-independent-developer/03-O/K2.项目管理/迁移资产清单.md`
1. `/Users/ar/Projects/PrivateVoice/AGENTS.md`
2. `/Users/ar/Projects/PrivateVoice/PROJECT.md`
3. `/Users/ar/Projects/PrivateVoice/02-P/进度地图.md`
4. `/Users/ar/Projects/PrivateVoice/02-P/事件地图.md`
5. `/Users/ar/Projects/PrivateVoice/03-O/CODEGRAPH.md`
6. `/Users/ar/Projects/PrivateVoice/03-O/K2.项目管理/迁移资产清单.md`
## 接手事实
- Git 根:`/Users/ar/Projects/PrivateVoice-independent-developer/03-O`
- Git 根:`/Users/ar/Projects/PrivateVoice/03-O`
- 分支:`independent-developer`
- 代码基线:`a075aec1` / `v2.2.2-build20260703.0335-real-user-test`
- 当前任务只从 `/Users/ar/Projects/PrivateVoice-independent-developer/02-P/进度地图.md` 领取。
- 当前任务只从 `/Users/ar/Projects/PrivateVoice/02-P/进度地图.md` 领取。
- MAS 是另一项目,不共享工作树、任务或发布结论。
## 接手自检
```bash
git -C /Users/ar/Projects/PrivateVoice-independent-developer/03-O status --short --branch
git -C /Users/ar/Projects/PrivateVoice-independent-developer/03-O diff --check
git -C /Users/ar/Projects/PrivateVoice/03-O status --short --branch
git -C /Users/ar/Projects/PrivateVoice/03-O diff --check
```
涉及源码、构建、QA 或发布时,再按 `CODEGRAPH.md` 和项目全局规则执行对应门禁;本迁移没有运行构建或发布。