mcpField
I
init

init

github.com/davepoonAgent 工作流3.7k59 次安装1 天前更新
代码仓库

关于 init

init 是用于配置 Origin 的技能，可使其守护进程和 MCP 连接进入可用状态。它会检查守护进程、按需安装 CLI、验证后端，并测试 MCP 往返调用。

主要功能

  1. 01检查守护进程健康状态
  2. 02按需安装并启动守护进程
  3. 03验证已配置的后端
  4. 04测试 MCP 连接
  5. 05报告设置状态

适用场景

  1. 01安装插件后配置 Origin
  2. 02排查守护进程未运行提示
  3. 03检查 Origin 是否正常工作

MCP 相关

调用 Origin MCP 服务的 doctor 工具验证后端，再调用 context 测试 MCP 连接。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davepoon/buildwithclaude --skill init

安装后在 Claude Code 中输入/init确认已加载。

详细介绍

/init

自修复设置。目标：30 秒内完成，最多需要用户执行两项操作（安装插件， 输入 /init）。默认后端为本地内存——无需本地模型、API 密钥或提示词。本地模型和 Anthropic 密钥是可选升级，相关说明见 /help。

步骤

按顺序执行。遇到需要人工处理的首个故障时，停止并报告。否则，自动继续执行。

1. 守护进程健康检查
Bash: curl -fsS -m 1 http://127.0.0.1:7878/api/health
  • 200 OK → 跳至步骤 4。
  • 其他情况 → 步骤 2。
2. 引导设置（缺失时自动安装）

检测 origin CLI 是否在 PATH 中：

Bash: command -v origin >/dev/null 2>&1 && echo present || echo absent

如果为 absent，运行安装程序（不提示用户）：

Bash: curl -fsSL https://raw.githubusercontent.com/7xuanlu/origin/v0.6.1/install.sh | bash

然后将其添加到当前会话的 PATH，并以非交互方式配置本地内存：

Bash: export PATH="$HOME/.origin/bin:$PATH" && origin setup --basic && origin install

如果为 present（CLI 存在，但守护进程未运行），只需安装并启动：

Bash: origin setup --basic 2>/dev/null || true; origin install

origin setup --basic 具有幂等性，可安全地重复运行。origin install 会写入 launchd plist 并启动守护进程。

3. 再次检查守护进程健康状态
Bash: for i in 1 2 3 4 5; do curl -fsS -m 1 http://127.0.0.1:7878/api/health && break; sleep 1; done

如果约 5 秒后仍无法连接守护进程，则显示错误并停止。 可能原因：launchd plist 加载失败、端口 7878 被其他 进程占用，或 macOS Tahoe Metal 初始化问题（守护进程会降级运行，但仍会绑定端口—— 检查 lsof -ti :7878）。

4. Doctor（验证后端）

调用 origin MCP 服务的 doctor 工具：

doctor()

预期结果：已配置本地内存（无模型、无密钥）。记录模式 字符串，以便在最终报告中使用。

5. MCP 往返测试
context()

通过 → 继续。失败 → MCP 未接通。告知用户： "origin-mcp 没有响应。请重启 Claude Code，让插件的 .mcp.json 重新启动服务。"

6. 就绪报告

输出：

Origin ready.
  Daemon:   up on 127.0.0.1:7878
  Mode:     <mode from doctor()>
  MCP:      connected
  Data:     ~/.origin/  (pages, sessions, db symlink)
  Try:      /brief, /capture <thing>, /recall <query>, /help

如果这是本次会话中首次调用 /init，则调用一次 /help， 让用户无需询问即可看到动词速查表。

可选升级（不要自动运行）

仅当用户明确要求“更丰富的功能”或询问由模型支持的提取功能时，才在就绪报告中 提及以下选项：

  • origin model install — 安装本地 Qwen，用于蒸馏周期。
  • origin key set anthropic — 使用 Anthropic 进行更强的综合处理。

默认流程不会执行这两项。本地内存模式下，存储、搜索、回忆和 MCP 内存均可 正常工作。

适用场景

  • 执行 /plugin install origin@7xuanlu 后立即使用。
  • 钩子打印了“daemon down — run /origin:init”。
  • 用户说“设置 origin”、“能用吗”或“重新安装 origin”。

不适用场景

  • 本次会话中已验证守护进程 → 改用 /brief。
  • 仅编辑一个配置字段 → 使用 origin doctor 或直接编辑设置文件。

评论

支持 Markdown