更新日志
Multica 的版本更新记录。
CLI 私有仓库自更新
v1.0.9 · upgraded from v1.0.8
CLI 1.4.74 支持鉴权下载私有 Release，更新源固定为 GAIR-NLP/multica。
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。
发布者时闰洲
交付物改为选填
v1.0.8 · upgraded from v1.0.7
关闭 issue 无需再填写交付物，支持完成时提交或完成后补交，CLI 同步支持。
关闭单条、子 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。不提交交付物时省略这些参数；上传交付物附件时仍需填写说明。
发布者时闰洲
评论
正在加载评论…
Private workspace/project/issues
v1.0.7 · upgraded from v1.0.6
通过个人工作区、私有项目和私有 issue 管理个人任务与定向协作。
新增
- 每个用户可创建一个个人工作区，用于管理个人任务，不支持邀请其他成员。
- 私有 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>发布者时闰洲
评论
正在加载评论…
共享上下文
v1.0.6 · upgraded from v1.0.5
按工作区、项目和 issue 组织知识、规则与任务材料。
共享上下文是什么
把术语、规范、资源位置、权限申请方式和必读文档配置一次，供相关 issue 与智能体重复使用。
| 层级 | 放什么 | 配置入口与范围 |
|---|---|---|
| 工作区 | 团队通用规范、安全要求、公共文档与群聊 | 工作区设置 → 工作区上下文；工作区内所有 issue |
| 项目 | 项目知识库、架构和业务文档、项目群聊 | 项目详情 → 共享上下文；当前项目及继承它的子项目 |
| issue | 当前任务的设计稿、调查材料、Agent Session | issue 详情 → issue 上下文；仅当前 issue |
有项目的 issue 按项目边界继承上下文；无项目的 issue 使用工作区和自身材料。可通过 context effective 查看有效范围与规则。
从零开始
先给知识空间添加 Ginit Bot
顶层项目绑定根 Wiki 前，先在飞书知识空间中添加当前工作区使用的 Ginit Bot，让它能够访问知识库。
- 打开目标飞书知识库，点击左下角齿轮进入知识库设置。
- 进入成员设置 → 管理员，点击添加管理员。
- 搜索并添加 Ginit（当前工作区使用的 Bot），确认它已出现在成员列表中。
- 回到 Multica 项目的共享上下文 → 添加根知识库，粘贴该知识空间中目标根节点的 Wiki 链接并绑定。
若后续需要 Bot 创建 issue 文档，还需确认它对目标知识空间和顶层节点具有编辑权限；仅操作者本人是管理员并不足够。
配置与使用
- 配置公共背景：owner/admin 在工作区上下文中添加通用说明、文档或群聊；只有每次开工必须看的内容才标记为默认必读。
- 有项目时绑定知识库：进入项目共享上下文，点击“添加根知识库”。顶层项目粘贴飞书 Wiki 链接；子项目从父项目可选文档中选择。绑定后可展开文档树、预览和重新同步正文。
- 给 issue 聚焦材料：在 issue 上下文中点击“添加上下文”。有项目的 issue 可选择继承的项目文档，也可添加 issue 自有文档；无项目的 issue 直接添加自己的材料，不使用项目文档绑定。
- 接手时检查：运行
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 jsoncontext list 显示关联条目；文档正文可能是同步快照，最新内容可在 Multica 预览或打开原链接查看。查询失败不代表没有上下文。
当前会话可在上传时指定 issue，已有云端会话可直接关联；随后读取摘要和相关轮次。命令见 Agent Session 关联与读取。
权限与使用提醒
关联上下文不会扩大原文档或会话的访问权限。owner/admin 可用 multica workspace context scan 检查敏感内容；context-id 支持完整 UUID 或至少 4 位的唯一前缀。
发布者runzhou
评论
正在加载评论…
Agent Session 关联、读取与目录绑定
v1.0.5 · upgraded from v1.0.4
在 issue 中关联、预览和读取 Agent Session，支持摘要、筛选与工作目录绑定。
功能
- Issue 可关联 Agent Session，预览摘要、轮次和活动时间线，并绑定、更换或清除会话工作目录。
- CLI 可查看关联列表、读取摘要，并按轮次或关键词筛选会话内容。
绑定会话工作目录
- 在 issue 上下文中关联 Agent Session，点击打开会话预览。
- 在工作目录区域点击绑定，输入运行 ginit 的机器上的绝对路径，例如
/Users/yourname/projects/demo，点击保存。 - 保存后预览会显示绑定路径；再次点击绑定可更换目录，点击清除可解除绑定。
绑定工作目录不会上传目录中的文件。也可用 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 jsonnode_id 是上传结果中的云端 ID，与 Claude/Codex 原生会话 ID 不同；context-id 来自关联结果或列表。也可通过 ginit agent session read --json <session-url-or-node_id> 直接读取。
上传成功后仍需确认关联及读取结果；last_sync_status 不代表当前身份可读。挂载不会扩大私有会话权限；权限或服务异常时，摘要和正文都可能读取失败。
发布者时闰洲
评论
正在加载评论…
项目和 Issue 级别规则
v1.0.4 · upgraded from v1.0.3
可在项目或 Issue 中维护纯文本规则，并自动提供给 agent 使用。
更新内容
- 支持在项目和 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发布者时闰洲
评论
正在加载评论…
飞书文档与群聊上下文
v1.0.3 · upgraded from v1.0.2
将飞书文档、知识库和群聊消息纳入 Issue 与项目上下文。
新增
- 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 ... 命令管理。
发布者时闰洲
评论
正在加载评论…
飞书每日简报与 Inbox 推送
v1.0.2 · upgraded from v1.0.1
将工作区每日简报和 Inbox 通知自动发送到飞书。
New
- 每日按工作区时区生成简报，并通过飞书卡片发送给成员。
- Inbox 中的状态、评论和任务变化可自动推送到飞书。
- 推送失败会自动重试，避免临时网络问题导致消息丢失。
CLI
每日简报和 Inbox 推送目前通过 Multica Web 的工作区设置配置，没有单独的 CLI 开关。CLI 可以先切换到目标工作区，确保后续命令与 Web 设置使用同一工作区：
multica workspace list --output json
multica workspace switch <workspace-id-or-slug>发布者时闰洲
评论
正在加载评论…
关闭 Issue 必须填写交付物
v1.0.1
将 Issue 标记为完成前必须提交非空交付物，并保留交付物版本记录。
新增
- 关闭 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 附加构建产物。
发布者时闰洲
评论
正在加载评论…
评论
正在加载评论…