daybook-orch

DAYBOOK 司南：把账本底座上的身份/任务/锁/心跳/路由焊成一个可跑闭环的智能体编排中心

安装

pip install daybook-orch

用法

daybook-orch selftest               # 自检（应全绿）
daybook-orch --help                 # 列出可用命令

你的数据放在哪（重要）

第一次运行会在运行目录就位 daybook.conf 与 sample/（示例三卷）， 账本、索引、备份、各数据卷全部落在该目录，不会写进 Python 安装目录。

运行目录的挑选次序：

1. --home=/path（当次指定）
2. 环境变量 DAYBOOK_HOME
3. 当前目录（仅当它已含 daybook.conf —— 即"用我自己那本账"）
4. 默认 ~/.daybook（首次自动创建）

产品代码留在包内（以软链接入运行目录），pip install -U 升级代码时不会动你的数据。 要用自己的账本：把 daybook.conf 里 [卷] 的路径改成你自己的纯文本卷即可（相对该目录或绝对路径都行）。

八件要紧的事

1. 纯文本 —— 卷是纯文本，任何编辑器、任何年代都能打开。
2. 零依赖 —— 只用 Python 标准库，不装任何第三方包。
3. 只增不改 —— 追加写，旧的条目不删不改（append-only 纪律）。
4. 多写者安全 —— 带锁写入，多人/多进程同时记不会互相踩。
5. 图是引用 —— 结构以引用表达，不复制正文。
6. 可挂长期记忆 —— 可作为 AI 智能体的可读长期记忆底座。
7. 够快 —— 索引随取随算，日常规模下即时完成。
8. 跨年代 —— 不依赖特定工具链，十年后仍读得出。

三件套

授权分层

本包混装：编排件（orchestrator.py／agent_lock.py／agent_heartbeat.py／agent_message.py／task_volume.py）为 AGPL-3.0-or-later（或另购商业许可）；其余共享件（agent_registry.py／cross_ref.py／daybook_append.py／safeio.py）仍为 MIT。逐件标注见各件文件头的 SPDX-License-Identifier，分层说明见随包 LICENSING.md。

逐件以文件头 SPDX-License-Identifier 为准；包内另附 LICENSING.md（分层说明）。

发行名归属（官方渠道声明）

daybook-orch 是版权持有人（手艺人老宋）注册并持有的官方发行名。判 official 三条须同时成立：

1. PyPI 页 Homepage 指向 https://daybooksuite.com；
2. PyPI 页 Repository／Source 指向 https://github.com/songliansheng1972/daybook-suite；
3. GitHub Release 的 tag 与仓库 CHANGELOG.md 的版本号对得上。

其余渠道上的同名包均非官方，不得以之名作「官方／兼容／认证」背书。

商标（名不可乱用）

daybook／起居注／璇玑／司南 及三个发行名 daybook-suite／daybook-mcp／daybook-orch 均为署名标识，且已列入商标申请范围（第 9 类·可下载软件；第 42 类·软件开发与平台服务）。

• 可以用我们的码（遵 MIT／AGPL 分层，见包内 LICENSING.md）；
• 不可以用我们的名——不得自称「官方／兼容／认证」，不得用于衍生产品之命名、分发、推广， 亦不得注册与之相同或近似之商标、包名、域名；分叉须另立其名。
• 申请范围、标识清单与使用规则正本见包内 TRADEMARK.md。
• ⚠️ 当前状态为拟申请、尚未核准；保护力自核准之日起算，本页不构成核准证明。核准前标识标 ™。

链接

• 官网：https://daybooksuite.com
• 仓库：https://github.com/songliansheng1972/daybook-suite