Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
df3eab0
fix(persona): 逐命题核对收录资格、频率强度不得升级、单句截断按焦点拆分 (PE-23)
leafliber Nov 11, 2026
201db4d
fix(persona): PE-23 审查修改:重试失败回退、频率依据只认原话被肯定的词、计划标记收窄
leafliber Nov 11, 2026
af9533d
fix(persona): PE-23 复审修改:恢复须留出后续窗口时间、拆分失败回退、“都”按整句前文判断
leafliber Nov 11, 2026
702978d
fix(persona): PE-23 第三轮复审:“都”只按三种封闭写法豁免、只有“都”可写有界经历、按句拆分失败回退、容忍只绑定失败重试本身
leafliber Nov 11, 2026
fd8cfe9
fix(persona): PE-23 第四轮复审(代码):计数分组须两个以上、多个“都”逐个限定、来源单独“都”不算依据、暂停类错误不回…
leafliber Nov 11, 2026
3b78c30
test(persona): PE-23 第四轮复审的测试与架构说明
leafliber Nov 11, 2026
0025f86
fix(persona): PE-23 第五轮复审:计数分组为固定形状、单条请求的拒绝与条目错误可回退、提示词写明单独“都”不算依据
leafliber Nov 12, 2026
a557756
fix(persona): PE-23 第六轮复审:序数不算计数分组、来源“每……都”算明确频率依据
leafliber Nov 12, 2026
a48d969
feat(persona): prepare automatic publication as default
leafliber Nov 15, 2026
bebe3aa
test(persona): keep manual confirmation scenarios explicit
leafliber Nov 15, 2026
dd19ee0
fix(persona): allow one hour per check stage
leafliber Nov 16, 2026
c697052
fix(persona): bind one-date scopes and corroborate handwriting correc…
leafliber Nov 16, 2026
c635e94
fix(persona): preserve bounded narrative and spoken clauses
leafliber Nov 16, 2026
c12f3d5
Integrate the accepted Persona checks with automatic publication
leafliber Nov 17, 2026
6a2b03d
Run release tests on Python 3.13 only
leafliber Nov 17, 2026
438952b
Stabilize the Persona stream deadline test
leafliber Nov 17, 2026
d183086
Prepare iris-core 0.0.3
leafliber Nov 17, 2026
d526c19
Sync the reviewed 0.0.3 candidate with main
leafliber Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,7 @@ jobs:
out.write('version=' + version + '\n')
PYCODE
- run: uv sync --locked --python 3.13
- run: uv run pytest
- run: uv run --locked --isolated --python 3.12 pytest
- run: uv run --locked --python 3.13 pytest
- run: uv build
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
with:
Expand Down Expand Up @@ -88,7 +87,7 @@ jobs:

支持宿主机 AstrBot 与可信 Docker 网络中的 AstrBot。镜像以非 root 用户运行;首次设置使用容器日志中的一次性设置码,数据保存在 /data。请仅映射到 127.0.0.1,或使用明确 Host 白名单的可信网络;本服务不提供 TLS。

