更新日志

CLI 1.4.74 起，multica update 显示更新仓库，支持从私有仓库 GAIR-NLP/multica 下载并校验发布包，不会回退到开源版或其 Homebrew tap。

# 使用有私有仓库访问权限的 GitHub 账号登录（只需一次）
gh auth login --hostname github.com
multica update
multica version

也可设置 GH_TOKEN 或 GITHUB_TOKEN；优先级为 GH_TOKEN → GITHUB_TOKEN → gh 登录凭据。细粒度 token 需为该仓库授予 Contents: read。

1.4.73 及更早版本需先手动升级一次，见 CLI 升级说明。旧版更新器缺少私有仓库鉴权，仅执行 multica update 仍会返回 404。

关闭单条、子 issue 或批量完成时，交付物均为选填。仍可提交交付物和附件，或在完成后点击“添加交付物”补交；已有交付物和版本历史保留。

CLI

以下命令需要 CLI 1.4.73 或更新版本。建议使用 1.4.74+，支持私有仓库自更新；更早版本需先按 CLI 升级说明 手动升级一次，再使用 multica update。

# 直接关闭，也支持一次关闭多个 issue
multica issue close <id>
multica issue close <id-1> <id-2>

# 以下两种状态更新方式同样无需交付物
multica issue status <id> done
multica issue update <id> --status done

# 关闭时提交交付物，可选附加文件
multica issue status <id> done --deliverable-file report.md --attachment result.zip

# 完成后补交，或追加一个新版本
multica issue deliverable add <id> --deliverable-file report.md

短文本可用 --deliverable "完成说明"，多行内容可用 --deliverable-file 或 --deliverable-stdin。不提交交付物时省略这些参数；上传交付物附件时仍需填写说明。

共享上下文是什么

把术语、规范、资源位置、权限申请方式和必读文档配置一次，供相关 issue 与智能体重复使用。

有项目的 issue 按项目边界继承上下文；无项目的 issue 使用工作区和自身材料。可通过 context effective 查看有效范围与规则。

从零开始

先给知识空间添加 Ginit Bot

顶层项目绑定根 Wiki 前，先在飞书知识空间中添加当前工作区使用的 Ginit Bot，让它能够访问知识库。

1. 打开目标飞书知识库，点击左下角齿轮进入知识库设置。
2. 进入成员设置 → 管理员，点击添加管理员。
3. 搜索并添加 Ginit（当前工作区使用的 Bot），确认它已出现在成员列表中。
4. 回到 Multica 项目的共享上下文 → 添加根知识库，粘贴该知识空间中目标根节点的 Wiki 链接并绑定。

若后续需要 Bot 创建 issue 文档，还需确认它对目标知识空间和顶层节点具有编辑权限；仅操作者本人是管理员并不足够。

配置与使用

1. 配置公共背景：owner/admin 在工作区上下文中添加通用说明、文档或群聊；只有每次开工必须看的内容才标记为默认必读。
2. 有项目时绑定知识库：进入项目共享上下文，点击“添加根知识库”。顶层项目粘贴飞书 Wiki 链接；子项目从父项目可选文档中选择。绑定后可展开文档树、预览和重新同步正文。
3. 给 issue 聚焦材料：在 issue 上下文中点击“添加上下文”。有项目的 issue 可选择继承的项目文档，也可添加 issue 自有文档；无项目的 issue 直接添加自己的材料，不使用项目文档绑定。
4. 接手时检查：运行 multica issue context effective <issue-id> --output json，阅读必需文档及相关会话；续跑时重新检查是否新增材料。

新建 issue 飞书文档需要对应的根 Wiki：有项目时使用项目根节点，无项目时使用工作区根节点。文档创建在该根节点下，归 issue 所有。添加文字说明或关联 Agent Session 无需根 Wiki。

