exomind 0.1.3 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "exomind",
3
- "version": "0.1.3",
3
+ "version": "0.2.1",
4
4
  "description": "ExoMind 跨平台命令行客户端 — 通过 REST 与 ExoMind 知识库交互(ingest/query/search/review),替代 Windows 不可用的 MCP 客户端。",
5
5
  "bin": {
6
6
  "exomind": "dist/cli.js"
package/skill/SKILL.md CHANGED
@@ -9,11 +9,19 @@ description: Interact with the ExoMind knowledge base — ingest insights/experi
9
9
 
10
10
  If a command fails with "未登录", run `exomind login` first.
11
11
 
12
+ ## ⚠️ 用法铁律(最先读,必守)
13
+
14
+ 1. **目录 / 多个文件 → 一条 `exomind ingest --dir <路径>`**(增量,自动跳过已摄文件)。**绝不**逐文件调用 Skill 工具、**绝不**逐条 `exomind ingest --file`。
15
+ 2. **Skill 工具只调用一次**(加载本文件一次即可,后续一律用 Bash 跑 `exomind ...`)。
16
+ 3. 单条知识 → `exomind ingest "内容" -t 标题 --tag 标签`。
17
+ 4. ingest 是**同步**(每文件 1-3 min);`--dir` 串行 + `⏳[i/n]` 进度 + 结束汇总(新增/更新/跳过/失败),不是后台异步。
18
+
12
19
  ## 数据位置(重要 — 勿误报)
13
20
 
14
- **所有知识库数据都在服务器(d.youhuale.cn),不在本地。** CLI 通过 REST 上传/查询,**绝不写本地 wiki 目录**(不存在 `~/my-wiki` 之类)。本地仅两处:
21
+ **所有知识库数据都在服务器(d.youhuale.cn),不在本地。** CLI 通过 REST 上传/查询,**绝不写本地 wiki 目录**(不存在 `~/my-wiki` 之类)。本地仅以下状态文件:
15
22
  - `~/.exomind/config.json` — 凭证
16
23
  - `~/.exomind/cache/` — hook 的关键词/实体缓存(从服务器拉的副本)
24
+ - `~/.exomind/manifest.json` — 目录增量摄入的内容哈希清单(去重用,非知识库本身)
17
25
 
18
26
  摄入成功后输出 `✓ 已导入服务器知识库`。若要确认数据落地,用 `exomind search <关键词>` 复查。**不要向用户报告"已保存到 ~/my-wiki/entities/X.md"等本地路径——那是错的。**
19
27
 
@@ -24,6 +32,20 @@ If a command fails with "未登录", run `exomind login` first.
24
32
  - **不要用 `timeout` 命令包裹**(macOS 默认无该命令;且 CLI 自己会等)。
25
33
  - 超长文本(>5 万字符)会被拒;拆成多条 ingest。
26
34
 
35
+ ## 批量目录摄入(增量,推荐)
36
+
37
+ **本 skill 只加载一次。** 同步一个目录的多个文件,用 `--dir` 一条命令搞定——**不要**逐文件调用 Skill 或逐条 Bash:
38
+
39
+ ```bash
40
+ exomind ingest --dir ~/workspace/notes --recursive # 增量:只摄新增/改动
41
+ exomind ingest --dir ~/workspace/notes --force # 强制全量重摄
42
+ exomind ingest --dir ~/workspace/notes --pattern "*.md" # 默认就是 *.md
43
+ ```
44
+
45
+ - **增量去重**:按文件内容 SHA-256 记在 `~/.exomind/manifest.json`,**未变的文件直接跳过**(不调 LLM),所以隔几天重跑同目录很便宜——只处理新/改文件。
46
+ - **串行 + 进度**:弱服务器上每文件 1-3 分钟,`--dir` 串行处理、stderr 打 `⏳ [i/n]`;ingest 是**同步**(不是后台异步),会一直占住到完成。
47
+ - 结束汇总:`新增 N / 更新 M / 跳过 K / 失败 J`。
48
+
27
49
  ## Commands
28
50
 
29
51
  ### Save knowledge