@yottameta/yotta-resume 0.0.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,5 @@
1
+ # References
2
+
3
+ 本目录存放按需读取的细节文档:
4
+
5
+ - [usage.md](usage.md):输入格式、CLI 退出码、输出说明和 PDF 浏览器要求。
@@ -0,0 +1,34 @@
1
+ # 数据契约
2
+
3
+ 元简从 `0.1.2` 起随包提供 5 个机器可读契约及其 JSON Schema:
4
+
5
+ - `data/security-role-map.json`:6 个安全岗位族与 4 个职级。
6
+ - `data/evidence-ledger.json`:简历证据账本,记录责任、动作、规模、结果和边界。
7
+ - `data/source-registry.json`:来源层级、日期、刷新周期、失效周期和许可复核状态。
8
+ - `data/question-bank.json`:题库清单;`0.1.2` 为空题库,题目由后续批次按契约写入。
9
+ - `data/dual-role-contract.json`:求职者和 HR 的数据访问、导出及受保护属性边界。
10
+
11
+ ## 校验
12
+
13
+ 离线校验随包契约:
14
+
15
+ ```bash
16
+ python scripts/yotta_resume.py contracts --format json
17
+ ```
18
+
19
+ 直接运行独立校验器:
20
+
21
+ ```bash
22
+ python scripts/contract_validate.py --root data --format json
23
+ ```
24
+
25
+ 成功返回退出码 `0`;主 CLI 的契约校验失败返回 `6`。独立校验器失败返回非零退出码。
26
+
27
+ ## 安全边界
28
+
29
+ - 默认策略为 `deny`。
30
+ - HR 默认不能读取候选人私有证据账本、原始简历或分析报告。
31
+ - 跨角色导出必须提供字段清单并确认,默认只导出投递版简历。
32
+ - 年龄、性别、婚育、民族、宗教、籍贯、残障和照片等受保护属性不得进入评分字段。
33
+ - 来源许可未确认时只允许事实提炼、链接引用和自主改写,不复制长段原文。
34
+ - 社区面经只可作练习提示,不能作为标准答案。
@@ -0,0 +1,82 @@
1
+ # 使用细节
2
+
3
+ ## 输入格式
4
+
5
+ 推荐使用 UTF-8 Markdown 简历:
6
+
7
+ ```markdown
8
+ # 姓名
9
+ 手机号 | 邮箱
10
+
11
+ ## 个人简介
12
+ 2-3 句说明方向、经验和代表性成果。
13
+
14
+ ## 工作经历
15
+ ### 公司 | 岗位 | 开始时间 - 结束时间
16
+ - 我的动作 + 工具/流程 + 规模 + 结果。
17
+
18
+ ## 技能
19
+ 技能 A, 技能 B
20
+
21
+ ## 教育背景
22
+ 学校 | 专业 | 学历 | 开始时间 - 结束时间
23
+ ```
24
+
25
+ DOCX 输入读取 WordprocessingML 正文;复杂文本框、页眉页脚和图片内文字可能丢失,
26
+ 报告会给出解析提示。需要完整保留结构时建议使用可复制的 Markdown。
27
+
28
+ PDF 输入支持带文字层的本地 PDF,优先使用 PyMuPDF:
29
+
30
+ ```bash
31
+ pip install pymupdf
32
+ python scripts/yotta_resume.py audit --resume resume.pdf --format json
33
+ ```
34
+
35
+ 报告会记录页数、图片数、文本字符数、SHA-256、解析后端和提示。加密、损坏或
36
+ 扫描件不会生成伪完整报告。当前不执行 OCR;图片内信息会列入未知项。
37
+
38
+ ## CLI
39
+
40
+ ```bash
41
+ python scripts/yotta_resume.py --version
42
+ python scripts/yotta_resume.py audit --resume resume.md --format markdown
43
+ python scripts/yotta_resume.py audit --resume resume.md --jd jd.txt --format json
44
+ python scripts/yotta_resume.py export --input resume.md --docx resume.docx
45
+ python scripts/yotta_resume.py export --input resume.md --pdf resume.pdf
46
+ python scripts/yotta_resume.py contracts --format json
47
+ ```
48
+
49
+ 退出码:
50
+
51
+ - `0`:成功。
52
+ - `2`:命令参数不完整。
53
+ - `3`:输入文件不存在或无法读取。
54
+ - `4`:没有可用浏览器,或浏览器 PDF 渲染失败。
55
+ - `5`:PDF / DOCX 解析失败、扫描件不可提取、缺少 PDF 解析依赖或输入编码不支持。
56
+ - `6`:数据契约校验失败。
57
+
58
+ ## 输出说明
59
+
60
+ - `audit` 的 JSON 使用 `schema_version: "1.1"`。
61
+ - `sections` 返回规范化章节名,如 `experience`、`projects`、`skills`、`education`。
62
+ - `questions` 用于向求职者追问缺失事实;`suggestions` 只提供改写方向,不提供虚构数字。
63
+ - `jd_match` 包含 `matched`、`missing`、`coverage` 和 `status`;未提供 JD 时
64
+ `coverage` 为 `null`。
65
+ - `readiness.score` 是“结构准备度(规则分)”,不代表招聘竞争力或招聘结果。
66
+ - `issues` 中的每项 finding 包含稳定 ID、严重度、来源类型和待确认标记。
67
+ - `source_manifest`、`parse_warnings` 和 `unknowns` 用于说明输入质量与分析边界。
68
+ - 只能原样引用结构分;不得改写为其他数值、主观数字区间或“招聘方分数”。
69
+
70
+ ## 数据契约
71
+
72
+ `contracts` 离线校验 5 个实际契约与 5 个 JSON Schema,包括岗位族、证据账本、
73
+ 来源 registry、题库和双角色权限。详细字段见
74
+ [data-contracts.md](data-contracts.md)。
75
+
76
+ ## PDF 要求
77
+
78
+ PDF 导出使用本机 Chromium、Chrome 或 Edge 的 headless 打印能力。没有浏览器时不会输出伪 PDF,请先安装任一受支持浏览器,或继续使用 DOCX/HTML。
79
+
80
+ ## 数据边界
81
+
82
+ Python 实现不发起网络请求,不执行简历文本拼接出的 shell 命令。分析报告会遮蔽手机号和邮箱;正式导出的简历仍按原文保留联系方式,请只在需要投递时分享。