Skip to content

docs: refresh strategy audit and rank P2 roadmap #48

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kooksee merged 1 commit into from
Oct 2, 2026
Merged

docs: refresh strategy audit and rank P2 roadmap #48

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions docs/roadmap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,13 +59,15 @@

- [x] `internal/server` HTTP API 用例补齐：新增 api_test.go（groups / file content / graph / outline / reorder / patterns 全生命周期 / move / upload / status / shutdown）+ State 纯函数用例——server 包 62.1% → **74.7%**，全仓 50.5% → **56.6%**；下一版目标：server ≥ 80%（缺口集中在 fsnotify watchLoop 与 SSE 长连接）

## 3. P2 · 中期（3–6 个月）

- [ ] 阅读/review 定点打磨：搜索键盘导航、大会话性能（虚拟列表、索引防抖）——按策略此轨道不再扩面
- [ ] frontmatter 容错：`...` 结束符、BOM
- [ ] LAN 部署配套：远程访问 token 鉴权 + 部署文档（`--dangerously-allow-remote-access` 目前无防护）
- [ ] 发布生态：`pubgo/homebrew-tap` + goreleaser `brews` 恢复 Homebrew 安装（或先提供 install script）
- [ ] 可配置 Markdown 扩展开关；图谱维度增强（标签 / 引用类型 / 跨分组）
## 3. P2 · 中期（3–6 个月，按建议顺序）

1. [ ] **LAN 访问鉴权（token）**——手机遥控使 `0.0.0.0` 绑定成为常态场景，裸奔风险随之放大。方案：启动时生成 token 并编入遥控二维码（URL 参数），非 loopback 请求校验；`--dangerously-allow-remote-access` 保留为显式跳过
2. [ ] **发布生态**——`pubgo/homebrew-tap` + goreleaser `brews` 配置恢复 Homebrew 安装，或先提供 `curl | sh` install script（release 产物已就绪，只差分发渠道，一次配置长期生效）
3. [ ] **搜索键盘导航**——`↑/↓` 选择、`Enter` 跳转、`Esc` 关闭（阅读轨定点打磨，不扩面）
4. [ ] **frontmatter 容错**——`...` 结束符、BOM
5. [ ] 大会话性能：虚拟列表、索引防抖（有实测卡顿再做）
6. [ ] 可配置 Markdown 扩展开关；图谱维度增强（标签 / 引用类型 / 跨分组）
7. [ ] Go 覆盖率第二阶段：server 74.7% → 80%（fsnotify watchLoop + SSE 长连接需要进程级测试）

## 4. P3 · 远期 / 探索（需单独设计，不承诺排期）

Expand Down
12 changes: 6 additions & 6 deletions docs/strategy-status.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 策略落地现状（对照 STRATEGY.md）

> 审计日期：2026-09-20。对照根目录 [STRATEGY.md](../STRATEGY.md) 与当前代码/文档，说明「做到哪一步了」。
> 审计日期：2026-10-02。对照根目录 [STRATEGY.md](../STRATEGY.md) 与当前代码/文档，说明「做到哪一步了」。
> 本文是**现状快照**，不是排期；功能细节以代码与 README 为准。

## 1. 指标快照
Expand All @@ -9,13 +9,13 @@
| ---- | ------ | ---- |
| 冷启动到可读 | 强 | `markview …` 起服务并打开浏览器 |
| 少开编辑器 | 偏强 | 只读展出面：分组、搜索、图谱、Slides、PDF |
| 演示可用 | 够用 | 内置 `---` Slides + 全屏舞台；未完全替代 PPT |
| 导出保真 | 够用 | PDF 主题背景已对齐；静态站/Pages 包装仍薄 |
| 演示可用 | 强 | Slides 全屏/备注/提词器/转场/手机扫码遥控/超高自动缩放；未完全替代 PPT |
| 导出保真 | 强 | PDF 主题对齐；PlantUML 可自托管离线；单分组导出；图片失败占位 |
| 美化缺口 (~80%) | 与策略一致 | 功能大体具备；易用与视觉质感是主要剩余工作 |

## 2. 四条投资轨道

### 2.1 演示质感 — **够用**
### 2.1 演示质感 — **强**

**已有**

Expand Down Expand Up @@ -49,7 +49,7 @@
- 搜索结果键盘导航等（见 `docs/global-search.md` / `docs/design.md`）
- 未加入会话的全盘索引（设计边界：仅会话内文件）

### 2.3 导出与静态发布 — **够用**
### 2.3 导出与静态发布 — **强**

**已有**

Expand All @@ -61,7 +61,7 @@

**未齐**

- 静态导出单分组
- ~~静态导出单分组~~（v0.20 已落地 `build --group`）
- 应用内无 PPTX（deck PDF 已有；PPTX 仍靠 Marp）

详见 [export-and-static.md](export-and-static.md)。
Expand Down
Loading