agent-wiki

agent-wiki — Claude Code 插件

agent-wiki 通过 MCP 为 Agent 提供私有 Markdown 项目记忆。此公开仓库分发 0.3.0 版本，其中包含需显式调用的 /agent-wiki:setup 技能，以及位于 https://getagentwiki.com/mcp 的远程服务。它不包含凭据、依赖项或自动写入钩子。

安装

首先在 Claude Code 中检查 /mcp。如果 agent-wiki 已通过直接服务或 claude.ai 连接器正常工作，请保留该连接，并在安装前阅读现有连接。

在 shell 中运行以下命令：

claude plugin marketplace add animal-ltd/agent-wiki-plugin
claude plugin install agent-wiki@agent-wiki --scope user

对应的交互式命令为 /plugin marketplace add animal-ltd/agent-wiki-plugin 和 /plugin install agent-wiki@agent-wiki；请在插件管理器中选择预期的范围。

• user：你可在不同项目中使用此技能和捆绑的服务。
• project：通过此仓库的 Claude 设置与协作者共享。
• local：仅你本人可在此项目中使用。

只有在有意选择时，才使用 --scope project 或 --scope local。在项目目录中使用 --scope user 安装，仍会使其在所有项目中可用。安装范围不会授予知识库访问权限。捆绑的端点适用于整个账户；除非你主动选择更广泛的连接，否则不要替换现有的单知识库连接。

重启 Claude Code。在 /plugin 中，检查 Installed，确认 agent-wiki 已启用且版本为 0.3.0；如果缺少 /agent-wiki:setup，请检查 Errors。支持 /reload-plugins 的客户端也可使用该方式；请按照其重新加载说明操作。通过 shell 安装不会更新已运行的会话。

先进行身份验证，再运行设置

安装只会加载技能和服务。打开 /mcp，选择当前启用的 agent-wiki 服务，并在需要时选择 Authenticate 或 Re-authenticate。在浏览器中完成登录和授权，然后返回正在等待的客户端。切勿分享凭据或 OAuth 回调 URL。对于名为 agent-wiki 的直接服务，Claude Code v2.1.186 或更高版本也支持 claude mcp login agent-wiki。非交互式提示无法完成交互式 OAuth。

当 /mcp 显示连接和工具后，调用：

/agent-wiki:setup

你可以提供知识库名称或 ID。该技能会通过 list_wikis 确认访问权限；如果选择不明确，会询问你；随后检查知识库状态，并最多读取三篇引导页面。它会使用现有连接配置私有项目指令和只读检索钩子。原生钩子要求 Claude Code 2.1.282 或更高版本。启用检索前，它会说明当前提示词（包括粘贴的文本）会被临时发送以进行检索，并允许你选择仅配置指令。该钩子不会额外添加对话记录、本地路径或凭据字段，但提示词中包含的所有文本都会被发送。Agent-wiki 不会在日志中保留提示词文本；客户端的对话历史则是独立的。现有设置、权限和其他钩子都会保留。

配置无需保存新的决策。如果确实需要，助手会显示确切的说明和保存位置，并等待你批准。它会使用稳定的写入请求 ID，保留当前版本，验证已保存的修订版本，并搜索保存结果。现有决策不会再次保存。示例不会作为决策保存。

如果凭据过期，请返回 /mcp，对所选连接重新进行身份验证。如果权限为只读、缺少访问权限、工具调用遭到拒绝或你取消了操作，设置流程会报告尚未完成的事项，且不会绕过失败。重新运行时会检查是否已有已保存的决策，而不会重复保存。保存后验证失败时，会报告为未验证，而非已完成。

现有连接

/mcp 会标识服务来源和隐藏的重复项。直接定义可以优先于指向同一 URL 的插件服务或继承自 claude.ai 的连接器。设置技能可以使用已确认的现有连接；安装不需要删除该连接。如果有多个可用连接，请明确选择一个。不要仅为了缩短列表而移除正常工作的服务或为重复项进行身份验证。

