Skip to content

02-命令说明.md

Latest commit

 

History

History
227 lines (151 loc) · 3.61 KB

02-命令说明.md

File metadata and controls

227 lines (151 loc) · 3.61 KB
Raw

Mesh 命令说明

当前版本完整命令参考（与代码实现一致）

全局

mesh --help
mesh --version

1) collect

采集一条认知到 SQLite。

mesh collect --source <source> --content <content> [--tag <tags>] [--summary <summary>]

参数：

  • --source 必填，来源
  • --content 必填，内容
  • --tag 可选，逗号分隔标签
  • --summary 可选，摘要

示例：

mesh collect --source "claude" --content "决策：先做导入导出" --tag "产品,决策"

2) list

列表展示最近记录（表格）。

mesh list [--source <source>] [--limit <n>]

参数：

  • --source 可选，来源过滤
  • --limit 可选，默认 20

3) query

查询记录。

mesh query [keyword] [--source <source>] [--tag <tag>] [--limit <n>]

参数：

  • keyword 可选（若无 keyword，必须至少有 source/tag）
  • --source 可选，来源过滤
  • --tag 可选，标签过滤
  • --limit 可选，默认 20，需 >0

说明：支持两种参数顺序：

  • mesh query 关键词 --source claude
  • mesh query --source claude 关键词

4) import

从 Markdown 导入。

mesh import [--source <source>] <markdown-file>

参数：

  • --source 可选，默认 markdown
  • <markdown-file> 必填

特性：

  • 支持解析日期/标题/标签/内容
  • 内容: 支持多行
  • 按 content 去重（重复跳过）

Markdown 示例：

## 2026-03-10

### 决策：使用 Go 开发 Mesh
标签: 技术,决策
内容: 第一行
第二行

5) export

导出为 Markdown。

mesh export [--output <file>]

参数：

  • --output 可选，默认输出到 stdout

说明：

  • 按日期分组输出
  • 标题优先使用 summary，为空时从 content 自动截取

6) init

初始化配置与同步目录。

mesh init --sync-space <path>

参数：

  • --sync-space 必填，同步空间路径

输出：

  • 配置文件 ~/.mesh/config.json
  • 本地数据库默认 ~/.mesh/mesh.db

7) push / pull / sync

push

mesh push

将本地数据库推送到同步空间。

pull

mesh pull

将同步空间数据库拉取到本地。

sync

mesh sync

顺序：先 pull 再 push。

同步安全：

  • 锁文件：.mesh.sync.lock
  • 检测到潜在冲突时会先备份本地库：mesh.db.bak.<timestamp>

8) agent

Agent 注册与查看。

register

mesh agent register --id <id> --name <name> [--type <type>] [--device <device>]

list

mesh agent list [--limit <n>]

说明：

  • 注册为 upsert（同 ID 重新注册会刷新信息和 last_seen）
  • 数据存储在 SQLite agents 表

9) inject

生成可注入给其他 AI 的上下文。

mesh inject [keyword] [--source <source>] [--tag <tag>] [--limit <n>] [--max-tokens <n>] [--format text|markdown]

参数：

  • keyword 可选（若无 keyword，必须至少有 source/tag）
  • --source 可选
  • --tag 可选
  • --limit 可选，默认 8
  • --max-tokens 可选，默认 1200（近似估算）
  • --format 可选：text（默认）/markdown

10) 环境变量

  • MESH_DB_PATH：覆盖数据库路径
  • MESH_CONFIG_PATH：覆盖配置文件路径

示例：

MESH_DB_PATH=/tmp/mesh.db mesh list
MESH_CONFIG_PATH=/tmp/config.json mesh init --sync-space /tmp/sync

11) 常见错误

  • 请先执行 mesh init：未初始化配置
  • --limit 必须大于 0：限制参数非法
  • flag 缺少对应值：某个参数未传值
  • lock busy：同步锁被占用，稍后重试