manmankan 0.0.1__tar.gz

manmankan-0.0.1/.githooks/pre-commit

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+#
+# manmankan pre-commit hook
+#
+# 启用方式 (一次性):
+#   git config core.hooksPath .githooks
+#
+# 跳过 (不推荐 · 仅紧急情况):
+#   git commit --no-verify
+#
+# 详见 CLAUDE.md「公开输出语言规范」+ CONTRIBUTING.md
+
+set -uo pipefail
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+cd "$REPO_ROOT"
+
+echo ""
+echo "═══ pre-commit 自检 ═══"
+echo ""
+
+# 1. 隐私泄漏自检
+echo "[1/2] 公开档案隐私自检 ..."
+if ! bash scripts/check-privacy-leaks.sh; then
+  echo ""
+  echo "❌ pre-commit 拦截 · 修复后再 commit"
+  echo "💡 临时跳过 (不推荐): git commit --no-verify"
+  exit 1
+fi
+
+echo ""
+echo "[2/2] ruff lint ..."
+if command -v uv >/dev/null 2>&1; then
+  if ! uv run ruff check kan/ tests/ 2>&1; then
+    echo ""
+    echo "❌ ruff lint 失败 · 修复后再 commit"
+    exit 1
+  fi
+elif command -v ruff >/dev/null 2>&1; then
+  if ! ruff check kan/ tests/ 2>&1; then
+    echo ""
+    echo "❌ ruff lint 失败 · 修复后再 commit"
+    exit 1
+  fi
+else
+  echo "⚠️ uv / ruff 未安装 · 跳过 lint (建议装上)"
+fi
+
+echo ""
+echo "✅ pre-commit 全部通过"
+echo ""

manmankan-0.0.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: 🐛 Bug 上报
+about: 报告慢慢看的 bug · 中文优先
+title: "[Bug] "
+labels: bug
+assignees: ""
+---
+
+## 现象
+
+<!-- 你看到了什么？最好贴 terminal 完整输出（敏感信息脱敏）-->
+
+## 复现步骤
+
+1.
+2.
+3.
+
+## 期望行为
+
+<!-- 你认为应该是什么样？ -->
+
+## 环境
+
+- 操作系统（macOS / Linux / Windows）：
+- Python 版本（`python --version`）：
+- manmankan 版本（`kan --version`）：
+- 终端宽度（列数 · 影响表格渲染）：
+- 终端类型（iTerm / Terminal.app / Windows Terminal / VS Code 等）：
+
+## 数据相关
+
+- 你跑的命令：
+- 自选股池大小（`kan list | wc -l`）：约 N 只
+- 数据是今天的吗（看 `kan scan` 标题"X 更新"）？
+
+## 其他线索
+
+<!-- 截图 / 异常 traceback / 你的推测 -->

manmankan-0.0.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,30 @@
+---
+name: ✨ 功能建议
+about: 建议新功能或改进
+title: "[Feature] "
+labels: enhancement
+assignees: ""
+---
+
+## 你想解决什么问题？
+
+<!-- 不要直接说"加 X 功能" · 先描述使用场景和痛点 -->
+
+## 你的建议
+
+<!-- 想要什么样的解决方案？怎么个调用方式？ -->
+
+## 替代方案
+
+<!-- 有其他可能的实现方式吗？为什么这个更好？ -->
+
+## 合规自检（金融工具必须）
+
+慢慢看的设计哲学：**位置感入口 ≠ 决策出口**。新功能必须满足：
+
+- [ ] 不涉及「建议买卖」「推荐持仓」「目标价」等决策性输出
+- [ ] 不涉及预测涨跌 / 选股推荐 / AI 选股
+- [ ] 仅展示客观数据 + 让用户自行判断
+- [ ] 措辞严守「位置 / 区间 / 触及 / 共振」等中性词
+
+如果建议本身违反上述任一条 · 请理解我们不会接受（参见 README §法律免责）。

manmankan-0.0.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,34 @@
+## 概述
+
+<!-- 1-2 句话说清楚改了什么 / 为什么 -->
+
+## 类型
+
+- [ ] 🐛 bug 修复
+- [ ] ✨ 新功能
+- [ ] ♻️ 重构（不改行为）
+- [ ] 📝 文档
+- [ ] ✅ 测试
+- [ ] ⚠️ Breaking change（必填 Migration guide）
+
+## 验证
+
+- [ ] `uv run pytest` 全绿
+- [ ] `uv run ruff check kan/ tests/` 无新增 F/E/B/N 类真技术债
+- [ ] **实际跑过 CLI** 验证（不仅看代码 · 见 CONTRIBUTING.md）
+
+## 合规自检（金融工具必须）
+
+- [ ] 不涉及买卖建议 / 选股推荐
+- [ ] 输出严守「位置 / 区间 / 触及 / 共振」中性措辞
+- [ ] 风险提示完整保留（不可关闭）
+
+## 相关 issue
+
+Closes #
+
+## Migration（如 Breaking change）
+
+| v0.x 写法 | v0.y 写法 |
+|---|---|
+| | |

