Block a user
@yaha/llmwiki (0.1.1)
Published 2026-05-13 12:34:00 +00:00 by yaha
Installation
@yaha:registry=http://git.flyaha.top/api/packages/yaha/npm/npm install @yaha/llmwiki@0.1.1"@yaha/llmwiki": "0.1.1"About this package
Yaha LLM Wiki
基于 LLM 持续维护的个人知识库。通过 Claude Code + Hooks + Skills 实现：开发经验 → 知识召回 → 方案辅助 → 知识归档 的闭环。
核心理念
让 LLM 承担所有知识维护工作——更新交叉引用、保持文档一致性、自动归档开发成果——而人只需要做开发和决策。
Wiki 不是用来被人写的，而是用来被 LLM 写、被人读的。
整体架构
三层结构：
| 层级 | 说明 | 由谁维护 |
|---|---|---|
原始资料 (raw/, inbox/) |
不可变的源文档：会议记录、外部文档、临时笔记 | 人（只读归档） |
Wiki 页面 (projects/, patterns/, sessions/ 等) |
结构化的知识页面：项目架构、经验模式、决策 | LLM（自动维护） |
Schema (CLAUDE.md) |
定义 Wiki 的结构约定和 LLM 行为准则 | 人 + LLM 共同演进 |
工作流程
完整闭环
- 开发中遇到问题 — 在项目中打开 Claude Code
- PreHook 触发 — 自动
git pullWiki，注入 index.md 上下文 - 知识召回 — 搜索 Wiki 中相关的经验模式、项目架构、历史决策
- 辅助开发 — 基于已有知识提供方案建议
- PostHook 提醒 — 任务完成时提醒归档
- 归档到 Wiki — 将新经验、踩坑记录、技术方案写入 Wiki
- Push — 推送到私有 git 服务器
- 知识沉淀 — Wiki 越来越丰富，下一次效率更高
自动化程度
| 步骤 | 自动化 | 说明 |
|---|---|---|
| PreHook | 全自动 | 每次提问自动触发 |
| 知识召回 | 半自动 | LLM 自动搜索，人确认结果 |
| 开发实现 | 半自动 | LLM 编码，人 Review |
| PostHook | 全自动 | 每次任务结束自动提醒 |
| 归档 | 半自动 | 人说"归档"，LLM 执行写入 |
| Push | 需确认 | 人确认后推送 |
快速开始
方式一：npm install
# 配置 registry（一次性）
npm config set @yaha:registry https://git.flyaha.top/api/packages/yaha/npm/
# 全局安装
npm install -g @yaha/llmwiki
postinstall 会自动完成：
- clone 仓库到
~/.yahallmwiki（如不存在） - 安装
yahawiki-connectorskill 到~/.claude/skills/ - 配置全局 Hooks 到
~/.claude/settings.json
方式二：手动安装
# Clone 仓库
git clone work@git.flyaha.top:yaha/YahaLLMWiki.git ~/.yahallmwiki
# 或创建 symlink（如果本地已有开发目录）
ln -sf /path/to/YahaLLMWiki ~/.yahallmwiki
# 安装 skill
cp -r ~/.yahallmwiki/skill/yahawiki-connector ~/.claude/skills/
在项目中启用
cd your-project
yahawiki init
会在项目的 CLAUDE.md 中追加 Wiki 集成说明（幂等）。
使用方式
场景 1：查询已有知识
你: 之前 Xcode 构建报错是怎么解决的？
Claude Code:
→ 读取 Wiki 上下文（PreHook 已注入）
→ 找到 patterns/xcode-build-debug.md
→ 返回诊断流程和修复方案
场景 2：开发完成归档
你: 归档到 wiki，这次解决了 iOS 签名的问题
Claude Code:
→ 创建或更新 patterns/ios-signing.md
→ 更新 index.md 和 log.md
→ git commit + push
场景 3：项目架构记录
你: 把 PawFriend 的架构设计记录到 wiki
Claude Code:
→ 创建 projects/superpet.md
→ 记录三层解耦架构、模块依赖、Design Token 体系
→ 更新 index.md
目录结构
YahaLLMWiki/
├── CLAUDE.md # Schema：LLM 行为准则和工作流定义
├── index.md # Wiki 总索引（LLM 导航入口）
├── log.md # 操作日志
├── package.json # npm 包配置
│
├── projects/ # 项目文档
│ ├── shigaungji.md # 拾光辑
│ ├── superpet.md # PawFriend
│ └── ...
│
├── patterns/ # 跨项目经验模式
│ ├── xcode-build-debug.md
│ ├── cache-strategy.md
│ └── ...
│
├── sessions/ # 会话级学习记录
├── concepts/ # 概念和规范
├── decisions/ # 技术决策记录
├── rules/ # 约束规则
├── tools/ # 工具使用经验
│
├── raw/ # 原始资料（只读）
├── inbox/ # 待处理输入
├── scripts/ # 自动化脚本
├── skill/ # Claude Code Skill
│ └── yahawiki-connector/
└── bin/ # CLI 工具
└── yahawiki.js
CLI 命令
yahawiki init # 在当前项目启用 Wiki 集成
yahawiki push "消息" # 提交并推送 Wiki 变更
yahawiki pull # 拉取最新内容
yahawiki --version # 显示版本号
配置全局 Hooks
安装时自动配置。如需手动添加，在 ~/.claude/settings.json 中：
{
"hooks": {
"UserPromptSubmit": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "if [ -d ~/.yahallmwiki/.git ]; then cd ~/.yahallmwiki && git pull --rebase -q 2>/dev/null; echo '=== Yaha Wiki Index ==='; head -60 index.md 2>/dev/null; echo ''; echo '=== Recent Log ==='; tail -5 log.md 2>/dev/null; fi"
}
]
}
],
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "if [ -d ~/.yahallmwiki/.git ]; then echo '[Yaha Wiki] 如果本次工作产出了新知识，可以说「归档到wiki」来沉淀。'; fi"
}
]
}
]
}
}
发布新版本
# 修改 package.json 中的 version
npm publish
FAQ
Q: 和 ~/.llmwiki 有什么关系？
完全独立。~/.llmwiki 是公司团队 Wiki，~/.yahallmwiki 是个人私有 Wiki，互不干扰。
Q: 如何升级？
npm update -g @yaha/llmwiki
Q: 不想每次都触发 PreHook？
在 hook 的 matcher 中添加条件，或在特定项目的 .claude/settings.local.json 中覆盖。
Details
2026-05-13 12:34:00 +00:00
Assets (1)
Versions (2)
View all
npm
0
UNLICENSED
latest
50 KiB
llmwiki-0.1.1.tgz
50 KiB