用途：diskd 是访问 diskd 平台 Projects、项目级 Drive Sessions 和 Drive 文件的 Rust 命令行工具，面向人类、shell 脚本和编程智能体。
主要能力：文件操作（ls、tree、glob、grep、vsearch、cat、download、read、stat、upload、mkdir、rm、mv、cp、sync）；数据查询（biquery 自然语言查询索引的 CSV/TSV/XLS/XLSX/mailbox 表格，database 与 telegram-db 提供 SQL 生命周期与查询）；平台管理（project、session 子命令）；认证与上下文（login、logout、whoami、set-context、get-context）；自更新（update）；以及内置 MCP stdio 服务器（mcp serve）。
使用方式：全局标志须写在子命令前，如 diskd --json ls docs 有效，diskd ls docs --json 无效。安装：curl -fsSL https://raw.githubusercontent.com/diskd-ai/diskd-cli/main/install.sh | sh，可用 DISKD_VERSION 与 DISKD_INSTALL_DIR 定制。基本流程：diskd login 认证（或用 --token），diskd --json whoami 验证身份，diskd --json project list 并 diskd set-context 01PROJECTID 选择项目上下文，然后在上下文中操作文件与会话。路径相对当前上下文解析，项目上下文仅本地有效，不作为公共 Drive API 字段发送。
适用场景：shell 脚本与 CI 集成、Drive 文件读写与同步、会话读取、表格数据的自然语言查询、智能体通过 MCP 接入。
限制：vsearch 使用具体文件路径比目录更可靠，目录可能无法展开向量搜索 inode，遇目录错误可重试文件或改用 grep；grep 的 --ignore-case 与 --files-with-matches 会被解析但拒绝，不可依赖；download 为原子操作，未加 --force 不覆盖本地目标；会话与项目的修改类命令（save、append、remove、rollback、delete）会改变状态，仅在授权时执行，破坏性删除需 --yes；session 应按域 ID 读取，不要构造 .sessions 路径或传入 inode；biquery 接受自然语言问题而非 SQL。更完整标志与 API 方法见官方 references/commands.md 等文档。