manmankan-0.0.1/.github/dependabot.yml

@@ -0,0 +1,27 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore(deps)"
+      include: "scope"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    open-pull-requests-limit: 3
+    labels:
+      - "dependencies"
+      - "ci"
+    commit-message:
+      prefix: "chore(ci)"
+      include: "scope"

manmankan-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,24 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  build-and-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # trusted publisher OIDC
+      contents: read
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4 (pinned 2025-11-13)
+      - uses: astral-sh/setup-uv@38f3f104447c67c051c4a08e39b64a148898af3a  # v4 (pinned 2024-11-30)
+        with:
+          python-version: '3.12'
+      - name: Build
+        run: uv build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b  # release/v1 (pinned 2026-02-18)
+        with:
+          packages-dir: dist/

manmankan-0.0.1/.github/workflows/test.yml

@@ -0,0 +1,34 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - main
+      - 'feat/**'
+      - 'fix/**'
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ['3.11', '3.12']
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4 (pinned 2025-11-13)
+      - uses: astral-sh/setup-uv@38f3f104447c67c051c4a08e39b64a148898af3a  # v4 (pinned 2024-11-30)
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Install dependencies
+        run: uv sync --all-extras
+      - name: Run tests
+        run: uv run pytest -q
+      - name: Lint
+        run: uv run ruff check kan/

