可见性是文档的属性，跟「谁写的」分开。改可见性不必重新 push 正文。
三档可见性
| 档 | 谁能打开 | 出现在哪个列表 | 搜索得到吗 |
|---|---|---|---|
private | 只有你自己 | 只出现在「我的文档」 | 只有你搜得到 |
public | 知道链接的人 | 只出现在你自己的「我的文档」；站点上没有对外的公开目录 | 登录的人搜得到，匿名搜不到 |
official | 任何人 | 只进「官方知识库」 | 是 |
三个档位互斥：一篇文档任一时刻只属于其中一档。
official 是什么
official 是管理员把文档上架到官方知识库的档位：公开可读、可被搜索，只出现在官方库列表。官方库是这台实例维护的只读区，行徽章是「只读」，阅读页徽章是「官方」。
jdu official add abc123 # 上架（管理员）
jdu official rm abc123 # 下架：回落 private，想公开再 jdu share --visibility public
新文档默认 private。push 时指定：
jdu push notes/index.md --visibility public
已经发布过的，用 share，不用重传正文：
jdu share abc123 --visibility public
和 push 一起用
| 场景 | 做法 |
|---|---|
| 先私有写，写完再公开 | 默认 push，确认后 jdu share <id> --visibility public |
| 只给自己看 | 默认就是 private，不用做什么 |
| 公开，人人可读 | --visibility public |
| 上架官方知识库 | 管理员 jdu push --official 或 jdu official add |
可见性改完立刻生效，不必 rerender。阅读页右上角的「分享」和站点管理页也能改档位。CLI 和网页写的是同一份数据。
评论
能读这篇的人都能看评论；登录后才能写。三种下笔方式：
- 划词：在正文里选中一段文字，选区上方会浮出「评论」，锚点就是这段话。原文之后改了，评论会按引文回溯；找不到就退回到所在段落。
- 段落：鼠标悬停到某一段，段落左侧出现一个把手，悬停或点击它选「评论这一块」；「复制块链接」拿到的地址带
#b…锚点，打开即定位到这一段。只用键盘时，Tab 到正文末尾的「块操作」按钮，上下键在段落之间移动，回车打开菜单。 - 全文：正文末尾的评论区可以对整篇文档发表评论，不挂在任何段落上。
有评论的段落右侧会有一个计数标记，悬停预览、点击钉住；回复在面板里写，「标记解决」只有作者能点。评论区跟文档版本无关——所有版本共用同一条线程。
正文末尾的评论区把全部线程按原文顺序汇总：全文评论在最前，每条段落评论标着「第 N 段」，点「跳到原文」滚到那一段并把线程面板钉在旁边；原文改动后找不到段落的评论排在最后。输入框支持 Markdown；把图片粘贴或拖进来会自动上传，挂在输入框下方当附件（可移除），不写进正文。发出去后图片在评论下方以缩略图一排展示，点开看大图；正文里的图也能这样点开。