llm-wiki-stack 1.0.0 → 1.0.2

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.
Files changed (3) hide show
  1. package/README.md +36 -34
  2. package/bin/setup.sh +20 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,64 +1,66 @@
1
1
  # llm-wiki-stack
2
2
 
3
+ 基于 Obsidian 的知识库编译器。将零散的源素材编译为互联的概念网络，由 LLM 驱动编译。
4
+
3
5
  Obsidian-based knowledge base compiler. Turns fragmented source notes into an interconnected concept network, powered by LLM compilation.
4
6
 
5
- ## Philosophy
7
+ ---
8
+
9
+ ## 核心理念 / Philosophy
10
+
11
+ 大多数笔记系统是**仓库**——你往里存东西。这是一套**编译器**——将原始素材转化为结构化的、可查询的知识。
6
12
 
7
13
  Most note systems are **warehouses** — you put things in. This is a **compiler** — it transforms raw material into structured, queryable knowledge.
8
14
 
9
15
  ```
10
- 01 raw/ ──compile──> 02 wiki/ ──dialogue──> 03 outputs/
11
- (source of truth) (concept network) (your opinions)
16
+ 01 raw/ ──编译──> 02 wiki/ ──对话──> 03 outputs/
17
+ (不可变源) (概念网络) (你的观点)
12
18
  ```
13
19
 
14
- ## Install
20
+ **知识编译一次，持续沉淀，产生复利效应。**
21
+ Knowledge compiled once, precipitates continuously, compounding over time.
22
+
23
+ ## 安装 / Install
15
24
 
16
25
  ```bash
17
26
  npx llm-wiki-stack
18
27
  ```
19
28
 
20
- This copies the skills into `~/.claude/skills/`. Works in Claude Code.
29
+ 将 5 个 skill 安装到 `~/.claude/skills/`，Claude Code 中即可使用。
21
30
 
22
- Or clone manually:
23
-
24
- ```bash
25
- git clone https://github.com/<your-username>/llm-wiki-stack.git
26
- cp -R llm-wiki-stack/skills/* ~/.claude/skills/
27
- ```
31
+ Copies 5 skills into `~/.claude/skills/`. Ready to use in Claude Code.
28
32
 
29
- ## Commands
33
+ ## 命令 / Commands
30
34
 
31
- | Command | Action | When |
35
+ | 命令 | 做什么 | 什么时候用 |
32
36
  |---------|--------|------|
33
- | `/kb-init` | Bootstrap a knowledge base from scratch | Once per vault |
34
- | `/wiki-compile` | Compile new raw notes into wiki | After collecting source material |
35
- | `/wiki-topic` | Question-driven opinion formation | When you have a research question |
36
- | `/wiki-lint` | Health check + structured report | Monthly |
37
+ | `/kb-init` | 从零初始化知识库 | 每个知识库一次 |
38
+ | `/wiki-compile` | 将新 raw 编译进 wiki | 积累素材后 |
39
+ | `/wiki-topic` | 基于问题形成观点 | 有研究问题时 |
40
+ | `/wiki-lint` | 健康检查 + 结构化报告 | 每月 |
37
41
 
38
- ## How It Works
42
+ ## 怎么用 / How It Works
39
43
 
40
- 1. **Collect** — Save articles, thoughts, clippings into `01 raw/` with `status: inbox`
41
- 2. **Compile** — Run `/wiki-compile`; LLM extracts concepts, creates wiki pages, builds cross-references
42
- 3. **Think** — Run `/wiki-topic` with a question; LLM reveals structural relationships between concepts
43
- 4. **Maintain** — Run `/wiki-lint` monthly; LLM surfaces orphan nodes, fragile dependencies, concept evolution
44
+ 1. **收素材** — 把文章、想法、剪藏放进 `01 raw/`，标记 `status: inbox`
45
+ 2. **编译** — 运行 `/wiki-compile`；LLM 提取概念、创建 wiki 页、建立交叉引用
46
+ 3. **思考** — 运行 `/wiki-topic` 提出问题；LLM 揭示概念间的结构化关系
47
+ 4. **维护** — 每月运行 `/wiki-lint`；LLM 标记孤岛节点、脆弱依赖、概念演化
44
48
 
45
- ## Key Mechanisms
49
+ ## 核心机制 / Key Mechanisms
46
50
 
47
- **Concept Independence Test** — Before creating a new wiki page, every candidate concept must pass:
48
- - Definability: can you clearly state what this concept *is* in 1-2 sentences?
49
- - Single core: is it one concept, or "A and B" glued together?
50
- - Multi-source verification: does it appear in at least two different source notes?
51
+ **概念独立性测试** — 创建新 wiki 概念页前，每个候选概念必须通过：
52
+ - 可定义性：能否用一两句话说清"这个概念是什么"？
53
+ - 单一核心：它是一个概念，还是"A 与 B"的组合？
54
+ - 多重验证：是否来自至少两个不同的源笔记？
51
55
 
52
- **Concept Evolution** — No overwrites. Understanding changes are tracked in a versioned timeline. Default behavior is *append*, not replace.
56
+ **概念演化** — 不覆盖历史。每次理解的改变都记录在版本化时间线中。默认行为是**追加**，而非替换。
53
57
 
54
- **Cross-Reference Integrity** — Every claim links to its raw source. Every wiki link is bidirectional. Linked counts are verified on each compile.
58
+ **交叉引用完整性** — 每条陈述链接到 raw 出处。wiki 间双向链接。每次编译校验 linked_count。
55
59
 
56
- ## Requirements
60
+ ## 限制 / Requirements
57
61
 
58
- - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or compatible AI coding agent
59
- - [Obsidian](https://obsidian.md/) (recommended, for graph visualization)
60
- - Git (for version control)
62
+ - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) 或兼容的 AI 编程助手
61
63
 
62
- ## License
64
+ ## 开源协议 / License
63
65
 
64
66
  MIT
package/bin/setup.sh CHANGED
@@ -1,7 +1,26 @@
1
1
  #!/usr/bin/env bash
2
2
  set -e
3
3
 
4
- SKILLS_SRC="$(cd "$(dirname "$0")/../skills" && pwd)"
4
+ # Resolve the real package root, even when invoked via npx symlink chain.
5
+ # npx creates .bin/<cmd> -> ../<pkg>/bin/setup.sh, so $0 is the symlink.
6
+ resolve_script() {
7
+ local target="$1"
8
+ local max_depth=10
9
+ while [ -L "$target" ] && [ "$max_depth" -gt 0 ]; do
10
+ local link
11
+ link="$(readlink "$target")"
12
+ case "$link" in
13
+ /*) target="$link" ;;
14
+ *) target="$(cd "$(dirname "$target")" && pwd)/$link" ;;
15
+ esac
16
+ max_depth=$((max_depth - 1))
17
+ done
18
+ echo "$target"
19
+ }
20
+
21
+ SCRIPT="$(resolve_script "$0")"
22
+ PKG_ROOT="$(cd "$(dirname "$SCRIPT")/.." && pwd)"
23
+ SKILLS_SRC="$PKG_ROOT/skills"
5
24
  SKILLS_DST="${HOME}/.claude/skills"
6
25
 
7
26
  echo "llm-wiki-stack installer"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "llm-wiki-stack",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "description": "Obsidian knowledge base compiler — three-layer architecture (raw → wiki → outputs) with concept evolution, cross-reference integrity, and health checks. Command-driven, AI-maintained, plain Markdown.",
5
5
  "license": "MIT",
6
6
  "bin": {