docs: 新增项目文档并更新开发规则
- 新增品牌命名、商业化策略、SDK视觉噪音处理、可视化库设计和系统架构文档 - 更新开发规则,明确禁止主动修改项目源代码文件 - 所有文档均为中文编写,用于记录项目设计讨论和决策
This commit is contained in:
47
.trae/documents/brand-naming.md
Normal file
47
.trae/documents/brand-naming.md
Normal file
@@ -0,0 +1,47 @@
|
||||
# Structrail 品牌命名解读
|
||||
|
||||
## 1. 命名构成
|
||||
|
||||
- **项目名称**:Structrail
|
||||
- **构词方式**:`Struct` + `t` + `rail` (共享字母 `t` 的混成词)
|
||||
- **核心双关**:
|
||||
- Struct **Trail** (数据轨迹)
|
||||
- Struct **Rail** (结构轨道)
|
||||
|
||||
## 2. 核心释义:Struct Trail (数据轨迹)
|
||||
|
||||
这是最贴切且最具动态感的解释,直接映射了项目的核心价值——**可视化数据结构的演变过程**。
|
||||
|
||||
* **与 Tracer (跟踪器) 的呼应**:
|
||||
* 核心组件 `Tracer` 的作用是记录数据结构的变化。
|
||||
* 每一次变化都在时间维度上留下了一个 `Trail` (痕迹/足迹)。
|
||||
* 用户通过 `Tracer` 追踪到了数据的 `Trail`。
|
||||
|
||||
* **Time Travel (时间旅行) 的隐喻**:
|
||||
* `Trail` 暗示了一条可以沿着往返的小径。
|
||||
* 支持“上一步”、“下一步”的操作,就像沿着留下的面包屑 (breadcrumbs) 在历史轨迹中穿梭。
|
||||
* 用户可以随时回溯,查看数据在某一时刻的状态。
|
||||
|
||||
* **Debugging (调试) 的本质**:
|
||||
* 算法执行的过程,本质上就是数据状态在时间流中留下的一条长长的轨迹。
|
||||
* 调试就是沿着这条轨迹寻找异常点。
|
||||
|
||||
## 3. 双关释义:Struct Rail (结构轨道)
|
||||
|
||||
作为第二层含义,`Rail` 为项目增添了稳固感和基础设施的韵味。
|
||||
|
||||
* **规范与引导 (On the Rails)**:
|
||||
* `Rail` 暗示了“轨道”,意味着代码在既定的逻辑轨道上运行。
|
||||
* 可视化的目的之一是确保算法逻辑“在正轨上” (Stay on the rails),帮助用户发现何时“脱轨” (Off the rails)。
|
||||
|
||||
* **基础设施感 (Infrastructure)**:
|
||||
* 像 *Ruby on Rails* 一样,`Rail` 给人一种坚实底座的感觉。
|
||||
* 暗示 Structrail 是承载算法运行、支撑可视化功能的坚实平台。
|
||||
|
||||
## 4. 结论与建议
|
||||
|
||||
建议以 **Struct Trail** 作为品牌叙事的核心,强调“追踪”、“轨迹”和“时间旅行”的概念,同时保留 **Struct Rail** 作为一种有趣的双关解读,暗示平台的稳定性和规范性。
|
||||
|
||||
**Slogan 构思:**
|
||||
> **Structrail**: Visualize the **trail** of your data structures.
|
||||
> (Structrail:可视化你数据结构的轨迹。)
|
||||
Reference in New Issue
Block a user