37 lines
2.3 KiB
Markdown
37 lines
2.3 KiB
Markdown
|
# 术语映射表（Core ↔ dogfood 实例）
|
|||
|
|
|
|||
|
|
> 本表是 Core 改写与 dogfood 实例对照的**唯一事实源**（v3 §E）：Core 侧
|
|||
|
|
> 工件使用下表左列的中立术语，右列是本组织 dogfood 实例（Gitea 后端）的
|
|||
|
|
> 实际表述。任何 Core 工件需要落到本实例时，按本表做机械替换；反向
|
|||
|
|
> 改写（实例 → Core）同样以本表为准。新增映射必须先改本表，再改工件。
|
|||
|
|
|
|||
|
|
| Core 中立术语 | dogfood/Gitea 实例表述 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 工单后端（ticket backend） | Gitea |
|
|||
|
|
| Tier-2 工件库 | Gitea wiki |
|
|||
|
|
| 工单评论 API（ticket backend 评论接口） | `gitea_issue_comment__*` |
|
|||
|
|
| wiki 读写 API（Tier-2 工件库读写接口） | `gitea_wiki__*` |
|
|||
|
|
| 看板移动 API（工单看板列迁移接口） | `gitea_column__move_issue` |
|
|||
|
|
| 项目看板 API（工单面板管理接口） | `gitea_project__*` |
|
|||
|
|
| 路由解析工具（Step 0 路由门依赖） | `route_resolver` |
|
|||
|
|
| 会话工作树路径（并发分支工作区根） | `<worktrees-root>` |
|
|||
|
|
| 测试命令·变更集（本地前置检查） | `bun run test:changed` |
|
|||
|
|
| 测试命令·全量分片（交付前置 / nightly） | `bun run test:parallel` |
|
|||
|
|
| 类型检查命令 | `bun typecheck` |
|
|||
|
|
| 产品代码路径（harness 实现所在包） | `packages/octopus/src/...` |
|
|||
|
|
| 私化工单引用（组织内部工单号） | `#NNNN` 活链接（Core 侧用 `[org-internal #NNNN]` 注记） |
|
|||
|
|
| 实例规则目录（dogfood 消费副本所在） | `.octopus/`（如 `.octopus/rules/`） |
|
|||
|
|
| 运行工作区（Tier-1 本地工件） | `.octopus/runs/{slug}/` |
|
|||
|
|
| 实例配置文件（会话/管线配置） | `octopus.jsonc` |
|
|||
|
|
|
|||
|
|
## 备注
|
|||
|
|
|
|||
|
|
- **私化工单引用**：Core 侧不得产出指向具体实例的活链接 `#NNNN`（会被
|
|||
|
|
实例渲染为真实工单）；一律写 `[org-internal #NNNN]` 注记格式，落地
|
|||
|
|
实例时按本表还原为 `#NNNN`。
|
|||
|
|
- **命令占位**：Core 规则正文中的 `<test-cmd:changed>`、
|
|||
|
|
`<test-cmd:parallel>` 等占位符按本表「测试命令」两行绑定到实例命令。
|
|||
|
|
- **裸词 Gitea**：仅当作为 adapter 名称出现时允许（如「Gitea adapter」）；
|
|||
|
|
- 表内反引号包裹的实例表述仅供对照，不构成 Core 对实例的引用
|
|||
|
|
（C-1 扫描剥离行内代码后本表零命中）。
|