@fugui200/llmwiki 0.1.2-beta.0 → 0.1.2-beta.1

package/README.md

@@ -51,9 +51,9 @@ llmwiki push "archive: update project notes"
 
 ## Agents
 
-- `codex`: writes `.llmwiki.json` and installs a global Codex hook.
-- `claude-code`: writes `.claude/settings.json` plus a lightweight `CLAUDE.md` block.
-- `gemini`: writes a lightweight `GEMINI.md` block.
+- `codex`: writes `.llmwiki.json`, installs a global Codex hook, and installs `llmwiki-connector` to `$HOME/.codex/skills/`.
+- `claude-code`: writes `.claude/settings.json` plus a lightweight `CLAUDE.md` block, and installs `llmwiki-connector` to `$HOME/.claude/skills/`.
+- `gemini`: writes a lightweight `GEMINI.md` block, and installs `llmwiki-connector` to `$HOME/.gemini/skills/`.
 - `all`: configures all supported agents.
 
 Agent integrations only inject routing metadata and recall rules. They do not

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fugui200/llmwiki",
-  "version": "0.1.2-beta.0",
+  "version": "0.1.2-beta.1",
   "description": "Project-scoped LLM wiki CLI for Codex, Claude Code, and Gemini",
   "bin": {
     "llmwiki": "bin/llmwiki.js"

package/scripts/codex-hook.js

@@ -77,6 +77,7 @@ function buildAdditionalContext(cwd) {
     'Use this as routing metadata only. Do not read or load global LLM Wiki pages at startup, after /clear, or for ordinary prompts.',
     'Search/read wiki pages only when the user asks to recall/archive knowledge, or when the current task clearly needs prior project context.',
     'When recall is needed, prefer current archiveProjects first; use shared patterns/tools/concepts only after keyword matching.',
+    'When the user asks to archive to llmwiki or 沉淀到 llmwiki, use the llmwiki-connector skill and the configured wikiRoot; do not route that task to OMX wiki.',
   ];
 
   if (legacyTargets.length) {

package/scripts/init-project.js

@@ -16,10 +16,11 @@
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
-const { writeProjectConfig, writeWorkspaceConfig } = require('./classify-project');
+const { resolveWikiRoot, writeProjectConfig, writeWorkspaceConfig } = require('./classify-project');
 
 const LLMWIKI_CONTEXT_BLOCK_START = '<!-- LLMWIKI:START -->';
 const LLMWIKI_CONTEXT_BLOCK_END = '<!-- LLMWIKI:END -->';
+const CONNECTOR_SKILL_NAME = 'llmwiki-connector';
 const STOP_HOOK_COMMAND = [
   'if [ -d ~/.llmwiki/.git ]; then',
   'echo \'[LLM Wiki] 如果本次工作产出了新知识',
@@ -99,9 +100,9 @@ function showInitHelp() {
   console.log('  为当前项目导入指定 Agent 的 LLM Wiki 接入配置。');
   console.log('');
   console.log('Agent:');
-  console.log('  claude-code  写入 .claude/settings.json hooks');
-  console.log('  codex        写入 .llmwiki.json 项目标记，并安装全局 Codex hooks');
-  console.log('  gemini       写入 GEMINI.md 项目上下文入口');
+  console.log('  claude-code  写入 .claude/settings.json hooks，并安装 $HOME/.claude/skills/llmwiki-connector');
+  console.log('  codex        写入 .llmwiki.json、全局 hook，并安装 $HOME/.codex/skills/llmwiki-connector');
+  console.log('  gemini       写入 GEMINI.md，并安装 $HOME/.gemini/skills/llmwiki-connector');
   console.log('  all          同时导入 claude-code、codex、gemini');
   console.log('');
   console.log('选项:');
@@ -348,6 +349,14 @@ function defaultWikiRootForProfile(profile) {
   return '~/.llmwiki';
 }
 
+function ensureTeamWikiRoot(config, configDir) {
+  if (config.profile !== 'team') return null;
+
+  const wikiRoot = resolveWikiRoot(config, configDir);
+  fs.mkdirSync(wikiRoot, { recursive: true });
+  return wikiRoot;
+}
+
 async function promptInteractiveConfig(args, input = process.stdin, output = process.stdout) {
   if (!input.isTTY || !output.isTTY) return args;
 
@@ -470,6 +479,7 @@ function installClaudeCode(projectRoot) {
   const claudeDir = path.join(projectRoot, '.claude');
   const settingsPath = path.join(claudeDir, 'settings.json');
   const claudePath = path.join(projectRoot, 'CLAUDE.md');
+  const skillResult = installConnectorSkill(path.join(resolveClaudeHome(), 'skills'));
   fs.mkdirSync(claudeDir, { recursive: true });
 
   let settings = {};
@@ -486,10 +496,12 @@ function installClaudeCode(projectRoot) {
 
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, '\t') + '\n');
   console.log(`✓ Claude Code hook/context 已${stopStatus === 'updated' ? '更新' : '导入'}: .claude/settings.json, CLAUDE.md`);
+  logSkillResult('Claude Code', skillResult);
 }
 
 function installCodex(projectRoot) {
   const result = installCodexGlobalHooks();
+  const skillResult = installCodexSkill();
   console.log('✓ Codex 接入已标记: .llmwiki.json');
   if (result.status === 'installed') {
     console.log(`✓ Codex 全局 hook 已写入: ${result.hooksPath}`);
@@ -500,13 +512,85 @@ function installCodex(projectRoot) {
   } else {
     console.log(`⚠ Codex 全局 hook 未写入: ${result.reason}`);
   }
+  if (skillResult.status === 'installed') {
+    console.log(`✓ Codex skill 已安装: ${skillResult.skillPath}`);
+  } else if (skillResult.status === 'updated') {
+    console.log(`✓ Codex skill 已更新: ${skillResult.skillPath}`);
+  } else {
+    console.log(`⚠ Codex skill 未安装: ${skillResult.reason}`);
+  }
   console.log('  Codex hook 只注入项目归属元数据；需要召回时再按需读取 wiki。');
 }
 
 function resolveCodexHome() {
-  return process.env.CODEX_HOME
-    ? path.resolve(process.env.CODEX_HOME)
-    : path.join(os.homedir(), '.codex');
+  return path.join(resolveUserHome(), '.codex');
+}
+
+function resolveClaudeHome() {
+  return path.join(resolveUserHome(), '.claude');
+}
+
+function resolveGeminiHome() {
+  return path.join(resolveUserHome(), '.gemini');
+}
+
+function resolveUserHome() {
+  return process.env.HOME ? path.resolve(process.env.HOME) : os.homedir();
+}
+
+function copyDirectory(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const from = path.join(src, entry.name);
+    const to = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectory(from, to);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(from, to);
+    }
+  }
+}
+
+function installConnectorSkill(skillsRoot) {
+  const skillSource = path.join(__dirname, '..', 'skill', CONNECTOR_SKILL_NAME);
+  const skillPath = path.join(skillsRoot, CONNECTOR_SKILL_NAME);
+
+  try {
+    if (!fs.existsSync(skillSource)) {
+      return {
+        status: 'failed',
+        skillPath,
+        reason: `skill 源目录不存在: ${skillSource}`,
+      };
+    }
+
+    const existed = fs.existsSync(skillPath);
+    copyDirectory(skillSource, skillPath);
+    return {
+      status: existed ? 'updated' : 'installed',
+      skillPath,
+    };
+  } catch (error) {
+    return {
+      status: 'failed',
+      skillPath,
+      reason: error.message,
+    };
+  }
+}
+
+function installCodexSkill() {
+  return installConnectorSkill(path.join(resolveCodexHome(), 'skills'));
+}
+
+function logSkillResult(agentName, result) {
+  if (result.status === 'installed') {
+    console.log(`✓ ${agentName} skill 已安装: ${result.skillPath}`);
+  } else if (result.status === 'updated') {
+    console.log(`✓ ${agentName} skill 已更新: ${result.skillPath}`);
+  } else {
+    console.log(`⚠ ${agentName} skill 未安装: ${result.reason}`);
+  }
 }
 
 function buildCodexHookCommand() {
@@ -585,8 +669,10 @@ function installCodexGlobalHooks() {
 
 function installGemini(projectRoot) {
   const geminiPath = path.join(projectRoot, 'GEMINI.md');
+  const skillResult = installConnectorSkill(path.join(resolveGeminiHome(), 'skills'));
   upsertContextBlock(geminiPath);
   console.log('✓ Gemini context 已导入: GEMINI.md');
+  logSkillResult('Gemini', skillResult);
 }
 
 function expandAgent(agent) {
@@ -634,22 +720,26 @@ async function main() {
 
     if (args.workspace) {
       const { configPath, config } = writeWorkspaceConfig(projectRoot, configOptions);
+      const createdWikiRoot = ensureTeamWikiRoot(config, projectRoot);
       console.log(`✓ workspace 配置已写入 ${path.relative(projectRoot, configPath)}`);
       console.log(`  - workspace: ${config.name}`);
       console.log(`  - profile: ${config.profile}`);
       console.log(`  - wikiRoot: ${config.wikiRoot}`);
       console.log(`  - sync: ${config.sync.type}${config.sync.branch ? ` ${config.sync.branch}` : ''}`);
       console.log(`  - projects: ${Object.keys(config.projectRoots).join(', ') || '(none detected)'}`);
+      if (createdWikiRoot) console.log(`✓ team wikiRoot 已创建: ${createdWikiRoot}`);
       wikiConfigWritten = true;
       return;
     }
 
     const { configPath, config } = writeProjectConfig(projectRoot, configOptions);
+    const createdWikiRoot = ensureTeamWikiRoot(config, projectRoot);
     console.log(`✓ project 配置已写入 ${path.relative(projectRoot, configPath)}`);
     console.log(`  - project: ${config.name}`);
     console.log(`  - profile: ${config.profile}`);
     console.log(`  - wikiRoot: ${config.wikiRoot}`);
     console.log(`  - sync: ${config.sync.type}${config.sync.branch ? ` ${config.sync.branch}` : ''}`);
+    if (createdWikiRoot) console.log(`✓ team wikiRoot 已创建: ${createdWikiRoot}`);
     wikiConfigWritten = true;
   };
 

package/skill/llmwiki-connector/SKILL.md

@@ -113,7 +113,7 @@ llmwiki init --agent gemini
 llmwiki init --agent all
 ```
 
-`llmwiki init` 在交互终端中会依次询问 agent、是否 workspace、profile（personal/team/local）和 wikiRoot；非交互环境必须显式传参。`claude-code` 写入 `.claude/settings.json` 归档提醒 hook，并在 `CLAUDE.md` 写入按需召回规则；`codex` 写入 `.llmwiki.json` 项目标记并安装全局 Codex hooks；`gemini` 写入 `GEMINI.md` 项目上下文入口；`all` 同时导入三者。三种接入默认只使用项目归属元数据和按需召回规则，不在启动、`/clear` 或普通提问时自动加载全局 wiki 页面。
+`llmwiki init` 在交互终端中会依次询问 agent、是否 workspace、profile（personal/team/local）和 wikiRoot；非交互环境必须显式传参。`claude-code` 写入 `.claude/settings.json` 归档提醒 hook、`CLAUDE.md` 按需召回规则，并安装 `$HOME/.claude/skills/llmwiki-connector`；`codex` 写入 `.llmwiki.json` 项目标记、全局 Codex hooks，并安装 `$HOME/.codex/skills/llmwiki-connector`；`gemini` 写入 `GEMINI.md` 项目上下文入口，并安装 `$HOME/.gemini/skills/llmwiki-connector`；`all` 同时导入三者。三种接入默认只使用项目归属元数据和按需召回规则，不在启动、`/clear` 或普通提问时自动加载全局 wiki 页面。
 
 ## 注意事项