基于金字塔原理的三层知识蒸馏工具包。将散乱的时间线笔记转化为结构化知识产出。
支持两种使用方式：独立 CLI 和 OpenClaw 插件。
# 在任意项目中初始化知识棱镜
npx js-knowledge-prism init docs/knowledge --name "我的知识库"
# 查看处理状态
npx js-knowledge-prism status
# 运行增量处理（先 dry-run 预览）
npx js-knowledge-prism process --dry-run
# 创建新视角
npx js-knowledge-prism new-perspective blog-post --name "博客文章"一束白光射入三棱镜，折射出有序的七色光谱。散乱的日常笔记（白光）经过结构化拆解（棱镜），产出面向读者的清晰文章（光谱）。
journal/ 原始素材层 ← 按日期忠实记录，只增不改
↓
pyramid/ 结构化拆解层 ← 基于金字塔原理，双轨处理
↓
outputs/ 读者产出层 ← 面向特定读者的成品文章
详细方法论见 docs/knowledge-prism-introduction.md。
在目标目录生成完整的知识棱镜骨架。
npx js-knowledge-prism init docs/knowledge --name "项目知识库"生成的目录结构：
docs/knowledge/
├── .knowledgeprism.json # 配置文件（处理参数，不含敏感信息）
├── .env.example # 环境变量模板（复制为 .env 填入实际值）
├── README.md # 知识库说明
├── CHANGELOG.md # 架构变更日志
├── journal/ # 原始笔记（按日期组织）
├── pyramid/ # 结构化拆解
│ ├── analysis/
│ │ ├── atoms/ # 信息单元（按月分目录）
│ │ ├── groups/ # 归组（跨文档分组）
│ │ └── synthesis.md # 收敛（顶层观点候选）
│ └── structure/
│ ├── _template/ # 视角模板
│ └── PXX-xxx/ # 各视角目录
└── outputs/ # 面向读者的产出
金字塔增量处理：自动从 journal 提取 atoms，更新 groups 和 synthesis。
npx js-knowledge-prism process # 三阶段完整处理（建议模式）
npx js-knowledge-prism process --dry-run # 只预览，不调用模型
npx js-knowledge-prism process --auto-write # 自动写入文件
npx js-knowledge-prism process --stage 1 # 只执行阶段 1（提取 atoms）
npx js-knowledge-prism process --file x.md # 只处理指定 journal需要配置 OpenAI 兼容的 API 端点，见下方配置说明。
查看知识棱镜的处理状态：journal 总数、待处理数、atoms/groups 统计等。
npx js-knowledge-prism status从模板创建新的金字塔视角。
npx js-knowledge-prism new-perspective tutorial --name "入门教程"init 命令会在知识棱镜根目录生成 .knowledgeprism.json（不含敏感信息）和 .env.example 模板：
{
"name": "知识库名称",
"api": {},
"process": {
"batchSize": 5,
"temperature": 0.3,
"maxTokens": 8192,
"timeoutMs": 1800000
}
}API 地址、模型和密钥通过环境变量配置。复制 .env.example 为 .env 并填入实际值：
cp .env.example .envKNOWLEDGE_PRISM_API_BASE_URL=http://localhost:8888/v1
KNOWLEDGE_PRISM_API_MODEL=qwen3.5
KNOWLEDGE_PRISM_API_KEY=your-api-key-here| 环境变量 | 覆盖字段 | 默认值 |
|---|---|---|
KNOWLEDGE_PRISM_API_BASE_URL |
api.baseUrl |
http://localhost:8888/v1 |
KNOWLEDGE_PRISM_API_MODEL |
api.model |
unsloth/Qwen3.5-397B-A17B |
KNOWLEDGE_PRISM_API_KEY |
api.apiKey |
not-needed |
.env已在.gitignore中，不会被提交到仓库。
本项目内置 OpenClaw 插件（openclaw-plugin/ 目录），可将知识棱镜集成到 OpenClaw 的 CLI 和 AI Agent 中。
在 OpenClaw 配置文件（如 ~/.openclaw/openclaw.json）中添加：
{
"plugins": {
"load": {
"paths": ["/path/to/js-knowledge-prism/openclaw-plugin"]
},
"entries": {
"knowledge-prism": {
"enabled": true,
"config": {
"baseDir": "/path/to/your-knowledge-base",
"api": {
"baseUrl": "http://localhost:8888/v1",
"model": "your-model-name",
"apiKey": "your-api-key"
},
"process": {
"batchSize": 5,
"temperature": 0.3,
"maxTokens": 8192,
"timeoutMs": 1800000
}
}
}
}
}
}API 配置支持 ${ENV_VAR} 语法引用环境变量。
通过 openclaw prism 子命令组使用，功能与独立 CLI 一致：
openclaw prism init <dir> [--name <name>]
openclaw prism process [--dry-run] [--auto-write] [--stage <n>] [--base-dir <dir>]
openclaw prism status [--json] [--base-dir <dir>]
openclaw prism new-perspective <slug> [--name <name>]插件注册了两个 AI 工具，OpenClaw Agent 在对话中可自动调用：
knowledge_prism_process— 执行增量处理（atoms → groups → synthesis），返回处理摘要knowledge_prism_status— 查询知识库当前状态
lib/process.mjs 和 lib/status.mjs 导出了可编程接口，方便集成到其他系统：
import { createHttpCaller, runPipeline } from "js-knowledge-prism/lib/process.mjs";
import { getStatus } from "js-knowledge-prism/lib/status.mjs";
// 创建模型调用函数
const callAgent = createHttpCaller({
baseUrl: "http://localhost:8888/v1",
model: "your-model",
apiKey: "your-key",
});
// 运行处理管道
const summary = await runPipeline({
baseDir: "/path/to/knowledge-base",
config: { process: { batchSize: 5 } },
callAgent,
autoWrite: true,
});
// 查询状态
const status = getStatus("/path/to/knowledge-base");- Node.js >= 18.0.0
- 零外部依赖（独立 CLI 和核心模块均不依赖第三方包）
MIT