百科 Wiki 与命令行工具

2SOMEone Wiki 用来沉淀主播、团体和社区相关的公开资料。你可以直接浏览公开内容，也可以通过官方命令行工具 2s1 查询、编辑、认领和管理自己有权限的 Wiki。

安装并查看能力

npm install -g @2someone/cli@latest

# 查看当前版本支持的命令、权限和安全边界
2s1 --json wiki context

公开读取不要求登录：

2s1 wiki list --query "名称" --subject person
2s1 wiki show <wiki-id-or-slug>
2s1 wiki ai-context <wiki-id-or-slug>
2s1 wiki revisions <wiki-id-or-slug>
2s1 wiki revision show <wiki-id-or-slug> <revision-id>

ai-context 返回适合交给 AI 编程助手使用的安全上下文。所有命令都支持全局 --json，方便脚本读取稳定的结构化结果。

登录并管理 Wiki

写入操作使用你自己的账号密钥，不支持机器人运行密钥：

2s1 login
2s1 whoami
2s1 wiki mine

Level 1 及以上用户可以创建符合平台规则的 Wiki。有权限的用户可以修改标题、摘要和段落：

2s1 wiki create --subject person --ownership platform_user --title "名称"
2s1 wiki update <wiki-id-or-slug> --title "新标题" --summary "简介"
2s1 wiki section upsert <wiki-id-or-slug> \
  --kind backstory --markdown "正文" --edit-summary "补充经历"

section upsert 的正文可以使用 --markdown，也可以通过 --body-file 传入 infobox 或 timeline 的 JSON；两者不能同时使用。

使用 AI 生成草稿

AI 草稿只返回建议内容，不会自动覆盖 Wiki：

# 为整篇 Wiki 生成草稿
2s1 --json wiki draft <wiki-id-or-slug> --instruction "整理结构并精简措辞"

# 为指定段落生成草稿，并补充本地资料
2s1 --json wiki draft <wiki-id-or-slug> \
  --kind backstory --material-file ./notes.md

认领 Wiki

符合条件的个人或团体 Wiki 可以由权利人认领。提交者需要先在 2SOMEone 绑定对应的抖音或 B 站账号：

2s1 wiki claim <wiki-id-or-slug> --note "补充账号归属说明"
2s1 --json wiki claim-status <wiki-id-or-slug>

认领审核由平台系统管理员处理，CLI 不提供批准或拒绝认领的命令。

权利人治理

Wiki 所有者、共同所有者和编辑者可以按各自权限管理修订与段落：

2s1 wiki approve <wiki-id-or-slug> <revision-id> --yes
2s1 wiki protect <wiki-id-or-slug> <section-id> --mode open --yes
2s1 wiki review-mode <wiki-id-or-slug> --mode pending --yes
2s1 wiki revert <wiki-id-or-slug> <revision-id> --yes
2s1 wiki role list <wiki-id-or-slug>
2s1 wiki role grant <wiki-id-or-slug> --kind wiki_editor --username <用户名> --yes
2s1 wiki role revoke <wiki-id-or-slug> <role-id> --yes

权限边界

Club Owner 或 Admin 只能管理当前归属于该 Club 的 Wiki。平台系统管理员是独立的全局角色，不能从 Club 身份推导。修订隐藏、Wiki 删除、段落删除和认领审核等平台管理操作不在 CLI 中开放。

会改变真实内容或权限的治理命令要求显式传入 --yes。执行前建议先运行 2s1 wiki show <wiki-id-or-slug>，根据返回的 capabilities 判断当前账号可以执行哪些操作。