子项目绑定自己的根 Wiki 后，以该节点为新的文档边界。普通项目文档在飞书中创建、移动和删除；解绑根 Wiki 不删除飞书原文。解除 issue 的项目文档引用也不删除原文；切换或移除所属项目会清空旧项目的聚焦引用。

常用 CLI

# 添加工作区通用说明（owner/admin）
multica workspace context add --kind safety --title "发布要求" --body "先通过测试，再申请发布"

# 顶层项目绑定根 Wiki；子项目使用下方 promote 命令
multica project context add <project-id> --kind resource --source-type feishu_wiki --source-ref "<飞书 Wiki 链接>" --title "项目知识库" --root-wiki

# 查看父项目文档 ID，再将可选文档设为子项目根 Wiki
multica project context list <parent-project-id> --output json
multica project context promote <child-project-id> <parent-context-id>

# 将项目文档聚焦到该项目的 issue；context-id 来自项目列表
multica issue context bind <issue-id> <project-context-id>

# 添加仅属于当前 issue 的文字说明或已有飞书文档
multica issue context add <issue-id> --kind resource --title "验收说明" --body "需要验证的场景与预期结果"
multica issue context add <issue-id> --kind resource --source-type feishu_doc --source-ref "<飞书文档链接>" --title "设计说明"

# 查看 issue 关联条目及有效上下文
multica issue context list <issue-id> --output json
multica issue context effective <issue-id> --output json

context list 显示关联条目；文档正文可能是同步快照，最新内容可在 Multica 预览或打开原链接查看。查询失败不代表没有上下文。

当前会话可在上传时指定 issue，已有云端会话可直接关联；随后读取摘要和相关轮次。命令见 Agent Session 关联与读取。

权限与使用提醒

关联上下文不会扩大原文档或会话的访问权限。owner/admin 可用 multica workspace context scan 检查敏感内容；context-id 支持完整 UUID 或至少 4 位的唯一前缀。

边开会，边转写、提问

Meeting 把会议录音、实时转写和会中问答放在同一个页面。浏览器采集麦克风音频，左侧逐句显示转写，右侧可以随时询问“刚才有哪些结论？”或“下一步要做什么？”，答案基于当前会议内容。

开始一场会议 · 查看我的会议 · 完整使用指南

这次带来了什么

一条命令开始

更新并登录 ginit 后运行：

ginit update
ginit login
ginit meeting record --title "项目周会"

浏览器会打开这场会议的录音页。允许麦克风权限，确认 ASR 状态为 live 后即可开始讨论。远程终端使用 --no-browser，将返回的链接放到本地浏览器中打开。

把讨论交给 agent 跟进

在另一个终端或 agent 会话里持续读取会议内容：

ginit meeting tail "项目周会" --follow

你可以让 agent 每分钟总结新增结论、整理待办，或结合刚才的讨论回答问题。tail 默认每 2 秒拉取新句，按 Ctrl-C 只停止监听；周期总结由接入的 agent 执行。

会议结束后，保留文字供后续查阅：

ginit meeting end "项目周会"
ginit meeting read "项目周会"
ginit meeting qa "项目周会"

记录与访问

会议记录按登录用户隔离。ginit 服务端保存转写文字和问答，音频仅在内存中转发给语音识别服务，不保存音频文件。页面提供会议 ID 和 CLI 命令复制入口；遇到同名会议时可直接使用 ID。

Meeting 随 ginit 发布，本页沿用 ginit v1.4.117 的版本号。

新增

• 每个用户可创建一个个人工作区，用于管理个人任务，不支持邀请其他成员。
• 私有 Issue 不在工作区内公开，可通过只读链接分享。
• 项目可以设置为私有，限制非成员访问。

分享私有 issue

在 issue 的操作菜单中点击分享只读链接，生成并复制链接后即可发给他人。创建者、所属项目负责人或工作区 owner/admin 可以创建分享链接。

持有链接即可只读查看 issue、已附加的上下文和评论，无需加入工作区，不能编辑或回复。链接不开放其他项目或 issue；原始文档和 Session 链接仍按各自权限访问。

