56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
# Zhixu（知序）
|
||
|
||
Zhixu 是一个「原生优先」的个人知识与任务系统，优先解决两件事：**信息管理混乱**与**多端同步困难**。当前策略是先把 Android 原生端做稳，同时在底层统一数据格式、协议与语义，确保未来 Web / Desktop 能复用“核心”而不是复用 UI。
|
||
|
||
产品定位：**AI 原生的个人知识与任务管理系统**（隐私优先），并逐步强化会议场景能力（OCR/录音/转写/行动项）。
|
||
|
||
## 官方方案（方案 A：原生优先·终局兼容）
|
||
|
||
- 方案总览：`docs/plan-a-native-first.md`
|
||
- Vault 规范：`docs/vault-spec.md`
|
||
- 任务语法：`docs/task-syntax.md`
|
||
- 编辑器方案：`docs/editor-spec.md`
|
||
- 同步协议：`docs/sync-protocol.md`
|
||
- WebDAV MVP 计划：`docs/webdav-mvp-plan.md`
|
||
- 路线图：`docs/roadmap.md`
|
||
- v0.1 执行计划：`docs/v0.1-execution-plan.md`
|
||
- v0.2 执行计划：`docs/v0.2-execution-plan.md`
|
||
|
||
## v0.1 MVP（已开始落地）
|
||
|
||
- Vault：选择一个文件夹作为 `VaultRoot/`，应用会自动确保 `docs/`、`attachments/`、`.zhixu/` 结构存在，并在 `docs/` 下创建示例 `Inbox.md`
|
||
- Docs：支持 Markdown 文档列表/新建/删除，点击进入编辑
|
||
- Editor：基础纯文本编辑 + 一键 Preview（Markdown 渲染）
|
||
- Tasks：保存时自动为任务行补全缺失的 `@id(<ulid>)`（见 `docs/task-syntax.md`）
|
||
|
||
## 开发与运行
|
||
|
||
```bash
|
||
cd ZhiXu
|
||
./gradlew :apps:zhixu-android:assembleDebug
|
||
```
|
||
|
||
## 许可与商业化（开源 + 收费落地）
|
||
|
||
- 客户端（Android / Desktop）：Apache-2.0（本仓库）
|
||
- 云服务（同步托管 / 转写 / AI 代理）：独立闭源服务或独立仓库
|
||
- 第三方项目参考（如 flymd）：不复制代码，仅参考协议/数据设计
|
||
|
||
## 目录规划（Core-first）
|
||
|
||
> 代码尚未落地前先对齐边界：Android UI 原生实现；跨端复用走 `core`。
|
||
|
||
```
|
||
zhixu/
|
||
├─ apps/
|
||
│ └─ zhixu-android/
|
||
├─ core/
|
||
│ ├─ model/
|
||
│ ├─ parser/
|
||
│ ├─ index/
|
||
│ ├─ sync/
|
||
│ ├─ tasks/
|
||
│ └─ ai/
|
||
└─ docs/
|
||
```
|