Skip to content

Commit 3894542

Browse files
AparenciaAparencia
committed
docs: 文档总导航整理与临时副本清理（Foresight/adr 区块、版本文档索引、移除 3 个临时文件）
1 parent e65035c commit 3894542

8 files changed

Lines changed: 102 additions & 157 deletions

File tree

‎docs/README.md‎

Lines changed: 55 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 熵减 (Entropydecrease) 项目文档
22

3-
> 重组版（4 目录结构）：开发规范 / 产品设计 / 版本规划 / 模板。
3+
> 文档总导航。目录结构：开发规范 / 产品设计 / 前瞻构想 / 架构决策 / 版本规划 / 模板 / 知识库，共 7 个区块。
44
55
## 📐 standards/ — 开发规范
66

@@ -41,24 +41,73 @@
4141
| [pain-points.md](./product/pain-points.md) | 网课学习全链路痛点图谱 |
4242
| [requirements-pool.md](./product/requirements-pool.md) | 需求池（含立项规划精要附录） |
4343
| [migration-spec.md](./product/migration-spec.md) | 项目迁移与重构规范（含各阶段收尾结论与豁免清单） |
44+
| [entropy-visualization-constitution.md](./product/entropy-visualization-constitution.md) | 熵可视化设计宪法（单范式宣言，视觉/体验设计最高规范） |
45+
| [mcp-learning-memory-interface.md](./product/mcp-learning-memory-interface.md) | MCP 学习记忆服务器接口清单草案（P2 战略项） |
46+
| [ai-era-survival-positioning.md](./product/ai-era-survival-positioning.md) | 熵减 · AI 时代生存定位（三层防御纵深） |
47+
| [revenue-plan-no-license.md](./product/revenue-plan-no-license.md) | 收入方案（无工商户版） |
4448
| [beta-tester-intro.md](./product/beta-tester-intro.md) | 内测简介（面向内测用户） |
4549
| [beta-recruitment-playbook.md](./product/beta-recruitment-playbook.md) | 内测招募与运营手册（招募→筛选→增长→运营→过渡全链路） |
4650
| [beta-recruitment-announcement.md](./product/beta-recruitment-announcement.md) | 内测用户招募公告（含一分钟短版 + 完整版） |
4751
| [beta-agreement.md](./product/beta-agreement.md) | 内测协议简版（双方权责、数据处理、风险告知、退出机制） |
4852
| [beta-tier-management.md](./product/beta-tier-management.md) | 内测用户分层管理方案（三层标准、升降级、各层运营动作） |
53+
| [beta-exclusive-system.md](./product/beta-exclusive-system.md) | 内测人员专属系统设计方案（身份权益体系） |
4954

50-
## 🗓 versions/ — 版本规划（扁平化）
55+
## 🔭 Foresight/ — 前瞻构想
5156

