Wiki 空间、分页与动态参考

只在根 Skill 的 Golden Route 不足时读取相关章节。节点写操作和成员管理分别读取对应 operation reference。

空间定位

已知条件	入口
精确 workspaceId 或知识库 URL	`+space-get --workspace <值>`
名称且必须得到唯一 ID	`+space-list --type <orgWikiSpace\|myWikiSpace> --limit 50 --page-all` 后按完整名称精确匹配
关键词且需要浏览候选	`+space-search --query <关键词>`
明确要列出组织/个人知识库	`+space-list --type orgWikiSpace

名称解析前先明确组织知识库还是个人知识库；范围未知时向用户消歧。只有 +space-list 返回 autoPageComplete=true，并且完整结果中恰好一个名称精确相等的空间时，才可把其 workspaceId 交给后续写操作。0 条、多条、分页未完成都停止，不选择第一项。

+space-search 用于候选发现，但当前没有可执行的续页 flag；+resolve-space 和 +wiki-new-doc 的内部名称搜索也不暴露分页完成证据。因此这三个入口的单页结果都不能证明全局唯一，当前不用于写入前的权威身份解析。空关键词不能构造 --query ""。

Runtime 确认与首次执行

先唯一解析 workspace、node、目标父节点或成员，再以精确 leaf Schema 和 Runtime gate 判断是否需要确认；不要通过一次缺少 --yes 的失败调用探测确认要求。
Runtime 要求确认且当前请求已明确授权具体空间/节点/成员、动作、目标位置或角色及影响时，首次正式远端写调用直接追加 --yes。只有“整理知识库”“调整成员”等宽泛意图时必须先补齐范围。
Runtime 不要求确认时不添加 --yes。需要询问时，确认后必须保持同一 profile、对象、动作、范围和关键参数；移动目标、成员列表、角色或其他影响范围变化时重新确认。
只读定位和检查不加 --yes。收到 confirmation_required 仅表示尚未通过预执行门禁，不代表业务写入成功，也不能据此盲目重放。

全量分页

+space-list、+node-list、+feed-list 支持自动翻页：

dws wiki +space-list --page-all --page-limit 20 --format json
dws wiki +space-list --type orgWikiSpace --limit 50 --page-all --format json
dws wiki +node-list --workspace <ID> --page-all --max-items 500 --format json
dws wiki +feed-list --workspace <ID> --page-all --format json

--page-all 才启用自动翻页；--page-limit/--max-items/--page-delay 不能单独使用。
autoPageComplete=true 且 endpoint exhausted 才表示端点取完；达到 page/items 上限必须保留 continuation/stop reason。
游标缺失、停滞、循环或后续页失败均不能返回“全部”。
+node-search 当前保留服务端单页 cursor；需要续页时使用真实 nextCursor，不手工猜 token。

空间创建与删除

dws wiki +space-create --name "产品文档库" --desc "团队资料" --format json
dws wiki +delete-space --workspace <workspaceId> --format json

名称最多 32 字符，描述最多 500 字符；本地校验失败不能产生远端调用。
创建必须返回 workspaceId，并通过 get_wikiSpace 读回同一 ID。
删除整个知识库前先读取目标，经 Runtime 确认后只接受 success=true。

知识库动态

dws wiki +feed-list --workspace <workspaceId> --limit 20 --format json

动态用于回答“谁在何时创建、更新或评论了什么”。需要排除普通文件时加 --exclude-file；需要完整范围时加 --page-all。节点正文或历史版本不从 feed 推断，锁定 nodeId 后切 Doc。

响应与错误

空响应、success=false、畸形 wrapper、缺失业务数组都属于失败，不是零条数据。
集合结果检查 count 与对应 spaces/nodes/feeds；分页检查 nextCursor/hasMore 及 meta.pagination。
读写始终保持同一 profile。权限失败不能通过切换账号或退回 Drive 猜测解决。
写入提交后连接中断时先用返回/已知 ID 读取；无法证明是否提交则报告未知效果，不自动重试非幂等创建。

4.2 KiB Raw Permalink Blame History