★ FEATURED ARTICLE 桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载Trellis 的forum频道Forum Channel是面向多 Agent 协作的持久化、主题式频道它在channel create时通过--type forum定型此后不可变更并以论坛摘要 → 单线程时间线 → 当前上下文作为默认读路径。本文以 EcoPaste 仓库中使用的 Trellis 工作流参见 AGENTS.md 中的 Trellis 说明块为背景完整讲解论坛频道的创建、线程生命周期、Context 管理、标题投影、线程重命名、删除纪律与内部变更日志模式并提供可直接复制运行的命令示例与源码级参数说明帮助你搭建可检索、可长期维护的多 Agent 议题看板。Forum 频道的核心模型它不是一条聊天流Forum 频道是持久化、主题风格durable, topic-style的频道在创建时通过--type forum声明之后不可变。它不属于普通聊天流其默认读路径是一条固定链路——forum summary论坛摘要→ one thread timeline单个线程时间线→ current context当前上下文也就是说当你打开一个论坛频道时看到的不是一长串原始事件而是这个论坛里有哪些线程、各自什么状态点进某个线程后才能看到该线程的完整事件时间线并配合已投影好的 Context 理解背景。这套模型在 forum.md 中被定义为 Forum 与普通频道的根本差异。Forum 与普通频道的区别频道的类型由channel create时的--type参数决定创建后永不改变。两种类型对比如下chat默认扁平消息时间线。channel messages永远渲染事件流论坛专属参数如--thread、--action在此类型下会被拒绝。forum线程导向。channel messages在无过滤条件时渲染的是线程看板摘要thread-board summary而非原始事件流post、forum、thread、thread rename这些子命令只对 forum 频道生效。两种类型共享同一套 scope 模型--scope project是默认值将频道放入当前项目桶--scope global将频道放入跨项目共享桶__global__。补充实现细节在channel messages的实现中CLI 会自动检测论坛频道——无过滤参数时渲染线程看板而非事件流--thread与--action属于 forum-only 参数对 chat 频道会直接报错。这一点在 command-reference.md 中有明确记录。创建一个 Forum 频道创建论坛频道使用channel create关键是在创建时声明--type forumtrellis channel create design-feedback \ --type forum \ --scope global \ --description Cross-project design feedback board. \ --context-raw One thread per design topic; close when resolved. \ --by main--scope project看板仅作用于当前仓库/项目--scope global跨项目共享看板。请谨慎选择 scope——全局看板在默认的项目列表里是不可见的必须显式加--scope global才能看到。--description频道的稳定描述。--context-raw创建时立即写入的频道级上下文详见下文 Context 一节。--by agent创建事件的作者默认main。create还支持更多参数完整清单见 command-reference.md参数说明--task path关联的 Trellis task 目录--labels a,b,c频道标签--context-file abs-path以文件形式注入上下文可重复--linked-context-file/--linked-context-raw已废弃别名会折叠进--context-file/--context-raw并打印废弃提示--force覆盖已存在的同名频道--ephemeral从默认列表隐藏、可被prune --ephemeral清理创建动作会追加一条create事件频道的type一旦写入便不可变更不能事后把 forum 改成 chat反之亦然。线程生命周期opened、comment、status、summary线程Thread存活在论坛频道内部每个线程由稳定的--thread key标识惯例使用小写 kebab-case如login-empty-state。线程的第一个动作必须是opened之后的所有动作都复用同一个--threadkey。标准生命周期如下# 1. 开线程 trellis channel post design-feedback opened \ --scope global \ --as main \ --thread login-empty-state \ --title Empty state on the login screen \ --description Track design feedback for the new login empty state. \ --labels design,login \ --context-raw Spotted during the 0.4 release review. \ --text-file /tmp/thread-open.md # 2. 评论 trellis channel post design-feedback comment \ --scope global \ --as reviewer \ --thread login-empty-state \ --text-file /tmp/review.md # 3. 更新状态 trellis channel post design-feedback status \ --scope global \ --as main \ --thread login-empty-state \ --status closed # 4. 写入决议摘要 trellis channel post design-feedback summary \ --scope global \ --as main \ --thread login-empty-state \ --summary Adopted the option-B layout; ticket TRELLIS-123 owns the fix.理解这几个核心区分点是用好线程模型的关键--description是持久化的线程描述——回答这个线程是关于什么的这一永恒问题。它在opened时设置之后可通过再次执行post ... --description来编辑。--text/--stdin/--text-file是事件正文——附着到这条时间线条目上的评论或负载。长文本尤其是中英混合的长文应通过--stdin或--text-file传入不要塞进位置参数。--labels与--assignees是 CSV 且是替换语义——重复执行会替换当前值而不是追加。--summary是滚动累积的线程摘要在status closed时同时写入--summary是带上下文地标记线程已解决的标准做法。--thread对除opened外的每个动作都是必需的即使是opened实际中也没有匿名线程所以该参数始终要传。post的action在 CLI 表面是自由字符串惯用值包括opened、comment、status、labels、assignees、summary、processed但actionrename会被拒绝线程重命名必须走专门的thread rename见下文。读取 Forum先看摘要再钻取单线程读取论坛频道遵循先概览、后下钻的路径相关命令如下# 看整个论坛的事件流无过滤时自动渲染线程看板 trellis channel messages design-feedback --scope global # 看论坛的线程摘要可按状态过滤 trellis channel forum design-feedback --scope global --status open # 看单个线程的完整时间线 trellis channel thread design-feedback login-empty-state --scope global # 以原始 JSON 事件流形式读取某个线程适合审计/脚本处理 trellis channel messages design-feedback --scope global --raw --thread login-empty-state当同伴说我在论坛里评论了时正确做法是先执行channel forum确认哪个线程发生了变化再用channel thread name thread钻取该线程。论坛频道是事件溯源event-sourced的不要一上来就手工解析events.jsonl——这些 reducersforum、thread、context list才是官方的状态投影入口。补充参数细节源自 command-reference.mdforum支持--status过滤当前线程状态、--raw每线程输出一行 JSONthread name key的 pretty 输出头部为thread [status] title随后是 description / labels / assignees / summary / 时间线--raw切换为原始事件messages的--thread/--action是 forum-only 参数对 chat 频道直接报错messages --follow可流式跟踪新事件--kind只接受CHANNEL_EVENT_KINDS白名单内的单值。Context每个读者都会重放的持久化背景Context 条目是持久化的背景信息始终应在读取频道或线程时纳入考虑。它们不是时间线事件——而是被单独投影、并为每个读者重放的。正确用法是context子命令族# 添加频道级上下文影响整个论坛 trellis channel context add design-feedback \ --scope global \ --raw Upstream feedback board; please link tasks before opening threads. # 添加线程级上下文只影响一个线程 trellis channel context add design-feedback \ --scope global \ --thread login-empty-state \ --file $PWD/.trellis/tasks/05-13-login-redesign/design.md关键规则--thread key用于切换频道级与线程级上下文不传则作用于频道级。--file路径必须是绝对路径相对路径会被拒绝。--raw是内联纯文本。--file与--raw都可重复传入add/delete至少需要其中一种。--as agent记录作者默认main。列出 Context# 人类可读列表file path / raw 截断文本 trellis channel context list design-feedback --scope global # 线程级 原始 JSON 输出每行一条便于管道处理 trellis channel context list design-feedback --scope global --thread login-empty-state --rawlist加上--raw时每行输出一条 JSON非常适合管道/脚本不加时输出可读的file path/raw truncated text列表。空 store 打印(no context)。删除 Contexttrellis channel context delete design-feedback \ --scope global \ --thread login-empty-state \ --raw stale note删除是按值by value而非按 id进行的传入当初添加时相同的--file或--raw值即可重复该 flag 可以一次调用删除多个条目。推荐的线程读取顺序阅读一个线程时自顶向下处理线程description持久化的这个线程是关于什么的Context 条目频道级 线程级时间线opened、comment、status、summary。如果某个 Context 文件缺失或不可读要显式说明并基于剩余数据继续——绝不能凭空编造内容。Title Projection不改存储地址的显示标题title为频道投影一个稳定的显示标题不会重命名存储地址——你在每条命令里传的 channelname始终保持不变# 设置显示标题 trellis channel title set design-feedback \ --scope global \ --title Design feedback board # 清除显示标题 trellis channel title clear design-feedback --scope globaltitle set必须提供--title--as agent记录作者默认main这是展示层presentation-layer变更脚本和工具继续使用原始频道名不受影响。Thread Rename线程键的纠错通道线程以错误的 key 开启拼写错误、slug 惯例不符等时thread rename是纠错通道。线程不支持硬删除——重命名是官方支持的更正动作trellis channel thread rename design-feedback old-key new-key \ --scope global \ --as main--as agent必填post name rename会被拒绝——必须使用thread rename。删除纪律论坛线程是追加式协作史不要把删除单条评论或硬删线程建模为常规工作流。论坛线程是append-only 的协作历史。要纠正状态使用以下手段组合post ... status—— 将线程标记为 closed / blocked 等状态post ... summary—— 记录决议结果post ... --labels—— 重新打标替换整个标签集thread rename—— 纠正错误的线程 key。这种设计保证了每一条协作记录都可审计、可追溯同时通过状态与摘要表达已解决而不是物理抹除历史。实战模式内部变更日志Internal Changelog论坛频道的一个典型用法是内部发布/运行时变更日志每个值得记录的变更开一个线程让历史保持可搜索。完整示例# 创建全局变更日志论坛 trellis channel create release-notes \ --type forum \ --scope global \ --description Internal release and runtime changelog. \ --context-raw One thread per notable change; close when shipped. \ --by main # 为某次发布记录一个线程 trellis channel post release-notes opened \ --scope global \ --as main \ --thread release-2026-q1 \ --title Channel threads and forum UX in 0.6 \ --description Forum channel UX shipped in the 0.6 line. \ --labels channel,release \ --text-file /tmp/release-notes.md线程 key 要稳定且具有描述性如release-2026-q1、runtime-event-schema-change这样后续读者才能按名字找到它们。这一模式在 workflows.md 中被正式列为 Pattern E适用于 issue 论坛、主题式反馈、发布待办、Agent 发现记录与内部变更日志对应的接管旧线程流程Pattern F则建议依次执行channel forum board --scope global、channel thread board thread --scope global --raw、channel context list ... --thread thread与channel messages ... --raw --thread thread来恢复上下文。事件模型与输出约定速查理解论坛频道的底层事件模型有助于排查问题来源command-reference.md事件类型由CHANNEL_EVENT_KINDS白名单约束parseChannelKind强制校验包括create、join、leave、message、thread、context、channel、spawned、killed、respawned、progress、done、error、waiting、awake、undeliverable、interrupt_requested、turn_started、turn_finished、interrupted、supervisor_warning论坛状态一律通过 CLI reducersforum、thread、context list投影不要直接解析events.jsonl输出约定变更类命令post、context add/delete、title set/clear、thread rename在 stdout 打印一条 JSON 事件流式读取wait、messages --follow每行一条 JSONpretty 读取list、messages、forum、thread、context list输出着色表格/时间线错误统一走 stderr 并exit 1。小结Trellis 论坛频道把多 Agent 协作从不可检索的即时消息升级为持久化、线程化、带上下文投影的议题体系创建时用--type forum定型用post驱动线程从opened走向comment → status → summary用context子命令维护每个读者都会重放的背景用title投影稳定的显示标题用thread rename纠正 key并通过变更日志模式沉淀可搜索的历史。这套模型的全部细节与命令速查可在仓库 forum.md 与 command-reference.md 中继续深入查阅。赞分享桌面应用【免费下载链接】EcoPaste跨平台的剪贴板管理工具 | Cross-platform clipboard management tool项目地址https://gitcode.com/ayangweb/EcoPaste点击查看免费下载相关推荐Amaranth高级技巧构建复杂数字系统的7个最佳实践Amaranth高级技巧构建复杂数字系统的7个最佳实践 Amaranth是一款基于Python的现代硬件定义语言和工具链为开发者提供了灵活高效的数字系统设计硬件开发嵌入式Carbon-Forum: 高性能PHP论坛软件安装及使用指南Carbon Forum: 高性能PHP论坛软件安装及使用指南 1. 项目介绍 Carbon Forum是一款基于PHP编写的高性能开源论坛软件。该项目专为构建后端上一篇DDD值对象验证Modular Monolith FluentValidation实战下一篇告别卡顿WebLLM多轮对话优化实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
