08 · 实施
总览
本层定位
08 · 实施收录 Xisound 六大技术栈的实现级文档——与代码仓库 1:1 mirror，工程师"写模块 = 写文档"。 主笔模式：AI 辅助生成草稿 + 工程师校对合入，CI 扫描保证文档-代码同步。
🧩 六大技术栈
-
:material-music-note: DSP 算法栈
DSP 模块化实现：Channel Map / Delay / Dynamics / EQ / Mixer / Mixing / Sound Design / Spatial / Voice Logic
技术栈：
C native·DLL·9 modules -
:material-language-csharp: C# 后端栈
Xisound 主控后端实现，提供 SignalR 实时通讯、音频管道编排、Preset 持久化。
技术栈：
ASP.NET Core 8·NAudio·SignalR -
:material-vuejs: Vue3 前端栈
Xisound 桌面端 IDE 实现：模块画布、参数 Tuning、波形可视化、Signal Flow 编辑。
技术栈：
Vue 3·Pinia·Vite -
:material-language-python: PySidecar 栈
Python 旁路服务：算法热重载、批处理工作流、机器学习推理后端。
技术栈：
Python·FastAPI -
:material-web: Web Astro 栈
Xisound 官网 / 营销站 / 文档站构建栈，支持 SSG/SSR 混合渲染。
技术栈：
Astro 4·TypeScript -
:material-function-variant: 算法原型栈
DSP + ML 算法源码库，跨产品共享的算法实现与原型仿真。
技术栈：
MATLAB/Python/C
🚀 快速入口
我是工程师，刚入职某个栈
进入对应栈的子目录，从 index.md 开始阅读，按目录中的实施文档逐项完成本地环境搭建与首个模块改造。
我是技术负责人，需要审阅技术决策
- DSP 模块定制约束 →
10-dsp-algo/module-customization.md - DSP 模块分析（AWE）→
10-dsp-algo/module-analysis/awe.md - 各栈实施进度 → 进入对应栈的
index.md查看 status
我是文档作者，需要规范
- MD 写作规范 →
05-standards/md-writing-spec.md - 文档编号规范 →
05-standards/doc-numbering.md - 跨部门交付索引 →
05-standards/release-to-other-depts.md
🔄 代码-文档同步约束
flowchart LR
A[PR 修改代码] --> B{CI job<br/>docs-sync-check}
B -->|文档未更新| C[❌ 拒绝合并]
B -->|文档已更新| D[✅ 允许合并]
classDef xyDefault fill:#0B1C2E,stroke:#D4A574,color:#fff
classDef xyDecision fill:#1E3A52,stroke:#D4A574,color:#fff
classDef xyError fill:#E24A5B,stroke:#E24A5B,color:#fff
classDef xySuccess fill:#3FB47F,stroke:#3FB47F,color:#fff
class A xyDefault
class B xyDecision
class C xyError
class D xySuccess硬规则
修改 04_development/backend_csharp/Controllers/*.cs → 必须同步更新 08-implementation/20-backend-csharp/ 下对应 .md。
未同步的 PR 将被 CI job 自动阻断。
📌 历史追溯
本目录原 D 系列编号为 D4 · 实现级文档（legacy_doc_id D4-IMPL-000），P2 阶段 IA-v3 重构后更名为 08 · 实施。原 D 系列规划的"6 子项目 × 10 标准模板 = 60 份"目标继续保留，落地范围由各栈 owner 按实际推进。
Xisound 08 · 实施 · v2.0 · 2026-05-13