Deepvista Notes — Deepvista 笔记

先决条件：阅读 deepvista-shared 以了解 auth、profiles 和全局标志。 Notes 是类型为 note 的上下文卡片，支持富 markdown 内容，是显式捕获知识的主要方式 —— 会议记录、摘要、研究、决策。deepvista notes 是一种方便的简写。 每个 notes 命令都有一个使用 deepvista card 的等效命令： Notes 命令 等效的 card 命令 deepvista notes list deepvista card list --type note deepvista notes get deepvista card get deepvista notes create ... deepvista card create --type note ... deepvista notes +quick "..." (仅简写，没有直接的 card 等效命令) App URL 在任何写操作（create、update、+quick）后，始终向用户显示 note URL：https://app.deepvista.ai/notes/ 从 JSON 响应（card.id）中提取 id，并将其呈现为可点击的链接。 命令 list deepvista notes list [--limit N] [--page N] 只读 —— 列出所有 notes，最新的先显示。 get deepvista notes get 只读 —— 返回完整的 note 内容，包括 markdown 正文。 create deepvista notes create --title "标题" [--content "Markdown 内容"] [--content-file 路径/文件.md] [--tags '["t1","t2"]'] 使用 --content-file <路径> 从本地文件读取内容。这对于导入文件、URL 或任何内容超过几句话时是必需的。 永远不要通过 --content 内联粘贴大量内容 —— 总是先将其写入临时文件，然后使用 --content-file。 使用 --content-file - 从 stdin 读取（例如，curl ... | deepvista notes create --title "..." --content-file -）。 当同时提供 --content-file 和 --content 时，--content-file 优先。 [!CAUTION] 写命令 —— 执行前请与用户确认。 update deepvista notes update [--title "..."] [--content "..."] [--content-file 路径/文件.md] [--tags '["t1"]'] 使用 --content-file <路径> 进行大内容更新，同 create。 [!CAUTION] 写命令 —— 执行前请与用户确认。 delete deepvista notes delete [!CAUTION] 破坏性命令 —— 执行前请与用户确认。 +quick deepvista notes +quick "您的文本在这里" 快速从单行文本创建 note。前 ~50 个字符成为标题；完整的文本成为内容。实体增强自动运行。 [!CAUTION] 写命令 —— 创建新 note。执行前请与用户确认。 适合在工作流中捕获快速观察。对于具有自定义标题或结构化内容的 notes，请使用 notes create 代替。 创建的 notes 可以使用 deepvista card +search 进行搜索。 将文件或 URL 作为 notes 导入 当用户要求将文件、URL 或大量文本作为 note 导入时，始终使用 --content-file 以保留完整的内容。 永远不要总结、截断或改述内容 —— 用户期望存储确切的文本。 导入本地文件 deepvista notes create --title "会议记录" --content-file /路径/记录.md 从 URL 导入 先下载文件，然后导入： curl -sL "https://example.com/文档.md" -o /tmp/文档.md deepvista notes create --title "文档标题" --content-file /tmp/文档.md 或者直接通过 stdin 管道： curl -sL "https://example.com/文档.md" | deepvista notes create --title "文档标题" --content-file - 为什么使用 --content-file 而不是 --content？ 当代理读取文件并尝试通过 --content 内联传递时，内容经常被总结或截断，因为： 代理的上下文窗口使得实用性地回显大文件变得不切实际 Shell 参数长度限制可能适用 代理可能无意中改述而不是复制 --content-file 直接从磁盘读取文件，绕过代理的上下文。 这保证了确切、完整的文件内容被存储。 示例 # 列出最近的 notes deepvista notes list --limit 5 # 创建会议记录 deepvista notes create --title "2026-03-26 站立会议" --content "## 讨论\n- 路线图优先事项\n- CLI 发布" # 将文件作为 note 导入（对于任何文件或大内容，首选） deepvista notes create --title "架构文档" --content-file 文档/架构.md # 通过 stdin 从 URL 导入 curl -sL "https://example.com/文章.md" | deepvista notes create --title "文章" --content-file - # 从单行快速捕获 deepvista notes +quick "Alice 提到 API 迁移截止日期是 4 月 15 日" # 更新 note deepvista notes update note_abc --content "更新内容，包含新发现..." # 搜索 notes（使用 card search） deepvista card +search "API 迁移" --type note 请参阅 deepvista-shared —— Auth 和全局标志 deepvista-vistabase —— 全知识库 API（所有 card 类型） deepvista-recipe-analyze-notes —— 分析 notes 中的模式