Skip to content

docs: enrich domain glossary and rewrite open questions for handoff - #1394

Merged
ulleo merged 2 commits into
mainfrom
docs/domain-glossary
Sep 24, 2026
Merged

ulleo merged 2 commits into
mainfrom
docs/domain-glossary

Conversation

@ulleo

@ulleo ulleo commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

内容

领域文档一轮全量查证的成果(主仓库 + sqlbot-xpack 可读源码取证,逐条附 file:line 后归纳):

CONTEXT.md(+15 词条、修订 4 个)

  • 工作空间与数据:System Admin、Workspace Admin、Excel Datasource、Dynamic Datasource、Table Relation、Row/Column Permission(标注 xpack)、Base Model、Default Model、Knowledge Scope
  • 会话:Chat Origin、Opening Record;Assistant Domain、Dashboard 定义精化
  • 助手与集成:Assistant Certificate、App Secret、MCP
  • 新增「商业扩展(xpack)」小节:License、Authentication Source、Platform Integration

docs/agents/knowledge-enhancement.md(新建)

术语/SQL 示例/自定义提示词的作用域矩阵、命中即注入的组合语义、embedding 与关键词的并集关系、注入顺序。

docs/agents/backend.md

  • AssistantModel.type 修正为实际值域 0–4(2、3 为遗留兼容值)
  • 新增「记录状态与衍生关系」小节(二元终态、衍生记录互斥、再生链、开场记录、快捷入口规则)
  • 持久化命名澄清:chat_type 遗留值、recommended_question 双重承载

docs/agents/domain-open-questions.md(重写为交接版)

八节各附"已确认"摘要与词条去向;16 条【待答】均附代码现状与二选一选项,供产品/设计同事直接回答,无需重新查证。

CLAUDE.md(新建)

仅含 @AGENTS.md 导入,使 Claude Code 会话自动加载 AGENTS.md(AGENTS.md 保持单一事实来源)。

验证

  • 纯文档变更,无代码影响
  • 词条与行为描述均来自源码取证;无法从代码确定的项已全部归入【待答】而非臆断

@ulleo
ulleo merged commit e02f717 into main Sep 24, 2026
3 checks passed
@ulleo
ulleo deleted the docs/domain-glossary branch September 24, 2026 10:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant