Skip to content

v0.5.0

Choose a tag to compare

View all tags
@Sapientropic Sapientropic released this 18 Apr 06:19
· 61 commits to public since this release
v0.5.0
c08ab07

Added

  • host attachment contract v2：host manifest / host bootstrap / host doctor / 示例资产现在会输出结构化 hostIdentity，并新增 coreInvariant=codeksei-core-owned、scheduleTruthOwner=codeksei、schemas/hostkit-v2.json 与 schemas/codeksei-config-v2.json。
  • 语义化 onboarding persona 提取主链，支持“小模型优先、规则兜底”的六域 backstage 抽取，并继续把长期真相只写回 companion note，而不是新建第二套 profile store。adb6b90
  • codeksei onboarding start|step|status|reset 公共 CLI 面，以及无 workspace schema / 无 Obsidian 时自动回退到 CODEKSEI_STATE_DIR/companions/<userKey>/profile.md 的 companion profile。adb6b90
  • 统一的 semantic JSON runtime 抽取基础件，供 onboarding 和 review semantic host 复用，减少重复的 Codex/Hermes JSON 提取逻辑。adb6b90
  • 通用的 codeksei companion remember 公共 CLI 和 src/companion-memory/* shared owner：所有宿主都可以把会影响未来陪伴判断的新事实或纠正送进同一条 ongoing companion memory 主链，而不是只把记忆更新绑在 onboarding 会话里。
  • CODEKSEI_STATE_DIR/companion-memory/<userKey>.json 运行态记忆状态：只存 dedupe、freshness、recent writes 和 pending pattern candidates，不引入第二套长期 profile store。
  • host 升级感知合同：host manifest 现在带 machine-readable 的推荐工作流与升级要求；host bootstrap 会写入 bootstrap 快照；host doctor 会显式判断是否需要重新 bootstrap 或重装 companion skill。c650278

Changed

  • timeline screenshot 现在只负责生成本地截图文件；文件发送统一收口到 channel send-file，并移除了旧的 timeline screenshot --send/--user 路径及相关内部发送链路。bc66471 ee6ac84 f854ec3
  • reminder / host / system / operator 的命令面进一步做减法收口：reminder write --delivery proactive、system send、外部 system checkin-poller、operator hermes sync-checkin、host bootstrap --ensure-daemon 已移除，不再作为 public/operator surface 保留。74b7bb8
  • 公开 mode 命名现在收口到 Codex Mode 与 Hosted Mode；Bridge Mode、Hermes Hosted Mode、bridge-codex-weixin、hosted-hermes-weixin 退到兼容别名层，不再是公开主命名。
  • host config / host recipe / host resolution 改成宿主无关：不再把 channel=weixin 写死成唯一支持组合；codex + host-managed telegram/discord/feishu 与 hermes + host-managed channel 现在都能通过同一条 attach contract 解析，first-party Weixin adapter 只保留给 Codex Mode + codeksei/weixin。
  • shared:* shell wrapper 明确只支持 Codex Mode + codeksei/weixin；一旦切到 Hosted Mode 或 host-managed channel，就直接提示改走宿主桥，而不是误落回本地 Weixin 脚本。
  • 主上下文策略切到 context board first / raw vault injection second。宿主默认应先读受控的 context board handoff，而不是把原始 vault/note 直接塞进 prompt。9b8012f
  • Hermes companion skill 与 host manifest 不再只是命令清单，而是带默认 routing/workflow 提示，明确何时先看 onboarding、何时先看 context briefing、以及 hosted proactive 必须走 seed-proactive / claim-checkin / settle-checkin。678b3eb
  • onboarding 的 durable memory 写入逻辑已退回 shared companion-memory 内核；onboarding step 继续负责首访状态机和自然追问，但长期真相更新、去重、纠错和 runtime freshness 现在与后续 ongoing memory 共用同一条 host-neutral 管线。
  • host manifest / Hermes companion skill 的默认工作流新增 ongoing_companion_memory，并把 user_correction_persistence 明确成“onboarding 未完成走 onboarding step，ready 后统一走 companion remember”，不再暗示不同宿主要维护各自专用的长期记忆语义。
  • context briefing 现在会暴露 companion memory freshness / source status，帮助宿主判断当前 handoff 只是在消费旧 onboarding 画像，还是已经接上了持续更新的 companion memory。
  • Hosted proactive wake、reminder delivery 和 Hermes wake-forwarder 进一步收口，修正了一次性 wake job、delivery origin 和 recovery ownership 的行为。f5aaeec
  • Weixin 默认值与腾讯官方插件对齐，包括协议 client version、登录相关默认行为，以及 repo-local bridge 对应的兼容更新。35c784a
  • Weixin 路由和 Hermes hosted checkin 路径先做了一轮收口式简化，并补上 Hermes cron env passthrough patch 文档与资产。f67f383

Fixed

  • stale schema 探测如 codeksei schema system send 与 codeksei operator schema operator hermes sync-checkin 不再回 internal_error，而是返回稳定的 validation_error，并给 agent/tooling 明确的 removed-command guidance。74b7bb8

Upgrade Notes

  • 若你消费 host manifest / hostkit schema，把 hostIdentity.*、coreInvariant、scheduleTruthOwner 视为新 canonical 真相；runtimeInvariant=bridge-full 只保留给旧 consumer 兼容读取。
  • 若你之前把公开命名写成 Bridge Mode / Hermes Hosted Mode，现在统一改成 Codex Mode / Hosted Mode；旧 profile id 仍可读，但 help / doctor / schema 都会把它们当成 legacy alias。
  • 这条发布线的核心变化不是“多了几个命令”，而是宿主默认接法已经从“拿命令列表自己拼”升级为“由 host manifest、skill 和 host doctor 共同驱动默认工作流”。
  • 如果你之前还在调用 timeline screenshot --send、reminder write --delivery proactive、system send、operator hermes sync-checkin 或 host bootstrap --ensure-daemon，现在需要切到新的公开主链，不要再依赖旧兼容入口。
  • onboarding 现在是正式的一等入口，新用户或薄画像用户不应再假设已有 durable profile；长期真相也不应旁路写入，而应继续回到 companion note。
  • onboarding 之上的记忆更新能力已经进一步泛化成 host-neutral 的 ongoing companion memory。对已完成 onboarding 的用户，后续纠正、支持偏好变化、节奏变化和近线任务更新，默认应走 codeksei companion remember，不要继续把 onboarding step 当作长期记忆的总入口。
  • 主动判断上下文现在应优先依赖 context briefing / context board，而不是直接注入 raw vault。
  • 没有数据库迁移，也没有新的公开 profile store；升级影响主要集中在 host routing、bootstrap 快照和 skill 安装物。

Host / Installer Checklist

  • 如果你消费 CODEKSEI_HOSTKIT.json 或 codeksei.config.json，升级到 hostkit-v2 / codeksei-config-v2 字段面：读取 hostIdentity.*、runtimeProvider、runtimeOwner、channelProvider、channelKind、deliveryRecipe，不要再把公开 profile 绑定死在 bridge-codex-weixin / hosted-hermes-weixin。
  • 把公开文案和宿主 UI 里的 Bridge Mode / Hermes Hosted Mode 统一改成 Codex Mode / Hosted Mode。
  • 如果宿主之前会直接调 shared:* 或微信脚本，确认它们只在 Codex Mode + codeksei/weixin 下使用；Hosted Mode 和其他 host-managed channel 需要走宿主自己的 bridge / gateway。
  • 先跑一次 codeksei host doctor --provider hermes，确认当前安装是否需要重新 bootstrap 或重装 skill。
  • 如果 host doctor 返回 bootstrap_required: yes，执行 codeksei host bootstrap --provider hermes。
  • 如果 host doctor 返回 skill_reinstall_required: yes，执行 codeksei operator hermes install-skill。
  • 如果你之前把截图和发送绑在一起，改成 codeksei timeline screenshot ... 之后再显式运行 codeksei channel send-file --path ...。
  • 如果你之前把 proactive 唤醒、scheduler glue 或 daemon readiness 绑在旧命令/flag 上，改成 host seed-proactive / claim-checkin / settle-checkin 与默认的 host bootstrap --provider hermes。
  • 如果宿主之前只缓存了命令清单，改为读取 codeksei host manifest --format json，并消费其中的 recommendedWorkflows 与 entrypoints。
  • 把“新用户 / 薄画像”默认链路改成 onboarding status -> onboarding start|step，不要再假设已有 companion profile。
  • 把“onboarding 已完成后的持续记忆更新”默认链路改成 codeksei companion remember --user <id> --workspace <path> --source host_user_turn --stdin，不要再复用 onboarding step 承担全部长期纠正。
  • 把“主动判断 / 当前状态 handoff”默认链路改成 codeksei context briefing --user <id> --workspace <path> --mode proactive，不要再直接注入原始 vault。

Commit Trace

  • c650278 Add host upgrade awareness contract
  • 678b3eb Teach hosts the default companion workflow
  • adb6b90 Add semantic onboarding persona extraction
  • 9b8012f Switch to "whiteboard/context board first, raw vault injection second"
  • 74b7bb8 Clean up removed command surfaces
  • 3164496 chore: refresh react 19.2.5 lockfile
  • ee6ac84 Remove timeline screenshot send wrapper
  • f854ec3 Tighten timeline screenshot command contract
  • bc66471 Decouple timeline screenshot delivery and workspace config paths
  • 35c784a Align Weixin defaults with Tencent plugin
  • f5aaeec Fix hosted proactive wake jobs and reminder delivery
  • f67f383 Simplify Weixin routing and harden Hermes hosted checkins
Assets 2
Loading