work-ally

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

快速入口

• 产品使用者：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/
└── .system/
    ├── config.env
    ├── codex-home/
    │   ├── AGENTS.md
    │   └── config.toml
    ├── runtime/
    ├── logs/
    ├── runs/
    ├── cache/
    ├── routines/
    └── archive/

用户路径

ally setup <assistant_id> --workspace /path/to/project
ally --assistant <assistant_id> desk
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

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

安全边界

• API key 由 ally config set api_key 写入 assistant 的 ally.toml
• API key 不落盘到 .system/codex-home/config.toml
• config.toml 仅保留 env_key
• 启动时由 ally start 注入运行环境变量（不依赖全局 shell env）

维护入口

• 命令分发：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 setup <assistant_id> --workspace /path/to/project
ally config set model openai/gpt-5.4 --assistant <assistant_id>
ally config set reasoning_effort medium --assistant <assistant_id>
ally config set api_key <your_provider_api_key> --assistant <assistant_id>
ally start --assistant <assistant_id>
ally status --assistant <assistant_id>
ally stop --assistant <assistant_id>
ally logs bridge --assistant <assistant_id>
ally assistant list
ally global list