CLI

# 查看并切换工作区
multica workspace list --output json
multica workspace switch <workspace-id-or-slug>

# 创建私有 Issue
multica issue create --title "内部任务" --visibility private --output json

# 修改 Issue 可见性，并按可见性筛选列表
multica issue update <issue-id> --visibility member --output json
multica issue list --visibility private --output json

# 管理私有项目成员
multica project member add <project-id> --user-id <user-uuid> --output json
multica project member remove <project-id> --user-id <user-uuid>

Improvements

• 移除 issue-binding 与 context-provenance 两个 bookend hook（PR #338），新会话启动时不再被强制要求先绑 issue 或做上下文标注。
• 保留手动绑定入口：$ginit-issue-binding、$ginit-context-provenance 仍可按需调用。

升级

ginit update

New

• ginit agent session bind-dir <session-url-or-node_id> --dir <绝对路径>：为指定会话绑定工作目录。
• ginit agent session attach-dir <session-url-or-node_id>：在绑定目录恢复并继续该会话，也可用 --dir 指定其他目录。

Improvements

• 会话详情页显示绑定目录，可更换或清除；绑定不会上传目录文件。
• 组织共享文件夹在 UI 上点击不生效的问题已修复。

升级

ginit update

功能

• Issue 可关联 Agent Session，预览摘要、轮次和活动时间线，并绑定、更换或清除会话工作目录。
• CLI 可查看关联列表、读取摘要，并按轮次或关键词筛选会话内容。

绑定会话工作目录

1. 在 issue 上下文中关联 Agent Session，点击打开会话预览。
2. 在工作目录区域点击绑定，输入运行 ginit 的机器上的绝对路径，例如 /Users/yourname/projects/demo，点击保存。
3. 保存后预览会显示绑定路径；再次点击绑定可更换目录，点击清除可解除绑定。

绑定工作目录不会上传目录中的文件。也可用 ginit agent session bind-dir <session-url-or-node_id> --dir <绝对路径> 设置。

CLI

使用 GAIR-NLP/multica Releases 的对应平台安装包（需私有仓库权限），并确认 multica issue context add-session --help 可用。公开 Homebrew tap 与该仓库不同，brew upgrade multica 不保证获得这些功能。

# 当前会话：上传时同时关联 issue（ginit 1.4.108 起支持）
ginit context upload-current --issue <issue-url> --json

# 已上传的会话：直接关联，无需再次上传
multica issue context add-session <issue-id> --session <session-url-or-node_id> --output json

# 接手 issue 或关联完成后，检查条目并读取摘要
multica issue context list <issue-id> --output json
multica issue context session <issue-id> <context-id> --summary --output json

# 按需读取相关轮次；也支持 --round 和 --offset
multica issue context session <issue-id> <context-id> --keyword "调研" --limit 5 --output json

node_id 是上传结果中的云端 ID，与 Claude/Codex 原生会话 ID 不同；context-id 来自关联结果或列表。也可通过 ginit agent session read --json <session-url-or-node_id> 直接读取。

上传成功后仍需确认关联及读取结果；last_sync_status 不代表当前身份可读。挂载不会扩大私有会话权限；权限或服务异常时，摘要和正文都可能读取失败。

更新内容

• 支持在项目和 Issue 级别添加规则，直接输入纯文本即可保存。
• 可查看、编辑和删除已有规则；项目规则会自动应用到项目下的 Issue。
• 规则会汇入对应任务的有效上下文，供 agent 执行任务时参考。

CLI

# 为项目添加一条规则
multica project context add <project-id> --kind rules --title "提交规范" --body "所有变更必须附带测试结果。" --output json

# 为 Issue 添加临时规则
multica issue context add <issue-id> --kind rules --title "验收条件" --body "完成前必须验证边界场景。" --output json

