OpenCode · 附录 A 术语表 · 命令速查 · 常见报错排查

OpenCode · 附录 A 术语表 · 命令速查 · 常见报错排查

章节摘要:这是一份检索型附录,把全书散落各章的术语、高频命令、常见报错收敛成三张表,作为日常工作的快速入口。术语表按主题分组,给中英对照与一句话含义;命令速查覆盖安装、启动、会话、模型、配置、调试等高频操作;报错排查用「报错 → 原因 → 解决」三列表给出最常踩的坑。本附录随各章写作持续扩充,不一次性写死——它是活的工具,不是死的清单。

学习目标

阅读完本附录,你应当能够:

1. 遇到陌生术语时,在本附录快速查到中英对照与一句话含义。
2. 日常操作时,在本附录快速找到对应命令及其关键参数。
3. 遇到常见报错时,在本附录按报错文本定位原因与解决方案。
4. 把本附录作为读源码、做集成、排问题的常备检索入口。

核心概念速览

一句话总结:三张表覆盖「是什么、怎么做、为什么错」三类高频问题——本附录是全书的索引,值得在动手时随手翻。

子章节导航

01 术语词典(中英对照)

按主题(架构、会话、上下文、工具、LLM、扩展、工程化)分组的术语表,每条给中英对照与一句话含义,并标注首次出现的章节便于回查。

02 命令与接口速查

覆盖安装、多形态启动、会话管理、模型与 Provider、配置、调试、导出导入等高频命令,每条给命令形态与关键参数说明。

03 常见报错与排查

用「报错 → 原因 → 解决」三列表给出最常踩的坑:安装与平台匹配类、认证与权限类、模型调用与流式类、会话与压缩类、MCP 与扩展类。

子章节之间的逻辑关系

本附录三节是并列的检索入口,无强先后,按需查阅:

术语词典 (01)   ──是什么
   │
命令速查 (02)   ──怎么做
   │
报错排查 (03)   ──为什么错
​

建议把本附录加入书签,遇到问题时先来这里定位,再回正文深读。

前置知识与后续延伸

前置知识:

• 本附录无前置,可独立查阅;但术语含义的深入理解需回到对应章节。

本附录的用法:

• 它是工具而非教材,不必通读,按需检索即可。
• 随全书各章写作持续扩充,术语表会越来越全。
• 若某报错未收录,建议结合报错文本与对应章节(如会话类报错查第 7、9 章)排查。