paperclip-wiki-manage

Paperclip Wiki 管理

仅通过已确认的 paperclipai.plugin-llm-wiki 插件桥接写入路由管理 Paperclip llm-wiki 内容。

使用 paperclip-wiki-fetch 读取页面内容、页面列表、来源列表，以及转换 SPA URL 路径。仅在修改 wiki 时使用此技能。

路径形式与 MCP 注意事项

• 操作桥接（写入）：/api/plugins/paperclipai.plugin-llm-wiki/actions/<key>，请求体 { "companyId": "...", "params": { ... } }。
• 限定范围的 REST（写入）：/api/plugins/paperclipai.plugin-llm-wiki/api/<route>（多一个 /api 段），扁平 JSON 请求体。

通过 MCP paperclipApiRequest 调用时，省略开头的 /api——MCP 会添加此前缀；/api/plugins/... 会变成 /api/api/...，导致 404。直接使用 REST / curl 时，需使用完整的 /api/plugins/... 路径并携带 bearer token。

已确认路由要求

不要猜测 wiki 写入路由。已验证的路由（均已确认不会创建操作/任务，除非另有说明）：

POST /api/plugins/paperclipai.plugin-llm-wiki/actions/write-page   # write/replace a page directly — NO task ✅
POST /api/plugins/paperclipai.plugin-llm-wiki/api/sources          # capture a raw source into raw/ — NO task ✅
POST /api/plugins/paperclipai.plugin-llm-wiki/api/spaces           # create a space (board)

避免使用 …/api/file-as-page：此路由会写入页面，但也会创建一个（自动完成的）file-as-page 操作问题，留下任务记录。如需直接写入干净的页面，请使用 actions/write-page。

使用 actions/write-page 写入 markdown 页面。已验证的请求体格式：

{
  "companyId": "<company-id>",
  "params": {
    "wikiId": "default",
    "spaceSlug": "<space-slug>",
    "path": "wiki/sources/example.md",
    "contents": "# Example\n",
    "expectedHash": "<optional-current-hash>",
    "summary": "<optional-change-summary>"
  }
}

使用 api/sources 存入原始来源（与 wiki-contribute 技能使用的底层机制相同）。扁平请求体为 {companyId, wikiId, spaceSlug, sourceType:"text", title, contents, url?, metadata?}；返回 {sourceId, rawPath, hash}。此操作会将内容放入空间的 raw/ 目录，状态设为 captured，且不会触发 Wiki Maintainer。

**空间：**写入目标由 spaceSlug 指定（默认为 default；也存在各创建者/团队的空间，例如 creator-jane）。通过 fetch 技能的 api/spaces 路由列出空间。空间内的路径均为相对路径（wiki/...、raw/...）。

使用其他 wiki 修改路由时，需从以下来源之一确认插件桥接写入路由及其架构：

• Paperclip/插件官方文档
• 检查过的 Paperclip/插件源代码
• 操作员提供的可用示例
• 能证明路由约定的成功非修改性架构/选项/读取探测

路由必须位于以下某个位置：

/api/plugins/paperclipai.plugin-llm-wiki/data/...
/api/plugins/paperclipai.plugin-llm-wiki/actions/...

绝不要使用 /api/wiki/...，也绝不要通过重命名读取路由来推断写入路由。

修改工作流

1. 对请求的修改进行分类：
   • 创建页面
   • 更新页面正文或标题
   • 移动或重命名页面路径
   • 归档或删除页面
   • 创建、更新、归档或删除已捕获的来源
   • 其他插件支持的 wiki 修改
2. 检查 Paperclip 上下文和身份验证信息，不要打印机密。
3. 使用 paperclip-wiki-fetch 获取当前 wiki 状态：
   • 选择目标时，列出页面或来源
   • 编辑现有页面前，获取页面内容
   • 记录标题、路径、更新时间和哈希（如有）
4. 确认准确的写入路由、HTTP 方法和请求架构。写入页面时，使用 POST /api/plugins/paperclipai.plugin-llm-wiki/actions/write-page。
5. 起草准确的拟议修改：
   • 目标公司、wiki、空间、路由和路径
   • 省略机密的请求 JSON
   • 页面正文修改的 Markdown 差异，或创建页面时的完整正文
   • 预期的标题、路径、页面类型、来源元数据，以及哈希/更新时间行为
6. 写入前，征求操作员的明确批准。
7. 写入前一刻，如果目标页面或来源已存在，则重新获取。
8. 如果自获批后更新时间或哈希已变更，请停止并询问是否要基于最新状态重新应用编辑。
9. 仅通过已确认的插件桥接路由应用获批的修改。
10. 读取页面或来源并验证：
    • 标题
    • 路径
    • 正文或来源元数据
    • 页面类型（如有）
    • 更新时间
    • 哈希
11. 报告所用路由、记录标识符、验证结果及任何尚未确认之处。

审批规则

• 每次创建、更新、移动、重命名、归档、删除、捕获来源或修改来源前，都要先征求同意。
• 破坏性操作需要获得特别明确的批准，其中必须注明目标路径／来源和操作。
• 除非操作者批准了确切的批次，否则不得将多项 Wiki 修改合并到一次审批中。
• 除非其他技能的已批准工作流明确要求，否则不得通过此技能修改 Paperclip 问题、目标、项目、Agent 或审批。

故障处理

• 如果没有已确认的写入途径，则停止操作，并报告 Wiki 管理因途径／架构发现而受阻。
• 如果缺少身份验证信息、公司 ID、Wiki ID、空间 slug、页面路径或目标来源 ID，且无法推断，则询问缺少的信息。
• 如果读回结果与预期修改不符，则报告差异；未经重新批准，不得进行后续修复。
• 如果请求的操作会发布敏感、机密或未经批准的外部内容，则停止操作并请求操作者审核。

安全默认值

• 仅当现有 Wiki 上下文或用户提示支持时，才将 wikiId 默认设为 default。
• 仅当现有 Wiki 上下文或用户提示支持时，才将 spaceSlug 默认设为 default。
• 除非操作者明确要求重命名或移动，否则保留现有页面路径和标题。
• 优先进行小范围、有针对性的编辑，而不是替换整个页面。
• 除非操作者明确要求将内容发布或同步到 Wiki，否则将 Paperclip 计划文档作为事实来源。