manmankan-0.0.1/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual env
+.venv/
+venv/
+.uv/
+
+# Environment variables
+.env
+.env.local
+
+# Database / Data
+*.db
+*.sqlite
+data/
+*.parquet
+
+# Testing
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+.coverage.*
+.tox/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Local / private (any user-private files we don't want to track)
+*.local
+*.private
+*.secret
+*.bak

manmankan-0.0.1/AUTHORS.md

@@ -0,0 +1,12 @@
+# Authors · 作者
+
+## Maintainer · 维护者
+
+- **piklen** — <https://github.com/piklen>
+
+## Contributors · 贡献者
+
+Contributions are welcome. See `git log` for a complete list of contributors,
+and [`CONTRIBUTING.md`](CONTRIBUTING.md) for how to get involved.
+
+欢迎贡献。完整贡献者列表请见 `git log`，参与方式请见 [`CONTRIBUTING.md`](CONTRIBUTING.md)。

manmankan-0.0.1/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.0.1] - 2026-05-10
+
+### Added · 首次公开发布
+
+**位置扫描** `kan scan`
+- 多周期位置扫描（3/5/7/10/15/30/60/90/120/180 日）
+- `--high` 高点模式 / `-S --signal` 仅显示有共振信号 / `--diff` 增量模式
+- `--exclude-st` 排除 ST/*ST
+- 多周期共振信号自动高亮（×N 标记）
+- 终端宽度自适应（130+ 列 10 周期 · 100 列 6 周期 · 80 列 4 周期 · 共振列始终可见）
+
+**筛选模式**
+- `kan low N [N2 ...]` / `kan high N [N2 ...]` 触及阈值筛选（≤5% 低点 / ≥95% 高点 · 支持多周期）
+
+**连续涨跌看板** `kan trend`
+- `--latest N` 近 N 天走势
+- `--down N` / `--up N` 筛选连续涨/跌（N 范围 2-30）
+- `--candle` 阳线阴线口径
+- 涨跌停自动标记
+- 跨板块差异化涨跌停限制（按 2026-07-06 政策日期切换）
+
+**单只详情**
+- `kan info <代码>` 全周期位置 + 涨跌 + 共振统计
+
+**自选股管理**
+- `kan add` 支持代码 + 名称搜索 + 批量
+- `kan remove` 支持名称 + 批量
+- `kan list` / `kan import` / `kan clear`
+- `kan uninstall` 一次清数据 + 输出包卸载命令（自动检测 uv tool / pipx / pip）
+
+**数据层**
+- 多源 K 线 fallback：`baostock → 新浪 → 东财 → 腾讯`
+- 本地 Parquet 缓存（`~/.local/share/kan/data/` · XDG 规范）
+- 7 天 A 股代码-名称缓存 + 自动过期更新
+- `kan fetch [--force]` 手动刷新
+
+**Shell 集成**
+- `kan completion install [shell]` 一键启用 zsh / bash / fish / powershell 命令前缀补全
+- 任意命令首次启动自动启用补全（`KAN_NO_COMPLETION_AUTOINSTALL=1` 可关闭 · 非 TTY 跳过）
+
+**合规与隐私**
+- 强制风险提示 + 关键词黑名单（无买卖建议 / 无目标价 / 无评级）
+- 所有数据本地存储 · 不上传任何用户数据
+- `CONTRIBUTING.md` + `SECURITY.md` + 公开输出语言纪律
+
+[Unreleased]: https://github.com/piklen/manmankan/compare/v0.0.1...HEAD
+[0.0.1]: https://github.com/piklen/manmankan/releases/tag/v0.0.1

manmankan-0.0.1/CLAUDE.md

@@ -0,0 +1,203 @@
+# CLAUDE.md · manmankan AI 协作纪律
+
+> 本文件是给 AI 编程助手（Claude Code / GitHub Copilot / Codex / Cursor 等）的硬约束。
+> 人类 contributor 也适用。
+> manmankan 是公开的 MIT 开源项目，已发布到 PyPI 与 GitHub。
+> AI 协作产出直接进入永久公开档案，因此对 AI 输出有比私有项目**严苛得多**的语言纪律。
+
+---
+
+## 1. 核心原则
+
+**写之前先想 — 这条信息在 5 年后被 GitHub 上一个素未谋面的 contributor 看到，会不会显得奇怪 / 暴露内部语境 / 让维护者难堪？**
+
+manmankan 所有 commit / changelog / docs / 代码注释都是**永久公开档案**：
+
+- 一旦 push 到 `origin/main`，即使删除也会留底（GitHub forks / archive 镜像 / search index）
+- 一旦发布到 PyPI，包内 metadata（含 README / CHANGELOG）**完全无法修改**，只能 yank
+
+---
+
+## 2. 禁用词表（绝对红线 · 任何公开输出禁止出现）
+
+### 2.1 维护者私人称谓 / 昵称
+- 任何在 GitHub 公开身份页之外的称呼
+- 不在公开介绍出现的称谓 / 项目内部口语化称呼
+
+**必用替代**：用户 / 维护者 / 开发者
+
+### 2.2 维护者其他工作区 / 项目代号
+- 任何**本仓库 README 未公开介绍**的兄弟项目名
+- 内部工作区代号 / 私有 git 仓库代号
+
+**必用替代**：完全不引用（manmankan 是独立项目）
+
+### 2.3 AI 工具自身署名
+- `Claude` / `Codex` / `GitHub Copilot` / `Cursor` / `Plan agent` / `Plan subagent` / `Explore agent`
+- `claude.com/claude-code` 等 AI 工具 promo 链接
+- `🤖 Generated with [Claude Code](...)` 等 AI 生成标记
+- `Co-authored-by: Claude` / `Co-authored-by: <任何 AI 工具>` 等 trailer
+
+**必用替代**：完全删除 attribution，由 maintainer 统一署名
+
+### 2.4 AI 协作过程语境
+- `audit-must-user-test` / `audit 漏判` / `user-test 漏判` 等内部协作过程词
+- `LOCKED 准则` / `LOCKED 工作流` / 内部 ADR 编号
+- `合伙人 mode` / `主会话` / `subagent` 等 AI 协作架构语
+- 私有 memory 文件名引用（`feedback_xxx.md` / `project_xxx.md` 等）
+- `用户拍板` / `维护者拍板` / `和 X 讨论` / `X 建议` 类 attribution
+
+**必用替代**：直接陈述结论 / 用通用工程语言（"测试" / "实测" / "已确认"）
+
+### 2.5 维护者个人 / 账户信息
+- 持仓金额 / 账户底子 / 资产规模
+- 维护者其他平台账号 / 私有 alias
+
+**必用替代**：完全零提及
+
+### 2.6 跨项目语境（其他赛道 / 其他项目）
+- 任何不属于 manmankan 项目本身的策略 / 监管 / 平台名称
+
+**必用替代**：完全零提及（manmankan 边界 = A 股自选股 CLI 工具）
+
+---
+
+## 3. 公开输出规范
+
+### 3.1 Commit message
+- Conventional Commits 格式（`feat:` / `fix:` / `docs:` / `refactor:` / `test:` / `chore:`）
+- subject 简洁描述「做了什么」（用户视角）
+- body 描述「why + how」· **不写**「谁建议 / 谁审 / 谁拍板」
+- **绝对不带** `Co-authored-by: <AI>` trailer
+- **绝对不带** `🤖 Generated with <AI>` 类签名行
+- **绝对不带** AI 工具的 promo 链接
+
+❌ 反例：
+```
+fix(scan): 大 watchlist 卡死
+
+Co-authored-by: Claude Opus 4.7 (1M context)
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+```
+
+✅ 正例：
+```
+fix(scan): 大 watchlist 卡死体验 · 并发 + 进度条
+
+v0.3.0 串行拉取 172 只可能阻塞 ≥ 9 分钟无反馈。
+fetch_batch 改用 ThreadPoolExecutor (默认并发 5) · 总时间降到 ~30-90s。
+加 rich.Progress 进度条 · 实时显示进度 % + 已用时间。
+```
+
+### 3.2 CHANGELOG.md
+- **用户视角**：用户能感知到什么变化、为什么需要
+- "Why" 段写**用户痛点**或**技术原因**，不写**与谁讨论**
+- 涉及隐私 / 用语修复的 entry，用中性表述（"措辞规范化"），**不**暗示被修复内容的性质（避免 Streisand 效应引诱读者翻 PyPI 旧版）
+
+❌ 反例：「v0.X.Y 含项目内部私人称谓」「audit 漏判教训」「[audit-must-user-test] LOCKED 准则」
+✅ 正例：「CHANGELOG / docs 措辞规范化」「测试覆盖漏判」「「真实规模 + 错误路径」必须纳入发布前测试」
+
+### 3.3 设计文档 / Roadmap
+- 不写"X agent 产出 + Y 整理 + Z 拍板" 等 AI 协作脚注
+- 不引用内部 LOCKED memory 名 / 内部 feedback 文件名
+- 角色名用通用工程角色：「维护者」/「代码审查者」/「实施评审」
+- 不用：`Plan agent` / `Claude` / `subagent` / `PM 角色` / `架构师角色`
+
+### 3.4 代码注释
+- 解释 why（非平凡决策 / 隐藏约束 / 已知坑）
+- ❌ "Claude 建议" / "和维护者讨论后" / "audit step #N" / 私有 memory 引用 / LOCKED 准则名
+- ✅ "akshare push2his 对部分 IP 段持续封禁 · retry 无效 · 改 fallback 顺序"
+
+### 3.5 PR 描述 / Issue 评论
+- 同 commit message 规范
+- 不暴露内部 sprint 视角
+
+---
+
+## 4. 发布前自检（强制）
+
+### 4.1 一次性配置 git pre-commit hook（推荐）
+
+```bash
+git config core.hooksPath .githooks
+```
+
+启用后每次 `git commit` 自动跑禁用词扫描 + ruff lint。
+
+### 4.2 手动跑
+
+```bash
+bash scripts/check-privacy-leaks.sh
+```
+
+非零退出 = 立即停止 + 修完再 commit。
+
+### 4.3 release 前 checklist
+
+- [ ] `bash scripts/check-privacy-leaks.sh` 通过
+- [ ] 检查 `git log --pretty=full <last-tag>..HEAD` 无 AI co-author trailer
+- [ ] 检查 CHANGELOG 对应版本段无内部协作过程词
+- [ ] PyPI metadata（pyproject.toml description / keywords）干净
+
+---
+
+## 5. 不可逆操作的特殊责任
+
+### 5.1 PyPI 发布
+PyPI wheel/sdist **完全不可修改**，只能 yank（标记弃用，元数据永久存档）。release 前的隐私审查 = **一次性最高责任**动作。
+
+### 5.2 GitHub commit history rewrite
+`git filter-repo` + `git push --force` 可清掉历史泄漏，但：
+- 破坏所有 fork / clone（contributors 必须重新拉）
+- 已被搜索引擎 / GitHub archive / 镜像收录的页面留底
+
+### 5.3 AI assistant 行为约束
+未由维护者明确指示前，**绝不**自主执行：
+- `git push --force` / `git push --force-with-lease` 到 main
+- `git filter-repo` / `git filter-branch` 重写历史
+- `pypi yank` / `twine yank` 任何已发布版本
+- 删除已发布 git tag
+
+---
+
+## 6. AI 工具署名问题（明确立场）
+
+GitHub 业界惯例支持 `Co-authored-by: <AI tool>` trailer · **本仓库明确不采用**：
+
+- AI 工具是维护者使用的**实现工具**，不是独立 contributor
+- AI 工具 footprint 出现在公开 commit history = AI 协作上下文泄漏
+- 维护者对所有 commit 内容**完全负责**，不需要 AI 共同署名分担
+
+**结论**：所有 commit / PR / release notes 中**零提及任何 AI 工具名**。由 maintainer (`piklen`) 统一署名。
+
+---
+
+## 7. 发现泄漏的处理
+
+### 7.1 已发现但未 commit
+直接修复 + 不带 attribution 重新 commit。
+
+### 7.2 已 commit 但未 push
+- `git commit --amend` 或 `git rebase -i HEAD~N` 重写本地历史
+- 重写时不能引入新 AI co-author trailer
+
+### 7.3 已 push 到 GitHub 但未发版
+- 优先：fix-forward 加新 commit 修复
+- 严重时：`git filter-repo` rewrite history + force push（**必须** maintainer 明确批准）
+
+### 7.4 已发布到 PyPI
+- PyPI 包**完全不可改**
+- 修复版本：patch bump（如 v0.3.3.4 → v0.3.3.5）
+- 严重泄漏：`pypi yank <package>==<version>` 标记弃用
+
+---
+
+## 8. 这份纪律的来源
+
+2026-05-10 maintainer 全面 audit 发现 v0.3.3.x 系列含 AI 协作上下文 + 内部代号 + 内部私人语境。修复后立纪律防再犯。
+
+---
+
+**违反本文件任何一条 = 视为 P0 issue**
+
+*Last updated: 2026-05-10*

manmankan-0.0.1/CONTRIBUTING.md

@@ -0,0 +1,97 @@
+# 贡献指南
+
+感谢你对慢慢看的兴趣！
+
+## 开发环境
+
+要求 Python 3.11+，推荐使用 [uv](https://docs.astral.sh/uv/)：
+
+```bash
+git clone https://github.com/piklen/manmankan.git
+cd manmankan
+uv sync
+```
+
+## 运行测试
+
+```bash
+uv run pytest
+uv run pytest --cov=kan          # 带覆盖率
+```
+
+## 代码风格
+
+- 使用 [ruff](https://docs.astral.sh/ruff/) 做 lint 和格式化：`uv run ruff check kan/`
+- 类型注解：所有公开函数应有类型注解
+- 命名：小写 + 下划线
+- Pydantic v2 用于数据模型
+
+## 合规红线（重要）
+
+本项目严格定位为**行情数据展示工具**，PR 不应引入任何形式的：
+
+- 买卖建议 / 评分评级 / 策略推荐
+- 涨跌预测 / 目标价
+- "建议关注 / 低估 / 见底 / 抄底"等暗示性词汇
+
+详见 [`docs/compliance.md`](docs/compliance.md)。
+
+## 提交流程
+
+1. Fork 本仓库
+2. 创建功能分支：`git checkout -b feat/your-feature`
+3. 提交改动：`git commit -m "feat: ..."`
+4. 推送到 fork：`git push origin feat/your-feature`
+5. 在 GitHub 上发起 Pull Request
+
+## Commit Message 规范
+
+```
+feat: 新功能
+fix: 修复 bug
+docs: 文档变更
+refactor: 重构（不改变功能）
+test: 测试相关
+chore: 构建/依赖等杂项
+```
+
+**用户视角**：commit message 描述用户能感知到的变化，不暴露内部协作过程 / 私人语境 / sprint 视角。
+
+⚠️ **不带 AI co-author trailer / 不带 AI 工具签名行** —— 详见 [`CLAUDE.md`](CLAUDE.md) §3.1。
+
+## 公开输出语言规范
+
+manmankan 是公开开源项目，所有 commit / changelog / docs / 代码注释都是**永久公开档案**。
+
+详细禁用词表 + 中性词替代见 [`CLAUDE.md`](CLAUDE.md)（AI 协作纪律 · 人类 contributor 也适用）。
+
+发布前必跑禁用词扫描：
+
+```bash
+bash scripts/check-privacy-leaks.sh
+```
+
+或一次性启用 git pre-commit hook：
+
+```bash
+git config core.hooksPath .githooks
+```
+
+## AI 协助开发
+
+如果你用 AI 编程助手协助开发：
+
+- 必须先阅读 [`CLAUDE.md`](CLAUDE.md) 中的公开输出规范 + 禁用词表
+- AI 生成的 commit message 不加 AI co-author trailer 和 AI 工具签名行
+- AI 生成的代码注释 / 文档不暴露 AI 协作过程
+- 提交前跑 `bash scripts/check-privacy-leaks.sh` 自检
+
+## 报告问题
+
+通过 [GitHub Issues](https://github.com/piklen/manmankan/issues) 报告 bug 或提出功能建议。
+
+请提供：
+- 复现步骤
+- 期望行为 vs 实际行为
+- Python 版本、操作系统
+- 相关日志或截图

manmankan-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 piklen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.