exomind 0.1.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/LICENSE +21 -0
- package/README.md +138 -0
- package/dist/cli.js +4021 -0
- package/dist/cli.js.map +1 -0
- package/package.json +46 -0
- package/skill/SKILL.md +68 -0
package/package.json
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "exomind",
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "ExoMind 跨平台命令行客户端 — 通过 REST 与 ExoMind 知识库交互(ingest/query/search/review),替代 Windows 不可用的 MCP 客户端。",
|
|
5
|
+
"bin": {
|
|
6
|
+
"exomind": "dist/cli.js"
|
|
7
|
+
},
|
|
8
|
+
"files": [
|
|
9
|
+
"dist",
|
|
10
|
+
"skill"
|
|
11
|
+
],
|
|
12
|
+
"engines": {
|
|
13
|
+
"node": ">=18"
|
|
14
|
+
},
|
|
15
|
+
"scripts": {
|
|
16
|
+
"build": "tsup",
|
|
17
|
+
"dev": "tsup --watch",
|
|
18
|
+
"test": "node --test --import tsx test/*.test.ts",
|
|
19
|
+
"prepublishOnly": "npm run build"
|
|
20
|
+
},
|
|
21
|
+
"dependencies": {},
|
|
22
|
+
"devDependencies": {
|
|
23
|
+
"@types/node": "^22.10.0",
|
|
24
|
+
"commander": "^12.1.0",
|
|
25
|
+
"picocolors": "^1.1.1",
|
|
26
|
+
"tsup": "^8.3.5",
|
|
27
|
+
"tsx": "^4.19.2",
|
|
28
|
+
"typescript": "^5.7.2"
|
|
29
|
+
},
|
|
30
|
+
"keywords": [
|
|
31
|
+
"exomind",
|
|
32
|
+
"knowledge-base",
|
|
33
|
+
"cli",
|
|
34
|
+
"mcp-alternative",
|
|
35
|
+
"cross-platform"
|
|
36
|
+
],
|
|
37
|
+
"license": "MIT",
|
|
38
|
+
"repository": {
|
|
39
|
+
"type": "git",
|
|
40
|
+
"url": "https://github.com/helloworldtang/exomind-cli.git"
|
|
41
|
+
},
|
|
42
|
+
"homepage": "https://github.com/helloworldtang/exomind-cli#readme",
|
|
43
|
+
"bugs": {
|
|
44
|
+
"url": "https://github.com/helloworldtang/exomind-cli/issues"
|
|
45
|
+
}
|
|
46
|
+
}
|
package/skill/SKILL.md
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: exomind
|
|
3
|
+
description: Interact with the ExoMind knowledge base — ingest insights/experiences/research/decisions, query, full-text search, FSRS review, and explore entities/relations. Use when the user wants to save knowledge into, or retrieve knowledge from, their ExoMind KB. Also use proactively to persist valuable session outcomes (lessons, decisions, root causes) via `exomind ingest`.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# ExoMind CLI
|
|
7
|
+
|
|
8
|
+
`exomind` is a cross-platform CLI that talks to your ExoMind knowledge base over REST. It replaces the MCP client (which is unreliable on Windows). After a one-time `exomind login` (paste the API Key from `d.youhuale.cn/ui/account`), every command works identically on Windows / macOS / Linux.
|
|
9
|
+
|
|
10
|
+
If a command fails with "未登录", run `exomind login` first.
|
|
11
|
+
|
|
12
|
+
## Commands
|
|
13
|
+
|
|
14
|
+
### Save knowledge
|
|
15
|
+
```bash
|
|
16
|
+
exomind ingest "内容文本" -t "描述性标题" --tag cli --tag exomind
|
|
17
|
+
echo "管道内容" | exomind ingest -t "标题"
|
|
18
|
+
exomind ingest --file ./notes.md -t "标题"
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
### Retrieve
|
|
22
|
+
```bash
|
|
23
|
+
exomind query "如何做 X?" # LLM 问答,引用 KB 页面
|
|
24
|
+
exomind search "关键词" --limit 10 # 全文搜索; --rerank / --hybrid 更准
|
|
25
|
+
exomind entity "Redis" # 实体详情 + 关系
|
|
26
|
+
exomind relations "Redis" --depth 2 # 关联实体
|
|
27
|
+
exomind stats # 知识库统计
|
|
28
|
+
exomind topics # 选题推荐
|
|
29
|
+
exomind gaps # 知识缺口(驱动摄入)
|
|
30
|
+
exomind daily # 每日摘要
|
|
31
|
+
exomind synthesize "主题" --depth 2 # 主题综合报告
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Review (FSRS-5)
|
|
35
|
+
```bash
|
|
36
|
+
exomind review # 待复习列表
|
|
37
|
+
exomind review mark "Redis" -r 3 # 1=忘记 2=吃力 3=顺利 4=轻松
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### Feedback (drives quality ranking)
|
|
41
|
+
```bash
|
|
42
|
+
exomind feedback "entities/Redis.md" positive
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Output mode
|
|
46
|
+
Default is human-readable (colored). Add `--json` to any command for machine-readable output when piping.
|
|
47
|
+
|
|
48
|
+
## Knowledge flywheel — proactively ingest (no need to ask)
|
|
49
|
+
|
|
50
|
+
When the session produces any of the following, **immediately run `exomind ingest`** to persist it (this is the compounding flywheel — do not wait for the user to ask):
|
|
51
|
+
|
|
52
|
+
- **Key takeaways / lessons / pitfalls** — 经验总结, 踩坑记录, 心得
|
|
53
|
+
- **Architectural decisions with rationale** — 架构决策, 技术选型
|
|
54
|
+
- **Root-cause / debugging insights** — 根因分析, 调试经验
|
|
55
|
+
- **Performance results with concrete numbers** — 优化效果, 性能数据, 对比数据
|
|
56
|
+
- **Best practices / patterns** — 最佳实践, 设计模式
|
|
57
|
+
|
|
58
|
+
Rules for ingesting:
|
|
59
|
+
- Use a **descriptive title** (`-t`), not a generic one like "经验总结".
|
|
60
|
+
- Add relevant **tags** (`--tag`).
|
|
61
|
+
- Include the **full context** — don't omit reasoning, numbers, or trade-offs.
|
|
62
|
+
- One `ingest` per coherent unit of knowledge; for multiple, run several.
|
|
63
|
+
|
|
64
|
+
## When to query/search before answering
|
|
65
|
+
|
|
66
|
+
- A **deep technical question** that needs more than general knowledge → run `exomind query` or `exomind search` first, then answer using the returned context.
|
|
67
|
+
- "What's the relationship between X and Y?" → `exomind entity X` / `exomind relations X`.
|
|
68
|
+
- When relevant KB content would improve the answer, retrieve it; don't answer from memory if the KB may know better.
|