Codeksei

• 入口：WeChat + codeksei
• 它会分担：守住时间感、补记忆锚点、在该出现时主动出现
• 你会慢慢得到：一天不那么容易整块糊掉，项目也更容易重新接上

一天里，你会这样遇见 Codeksei

• 开始一天时：你也许只说一句“我现在准备开始了”，或者问“昨天那条线停在哪来着？”。它会把挂着的提醒、最近状态、项目线索和更适合眼前的第一步慢慢接回来，让起步不必从空白和慌乱开始。
• 白天推进中：你把念头、待办、做完的时间块、突然想到的事丢给它。它会把该留的留下来：有的去 diary，有的钉进 timeline，有的变成提醒，脑子不用一直替未来的自己硬撑记忆。
• 一抬头发现半天过去了：你问“我刚刚到底干嘛去了？”或者“今天怎么又糊了”。它会把已经发生过的时间块、切换点和留下的线索慢慢钉回时间线，让这一天重新有形。
• 你安静了一阵子：它不会急着冒出来。它会先掂量现在更适合问一句、跟进一条线、补一条记录、留给未来一个提醒，还是先安静陪着这条线往后走。
• 项目做到一半又切回来：你只说“继续这条”或者“我现在卡在哪了？”。它会顺着同一条线程、项目脉络和最近动作，把重新进去的入口慢慢接回来。
• 卡住、切换、想躲一下的时候：你说“我有点散”、“我想逃一下”，或者“我现在不知道先做哪件”。它会帮你把线缩回眼前，留下一步可做的动作，必要时替你补一个提醒或收一个尾。
• 一天要收口的时候：睡前、出门前、做完一段之后，让它陪你收一下。它会把今天真实发生过的东西压成 timeline、review 和明天更容易接上的入口，让明天回来时，线还在，时间感也还在。

主动分忧 更像一种有人轻轻替你照看着的在场感。

它会先替你守住时间感、线头和已经发生过的痕迹；该留痕时留痕，该接话时接话，该安静时也会安静。

现在可以做什么

• Timeline：把已经发生过的时间块、切换点和生活事实钉成时间感与记忆锚点，不让一天只剩模糊印象
• Diary：Todo、碎片、补充记录、总结，以及和 timeline 紧密联动的时间线事实，帮你把零散日常慢慢收成可用痕迹
• Check-ins：随机唤醒与主动分忧。发一句消息只是其中一种；它也会先回看上下文、整理后台、补一条 diary / timeline、留一个提醒，再决定是不是该主动露个面
• Reminders：提醒写入与调度，给生活节奏和待办推进一个外部支点
• Review：nightly / weekly / monthly，把日常记录压成更稳定的节奏校准与复盘材料
• Project support：workspace bootstrap、project radar、按 workspace 恢复共享线程。项目切走再回来时，不用先把整条线在脑子里重建一遍
• WeChat bridge：扫码登录、长轮询收发、文件发送、共享线程接管
• Codex runtime：共享 app-server、thread/session 绑定、审批流、stop/resume
• Durable note：note:auto、note:maybe、note:sync

这些人会喜欢它

• 想有人替自己照看琐碎日常、提醒和未收口事项的人
• 有 ADHD 或执行功能摩擦，希望得到持续陪伴和轻推的人
• 希望对方会主动来问、主动跟进，也愿意替你分担一点琐碎的人
• 一天常常糊成一团，事后很难想起自己到底做了什么的人
• 项目一被别的事岔开，再回来就像整条线一起断掉的人
• 想把项目推进、日常记录和复盘整理放进同一条工作流的人
• 想把微信保留成主要交互入口，同时保留本地可控性的人

为什么叫 Codeksei

• Code：散落日常里的隐秘书写。那些稍纵即逝的念头、半途停下的线索、以及你本来想记住的生活纹理，都留在这里。
• -ksei：取自 Aleksei 的后半段。在这里，它借来“守护 / 帮助 / 同行”的意象，像一位安静陪在身边的同行者。

快速开始

1. 先选安装方式

如果你想按本文完整使用共享模式，先 clone 仓库，再跑 npm run ...：

git clone https://github.com/Sapientropic/codeksei.git
cd codeksei
npm install

如果你只是想先拿到基础 CLI：

npm install -g codeksei
codeksei help

说明：

• 本文后续命令示例默认按仓库工作树写成 npm run ...
• 全局安装更适合先体验基础 CLI；共享模式相关脚本在仓库内运行最直接

2. 配置最小环境变量

运行时会按“两阶段”补全环境变量：

1. 先保留当前进程里已经存在的环境变量
2. 读取当前项目目录下的 .env
3. 再根据这一步已经生效的 CODEKSEI_STATE_DIR 重新计算状态目录，并读取该状态目录下的 .env

前面的值优先，后面的 .env 只补缺省，不会覆盖已经存在的 key。也就是说，如果 repo .env 里才定义了 CODEKSEI_STATE_DIR，运行时会在读完 repo .env 之后，重新定位 state-dir .env。

最小可用配置：

CODEKSEI_USER_NAME=你的名字
CODEKSEI_USER_GENDER=female
CODEKSEI_ALLOWED_USER_IDS=桥实际观测到的 sender id
CODEKSEI_WORKSPACE_ROOT=/绝对路径/你的项目目录

