mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 11:26:32 +00:00
429 lines
29 KiB
Python
429 lines
29 KiB
Python
#!/usr/bin/env python3
|
||
"""原始资料JSON存储的行为契约；保存隔离输入与结果，不调用模型或第三方程序。"""
|
||
import base64
|
||
import hashlib
|
||
import importlib.util
|
||
import json
|
||
from pathlib import Path
|
||
import sys
|
||
import tempfile
|
||
import unittest
|
||
|
||
ARTIFACTS = Path(tempfile.mkdtemp(prefix='source-archive-test-'))
|
||
MODULE = Path(__file__).with_name('source_archive.py')
|
||
spec = importlib.util.spec_from_file_location('source_archive_test_subject', MODULE)
|
||
archive = importlib.util.module_from_spec(spec)
|
||
|
||
|
||
def document(raw, mode='100644'):
|
||
try:
|
||
data, encoding = raw.decode('utf-8'), 'utf-8'
|
||
except UnicodeDecodeError:
|
||
data, encoding = base64.b64encode(raw).decode('ascii'), 'base64'
|
||
return {'mode': mode, 'encoding': encoding, 'data': data, 'sha256': hashlib.sha256(raw).hexdigest()}
|
||
|
||
|
||
class SourceArchiveTest(unittest.TestCase):
|
||
def setUp(self):
|
||
self.root = ARTIFACTS / self._testMethodName
|
||
self.path = self.root / '.github/context/gongfa/data.json'
|
||
self.path.parent.mkdir(parents=True)
|
||
self.data = {'format': 'vibe-coding-cn/source-archive@1', 'kind': 'gongfa',
|
||
'source_revision': 'a' * 40, 'documents': {}, 'locations': {}, 'live_sources': {}, 'projections': []}
|
||
archive.clear_cache()
|
||
|
||
def save(self):
|
||
self.path.write_text(json.dumps(self.data, ensure_ascii=False), encoding='utf-8')
|
||
|
||
def test_original_bytes_are_distinct_from_live_implementation(self):
|
||
old = '.github/metadata/gongfa/source-original.txt'
|
||
self.data['documents'][old] = document('原始\r\n资料\n'.encode('utf-8'))
|
||
self.data['locations'][old] = '.github/extensions/current.txt'
|
||
self.data['live_sources'][old] = {'path': '.github/extensions/current.txt',
|
||
'sha256': hashlib.sha256(b'current implementation').hexdigest()}
|
||
live = self.root / '.github/extensions/current.txt'
|
||
live.parent.mkdir(parents=True)
|
||
live.write_bytes(b'current implementation')
|
||
self.save()
|
||
self.assertEqual(archive.read_bytes(self.root / old), '原始\r\n资料\n'.encode('utf-8'))
|
||
self.assertEqual(archive.physical_path(self.root / old), live)
|
||
archive.check_live(self.root)
|
||
live.write_bytes(b'unreviewed change')
|
||
with self.assertRaises(ValueError): archive.check_live(self.root)
|
||
|
||
def test_binary_and_symlink_payloads_roundtrip_without_dereference(self):
|
||
self.data['documents'] = {'.github/metadata/gongfa/history.xlsx': document(b'\x00\xff\x01'),
|
||
'.github/skills/original-ref': document(b'../fixed-source', '120000')}
|
||
self.save()
|
||
self.assertEqual(archive.read_bytes(self.root / '.github/metadata/gongfa/history.xlsx'), b'\x00\xff\x01')
|
||
self.assertTrue(archive.source_is_symlink(self.root / '.github/skills/original-ref'))
|
||
self.assertEqual(archive.source_readlink(self.root / '.github/skills/original-ref'), '../fixed-source')
|
||
target = self.root / 'exported'
|
||
archive.export_documents(self.root, 'gongfa', target)
|
||
self.assertEqual((target / '.github/metadata/gongfa/history.xlsx').read_bytes(), b'\x00\xff\x01')
|
||
self.assertTrue((target / '.github/skills/original-ref').is_symlink())
|
||
|
||
def test_rejects_corruption_unsafe_ids_and_bad_json(self):
|
||
for identity in ['../outside', '.github/../outside', '.github/config/auth.json', '.github/.env']:
|
||
with self.subTest(identity=identity):
|
||
self.data['documents'] = {identity: document(b'not a credential')}
|
||
self.save(); archive.clear_cache()
|
||
with self.assertRaises(ValueError): archive.read_bytes(self.root / '.github/metadata/gongfa/registry.json')
|
||
self.data['documents'] = {'.github/metadata/gongfa/registry.json': document(b'{}')}
|
||
self.data['documents']['.github/metadata/gongfa/registry.json']['sha256'] = '0' * 64
|
||
self.save(); archive.clear_cache()
|
||
with self.assertRaises(ValueError): archive.read_bytes(self.root / '.github/metadata/gongfa/registry.json')
|
||
for raw in ['{"format":"x","format":"y"}', '{"format":NaN}']:
|
||
self.path.write_text(raw); archive.clear_cache()
|
||
with self.assertRaises(ValueError): archive.read_bytes(self.root / '.github/metadata/gongfa/registry.json')
|
||
|
||
def test_rejects_missing_current_location_target(self):
|
||
old = '.github/metadata/gongfa/source-original.txt'
|
||
self.data['documents'][old] = document(b'archived source')
|
||
self.data['locations'][old] = '.github/extensions/retired-entry.sh'
|
||
self.save()
|
||
with self.assertRaisesRegex(ValueError, '当前位置映射目标不存在'):
|
||
archive.read_bytes(self.root / old)
|
||
|
||
def test_rejects_live_path_escape_and_changed_input(self):
|
||
old = '.github/metadata/gongfa/registry.json'
|
||
self.data['documents'][old] = document(b'{}')
|
||
self.data['locations'][old] = '../outside'
|
||
self.save()
|
||
with self.assertRaises(ValueError): archive.read_bytes(self.root / old)
|
||
self.data['locations'] = {}; self.save(); archive.clear_cache()
|
||
self.assertEqual(archive.read_bytes(self.root / old), b'{}')
|
||
self.path.write_text(self.path.read_text() + '\n')
|
||
with self.assertRaises(ValueError): archive.check_unchanged(self.root)
|
||
archive.clear_cache()
|
||
self.path.rename(self.path.with_suffix('.original'))
|
||
self.path.symlink_to(self.path.with_suffix('.original'))
|
||
with self.assertRaises(ValueError): archive.read_bytes(self.root / old)
|
||
|
||
def test_book_view_namespaces_headings_links_and_preserves_code(self):
|
||
import book_views
|
||
text = '# 示例\n\n<a id="目标"></a>\n## 目标\n\n[另一篇](other.md#目标)\n\n[other.md](other.md)\n\n[other[0..4]复核](other.md)\n\n````text\n### 代码不是目录\n```\n````\n'
|
||
text += ('\n[校验](../../scripts/check-gongfa.py)\n'
|
||
'\n[测试](../../extensions/test-source-archive.py)\n'
|
||
'\n[依赖](../../scripts/requirements-gongfa.txt)\n'
|
||
'\n[共享库](../../scripts/lib/README.md)\n'
|
||
'\n[资料读取](../../scripts/lib/source_archive.py)\n'
|
||
'\n[视图模块](../../extensions/lib/book_views.py)\n'
|
||
'\n[分类模块](../../lib/taxonomy.py)\n'
|
||
'\n[资源边界](../../lib/__init__.py)\n'
|
||
'\n[文档目录同步](../../extensions/sync-doc-toc.py)\n'
|
||
'\n[法器生成器](../../extensions/sync-faqi-catalog.py)\n'
|
||
'\n[功法生成器](../../extensions/sync-gongfa-catalog.py)\n'
|
||
'\n[研究抓取](../../extensions/fetch-research-raw.py)\n'
|
||
'\n[Claude旧初始化器入口](../../extensions/init_skill.py)\n'
|
||
'\n[Claude根级旧初始化器入口](../../init_skill.py)\n'
|
||
'\n[Claude官方初始化脚本历史来源](../../tools/external/claude-official-skills/skills/skill-creator/scripts/init_skill.py)\n'
|
||
'\n[Skill Seekers历史源码](../../tools/external/Skill_Seekers-development/README.md)\n')
|
||
retired_links = {
|
||
'../../tools/chat-vault/README.md': 'chat-vault/README.md',
|
||
'../../tools/external/my-nvim/README.md': 'my-nvim/README.md',
|
||
'../../tools/config/.codex/README.md': 'codex-config/.codex/README.md',
|
||
'../../tools/external/MCPlayerTransfer/README.md': 'MCPlayerTransfer/README.md',
|
||
'../../tools/external/XHS-image-to-PDF-conversion/README.md': 'XHS-image-to-PDF-conversion/README.md',
|
||
'../../tools/external/html-tools-main/xhs%20graphic%20production%20-%201.0.html': 'xhs%20graphic%20production%20-%201.0.html',
|
||
'../../tools/external/html-tools-main/xhs%20graphic%20production.html': 'xhs%20graphic%20production.html',
|
||
'../../tools/external/html-tools-main/README.md': 'html-tools-main.md',
|
||
'../../tools/prompts-library/README.md': 'prompts-library/README.md',
|
||
}
|
||
for index, link in enumerate(retired_links):
|
||
text += f'\n[历史{index}]({link})\n'
|
||
retired_cloud_links = {
|
||
'../../skills/auto-tmux/SKILL.md': ('blob', '.github/skills/auto-tmux/SKILL.md'),
|
||
'../../context/assets/': ('tree', '.github/context/assets'),
|
||
'../../context/assets/templates/tool-explanation-template-v1.md': (
|
||
'blob', '.github/context/assets/templates/tool-explanation-template-v1.md'),
|
||
'../../context/external-resources/README.md': (
|
||
'blob', '.github/context/external-resources/README.md'),
|
||
}
|
||
flattened_context_links = {
|
||
'../../context/ai-citation/README.md': 'ai-citation-README.md',
|
||
'../../context/metadata/taxonomy.yml': 'taxonomy.yml',
|
||
'../../context/prompts/README.md': 'prompts-README.md',
|
||
'../../context/getting-started/learning-map.md': 'god.md',
|
||
# 单一代码块不产生章节锚点；历史定位保留在输入，当前入口指向整份提示词。
|
||
'../../learning-map.md#milestone-2': 'god.md',
|
||
'../getting-started/learning-map.md#ai-guidance-rules': 'god.md',
|
||
'../getting-started/learning-map.md#milestone-0': 'god.md',
|
||
'../../god.md#milestone-2': 'god.md',
|
||
'../../context/tool-explanation-template-v1.md': 'tool-explanation-template-v1.md',
|
||
}
|
||
for index, link in enumerate(retired_cloud_links):
|
||
text += f'\n[云端退役{index}]({link})\n'
|
||
for index, link in enumerate(flattened_context_links):
|
||
text += f'\n[平铺{index}]({link})\n'
|
||
self.data['documents'] = {
|
||
'.github/docs/gongfa/example.md': document(text.encode()),
|
||
'.github/docs/gongfa/other.md': document('# 另一篇\n\n## 目标\n'.encode())}
|
||
self.save()
|
||
rendered = book_views.render_sources(self.root, 'gongfa')
|
||
index = self.root / '.github/taxonomy.yml'
|
||
index.parent.mkdir(parents=True, exist_ok=True)
|
||
index.write_text('documents:\n gongfa:\n - path: .github/context/gongfa/README.md#doc-other\n - path: .github/context/gongfa/README.md#doc-example\n')
|
||
self.assertEqual(rendered, book_views.render_sources(self.root, 'gongfa'), '阅读内容与顺序只由本集合JSON决定')
|
||
self.assertIn('id="doc-example-目标"', rendered)
|
||
self.assertIn('#doc-other-目标', rendered)
|
||
self.assertIn('[other.md](#doc-other)', rendered)
|
||
self.assertIn('[other[0..4]复核](#doc-other)', rendered)
|
||
self.assertIn('[校验](../../check-gongfa.py)', rendered)
|
||
self.assertIn('[测试](../../test-source-archive.py)', rendered)
|
||
self.assertIn('[依赖](../../requirements-gongfa.txt)', rendered)
|
||
self.assertIn('[共享库](../../AGENTS.md#维护脚本与共享库)', rendered)
|
||
self.assertIn('[资料读取](../../source_archive.py)', rendered)
|
||
self.assertIn('[视图模块](../../book_views.py)', rendered)
|
||
self.assertIn('[分类模块](../../taxonomy.py)', rendered)
|
||
self.assertIn('[资源边界](../../source_boundaries.py)', rendered)
|
||
for label, target in (
|
||
('文档目录同步', 'sync-doc-toc.py'),
|
||
('法器生成器', 'sync-faqi-catalog.py'),
|
||
('功法生成器', 'sync-gongfa-catalog.py'),
|
||
('研究抓取', 'fetch-research-raw.py'),
|
||
):
|
||
self.assertIn(f'[{label}](../../{target})', rendered)
|
||
claude_initializer = (
|
||
'https://github.com/anthropics/skills/blob/'
|
||
'1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563/'
|
||
'skills/skill-creator/scripts/init_skill.py')
|
||
self.assertIn(f'[Claude旧初始化器入口]({claude_initializer})', rendered)
|
||
self.assertIn(f'[Claude根级旧初始化器入口]({claude_initializer})', rendered)
|
||
self.assertIn(f'[Claude官方初始化脚本历史来源]({claude_initializer})', rendered)
|
||
self.assertIn(
|
||
'[Skill Seekers历史源码](https://github.com/yusufkaraaslan/Skill_Seekers/blob/'
|
||
'26638b248279a3b001b651475e0f28975f5ff069/README.md)', rendered)
|
||
for index, target in enumerate(retired_links.values()):
|
||
revision = ('b0e3454bb865b95bdc70127a431214c384542dee'
|
||
if target == 'prompts-library/README.md'
|
||
else '44e6fe37a6a871e9327d9f15b23cfef0b7dcbb58')
|
||
expected = (f'https://github.com/tradecatlabs/vibe-coding-cn/blob/{revision}'
|
||
'/.github/extensions/' + target)
|
||
self.assertIn(f'[历史{index}]({expected})', rendered)
|
||
for index, (route, path) in enumerate(retired_cloud_links.values()):
|
||
expected = (f'https://github.com/tradecatlabs/vibe-coding-cn/{route}/'
|
||
f'71bf460cfa894ad45163a9591d2043422974a681/{path}')
|
||
self.assertIn(f'[云端退役{index}]({expected})', rendered)
|
||
for index, target in enumerate(flattened_context_links.values()):
|
||
self.assertIn(f'[平铺{index}](../../{target})', rendered)
|
||
self.assertIn('### 代码不是目录', rendered)
|
||
self.assertNotIn('id="doc-example-代码不是目录"', rendered)
|
||
self.assertEqual(rendered.count('id="doc-example-目标"'), 1)
|
||
from markdown_it import MarkdownIt
|
||
self.assertIn('<h2>示例</h2>', MarkdownIt('commonmark').render(rendered))
|
||
toc = '\n'.join(book_views.source_toc(self.root, 'gongfa'))
|
||
self.assertIn('](#doc-example-目标)', toc)
|
||
self.assertIn('](#doc-other-目标)', toc)
|
||
self.assertNotIn('代码不是目录', toc)
|
||
|
||
def test_god_prompt_renders_markdown_with_only_example_code_blocks(self):
|
||
from markdown_it import MarkdownIt
|
||
import book_views
|
||
prompt = Path(__file__).with_name('god.md').read_text(encoding='utf-8')
|
||
markdown = MarkdownIt('commonmark')
|
||
tokens = markdown.parse(prompt)
|
||
self.assertEqual((tokens[0].type, tokens[0].tag), ('heading_open', 'h1'))
|
||
self.assertTrue(prompt.startswith('# 道成了肉身\n'))
|
||
self.assertNotRegex(prompt, r'</?(?:details|summary|a)\b')
|
||
self.assertNotRegex(prompt, r'\]\(#[^)]+\)')
|
||
self.assertNotIn('本代码块全文', prompt)
|
||
self.assertIn("printf 'local shell OK\\n'", prompt)
|
||
first_reply = next(
|
||
(line[2:] for line in prompt.splitlines() if line.startswith('> 我会先确认')),
|
||
'',
|
||
)
|
||
self.assertEqual(first_reply.count('？'), 1)
|
||
self.assertNotIn('command -v pi', prompt)
|
||
self.assertNotIn('Get-Command pi -ErrorAction SilentlyContinue', prompt)
|
||
for token in ('`', '://', 'pi --version', 'curl', 'npm', 'irm'):
|
||
self.assertNotIn(token, first_reply)
|
||
for contract in (
|
||
'## 字多不看',
|
||
'**本文目的：**帮助初学者借助网页版 Chat AI，按需检查或安装并验证 Pi CLI，再完成 OpenAI GPT 与本机 Bash 的配置和使用验证；实际操作由用户在本机完成。',
|
||
'把本文全文交给网页版 Chat AI：系统不明时首轮只问系统；已知的系统/终端信息不重复问，之后每轮只引导一个本机动作并等你回报。',
|
||
'有版本号就跳过 Pi 安装和安装网络检查',
|
||
'状态或渠道不明就暂停，不盲目重装。',
|
||
'目标不可达且你选择代理时才处理代理',
|
||
'版本号只证明 CLI 可用；OpenAI GPT 与本机 Bash 的配置及使用验证随后另行完成。',
|
||
'用户首次粘贴后，先简短说明路线，并复用用户已提供的信息，不重复追问。',
|
||
'若系统不明，只问系统；此时首轮不发命令、安装脚本、代理配置、链接或网络测试。',
|
||
'若系统已明但实际终端未确认或未就绪，只引导打开或确认对应终端并等待',
|
||
'若用户尚无 `pi --version` 检查结果，且系统和实际终端均已明确、终端已打开，可直接安排 M0 的只读检查并等待结果；已回报版本号则复用证据并跳过。',
|
||
'若用户已在计划使用 Pi 的终端回报 `pi --version` 结果，直接复用：版本号记作 M3，跳过安装专用 M1/M2；错误结果按下文对应分支处理（只有下文条件满足时才重试）。只有该终端尚无检查结果时，确认环境后，让用户单独运行：',
|
||
'我会先确认你准备使用的系统和终端，再检查 Pi 是否已可用；已安装就不重装。你现在使用 Windows、macOS、Linux 还是 Android/Termux？如果不知道终端怎么打开，告诉我即可。',
|
||
'Android/Termux，不套用下方 Linux/macOS/Windows 命令',
|
||
'https://pi.dev/docs/latest/termux',
|
||
'GitHub 或 F-Droid',
|
||
'已弃用的 Google Play 版本',
|
||
'Termux 包升级、依赖安装或共享存储授权前',
|
||
'共享存储仅在确需访问 Android 文件时配置',
|
||
'若 Android 用户尚未安装 Termux，说明其官方来源与安装影响，并等待用户明确决定',
|
||
'若 Termux 来源不明，先按上文官方路线核对并等待用户决定。',
|
||
'这一步只准备终端，不代表 Pi 已安装',
|
||
'Android/Termux 路线按 M0 链接的官方 Termux 指南处理',
|
||
'Termux 包管理器安装 Node.js 和 Git',
|
||
'若用户不知道“终端”或如何打开',
|
||
'安装/修复阶段仅核对当前路线实际需要的官方分发与依赖源',
|
||
'只有 M0 确认目标终端没有可用 Pi 且用户明确决定安装，或用户明确决定修复/重装时，才进入 M1',
|
||
'不要逐项探测未实际触发的安装源',
|
||
'OpenAI 模型的网络检查仅在 M4.1 阶段按所选登录路线和实际故障执行',
|
||
'若 `pi --version` 已成功，就跳过安装专用 M1/M2',
|
||
'若曾安装或不确定，先问安装渠道（不记得可直接说明），按能确认的渠道当前官方资料核对现有安装、目标终端和 PATH',
|
||
'若渠道或安装状态仍不明，先暂停，不直接重跑安装器',
|
||
'若确认没有可复用的既有安装，说明安装目标与影响后仍须等用户明确决定安装',
|
||
'仍找不到时回到 M0 核对既有安装渠道与目标终端，不再追加重复的 PATH 查询或盲目重装',
|
||
'只有用户刚安装或更新 Pi、或刚修改 PATH 后，才先重开同一终端并重试一次',
|
||
'用户只需回报版本号或“命令未找到”；启动失败时仅给简短脱敏错误摘要；不贴完整路径、完整 PATH、截图或完整日志',
|
||
'默认优先使用对应系统的官方安装器',
|
||
'不展示其他系统路线的命令',
|
||
'Android/Termux、macOS/Linux/WSL 按真实错误核对 Bash',
|
||
'请将本文全文复制给可用的网页版 Chat AI',
|
||
'可使用 GitHub 文件页右上角的全文复制按钮',
|
||
'用户将本文全文复制给网页版 Chat AI。',
|
||
'逐轮交互',
|
||
'完成本文范围内的 Pi CLI 检查/安装、必要网络准备、OpenAI GPT 授权与模型选择、工具配置及一次安全的实际使用验证',
|
||
'不得在 `pi --version`、单次模型回答或单个命令测试后提前宣告完成',
|
||
'本文所说“完成”仅指 Pi CLI + OpenAI GPT + 本机 Bash 通路',
|
||
'网页 AI 不能读取或操作用户终端',
|
||
'每轮只引导一个检查或动作',
|
||
'不索取密码、API Key、Token、cookie、私钥、订阅链接、`auth.json`',
|
||
'Pi 以启动账户权限运行，并非安全沙箱',
|
||
'须先说明具体目标与影响，等待用户明确决定',
|
||
'Node.js 22.19.0 或更高版本',
|
||
'irm https://pi.dev/install.ps1 | iex',
|
||
'安装失败时只请用户提供脱敏错误摘要，不要要求完整日志、凭据或私人路径',
|
||
'本文范围内的 Pi CLI、OpenAI GPT 与本机 Bash 配置及使用已完成',
|
||
'不是 Pi 官方模式',
|
||
'本指南的完成范围仅是 Pi CLI、OpenAI GPT 与本机 Bash 通路',
|
||
'任务不包括创建项目、修改项目文件',
|
||
'网络环境是 Pi 安装和 OpenAI 云端 GPT 的前置条件',
|
||
'FlClash',
|
||
'https://github.com/chen08209/FlClash/releases/latest',
|
||
'https://xn--9kqz23b19z.com/#/register?code=35BcnKzl',
|
||
'服务商注册链接不是个人订阅链接',
|
||
'订阅链接属于凭据',
|
||
'默认目标配置：启用 TUN、系统代理和全局模式',
|
||
'启用前须说明流量路由范围、隐私影响和恢复方式',
|
||
'用户拒绝或当前界面/系统不支持时',
|
||
'也不得报告网络路线已完成',
|
||
'### M4.0：进入 Pi 交互界面',
|
||
'先说明 Pi 可能加载目录指令、配置与扩展，并保存会话，等待用户决定后再启动。',
|
||
'等用户看到 Pi 的对话界面和输入框后再进入 M4.1',
|
||
'若已在该目录的 Pi 会话中，直接复用，不重复启动。',
|
||
'`/login`、`/model` 和问题均在 Pi 输入框中输入，不是在系统终端或网页版 Chat AI 中运行。',
|
||
'沿用 M4.1 已验证模型的 Pi 会话，不为工具验证重新启动',
|
||
'不自动批准目录信任提示',
|
||
'进入本节不等于必须重新登录。',
|
||
'目标环境、用户选定路线和模型均未变化且没有新失败信号',
|
||
'直接进入 M4.2，不重复 `/login`、模型选择或同类提问',
|
||
'先在 `/model` 核对所选路线实际可用的 GPT，再做本节末尾的简单提问',
|
||
'列表有模型或界面显示已授权，都不等于真实调用成功',
|
||
'网络超时、限额或模型不可用先按对应错误排查，不直接当成凭据失效',
|
||
'不要为常规验证先 `/logout`、删除 `auth.json` 或覆盖既有凭据',
|
||
'以下登录步骤仅在确需授权时使用',
|
||
'已完成的动作不重复',
|
||
'`auth.json`、OAuth 授权码、设备码、回调 URL',
|
||
'**OAuth 回报边界：**',
|
||
'只有 Pi 明确提示需要粘贴最终授权码或回调 URL 时，才贴回本机 Pi',
|
||
'不要发给网页版 AI',
|
||
'向网页 AI 只回报“授权成功/未完成”或简短脱敏错误',
|
||
'不提供授权码、设备码、回调 URL 或截图',
|
||
'Pi 的 `/login` 可使用两条不同的登录路线',
|
||
'`OpenAI (ChatGPT subscription)`',
|
||
'`openai-codex`',
|
||
'ChatGPT 订阅 OAuth',
|
||
'OpenAI API Key',
|
||
'`api.openai.com`',
|
||
'https://api.openai.com/v1/models',
|
||
'curl --connect-timeout 5 --max-time 15 -I https://github.com',
|
||
'curl.exe --connect-timeout 5 --max-time 15 -I https://github.com',
|
||
'curl --connect-timeout 5 --max-time 15 -i https://api.openai.com/v1/models',
|
||
'curl.exe --connect-timeout 5 --max-time 15 -i https://api.openai.com/v1/models',
|
||
'超时只说明本次检查未在限时内完成，不证明目标服务不可达',
|
||
'API 端点检查只用于 API Key 路线',
|
||
'订阅 OAuth 路线不使用 `api.openai.com/v1/models` 探测',
|
||
'只说明 API 端点有响应，不证明账户认证或 GPT 模型可用',
|
||
'不要在测试命令里加入 API Key',
|
||
'ChatGPT 网页订阅不等于 OpenAI API 额度',
|
||
'所选 OpenAI GPT 模型按上述一种路线完成必要授权/配置',
|
||
'完成标准第 2 项仍记为“OpenAI GPT 未验证”',
|
||
'不得把本地模型回答算作本文范围内的 OpenAI GPT 配置完成',
|
||
'若用户只完成本地模型路线，按前述规则单独记录，不静默切回 OpenAI GPT',
|
||
):
|
||
with self.subTest(prompt_contract=contract):
|
||
self.assertIn(contract, prompt)
|
||
self.assertNotIn('确认环境后，让用户在计划使用 Pi 的终端单独运行：', prompt)
|
||
self.assertNotIn('若尚未安装，说明其官方来源与安装影响', prompt)
|
||
self.assertNotIn('先确认用户有权使用 OpenAI API', prompt)
|
||
self.assertNotIn('完成 OpenAI GPT 主路线（ChatGPT 订阅 OAuth 或 OpenAI API Key）的授权后，让用户用 `/model` 选择该路线实际可用的 GPT 模型，并提出一个无需修改文件的简单问题。', prompt)
|
||
self.assertNotIn('curl -I https://github.com', prompt)
|
||
self.assertNotIn('curl.exe -I https://github.com', prompt)
|
||
self.assertNotIn('curl -i https://api.openai.com/v1/models', prompt)
|
||
self.assertNotIn('curl.exe -i https://api.openai.com/v1/models', prompt)
|
||
self.assertLess(prompt.index('## 字多不看'), prompt.index('## 给网页版 Chat AI 的任务'))
|
||
self.assertLess(prompt.index('## M1：网络环境'), prompt.index('## M2：预备行各样的善事'))
|
||
self.assertLess(prompt.find('### M4.0：进入 Pi 交互界面'), prompt.find('\npi\n'))
|
||
self.assertLess(prompt.index('\npi\n'), prompt.index('### M4.1：验证对话能力'))
|
||
self.assertNotIn('模型能回答后，建议用户在空目录或非敏感目录启动 Pi。', prompt)
|
||
self.assertEqual(
|
||
[(token.info, token.content) for token in tokens if token.type == 'fence'],
|
||
[
|
||
('text', 'pi --version\n'),
|
||
('bash', 'curl -fsSL https://pi.dev/install.sh | sh\n'),
|
||
('powershell', 'irm https://pi.dev/install.ps1 | iex\n'),
|
||
('text', 'pi\n'),
|
||
('text', "请只通过当前可用的本机 Bash 工具运行这一条只读命令：printf 'local shell OK\\n'\n"
|
||
'不要运行其他命令、读取文件、创建或修改文件、访问网络。只返回结果；若工具不可用，请直接说明。\n'),
|
||
],
|
||
)
|
||
html = markdown.render(prompt)
|
||
for rendered in ('<h1>道成了肉身</h1>', '<h2>M0：检查现状</h2>',
|
||
'<h2>完整配置与使用的完成标准</h2>',
|
||
'href="https://pi.dev/docs/latest/termux"',
|
||
'href="https://www.biblegateway.com/passage/?search=John%201%3A14&version=CUVS"'):
|
||
with self.subTest(rendered_markdown=rendered):
|
||
self.assertIn(rendered, html)
|
||
self.assertEqual(html.count('<pre>'), 5)
|
||
self.assertTrue({'道成了肉身', 'm0检查现状', '官方资料'}.issubset(
|
||
book_views._links.markdown_anchors(Path(__file__).with_name('god.md'))))
|
||
self.assertEqual(book_views.relocated('.github/god.md', 'milestone-2'), ('.github/god.md', ''))
|
||
self.assertEqual(book_views.relocated('.github/first-project.md', 'example'),
|
||
('.github/first-project.md', 'example'))
|
||
|
||
def test_v1_explanations_remain_separate_from_frozen_source_documents(self):
|
||
explanation = {'template_sha256': 'a' * 64, 'items': []}
|
||
self.data['explanations_v1'] = explanation
|
||
self.save()
|
||
archive.clear_cache()
|
||
bundle = archive.bundles(self.root)['gongfa']
|
||
self.assertEqual(explanation, bundle['data']['explanations_v1'])
|
||
self.assertNotIn('explanations_v1', bundle['bytes'])
|
||
|
||
def test_retired_v0_explanation_payload_is_rejected(self):
|
||
self.data['explanations_v0'] = {'template_sha256': 'a' * 64, 'items': []}
|
||
self.save()
|
||
archive.clear_cache()
|
||
with self.assertRaises(ValueError):
|
||
archive.bundles(self.root)
|
||
|
||
def test_independent_raw_input_remains_readable(self):
|
||
raw_root = self.root / 'standalone-input'
|
||
path = raw_root / '.github/metadata/gongfa/registry.json'
|
||
path.parent.mkdir(parents=True)
|
||
path.write_bytes(b'{"independent":"input"}\n')
|
||
self.assertEqual(archive.read_bytes(path), b'{"independent":"input"}\n')
|
||
|
||
|
||
if __name__ == '__main__':
|
||
try:
|
||
spec.loader.exec_module(archive)
|
||
result = unittest.TextTestRunner(verbosity=2).run(unittest.defaultTestLoader.loadTestsFromTestCase(SourceArchiveTest))
|
||
report = {'success': result.wasSuccessful(), 'tests': result.testsRun, 'failures': len(result.failures), 'errors': len(result.errors)}
|
||
except (OSError, ImportError) as error:
|
||
report = {'success': False, 'error': type(error).__name__}
|
||
report['test_sha256'] = hashlib.sha256(Path(__file__).read_bytes()).hexdigest()
|
||
(ARTIFACTS / 'result.json').write_text(json.dumps(report, ensure_ascii=False, indent=2) + '\n')
|
||
print(json.dumps({'artifacts': str(ARTIFACTS), **report}, ensure_ascii=False))
|
||
raise SystemExit(0 if report['success'] else 1)
|