52-
v0.3.0 ~ v1.1.0 各版本一个文件；v0.3.0/v0.4.0 为多文档合集（含发版计划/需求追溯/开发文档/测试标准）。
57+
> 未排期的战略构想、设计文档与头脑风暴。已立项内容会移入 `product/` 或 `versions/` 跟踪。
58+
59+
### 战略与设计
60+
61+
| 文档 | 主题 |
62+
|------|------|
63+
| [ai-era-competitiveness-strategy.md](./Foresight/ai-era-competitiveness-strategy.md) | AI 时代竞争力战略分析：熵减如何避免被通用 AI 淘汰 |
64+
| [ai-assistant-companion-design.md](./Foresight/ai-assistant-companion-design.md) | AI 深海学伴助手设计文档 |
65+
| [ai-assistant-implementation-plan.md](./Foresight/ai-assistant-implementation-plan.md) | AI 深海学伴助手实现计划 |
66+
| [ai-gateway-optimization-plan.md](./Foresight/ai-gateway-optimization-plan.md) | AI 网关与调用机制优化方案 |
67+
| [innovation-features-catalog.md](./Foresight/innovation-features-catalog.md) | 产品创新功能全景目录 |
68+
| [sop-custom-design.md](./Foresight/sop-custom-design.md) | 用户自定义 SOP 设计考虑 |
69+
70+
### 头脑风暴
71+
72+
| 文档 | 主题 |
73+
|------|------|
74+
| [course-preset-brainstorm.md](./Foresight/course-preset-brainstorm.md) | 课程预设（Course Preset）头脑风暴 |
75+
| [first-dive-onboarding-brainstorm.md](./Foresight/first-dive-onboarding-brainstorm.md) | 「首潜」新手引导系统头脑风暴与系统设计 |
76+
| [focus-guardian-nurture-brainstorm.md](./Foresight/focus-guardian-nurture-brainstorm.md) | 深潜守护与养成系统头脑风暴 |
77+
| [pomodoro-customization-brainstorm.md](./Foresight/pomodoro-customization-brainstorm.md) | 番茄钟（深潜）自定义功能头脑风暴 |
78+
| [sop-module-brainstorm.md](./Foresight/sop-module-brainstorm.md) | SOP（标准作业程序）功能模块头脑风暴 |
79+
80+
## 🗺️ adr/ — 架构决策记录
81+
82+
> 重要技术决策的背景、备选方案与权衡。索引见 [adr/README.md](./adr/README.md)，规范见 [adr.md](./standards/adr.md)。
83+
84+
| 编号 | 标题 | 状态 |
85+
|------|------|------|
86+
| [ADR-001](./adr/ADR-001-audio-capture-process-loopback.md) | 音频采集采用进程环回与端点环回双源互补 | 已接受 |
87+
88+
## 🗓 versions/ — 版本规划
89+
90+
各版本深度文档（发版计划 / 需求追溯 / 总结报告），**扁平存储**：单文件版本与目录合集（`v0.23.0/`、`v0.34.0/`）并存。
91+
92+
| 版本 | 文档 |
93+
|------|------|
94+
| v0.34.0 | [功能审计与修复总结报告](./versions/v0.34.0/00-功能审计与修复总结报告.md) |
95+
| v0.27.0 | [v0.27.0.md](./versions/v0.27.0.md) |
96+
| v0.23.0 | [阶段性工作总结报告](./versions/v0.23.0/00-阶段性工作总结报告.md) |
97+
| v0.10.0 ~ v0.11.0 | [v0.10.0.md](./versions/v0.10.0.md) / [v0.11.0.md](./versions/v0.11.0.md) |
98+
| v0.3.0 ~ v0.9.0 | [v0.3.0.md](./versions/v0.3.0.md) ~ [v0.9.0.md](./versions/v0.9.0.md) |
99+
100+
> 中间缺失版本（v0.12.0 ~ v0.22.0、v0.24.0 ~ v0.26.0、v0.28.0 ~ v0.33.0）未沉淀深度文档，变更记录见根目录 [CHANGELOG.md](../CHANGELOG.md)。
53101
54102
## 📋 templates/ — 文档模板
55103

56-
ADR、头脑风暴、估算、数据库迁移、知识卡片、MVP 画布、复盘、PRD、发布清单、Sprint 回顾、第三方评估共 11 个模板。
104+
ADR、头脑风暴、估算、数据库迁移、知识卡片、MVP 画布、复盘、PRD、发布清单、Sprint 回顾、第三方评估共 11 个模板，直接见 [templates/](./templates/) 目录。
57105

58106
## 📚 knowledge/ — 知识库
59107

60-
踩坑记录 / 技术方案 / 学习笔记，按 [知识管理规范](./standards/knowledge-management.md) 组织。索引见 [knowledge/index.md](./knowledge/index.md)。
108+
踩坑记录 / 技术方案 / 学习笔记，按 [知识管理规范](./standards/knowledge-management.md) 组织。完整索引见 [knowledge/index.md](./knowledge/index.md)。
61109

62110
---
63111

64-
*重组记录：原 10 目录 78+ 文件 → 4 目录；合并去重与去向对照清单见 [migration-spec.md](./product/migration-spec.md) 附录。*
112+
*重组记录：原 10 目录 78+ 文件 → 7 区块；合并去重与去向对照清单见 [migration-spec.md](./product/migration-spec.md) 附录。*
113+
*整理记录（2026-08）：新增 Foresight/adr 导航区块，补全 product 索引缺失项；移除 3 个临时副本文件（beta-agreement_facetouser.md、beta-recruitment-announcement facetouese.md、软件简介重制2.docx）。*