CODEKSEI_ACCOUNT_ID=
CODEKSEI_CODEX_ENDPOINT=ws://127.0.0.1:8765
CODEKSEI_WEIXIN_ADAPTER=v2
CODEKSEI_WEIXIN_REPLY_MODE=stream
CODEKSEI_WEIXIN_ROUTE_TAG=
CODEKSEI_WEIXIN_PROTOCOL_CLIENT_VERSION=2.1.1
CODEKSEI_TIMEZONE=Asia/Shanghai
CODEKSEI_DIARY_DIR=/绝对路径/你的 vault/日记
CODEKSEI_TIMELINE_STATE_DIR=/绝对路径/你的 vault/.codex/timeline
CODEKSEI_WORKSPACE_BOOTSTRAP_CONFIG=/绝对路径/你的 workspace-bootstrap.json
CODEKSEI_PROJECT_RADAR_CONFIG=/绝对路径/你的 workspace/.codex/code-projects.json
CODEKSEI_DURABLE_NOTE_SCHEMA_CONFIG=/绝对路径/你的 workspace/.codex/durable-note-schema.json
CODEKSEI_REVIEW_SCHEMA_CONFIG=/绝对路径/你的 workspace/.codex/review-schema.json
CODEKSEI_SHARED_USE_BUNDLED_CODEX_BINARY=1
CODEKSEI_SHARED_DISABLE_PLUGINS=0
CODEKSEI_SHARED_DISABLE_SHELL_SNAPSHOT=0

说明：

• CODEKSEI_WEIXIN_REPLY_MODE=stream 现在表示“半实时增量流”：会按小窗口持续发送用户可见增量，保留段落结构，可读性优先于减少气泡数量
• CODEKSEI_WEIXIN_REPLY_MODE=settled 仍表示“等整轮收口后再发”：只发送最新的可见最终回复
• CODEKSEI_USER_NAME 决定对话里怎么称呼你，不参与消息路由
• CODEKSEI_ALLOWED_USER_IDS 必须填写微信桥实际观测到的 sender id；最简单的做法是先跑 npm run accounts
• 微信 persona / continuity instructions 默认来自仓库里的 templates/weixin-instructions.md，如需本地覆盖可在状态目录放 weixin-instructions.local.md
• 如果你在共享模式下使用多 workspace，建议启动前就设置好 CODEKSEI_WORKSPACE_ROOT
• CODEKSEI_TIMEZONE 可选；若显式设置，它会统一驱动 reminder / diary / review / timeline 的本地时间解释
• 如果不设 CODEKSEI_TIMEZONE，Codeksei 会优先沿用 timeline state 里已声明的非 legacy timezone；否则回退到系统时区
• 旧的 Asia/Shanghai legacy timeline state 在需要时会在下一次 timeline 命令时自动迁移到当前统一 timezone
• CODEKSEI_TIMELINE_STATE_DIR 默认是 timeline-for-agent 的 state root；当前主布局会在它下面使用 timeline/*.json
• .env 只应放在你的本地工作目录或状态目录里，不要提交进仓库

3. 扫码登录

npm run login

4. 拉起共享模式

共享模式更适合日常使用：微信和终端会接到同一条共享线程。

npm run shared:start

接入当前微信绑定的共享线程：

npm run shared:open

查看状态：

npm run shared:status

5. Windows 后台常驻

如果你希望登录后自动拉起，并在解锁或恢复睡眠后快速自愈：

npm run background:install

卸载：

npm run background:uninstall

常用命令

先记住这一小组就够用：

终端：

npm run login
npm run accounts
npm run shared:start
npm run shared:open
npm run shared:status
npm run doctor
npm run help

微信：

/bind /绝对路径
/status
/new
/reread
/switch <threadId>
/stop
/yes
/always
/no
/model
/model <id>
/help

更完整的命令与架构说明见：

• docs/commands.md
• docs/architecture.md

本地数据与公开边界

当前默认状态目录是：

~/.codeksei

常见运行态内容包括：

• accounts/
• sessions.json
• sync-buffers/
• weixin-instructions.local.md
• weixin-operations.local.md
• workspace-bootstrap.json
• reminder-queue.json
• system-message-queue.json
• system-message-dead-letter.json
• timeline-screenshot-queue.json
• diary/
• timeline/
• logs/

连续性关键的状态文件目前包括 sessions.json、reminder-queue.json、system-message-queue.json、timeline-screenshot-queue.json。这几类文件现在会走原子写；如果 JSON 可读但关键 schema 已坏、或者文件本身损坏，运行时会把原文件隔离成 *.corrupt-<timestamp>.json 再回到空默认状态继续启动。

如果你单独设置了 CODEKSEI_DIARY_DIR 或 CODEKSEI_TIMELINE_STATE_DIR，真正的数据会写到你指定的位置，状态目录只保留运行态文件。

默认 persona / operations 模板继续跟仓库一起发布在 templates/；状态目录里的 *.local.md 只负责你本机的 overlay，不再充当唯一真相源。

这个仓库和 npm 包默认只放代码、脚本、模板与文档，不应包含你的账号、会话、日志、个人 .env 或本地业务数据。

Timeline 可单独复用

Codeksei 的时间轴能力建立在 timeline-for-agent 之上。
如果你只想要 timeline，而不需要微信桥接与生活助理能力，也可以直接单独使用上游项目。

Upstream Acknowledgement

感谢原仓 WenXiaoWendy/cyberboss 的开源。
Codeksei 从那里长出来，也感谢这份开源起点。

FAQ

可以直接 npm install -g codeksei 吗？

可以。 如果你只想先拿到基础 CLI，这是最短路径；如果你要按本 README 跑完整共享模式、调试共享桥接脚本或直接改仓库源码，clone 仓库会更顺手。

共享模式和 npm run start 有什么区别？

npm run start / npm run start:checkin 更适合最小链路调试。
日常使用、微信与终端共用同一条线程、后台自愈和多窗口接管，默认都应走共享模式。

License

本项目采用 AGPL-3.0-only。
如果你基于本项目修改、扩展并通过网络向他人提供服务，需要按照 AGPL 的要求向对应用户提供完整的对应源代码。