work-ally

work-ally 是一个把当前项目连接到命名 assistant 办公桌与官方 Codex runtime 的薄编排层。

快速入口

• 正式 CLI 用户：docs/user-quickstart.md
• 产品说明：PRODUCT.md
• 产品同事：docs/product-onboarding.md
• 研发同事：docs/developer-workflow.md
• 值班排障：docs/ops-runbook.md、docs/troubleshooting.md

Desk V2（当前基线）

assistant 办公桌根目录：~/.ally/desk/<assistant_id>/

~/.ally/desk/<assistant_id>/
├── AGENTS.md
├── ally.toml
├── Desk/
│   ├── PROFILE.md
│   ├── MEMORY.md
│   ├── conversations/
│   ├── journal/
│   └── skills/
│       └── work-ally-operator/
└── .system/
    ├── codex-home/
    │   ├── AGENTS.md
    │   └── config.toml
    ├── runtime/
    ├── logs/
    ├── runs/
    ├── cache/
    ├── routines/
    └── archive/

用户路径

ally setup <assistant_id> --workspace /path/to/project
ally config show --assistant <assistant_id>
ally start --assistant <assistant_id>
ally status --assistant <assistant_id>

人格与记忆设置

先拿到办公桌路径：

ally --assistant <assistant_id> desk

然后编辑这两个文件：

• 人格/风格/原则：~/.ally/desk/<assistant_id>/Desk/PROFILE.md
• 长期记忆：~/.ally/desk/<assistant_id>/Desk/MEMORY.md

修改后建议执行：

ally --assistant <assistant_id> restart

每次 ally start / ally restart 都会自动对该 assistant desk 的内置 Skill 做 reconcile：缺失即安装，版本落后即更新，文件漂移即修复。当前内置的核心 Skill 是 Desk/skills/work-ally-operator/，用于把“重启一下”“我想回飞书了”“我想回 codex-cli 了”这类自然语言请求翻译成正式的 ally 操作。

assistant_id 规则：^[a-z][a-z0-9_-]{1,31}$

配置与模型作用域

• 用户配置真源：ally.toml（固定 V1 schema）
• CLI 配置命令：ally config show|set
• global 模型：写入 ally.toml
• current 模型：写入 work-session 元数据
• 优先级：current > global
• 飞书会话命令：/model show、/model set global|current ...、/model reset current

安全边界

• Codex CLI 的登录、provider 与鉴权由官方 Codex runtime 自己负责；assistant 级入口是 ally --assistant <assistant_id> auth codex
• work-ally 不保存 provider API key，不生成 provider base_url / env_key
• ally.toml 只保存 work-ally 自己需要的模型、飞书与记忆开关配置

维护入口

• 命令分发：internal/dispatch.sh
• 通用路径/状态：internal/lib/common.sh
• assistant 生命周期：internal/modules/runtime/*.sh
• assistant 管理：internal/modules/assistant/manage.sh
• bridge 入口：bridge/src/server.ts
• 入站主流程：bridge/src/receiver.ts

常用命令

ally --assistant <assistant_id> setup --workspace /path/to/project
ally --assistant <assistant_id> auth codex
ally --assistant <assistant_id> config set model gpt-5.5
ally --assistant <assistant_id> config set reasoning_effort medium
ally --assistant <assistant_id> config set memory.nightly_digest_enabled true
ally --assistant <assistant_id> start
ally --assistant <assistant_id> status
ally --assistant <assistant_id> stop
ally --assistant <assistant_id> logs bridge
ally --assistant <assistant_id> diagnostics export
ally assistant list
ally global list