‎docs/knowledge/index.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
| 2026-08-02 | [ASR 报错「whisper.cpp 执行失败」在代码库零匹配：运行构建落后源码 8 个版本](./bugs/2026-08-asr-whisper-cpp-stale-build-mismatch.md) | #ASR #版本错位 #sherpa-onnx #构建产物 #诊断方法 |
1212
| 2026-08-01 | [3D 动画有时不显示/不流畅：性能分级无滞回导致 tier 抖动，特效反复卸载；后台返回误判降级](./bugs/2026-08-3d-tier-flapping-animation-hitching.md) | #3D性能 #R3F #性能分级 #滞回 #drei #WebGL |
1313
| 2026-08-01 | [首页 3D 物体点击与功能错位：浅色模式下背景场景重复渲染了一套“只改状态不跳转”的行星](./bugs/2026-08-homepage-3d-duplicate-planets-misaligned-click.md) | #3D导航 #react-three-fiber #职责边界 #单一数据源 #浅色模式 |
14+
| 2026-08-01 | [页面主题“有时亮有时暗”：useTheme 多实例竞态覆盖 data-theme](./bugs/2026-08-theme-flicker-multi-instance-race.md) | #主题 #竞态 #Zustand #useState多实例 #data-theme #内测反馈 |
1415
| 2026-07-31 | [CI 编译原生模块报「Could not find any Visual Studio installation」——旧版 node-gyp 找不到 VS 2022](./bugs/2026-07-ci-node-gyp-vs2022-not-found.md) | #CI #原生模块 #node-gyp #本地能跑CI挂 |
1516
| 2026-07-31 | [课堂助手精细采集三症状：视觉抓页面元数据、ASR 静音幻觉、截断 JSON 泄漏 UI](./bugs/2026-07-classroom-capture-asr-hallucination-json-leak.md) | #课堂助手 #多模态 #ASR幻觉 #prompt工程 |
1617
| 2026-07-31 | [番茄钟"跳过"退化为"取消"：一个 onClose 回调承载两种意图，空目标番茄无法启动](./bugs/2026-07-pomodoro-goal-skip-acts-as-cancel.md) | #React #番茄钟 #弹窗交互 #回调语义 #意图区分 |
@@ -37,6 +38,6 @@ _（暂无）_
3738

3839
## 标签速查
3940

40-
- **技术**：#CSS #a11y #React #Vite #Tailwind #Zustand #CI #GitLFS #electron-builder #GitHubActions #CDN #阿里云 #环境变量 #Supabase #DesignTokens #color-mix #认证 #AuthGuard #3D导航 #react-three-fiber #3D性能 #R3F #drei #WebGL #ASR #sherpa-onnx
41+
- **技术**：#CSS #a11y #React #Vite #Tailwind #Zustand #CI #GitLFS #electron-builder #GitHubActions #CDN #阿里云 #环境变量 #Supabase #DesignTokens #color-mix #认证 #AuthGuard #3D导航 #react-three-fiber #3D性能 #R3F #drei #WebGL #ASR #sherpa-onnx #data-theme
4142
- **类型**：#bug #方案 #学习 #复盘
42-
- **模块**：#启动仪式 #reduced-motion #animation #发布 #安装包 #性能诊断 #测量方法 #番茄钟 #主题 #状态管理 #副作用 #数据统计 #路由守卫 #模式管理 #事件去重 #弹窗交互 #回调语义 #意图区分 #职责边界 #单一数据源 #浅色模式 #性能分级 #滞回 #版本错位 #构建产物 #诊断方法
43+
- **模块**：#启动仪式 #reduced-motion #animation #发布 #安装包 #性能诊断 #测量方法 #番茄钟 #主题 #状态管理 #副作用 #数据统计 #路由守卫 #模式管理 #事件去重 #弹窗交互 #回调语义 #意图区分 #职责边界 #单一数据源 #浅色模式 #性能分级 #滞回 #版本错位 #构建产物 #诊断方法 #竞态 #useState多实例 #内测反馈

‎docs/product/beta-agreement_facetouser.md‎

Lines changed: 0 additions & 68 deletions
This file was deleted.

‎docs/product/beta-recruitment-announcement facetouese.md‎

Lines changed: 0 additions & 80 deletions
This file was deleted.

‎docs/product/brand-story.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
1-
熵减 · 品牌故事
1+
# 熵减 · 品牌故事
2+
23
潜入深海，拾起认知的微光。
34
起源：深夜里的一点微光
45
故事始于一个再平常不过的深夜。屏幕亮着，网课还在播放，笔记记了一半，思绪却早已飘散。你回头翻看今天学了什么，发现大脑像一片被搅浑的海——信息沉不下去，也浮不上来，只是混沌地悬在那里。那一刻你意识到：遗忘不是意外，而是常态。知识如果不被主动拾起，就会像深海中的光，亮了一瞬，随即被黑暗吞没。这不是你一个人的困境。每一个在深夜独自打开屏幕的人，都在这片认知深海里独自下潜——没有灯塔，没有回声，只有自己和不断沉降的碎片。熵减，就诞生于这个念头：能不能有人，陪你一起潜入深处，把那些散落的微光一一拾起？

0 commit comments

Comments
 (0)