# 查看 Issue 最终生效的规则与上下文
multica issue context effective <issue-id> --output json

新增

• Issue 和项目可以关联飞书文档、知识库节点与群聊。
• 支持按时间范围读取群聊消息片段，作为可追踪的上下文来源。
• 增加文档创建、协作者授权和同步失败提示，权限问题会给出明确说明。

CLI

# 查看当前用户可访问的飞书群聊
multica feishu chat list --output json

# 将群聊注册为 Issue 上下文
multica issue context add <issue-id> --kind link --title "项目群" \
  --source-type feishu_chat --source-ref <oc-id> --output json

# 读取消息并导入指定消息快照
multica issue context messages <issue-id> <context-id> --output json
multica issue context import <issue-id> <context-id> --message-id <om-id> --output json

项目级上下文使用对应的 multica project context ... 命令管理。

New

• 每日按工作区时区生成简报，并通过飞书卡片发送给成员。
• Inbox 中的状态、评论和任务变化可自动推送到飞书。
• 推送失败会自动重试，避免临时网络问题导致消息丢失。

CLI

每日简报和 Inbox 推送目前通过 Multica Web 的工作区设置配置，没有单独的 CLI 开关。CLI 可以先切换到目标工作区，确保后续命令与 Web 设置使用同一工作区：

multica workspace list --output json
multica workspace switch <workspace-id-or-slug>

新增

• 关闭 Issue 前必须填写非空交付物。
• 支持交付物文本、附件快照和后续版本追加。
• 批量关闭 Issue 时可复用同一份交付物。

CLI

# 关闭单个 Issue，并从 Markdown 文件提交交付物
multica issue status <issue-id> done --deliverable-file report.md

# 批量关闭多个 Issue，共用同一份交付物
multica issue close <issue-id-1> <issue-id-2> --deliverable-file report.md

# 为已完成的 Issue 追加交付物版本
multica issue deliverable add <issue-id> --deliverable-file revised-report.md

也可以使用 --deliverable 或 --deliverable-stdin 直接传入文本，并通过重复传入 --attachment 附加构建产物。

New

• ginit paseo install：在运行 ginit CLI 的机器上一键安装并配置 Paseo daemon，无需公网入站或 SSH，daemon 主动连接 Hub 与 Relay。
• 默认接入公网 Relay（paseo.g0g.top:443，TLS wss://），同时支持通过环境变量切换到自建 Relay：
  • PASEO_RELAY_ENDPOINT：daemon 主动连的 Relay
  • PASEO_RELAY_PUBLIC_ENDPOINT：公网客户端用的 Relay
  • PASEO_GINIT_BASE_URL / PASEO_GINIT_HUB_WS_URL：Hub 入口
• 自动写入 Claude Stop hook（~/.local/share/paseo-hooks/paseo-auto-import.sh），让会话结束自动归档到 Paseo。

Improvements

• ginit paseo status 查看当前 Hub 中的已登记设备。
• ginit paseo attach 登记本机 daemon；ginit paseo detach --device-id <id> 移除指定设备。

升级

ginit paseo install && ginit up

环境要求

• 宿主已 ginit login，且对应 token 能访问目标 Hub 的 Paseo API。
• 若目标域名的 /api/paseo/devices 或 enrollment API 返回 404，说明该入口不是兼容的 ginit Hub，需要改用实际的 Hub base URL。

Breaking Changes

• Paseo daemon 不再监听公网端口；旧的「外部直连 daemon」部署方式不再支持，必须改为 Hub/Relay 主动外连模型。
• PASEO_LISTEN_ADDR 配置项移除，替换为 PASEO_RELAY_ENDPOINT 与 PASEO_GINIT_HUB_WS_URL。

New

• daemon 启动后主动向 Hub 建立 WebSocket 控制面、向 Relay 建立数据面 TLS 连接。
• 新增 ginit paseo attach：将本机 daemon 登记到当前 Hub。

升级

ginit paseo install && ginit up