Para 使用文档

Para 不是云笔记，也不是只针对代码项目的 IDE。它首先尊重你的本地目录结构：文件仍然在你的磁盘上，Para 负责提供更顺手的浏览、编辑、预览、终端和协作入口。

PARA 把所有资料按行动状态分为四类。Para 使用这四类作为默认目录，不改变文件格式，也不要求把内容导入数据库。

• 侧边栏顶部是一级目录入口，默认包含 P-Projects、A-Areas、R-Resources、Archive，也会支持根目录下的其他一级目录。
• 文件树用于快速跳转、右键操作和拖放。外部文件变化会通过 watch 接口同步到界面。
• 目录列表支持列表/网格视图，图片和视频会有缩略预览；网格大小和视觉密度会跟随 UI 设置。
• 搜索、设置、Webs、远程分享、Skills 等工具面板以标签页形式进入主工作区，方便保留和分栏。
• 侧边栏底部提供设置入口和 Webs 添加入口；在移动宽度下会切换为可收起侧栏。

Para 会根据扩展名和特殊文件名选择渲染器。大文件会先提示，超过上限则拒绝加载，避免因为单个素材拖垮工作区。

文件大小策略

• Markdown 文件可以在编辑和预览之间切换，编辑器基于 CodeMirror。
• 预览支持 GitHub Flavored Markdown、表格、任务列表、代码高亮和 Mermaid 图。
• 相对链接会按当前文件路径解析；在本地浏览和分享预览中都会尽量保持可跳转。
• 编辑时自动保存，不需要显式点击 Save。
• 预览和编辑区会做滚动同步，并高亮当前编辑位置附近的预览区域。
• Markdown 中引用的本地图片在分享时会通过受控资源代理暴露，不会把整个知识库都开放出去。

• 每个文件、目录、搜索、设置、Webs 和远程分享都可以作为标签页存在。
• 标签页支持点击切换、关闭、关闭其他标签页和拖拽排序。
• 主内容区支持拖拽标签页到 pane 边缘进行左右/上下分栏。
• 分栏后可拖动分隔线调整比例；关闭空 pane 后布局会自动回收。
• 终端也有独立的分栏系统，和文件工作区互不干扰。

Para 的终端使用真实 PTY 和 xterm，重点是把当前目录、文件路径、AI 助手命令和评论上下文直接接入你的工作流。

• Webs 可以把本地 dev server、网页应用或外部 URL 作为标签页打开，适合边改代码边看页面。
• Pinned 保存固定入口；Recent 自动记录最近打开过的 URL，并会和 Pinned 去重。
• Electron 环境优先使用 webview；普通浏览器环境回退到 iframe。
• 手机预览使用固定移动视口并尝试开启设备模拟，适合快速检查响应式页面。
• 截图按钮会优先捕捉 webview 原始像素，失败时回退为容器截图，并复制到剪贴板。
• 元素拾取和注释覆盖层可用于定位页面区域，辅助 UI 反馈和调试。

分享系统把本地文件或目录临时暴露为浏览器可访问页面。它适合同局域网预览、给协作者看文件、或把评论入口交给 Para 桌面端处理。

• 评论可以附着在文件内容上，而不是只绑定屏幕坐标。布局变化后会优先按内容重新定位，找不到时再退回原区域。
• Markdown、代码、文本、HTML、DOCX、JSON、CSV 等文本类内容支持选区批注。
• 图片、PPTX 和 PDF 支持矩形区域批注；PDF 还支持文本选区批注。
• 音频和视频支持时间点批注。
• 评论面板支持 open、resolved、unlinked、archived 等状态分组，能处理内容漂移后的未定位评论。
• 评论卡片可以把评论正文和上下文发送到终端，便于交给 CLI agent 处理。
• Web 分享页当前是只读评论视图；回复、解决、删除等协作操作主要在 Para 内完成。

Para 的边界原则是：个人本地知识库的日常基础能力保持免费；跨设备、跨用户、重度效率布局、自动化和工作台扩展进入高级版。

免费功能

• 首次引导、中文/英文界面、PARA 四象限初始化
• 本地文件浏览、目录列表、文件树、面包屑导航
• 文件和目录的新建、重命名、删除、拖放移动、系统文件夹中显示
• Markdown、代码、文本、HTML、图片、音频、视频、PDF、DOCX、表格、PPTX 预览
• Markdown 编辑、实时预览、自动保存、Mermaid 和 GFM 支持
• 基础搜索：文件名、目录名、文本内容摘要
• 基础主题、语言、UI 缩放和字体设置
• 单工作区标签页
• 基础终端：打开目录、cd 到目录、粘贴路径、普通复制粘贴
• Git 只读信息：状态、diff、history、graph 查看

高级版功能