nightme — Feature Index

关联文档：

产品定位 → PRD.md

技术架构 → SPEC.md

多 channel 架构 → CHANNEL.md

本文档是 nightme 的功能索引。每项功能的设计细节见对应文档。

1. 运行时与核心架构

功能	设计文档
Session 生命周期（`/cwd` 设 workspace；CLI 进程可重启）	feat/F-runtime.md
进程注册 / 清理 / Workspace 绑定 / Session 列表命令	feat/F-runtime.md
PTY 模拟 + CLI Transport + Agent Communication Modes	feat/F-runtime.md + bridge/cli-transport.md
消息透传（Channel → AgentSession via Gateway）	feat/F-message-flow.md
输出推送（AgentSession Events → Channel）	feat/F-message-flow.md
Command Gateway + Binding 表 + 职责隔离	feat/F-gateway.md
多 channel 并行接入（feishu + telegram + slack + ...）	CHANNEL.md
Channel interface 抽象 + Channel Registry（OCP 接入点）	feat/F-08-channel-abstraction.md + CHANNEL.md §4.1

功能	设计文档
ChatSession 模型（per chat 持久化会话上下文）	feat/F-chat-session.md
chatstore 抽象 + 修 lost-update race	F-CHATSTORE-001
`/use <agent>` 命令	feat/F-chat-session.md
AgentSession 池（`(agent, cwd)` 1:1 池化）	feat/F-chat-session.md
`/new` slash command	feat/F-chat-session.md
`/close` graceful + per-entry list reply	feat/F-chat-session.md
Message / Prompt 生命周期模型（`Prompt` 一等公民）	feat/F-53-message-prompt-lifecycle.md

功能	设计文档
Claude Code Bridge	bridge/claude.md
Codex App-Server Bridge	bridge/codex.md
OpenCode Bridge (ACP `opencode acp` + print-mode `opencode run`)	feat/F-OPENCODE-ACP-MIGRATION.md
Pi Coding Agent Bridge（传输 + 流式事件 + contextWindow）	bridge/pi.md
dsh (DeepSeek Harness) Bridge — print-mode RunOnce	feat/F-dsh-bridge.md
dsh Chat-Session Event Translation 重构（To-dos / Tool 列表修复）	feat/F-DSH-CHAT-001-event-state.md
Channel interface 抽象	feat/F-08-channel-abstraction.md
Agent 抽象（`AgentSpec` / `Starter` interface + `Agent` runtime handle）	feat/F-09-agent-abstraction.md

功能	设计文档
Feishu 渲染策略总览（Receipt / Thread / Footer / Card）	channel/feishu-rendering.md
Rolling-Log Receipt UX	channel/feishu-rendering.md
MessageState 进度反应（⏳ / 🔄 / ✅ / ❌）	channel/feishu-rendering.md
Tool/Thinking → Thread Reply + 类型感知摘要	channel/feishu-rendering.md
Task Checklist in Receipt	channel/feishu-rendering.md
`/tools on\|off` + 合并渲染	channel/feishu-rendering.md
OutReply 超限改独立 Reply	channel/feishu-rendering.md
Lazy Receipt Creation	channel/feishu-rendering.md
OutReply 拆出 Receipt + Task Receipt 瘦身	channel/feishu-rendering.md
Main-Chat 卡片 Footer (per-turn snapshot)	channel/feishu-rendering.md
Interactive Decision Cards	channel/feishu-rendering.md
Feishu 交互卡设计与踩坑（form / callback / AskUserQuestion）	channel/feishu-cards.md
Compaction Counter	channel/feishu-rendering.md
Footer Context Window 显示	channel/feishu-rendering.md
OutResult 独立 Reply（不再 fold receipt）	channel/feishu-rendering.md
Feishu 限速 / 重试 / WS 重连（可靠性）	channel/feishu-reliability.md
Feishu Onboarding（附件透传 / App QR 注册）	channel/feishu-onboarding.md

功能	设计文档
Telegram Forum Supergroup Topic 方案（每个 chat → 一个 Topic）	channel/telegram.md
Telegram Bot API 限速（per-chat / global QPS）	channel/telegram.md
Telegram Polling / Webhook 双模式	channel/telegram.md
Telegram Inline Keyboard / CallbackQuery → Choice 归一化	channel/telegram.md