是否继承 claude.ai 连接器取决于当前登录方式。检查 /status：使用 API 密钥和其他提供商身份验证时，不会加载继承的连接器。仅有之前的 claude.ai 登录记录，并不能证明现在仍会继承。如果继承的连接器需要授权，请使用其 claude.ai 控件；如果 Claude Code 会话令牌被拒绝，则需要执行 /login。是否更改登录方式或连接范围由你决定，不会由设置流程自动执行。Anthropic 的 MCP 文档 介绍了当前行为。

不使用插件时，可以通过 claude mcp add --transport http agent-wiki https://getagentwiki.com/mcp 建立直接连接；其默认的本地范围仅供你在此项目中使用。它不会安装设置技能。请先检查现有连接，然后单独进行身份验证。

从较早版本升级

使用与现有安装相同的范围（可在 /plugin 中查看）：

claude plugin marketplace update agent-wiki
claude plugin update agent-wiki@agent-wiki --scope user

重启 Claude Code，在 /plugin 中检查版本是否为 0.3.0，并确认 /agent-wiki:setup 可用，然后再使用。仅刷新目录并不会更新插件。插件版本控制缓存更新；不要编辑缓存的运行时文件。如果仍显示旧版本，请检查更新输出、市场来源、所选范围以及 /plugin 中的 Errors。不要清除整个 Claude 配置或凭据缓存。

以下是 Claude Code 2.1.282 中受支持的命令；请参阅插件参考和安装指南。客户端验收记录（包括经过测试的版本和公开发布 SHA）在 #83 中跟踪。仅检查源代码不能证明身份验证成功或设置成功。

回滚

要停止使用此版本，请在 /plugin 中禁用它并重启。这不会删除 Wiki 内容；仍可继续使用直接连接。

检索钩子仅限于项目，并且独立于插件是否启用。要停止自动检索，请让 Claude 仅移除 .claude/settings.local.json 中可识别的 agent-wiki UserPromptSubmit 钩子，同时保留其他钩子、权限和现有连接。请单独保留或有意移除带标记的说明。

对于较早发布的 0.1.0 公共制品，请先记下你的市场来源和安装范围。此市场仅包含 agent-wiki。移除它会卸载其中的插件，因此仅在你决定替换该安装时执行：

git clone https://github.com/animal-ltd/agent-wiki-plugin.git agent-wiki-plugin-rollback
git -C agent-wiki-plugin-rollback checkout --detach 81a790d715dfbd9412d1a30862d9c297afc290d7
claude plugin marketplace remove agent-wiki
claude plugin marketplace add ./agent-wiki-plugin-rollback
claude plugin install agent-wiki@agent-wiki --scope user

重启并在 /plugin 中检查版本是否为 0.1.0。旧制品包含 MCP 服务，但没有设置技能。请将该检出保持在固定的提交版本，在准备好升级之前，不要更新或删除其目录；要恢复使用当前版本，请将其替换为上文未固定版本的公共来源。整个过程中请使用原始安装范围。Wiki 写入内容有单独的版本历史；回滚插件不会撤销这些更改。

维护者

规范来源是 animal-ltd/agent-wiki：plugins/agent-wiki、.claude-plugin/marketplace.json、此 README（其中的 plugins/README.md）、plugins/LICENSE 和 scripts/verify-plugin-package.mjs。使用 scripts/export-plugin.mjs 从已提交的源代码导出，并提交经审核的公开 PR。不要手动编辑公开副本，也不要在无人监督的情况下将同步内容推送到 main。

SOURCE.json 记录了应用源代码的 SHA、每个导出文件的 SHA-256、组合校验和以及生成的首条提示词的校验和。使用 Node.js 22 或更高版本验证自包含的公开制品：

node scripts/verify-plugin-package.mjs .
claude plugin validate . --strict
claude plugin validate plugins/agent-wiki --strict

该回执用于一致性检查，并非签名：请将其与独立的应用导出内容和经审核的提交进行比对。公开发布 SHA 和客户端回执存放在源代码提交之外，因此回执不会引用自身的哈希值。

设置指南 · 隐私 · 条款 · 安全