镜像:\`ghcr.io/airobject/iris-core:$VERSION\`(另有 \`latest\`),支持 linux/amd64 与 linux/arm64。附件为同一版本的 wheel 与 sdist;Python 3.12、3.13 测试及构建均已通过。
镜像:\`ghcr.io/airobject/iris-core:$VERSION\`(另有 \`latest\`),支持 linux/amd64 与 linux/arm64。附件为同一版本的 wheel 与 sdist;Python 3.13 测试及构建均已通过。
EOF
gh release create "$RELEASE_TAG" dist/*.whl dist/*.tar.gz \
--verify-tag --title "Iris $VERSION" --notes-file "$RUNNER_TEMP/release-notes.md" --generate-notes
10 changes: 5 additions & 5 deletions ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ auto_v1 的初判使用 `consolidation_pair_auto_v1.md`(report_only 仍用 pai

## M3 persona

2026-10-10 的产品默认改为 `all_manual`;#61 的 persona 改进及 #130 的手写句规则合入后,默认仍为全部人工确认。管理员查看逐句依据与检查结果后确认,检查通过本身不触发默认自动发布;初始模板、管理员直接编辑和回滚仍是明确的发布操作。`DEFAULT_PUBLISH_MODE` 同时用于数据层缺省值和设置请求模型;`PUBLISH_MODES` 继续接受三种方式,不靠枚举顺序定义默认。
产品默认 `all_auto`。迁移 041 只升级从未保存过 persona 设置的旧默认,已保存过生成目标、监管要求或发布方式的库沿用此前的有效发布方式。迁移保留已接受任务的设置快照和已有候选。初始模板、管理员直接编辑和回滚仍是明确的发布操作。`DEFAULT_PUBLISH_MODE` 同时用于数据层缺省值和设置请求模型;`PUBLISH_MODES` 继续接受三种方式,不靠枚举顺序定义默认。

迁移 020 先补齐缺失的旧隐式发布方式,再只把 `small_medium_auto` 且从无管理员 `persona_settings_saved` 操作记录的值改为 `all_manual`。记录只要求 `actor=admin` 与动作匹配,任何字段的保存都保护管理员原选择;正文编辑、自动生成和其他设置操作不算 persona 设置修改。迁移不修改版本、已接受尝试或其检查/设置快照。待确认数量复用版本列表的 `status=pending` 过滤计数 `total`,唯一索引限制最多一个;没有新增宿主通知路径。

Expand All @@ -234,7 +234,7 @@ flowchart LR
A[有效自我认知记忆与当前手写条目] --> B[确定性选材、依据与出处快照]
B --> C[persona_generate v24]
C --> W[独立手写审查:仅许可删除]
W --> D[确定性预筛与分批事实检查 v37]
W --> D[确定性预筛与分批事实检查 v38]
D --> R{逐句检查}
R -->|有问题| S[确定性选择完整绑定记忆或删句]
S --> T[复查替换句;事实通过后独立评程度]
Expand All @@ -252,7 +252,7 @@ flowchart LR

`admin.py` 的路由 lifespan 在服务 Store/Gateway 建立后创建 `PersonaJobs`,退出时在线程中等待执行器关闭,然后才关闭底层资源。任务先在短写事务核对当前版本、排除已有 queued/running 任务、记录请求和冻结设置,再提交单线程执行器。HTTP 请求不等待模型。`persona_attempts` 持久保存状态、材料、输出及结果;读取接口只投影安全的任务元数据,生成输出就绪后显示 checking。服务启动把未完成任务记为 interrupted 失败,不自动重试。数据层同步生成也走同一任务准入,避免与管理请求并行生成。

现行 `PROMPT_VERSIONS` 为生成 `persona_generate_v24`、检查/复查 `persona_check_v37`;独立程度与手写审查分别使用 `DEGREE_PROMPT_VERSION=persona_degree_v1`、`HANDWRITTEN_PROMPT_VERSION=persona_handwritten_v2`。程度判定计入当前初检或复查,手写审查计入初检,均不另建用途预算。早期生成 v10、检查 v14、专用修复 v9 及 `persona_sentence_repair` 是历史方案,保留的旧提示词与原始输出不代表当前调用路径;证据笔记也不作为独立检查证据。生成通常提炼 3—6 个自动句,非硬截断上限,不输出 `evidence_note`,全部实际生成句仍接受检查。
现行 `PROMPT_VERSIONS` 为生成 `persona_generate_v24`、检查/复查 `persona_check_v38`;独立程度与手写审查分别使用 `DEGREE_PROMPT_VERSION=persona_degree_v1`、`HANDWRITTEN_PROMPT_VERSION=persona_handwritten_v3`。程度判定计入当前初检或复查,手写审查计入初检,均不另建用途预算。早期生成 v10、检查 v14、专用修复 v9 及 `persona_sentence_repair` 是历史方案,保留的旧提示词与原始输出不代表当前调用路径;证据笔记也不作为独立检查证据。生成通常提炼 3—6 个自动句,非硬截断上限,不输出 `evidence_note`,全部实际生成句仍接受检查。

事实与全文比较已经分离:所有初检/复查事实批均由 `_fact_payload` 构造,`task=check_facts_and_rules`,移除 `previous` 与 `candidate_text`,首批也不接收旧稿或完整比较稿。逐句 `evidence_refs` 绑定共享的 `evidence_by_ref` 去重池,只含本句当前冻结的依据;模板仅附对应原句核对设定口吻,不重复传整份旧背景。来源原话与归属供事实证明;有来源摘录时,`current_revision_text` 只提供当前范围及更正约束,不能补证原话没有的动作或完成状态。事实通过后,以独立 `task=degree_only` 比较上一当前版 `previous` 与组装稿 `candidate_text`,使用程度 v1,不重新判断事实;事实批中的幅度占位值不用于发布。存在事实拒绝时先修复/删句,再针对最终组装稿判程度;复查后仍删句时按后述规则保守覆盖。

Expand All @@ -270,7 +270,7 @@ flowchart LR

频率与断言强度(PE-23)共用这套结构。`FREQUENCY_STRENGTH` 是频率副词和事件全称词的封闭语法词表(含每天、天天、每周、全都等无歧义多字词;单字“常、总”和“一般”有歧义,留给模型检查),按封闭强度序 偶尔<有时<经常<通常/习惯<总是/都/每次/从不 分为五级,不含话题词或人名;它与 `SCOPED_QUANTIFIERS` 一起组成 `quantifiers`,其中的频率词另标 `frequency_words`。候选焦点和来源分句都由同一个 `_focus_quantifiers` 读出被肯定的词,被否定的(不经常、不是每次、从没……每次)不算。“都/全都”一律按频率/全称核对(宁可多删句,不漏拦),只有三种封闭写法例外(`_distributive_dou`):紧挨在“都”前(最多隔一个副词)的复数人称代词或人群词(`PEOPLE_GROUPS`:我们、大家、俩、两个人等);紧接在“都”前的固定形状(`COUNTED_GROUP`):[这/那]+两个以上或“几”+(个人|本、门、位、首、样等人或物量词+至多两字名词,前面可有一个新/老/小等形容词,名词里不能有时、里、上、来等时间、处所或动作字)+至多一个人称代词+至多一个副词,中间不能有其他字(“两个人独处时”“两首歌时”“这两本书里”都不算);“一”不算,前面是“第”的序数(第二本书)不算,分句里有“每”也不算;紧挨在“都”前的“X和/跟/与/同Y”,X、Y 都是人称代词(含“对方”)或本次材料里出现的主体名字/别名(`material.subject_names`,只供代码使用,不发给模型)。这些天、每个晚上、这些歌、每个人、任何人、“接龙和私聊”“平时和周末”“跟人吵架”等都照常核对。紧贴另一个量词(每次都)或在同一分句里跟着已计数的全称词(每次排练我都、所有事情都)的“都”是它的关联词,不另计。频率项在量词字段外另含 `source_instances`(本句绑定原话中这一做法的独立次数,非负整数),缺失按结构错误重问;非频率量词多给的这个字段忽略。`source_quantifier` 只能是词表中的一个明确频率词,或与同一分句后面的“都”构成“每……都”的单字“每”(按 5 级计);来源里单独的“都”不算依据;填整段或多个词按结构错误重问一次(同一焦点其他项已算出的不利结论随重问保留),仍不合格按无频率依据处理。频率依据只取本句绑定来源的原话(`_frequency_source_clauses`),当前正文只能收窄,没有摘录的记忆才用正文;修复替换句复查时同样如此。来源原话所引分句肯定了这个词时,代码按强度序比较,候选不能更强;否则只有“都”可以写成有界经历,且焦点里每个被肯定的“都”都要有自己的计数(计数只限定紧挨着的那个“都”):同一分句里紧挨在“都”前(只隔主语代词或副词)的“这/那+数词或几+次/回/场/遍/趟”(省去数词的“那次”按一次计,`BOUNDED_INSTANCES`),且它就是 `candidate_scope`,所数次数不超过 `source_instances`,同一分句不能有自从、从、之后、以后、过后、往后、后、起、以来、开始(`PERIOD_WORDS`)。总是、每次、一直等其他频率词没有来源频率词时一律不通过,任何计数都不能代替;“那两天”“那次直播里我一直……”也因此被拦。焦点没有肯定的量词项(如分配义的“都”)只记它自己的 preserved=false。意愿表态、第二个日期和不确定语气都不提高来源强度,也不降低候选强度;句中无关的“好像”不豁免这项核对。

逐命题收录资格(PE-23):检查 v37 要求一句中的每个实质命题(当次认识、已发生的行动、结果、未来打算或承诺)分别给出资格结论,“说过/当时表示”不让计划内容获得资格;后来确有实践时候选应写那次实践并绑定它自己的来源。`PLAN_MARKERS` 是表示将来、打算、承诺的时间词和动词的封闭语法类(以后、下次、将要、打算、准备、决定、承诺、保证、答应等),同 #107 先例;单字“会、要”和希望、愿意这类意愿动词太常见,不作标记,交给模型按资格规则判断;“打不打算”这类正反问句只是询问,不算标记。`_check_payload` 给含标记的自动句焦点标 `plan_markers`,只有请求里带标记的焦点必须返回 `claim_checks=[{claim,claim_type,eligible,reason}]`,模型多返回的不带标记的分句不要求;标记不决定结论。`_claim_eligibility_issues` 核对绑定:每个标记都落在与本焦点重叠的某一项 claim 里、claim 原样取自本句,缺失、格式不符或漏项按结构错误重问一次,仍缺按不合格处理;`claim_type=plan` 一律不合格,任一项 `eligible=false` 整句进入修复/删句,不被其他命题的合格结论覆盖。没有标记的焦点若自行返回 `claim_checks`,同样核对。生成 v24 要求保留当次认识时省去随附的未来打算、不把有限次数写成“都/总是/每次”。
逐命题收录资格(PE-23):检查 v38 要求一句中的每个实质命题(当次认识、已发生的行动、结果、未来打算或承诺)分别给出资格结论,“说过/当时表示”不让计划内容获得资格;后来确有实践时候选应写那次实践并绑定它自己的来源。`PLAN_MARKERS` 是表示将来、打算、承诺的时间词和动词的封闭语法类(以后、下次、将要、打算、准备、决定、承诺、保证、答应等),同 #107 先例;单字“会、要”和希望、愿意这类意愿动词太常见,不作标记,交给模型按资格规则判断;“打不打算”这类正反问句只是询问,不算标记。`_check_payload` 给含标记的自动句焦点标 `plan_markers`,只有请求里带标记的焦点必须返回 `claim_checks=[{claim,claim_type,eligible,reason}]`,模型多返回的不带标记的分句不要求;标记不决定结论。`_claim_eligibility_issues` 核对绑定:每个标记都落在与本焦点重叠的某一项 claim 里、claim 原样取自本句,缺失、格式不符或漏项按结构错误重问一次,仍缺按不合格处理;`claim_type=plan` 一律不合格,任一项 `eligible=false` 整句进入修复/删句,不被其他命题的合格结论覆盖。没有标记的焦点若自行返回 `claim_checks`,同样核对。生成 v24 要求保留当次认识时省去随附的未来打算、不把有限次数写成“都/总是/每次”。

检查保留否定短路:按序前缀中有效的否定可拒绝整句,未查焦点保存在 `unchecked_clause_indices`、`short_circuits`;省略冗余停止标记的否定前缀会记规整诊断,显式无效标记仍走结构校验。已验证的正向前缀若只缺后续焦点,可只补查该句缺失焦点一次;重复或额外焦点分别校验,已有不利结论不会被后来的正向结果覆盖。已被证据/日期/范围防护拒绝的句子可停止后续窗口。所有最终保留的自动句必须覆盖并通过全部焦点,不能把未查部分默认为支持。

Expand All @@ -288,7 +288,7 @@ flowchart LR

`_check_batches` 以 `CHECK_BATCH_SIZE=4`、`CHECK_BATCH_CLAUSES=2` 限制单批行数与自动证明片段数,再把含提示词的 UTF-8 JSON 消息材料限制为 32768 字节;超出时继续拆行或焦点。长句每个窗口仍附完整原句与本句完整绑定来源,只列本次核对片段,片段序号不重排;不能再拆的最小事实请求若仍超限,就保守拒绝该句并记 `material_rejections`,不截去证据。设定/手写/模板不拆自动证明窗口。逐窗口按 supported AND、fabricated OR、违规及问题并集组合,全部窗口通过才可保留;不把分片文字写进 persona。`window_map` 与尝试输出的 `_windows` 保存原句/片段映射。

初检和复查各自共享固定 900 秒阶段预算;手写审查、各事实批、结构重问、焦点补查、截断拆批及程度判定共用所属阶段 `_deadline`,单次请求取 360 秒与剩余阶段时间的较小值。单批超时可在预算内重试一次,拆批和重问不重置截止时间;阶段预算耗尽或未恢复调用错误仍为基础设施失败。GLM 检查的 SSE 流连续 90 秒没有新数据时主动中止并按既有规则重试;心跳或推理增量等新数据会刷新到达时间,不按总思考时长判停滞。已知网关超时摘要归一为尝试级 timeout,报告保留调用级和尝试级超时,含未发出 HTTP 就耗尽阶段预算的情况;原始输出、部分失败输出、配置及诊断随材料保存。
初检和复查各自共享固定 3600 秒阶段预算;手写审查、各事实批、结构重问、焦点补查、截断拆批及程度判定共用所属阶段 `_deadline`,单次请求取 360 秒与剩余阶段时间的较小值。单批超时可在预算内重试一次,拆批和重问不重置截止时间;阶段预算耗尽或未恢复调用错误仍为基础设施失败。GLM 检查的 SSE 流连续 90 秒没有新数据时主动中止并按既有规则重试;心跳或推理增量等新数据会刷新到达时间,不按总思考时长判停滞。已知网关超时摘要归一为尝试级 timeout,报告保留调用级和尝试级超时,含未发出 HTTP 就耗尽阶段预算的情况;原始输出、部分失败输出、配置及诊断随材料保存。

梦境网关仍逐实际调用扣 `persona_max_calls`,不足时本次保持未发布。全部网络调用在数据库事务之外。发布事务重新核对当前版本 ID、记忆修订/生命周期和来源指纹,删除许可所用依据也复核;确认候选同样复核。冲突返回/记录 conflict,不覆盖管理员刚发布的版本。新的候选取代已有待确认候选,管理员编辑/回滚也清理待确认状态;操作记录与版本或任务状态变更在同一事务提交。

Expand Down
Loading