llm-wiki-compiler可配置生命周期ProfileCLP完全指南一个profile.json搭建领域知识系统【免费下载链接】llm-wiki-compilerThe knowledge compiler. Raw sources in, interlinked wiki out. Inspired by Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/gh_mirrors/ll/llm-wiki-compilerllm-wiki-compilerllmwiki是一个开源知识编译器把论文、笔记、网页等原始素材编译成带引用、可互链、可审查的 Markdown 维基。而从 1.0 版本起它的核心升级是可配置生命周期 ProfileConfigurable Lifecycle Profile简称 CLP——只需一份经过校验的profile.json你就能声明自己领域的实体、关系、生命周期状态机、工作流和信任门禁无需修改任何编译器代码。本指南带新手用最小成本理解 CLP 并搭建第一个领域知识系统。为什么你的知识系统需要 Profile默认的 llmwiki 只区分两类页面概念wiki/concepts/和查询wiki/queries/。这对个人笔记够用但真实工作流需要更强的契约 一篇论文没有 DOI 和摘要就不能算完整入库 一个实验没有结果文件和关联想法就不能标记为complete 一篇新闻稿必须经历撰写 → 编辑 → 签发才能发布 外部连接器抓来的元数据必须先过人工审查队列CLP 的做法是把领域规则从代码搬到数据.llmwiki/profile.json就是唯一的领域契约编译、审查、lint、导出、查看器、SDK、MCP 服务全部基于同一份契约运行。规则不合规时fail closed失败即拒绝而不是靠提示词约定。三种起步方式从最快到最灵活方式命令适合场景从零搭建llmwiki profile init research --entity paper想自定义领域模型逐实体增量添加内置模板llmwiki template init autosci或newsroom快速落地科研/编辑部场景团队本地模板llmwiki template init --file ./team-template.json团队共享同一套领域规范安装模板时会先确认类型化语料为空避免现有页面在新 Profile 下被孤儿化。模板只包含配置和示例永远不含可执行代码安全性有保障。模板机制的完整说明见 docs/configuration/profile-templates.mdx。llmwiki template inspect autosci # 先查看模板能力清单 llmwiki template init autosci # 生成 .llmwiki/profile.json llmwiki profile validate # 校验 Profile 是否合法读懂 profile.json六大声明块profile.json的完整 Schema 在 docs/configuration/profiles.mdx六大块一览声明块作用新手理解entities实体类型映射到wiki/下目录 字段契约我的知识有哪些名词每个名词有哪些必填字段relations实体间的有向类型化边论文引用论文实验检验想法lifecycle基于某个字段的有限状态机一个状态只能走到下一状态不能跳步workflows多阶段流程每阶段可读/可写哪些实体、需要什么门禁先读论文、再写想法最后产出实验结果artifacts带哈希锚定的类型化文件引用实验结果文件必须存在且内容没被篡改connectors绑定内置连接器如 Crossref到实体字段DOI 自动填充论文元数据先入审查队列一个最小的 Profile 长这样定义决策记录实体带三态生命周期{ schemaVersion: 1, profileId: team, displayName: Team Knowledge Base, entities: { decisions: { directory: wiki/decisions, fields: { title: { type: string, required: true }, stage: { type: enum, enum: [proposed, accepted, rejected], required: true } }, lifecycle: { field: stage, initial: proposed, terminal: [accepted, rejected], transitions: { proposed: [accepted, rejected] } } } } }生命周期门禁CLP 最有价值的部分普通状态机只管能不能跳CLP 的门禁preconditions管带什么证据才能跳。以 AutoSci 模板中的实验实体为例要进入complete状态必须同时满足✅ 存在resultSummary字段证据字段✅ 存在一条到ideas的tests关系关系计数✅ 指向一个内容哈希匹配的experiment-result工件工件引用任一条件缺失写入直接被拒绝。而且这道关卡不只在你手动执行命令时生效——页面写入、生命周期迁移、关系写入、工件写入、审查批准五个写入面都走同一套校验OKF 导入或工作流输出也无法绕过。这套机制的源码集中在 src/profile/ 目录核心校验逻辑见 src/profile/lifecycle.ts。实战用 AutoSci 搭一个科研知识系统AutoSci 是内置的完整科研 Profile12 种实体论文、想法、实验、手稿、方法、人物……、12 种关系、5 个工作流、7 种工件类型外加 Crossref 连接器绑定。按 docs/guides/autosci-research-workflow.mdx 走一遍典型链路第一步安装并校验llmwiki template init autosci llmwiki profile validate llmwiki workflow list第二步从 DOI 导入论文。配置好 Crossref 后运行llmwiki connector run crossref --input doi10.1145/...元数据会作为类型化候选进入审查队列而不是直接写库——外部数据默认不可信这是 CLP 的信任模型核心。第三步审查批准后成为正式页面页面落入wiki/papers/字段契约标题、DOI、年份、作者由 Profile 保证。第四步跑工作流。AutoSci 内置literature-review文献综述、research想法→实验→完成、manuscript-writing手稿写作与投稿等五个工作流每个阶段的读/写权限和门禁全部声明在 Profile 中。敏感阶段如写实验结果要求trust:high门禁需操作者显式授予。完整的能力矩阵见 docs/configuration/autosci-profile.mdx概念层面的设计思路见 docs/concepts/configurable-lifecycle-profiles.mdx。日常维护校验、体检与可视化Profile 装好后日常只需关注这几条命令命令用途llmwiki profile validate校验 Profile 语法与契约合法性llmwiki profile show查看当前生效的 Profile 摘要llmwiki lint发现漂移曾经合法、现在不再满足关系/工件要求的页面llmwiki status页面计数、审查队列等全局状态llmwiki view打开本地只读浏览器浏览实体页面、图谱和引用需要特别注意修改profile.json会改变 Profile 摘要digest可能影响模板兼容性检查所以升级 Profile 版本前先在测试项目验证。常见问题没有 profile.json 会影响现有项目吗不会。没有该文件的项目自动使用内置defaultProfile完全保持 1.0 之前的目录结构wiki/concepts/wiki/queries/。CLP 是纯增量能力。Profile 能写自定义代码吗不能也不需要。模板和 Profile 都是纯声明数据连接器只能绑定编译器内置的实现网络访问需操作者用LLMWIKI_CONNECTORS环境变量显式开启。什么时候该换 Profiletemplate init会拒绝在已有类型化语料上安装新 Profile因为切换可能使旧页面失去归属。想换领域模型建议开新项目。小结llm-wiki-compiler 的 CLP 用一句话概括领域知识长什么样写进profile.json怎么强制执行交给编译器。从llmwiki profile init手写一个最小实体到llmwiki template init autosci一键获得完整科研系统你都能在不读一行编译器源码的前提下搭出一个状态受控、引用可溯、审查有据的领域知识系统 【免费下载链接】llm-wiki-compilerThe knowledge compiler. Raw sources in, interlinked wiki out. Inspired by Karpathys LLM Wiki pattern.项目地址: https://gitcode.com/gh_mirrors/ll/llm-wiki-compiler创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考