oschina — read & draft on 开源中国 via your own cookies
Drives the user's real 开源中国 account through the same
apiv1.oschina.net endpoints the site uses, authenticated by the login cookie
they captured with the ACE extension. No browser, no third-party deps — just
urllib.
The connector injects the cookie jar as a JSON env var $OSCHINA_COOKIES.
Never print it.
python3 "$SKILL_DIR/scripts/oschina.py" whoami
If $SKILL_DIR points at a different skill loaded in the same turn, resolve
this skill's directory explicitly before running the commands below.
Important: draft only
开源中国 has no public publish API. Every open-source client for this platform (including the upstream adapter this skill is modelled on) stops at draft creation. This skill does the same: it saves the Markdown as a draft and returns the editor URL. Tell the user plainly that they must open that URL and click publish themselves — do not claim the article was published.
Verify the connection first
python3 "$SKILL_DIR/scripts/oschina.py" whoami
If this fails with an auth error, the cookie has expired. Ask the user to
reconnect at https://studio.acedata.cloud/console/connectors rather than retrying.
Create a draft — GATED
Prepare the complete Markdown in a file. The first call is always a dry run and does not write anything.
# Dry run — shows exactly what would be written.
python3 "$SKILL_DIR/scripts/oschina.py" draft \
--title "标题" --content-file /tmp/article.md
# Actually create the draft after the user confirms.
python3 "$SKILL_DIR/scripts/oschina.py" draft \
--title "标题" --content-file /tmp/article.md --confirm
--confirm is valid only as the final argument. Show the title and full
content to the user before writing.
Gotchas
- Content is sent as Markdown (
contentType: 1). Do not pre-render it to HTML. - Images referenced by external URL are not re-hosted. If the source host blocks hotlinking they will not render; mention this when the article has images.
--catalogtakes a 开源中国 catalog id; the default0uses the account's default catalog. If the API rejects the catalog, ask the user for the right id rather than guessing.- Do not retry a timed-out write automatically — the outcome may be unknown and a retry can create a duplicate draft.
Record the output
This skill only produces drafts, so do not call publish_artifact. Report
the returned draft_id and edit_url to the user instead.