workspace/
├── .synapse/ # 系统目录
│ ├── config.yaml # 全局配置
│ ├── index.db # SQLite 索引
│ └── hooks/ # Git hooks
├── personal/ # namespace
│ ├── .synapse.yaml # namespace 配置
│ ├── 10/ # Area 10: 个人管理
│ │ ├── 001/ # Category 001: 任务
│ │ │ ├── 10.001.0001-task-完成报告.md
│ │ │ └── 10.001.0002-task-学习计划.md
│ │ └── 002/ # Category 002: 笔记
│ │ └── 10.002.0001-note-学习笔记.md
│ └── 11/ # Area 11: 会议
│ └── 001/
│ └── 11.001.0001-meeting-周会.md
├── work-project/
│ ├── .synapse.yaml
│ └── 20/
│ └── 001/
│ ├── 20.001.0001-meeting-需求评审.md
│ └── 20.001.0002-task-开发任务.md
└── _inbox/ # 特殊 namespace
└── 00/
└── 000/ # Inbox 固定使用 00.000
├── 00.000.0001-unprocessed-快速记录.md
└── 00.000.0002-unprocessed-临时想法.md
**设计说明**:
- **双层分桶**:Area → Category,避免单目录大量文件
- 每个 Category 目录最多 9999 个文件,人眼可管理
- 查询走 SQLite 索引,目录层级不影响性能
- Area/Category 子目录由系统自动创建
---
## 4. 用户界面
### 4.1 统一命令设计
CLI 和 TUI 使用统一的命令/操作命名:
| 操作 | CLI 命令 | TUI 快捷键 | 说明 |
|------|----------|------------|------|
| 新建 |
syn new [type] | n | 创建新资源 || 列表 |
syn list [type] | l | 列表视图 || 查看 |
syn show <id> | Enter | 查看详情 || 编辑 |
syn edit <id> | e | 编辑资源 || 删除 |
syn delete <id> | d | 删除资源 || 搜索 |
syn search <query> | / | 搜索过滤 || 日历 |
syn calendar | c | 日历视图 || 时间线 |
syn timeline | t | 时间线视图 || 图谱 |
syn graph | g | 图谱视图 |### 4.2 CLI 命令示例
# TUI 启动
syn
# 资源操作
syn new task --title "完成设计" --priority high --due 2024-01-15
syn new note --title "会议记录"
syn list task --status todo
syn show 10.001.0015 # 完整 ID
syn show 10.1.15 # 短 ID(自动补零)
syn show 15 # 最短 ID(当前 Namespace 内唯一)
syn edit 10.001.0015
syn delete 10.001.0015
syn search "kubernetes" --type note --tag devops
# Inbox 操作
syn inbox list
syn inbox process
syn inbox move <id> --to <namespace> --type <type>
# 回顾操作
syn review daily
syn review weekly
# Namespace 操作
syn ns list
syn ns new my-project
syn ns switch work-project
### 4.3 TUI 快捷键
| 快捷键 | 功能 |
|--------|------|
|
n | 新建资源 ||
e | 编辑(外部编辑器) ||
d | 删除 ||
a | 归档/取消归档(切换 archived 状态) ||
/ | 搜索/Fuzzy Finder ||
Enter | 查看详情 ||
Space | 切换活跃状态(见 §4.5 状态循环) ||
r | 刷新 ||
q | 退出/返回 ||
? | 帮助 ||
Ctrl+P | 命令面板 ||
l | 列表视图 ||
c | 日历视图 ||
t | 时间线视图 ||
g | 图谱视图 ||
0 | 切换到 Inbox ||
1-9 | 切换 Namespace |### 4.4 命令面板 (Command Palette)
参考 VS Code / Obsidian 的交互逻辑,区分不同模式:
| 快捷键 | 模式 | 功能 |
|--------|------|------|
|
Ctrl+P | 文件跳转 | Fuzzy Search Title/ID ||
Ctrl+Shift+P 或 > | 命令执行 | 执行命令 ||
# | Tag 搜索 | 按标签过滤 ||
@ | 范围搜索 | 按 Namespace/Area 过滤 |**交互示例**:
`┌─────────────────────────────────────────────┐
│ 设计文档 │ ← 默认:文件跳转
├─────────────────────────────────────────────┤
│ 10.001.0015 - 完成项目设计 │
│ 10.002.0003 - 设计规范笔记 │
└─────────────────────────────────────────────┘
┌─────────────────────────────────────────────┐
│ > review │ ← 命令模式
├─────────────────────────────────────────────┤
│ syn review daily │
│ syn review weekly │
└─────────────────────────────────────────────┘
┌─────────────────────────────────────────────┐
│ #urgent │ ← Tag 搜索
├─────────────────────────────────────────────┤
│ 10.001.0015 - 紧急任务 [urgent, work] │
└─────────────────────────────────────────────┘