功能	设计文档
Interactive Config（`nightme config` 交互菜单）	feat/F-30-interactive-config.md
ChatID 数据模型简化	feat/F-33-simplify-chatid-data-model.md

功能	设计文档
`/gtw` 子命令集：`fix` / `close` / `commit` / `push` / `pr` / `sync`	feat/F-gtw.md
`/gtw fix` Plan-first dispatch + `-y` 直接执行	feat/F-gtw-fix.md
`/gtw push` 三分支流	feat/F-gtw.md
`/gtw push` + `/gtw pr` 联动 Readiness Gate	feat/F-gtw.md
GitProvider 抽象 + 两阶段 Provider 探测	feat/F-50-git-provider.md

/watch on|off：群聊是否接收所有消息（默认只 @ 收）— 见 channel/feishu-rendering.md
/think on|off：是否在 thread reply 显示 agent 思考内容 — 见 channel/feishu-rendering.md
/tools on|off：是否显示工具调用的 thread reply — 见 channel/feishu-rendering.md

三个 toggle 模式一致：ChatSession 上挂 mode 字段 + Gateway dispatcher 入口 gate + Channel 自治渲染。

功能	设计文档
Workflow YAML + 引擎运行时架构（schema / 触发器 / 步骤 / 表达式 / bot↔wfe 边界）	WFE.md
5 类触发器：`schedule` / `pull_request` / `branch` / `issue` / `mention`	WFE.md §3
三种 step：`run`（shell）/ `prompt`（agent）/ `use`（action）	WFE.md §5
顶层 `worker` 字段（并发 worker pool）	WFE.md §2
`${{ ... }}` 表达式（`event.` / `steps..outputs.` / `needs..outputs.` / `env.`）	WFE.md §6
复用本地 agent 环境变量（不管理 agent，只调度）	WFE.md §5.2
`use` 步骤 = 扩展点（bot 注入 action；内置 + `~/.nightme/workflows/actions/*.sh`）	WFE.md §5.3
`bot` subsystem 作为 host（跟 `/gtw` 平级；不实现 `Channel` interface；持 `NightmeChannel` / `ActionRegistry` / `os/exec` 等资源 channels）	WFE.md §8.1
`wfe` 库 = 纯库（无 I/O / 无 clock / 无 secrets；Tick 推进 state）	WFE.md §8.2
Runtime interface（4 方法：RunShell / SendPrompt / RunAction / Now）	WFE.md §8.4
Action 注入模型（ActionRegistry + ShellAction 包装用户脚本）	WFE.md §8.5
触发器 → 虚拟 chat 映射	WFE.md §8.6
`prompt` 步骤作为合成消息经 Gateway 派发	WFE.md §8.7
Run 状态持久化（`~/.nightme/workflows/state/`）	WFE.md §8.8
实现设计（包结构 / Tick 状态机 / StateStore / ActionRegistry / 灰度上线）	feat/F-workflow-engine.md

Workflow 文件位置：~/.nightme/workflows/*.yaml，按 name: 去重，热加载。Engine 入口：internal/wfe/，host：internal/channel/bot/。

❌ 不做	原因
多 AgentSession 并行协作	ChatSession active 单一原则
跨 chat 共享 ChatSession	Channel 隔离
LLM 编排 / Code review / 提示词改写	透传原则
接管用户已有的 shell / terminal multiplexer	进程归属原则
Multi-user RBAC / 云端 SaaS	单用户独占假设

详细设计见 CHANNEL.md。

核心能力：

所有有凭据的 channel（feishu / telegram / slack / 未来）自动并行启动，无需 --channel flag
每个 channel 一个 chatsession.Manager（per-channel session 隔离，chatID 天然 namespaced）
每个 channel 一个 outbound.Emitter（= 该 channel 自己，无 router 无 multi 概念）
ChatSession 不知道 channel（无 channelName 字段，持久化 schema 零变更）
Restore 懒加载：首次 GetOrCreate(chatID) 时 csFile.GetByChat(chatID) 命中即 hydrate
入站 partition 隐式由 pump goroutine 闭包决定
共享 components（inbound.Router / command.Factory / shell.Dispatcher / gtw.Manager）持 mgr per call
OCP：接入新 channel = 1 个 adapter 文件 + 1 个 init() 注册到 channel.Registry

已实现的 channel：

未来接入的 channel（roadmap）：