1531263bd2
A writer with a tall panel does not want to shrink it from the left edge: what
they know is "this one is too tall". The format had a width and nothing else, so
the only way to make a figure shorter was to guess a percentage and check the
page — and the previous commit's answer, "type 638px", asked them to do the
arithmetic themselves.
So `{height=300px}` joins `{width=…}`, in the same attribute block, and the
editor grows a second box beside the first. Both are typeable as well as
pre-set, both write through the reader's own parse function, and the hint beside
them says what the picture will measure on the page.
Three rules, and the point of all three is that a figure cannot be stretched:
* **a width is exact, a height is a cap.** A width has a reference — the column,
or a length the writer chose — while nothing measures a height against
anything, and enlarging a picture past its own pixels only makes it soft. In
the flow of a sentence a height is always a downscale, which comes to the same
thing as exact.
* **given one, the other follows from the picture's own shape** — `max-height`
for a height, `width` for a width — so the height is never written by hand.
* **given both, they are a box to fit inside**, not a box to fill. Two numbers
that need not have the picture's proportions can only mean "no bigger than",
and the check asserts the drawn rectangle still matches the file's ratio.
Whichever box is left empty keeps the other's setting, so a size can be set in
two steps, and clearing either goes back to the natural size.
`check-image.mjs`: 26 checks to 36. Two of the new ones found real bugs while
being written. The first: with both a width and a height in one `{…}` block,
neither side parsed — the patterns were anchored to the whole block, so a figure
with two numbers silently printed at its natural size. The attribute block is now
split into declarations first. The second was mine: returning "contain" for a
height-only figure left a 1276×2000 box around a small picture, which the caption
then sat under. A height is a cap, and a cap needs no contain.
The MCP tool takes the same two arguments, so a model can write either number,
and a percentage height is refused with the reason it cannot work: a sentence is
flowed text, so there is nothing for it to be a percentage of and the browser
ignores it. v8 is deployed and DSH has verified both numbers round-tripping.
215 lines
7.3 KiB
YAML
215 lines
7.3 KiB
YAML
# paper-doc MCP server: ConfigMap, Deployment, Service.
|
|
#
|
|
# The REST API and the MCP server are the same image with different commands.
|
|
# Only the MCP server is deployed here, because that is what a client connects
|
|
# to; the API is described in a commented block at the end of this file rather
|
|
# than deployed, so that turning it on is a decision rather than a surprise.
|
|
#
|
|
# The database is TiDB, already running in this cluster as `tidb-tidb.tidb:4000`
|
|
# — the in-cluster Service, not the 32738 NodePort the host uses. Both reach the
|
|
# same rows; the Service is the one that survives the node's address changing.
|
|
---
|
|
apiVersion: v1
|
|
kind: ConfigMap
|
|
metadata:
|
|
name: paper-doc-config
|
|
namespace: paper-doc
|
|
labels:
|
|
app.kubernetes.io/name: paper-doc
|
|
data:
|
|
DB_HOST: tidb-tidb.tidb
|
|
DB_PORT: "4000"
|
|
DB_NAME: paper_doc
|
|
APP_NAME: paper-doc API
|
|
DEBUG: "false"
|
|
# Object storage for the images a paper embeds (MinIO, in its own namespace).
|
|
# The in-cluster Service, not the host's NodePort 30090: same bucket, and the
|
|
# address survives the node changing. The credentials live in the Secret —
|
|
# without them `image_upload` answers 「图片存储还没有配置好」 and names the
|
|
# variables, while every writing tool keeps working.
|
|
MINIO_ENDPOINT: http://minio.minio.svc.cluster.local:9000
|
|
MINIO_BUCKET: paper-images
|
|
MINIO_REGION: us-east-1
|
|
# The container's own defaults, restated here because the Deployment is where
|
|
# a reader looks for them.
|
|
MCP_TRANSPORT: http
|
|
MCP_HOST: 0.0.0.0
|
|
MCP_PORT: "8931"
|
|
MCP_PATH: /mcp
|
|
---
|
|
apiVersion: apps/v1
|
|
kind: Deployment
|
|
metadata:
|
|
name: paper-doc-mcp
|
|
namespace: paper-doc
|
|
labels:
|
|
app.kubernetes.io/name: paper-doc
|
|
app.kubernetes.io/component: mcp
|
|
spec:
|
|
# One replica. The server is stateless — every tool opens its own database
|
|
# session and closes it — so scaling is safe, but a second replica would only
|
|
# add connections to TiDB without adding throughput a model can use.
|
|
replicas: 1
|
|
strategy:
|
|
type: RollingUpdate
|
|
rollingUpdate:
|
|
maxSurge: 1
|
|
maxUnavailable: 0
|
|
selector:
|
|
matchLabels:
|
|
app.kubernetes.io/name: paper-doc
|
|
app.kubernetes.io/component: mcp
|
|
template:
|
|
metadata:
|
|
labels:
|
|
app.kubernetes.io/name: paper-doc
|
|
app.kubernetes.io/component: mcp
|
|
spec:
|
|
imagePullSecrets:
|
|
- name: aliyun-acr
|
|
securityContext:
|
|
runAsNonRoot: true
|
|
runAsUser: 10001
|
|
fsGroup: 10001
|
|
seccompProfile:
|
|
type: RuntimeDefault
|
|
containers:
|
|
- name: mcp
|
|
image: registry.cn-hangzhou.aliyuncs.com/mcp_skill/paper-doc-mcp:v8
|
|
imagePullPolicy: IfNotPresent
|
|
ports:
|
|
- name: http
|
|
containerPort: 8931
|
|
envFrom:
|
|
- configMapRef:
|
|
name: paper-doc-config
|
|
env:
|
|
- name: DB_USER
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: paper-doc-secrets
|
|
key: DB_USER
|
|
- name: DB_PASSWORD
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: paper-doc-secrets
|
|
key: DB_PASSWORD
|
|
# Without it the HTTP transport is unauthenticated. The server warns
|
|
# on stderr when it binds a non-loopback address and finds no token,
|
|
# which is the only signal a reader gets that this key is missing.
|
|
- name: MCP_HTTP_TOKEN
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: paper-doc-secrets
|
|
key: MCP_HTTP_TOKEN
|
|
# The object store's credentials. A key scoped to this one bucket is
|
|
# enough: the bucket is created on the first upload, so nothing has
|
|
# to be provisioned by hand before the first figure goes in.
|
|
- name: MINIO_ACCESS_KEY
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: paper-doc-secrets
|
|
key: MINIO_ACCESS_KEY
|
|
- name: MINIO_SECRET_KEY
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: paper-doc-secrets
|
|
key: MINIO_SECRET_KEY
|
|
# Readiness asks the database; liveness does not. A TiDB blip should
|
|
# take the pod out of the Service's endpoints and put it back when the
|
|
# blip ends — not restart a process that is working correctly.
|
|
readinessProbe:
|
|
httpGet:
|
|
path: /readyz
|
|
port: http
|
|
initialDelaySeconds: 5
|
|
periodSeconds: 10
|
|
timeoutSeconds: 5
|
|
failureThreshold: 3
|
|
livenessProbe:
|
|
httpGet:
|
|
path: /healthz
|
|
port: http
|
|
initialDelaySeconds: 10
|
|
periodSeconds: 30
|
|
timeoutSeconds: 5
|
|
failureThreshold: 3
|
|
resources:
|
|
requests:
|
|
cpu: 50m
|
|
memory: 128Mi
|
|
limits:
|
|
cpu: 1000m
|
|
memory: 512Mi
|
|
securityContext:
|
|
allowPrivilegeEscalation: false
|
|
readOnlyRootFilesystem: true
|
|
capabilities:
|
|
drop: ["ALL"]
|
|
volumeMounts:
|
|
- name: tmp
|
|
mountPath: /tmp
|
|
volumes:
|
|
- name: tmp
|
|
emptyDir: {}
|
|
---
|
|
apiVersion: v1
|
|
kind: Service
|
|
metadata:
|
|
name: paper-doc-mcp
|
|
namespace: paper-doc
|
|
labels:
|
|
app.kubernetes.io/name: paper-doc
|
|
app.kubernetes.io/component: mcp
|
|
spec:
|
|
# NodePort, not ClusterIP: the clients that matter here are not in the
|
|
# cluster. The Harness, Claude Code and Codex all run on the node or on a
|
|
# machine on the LAN, and `http://192.168.1.88:30931/mcp` is the same address
|
|
# from both. In-cluster callers use the ClusterIP on port 8931.
|
|
type: NodePort
|
|
selector:
|
|
app.kubernetes.io/name: paper-doc
|
|
app.kubernetes.io/component: mcp
|
|
ports:
|
|
- name: http
|
|
port: 8931
|
|
targetPort: http
|
|
nodePort: 30931
|
|
|
|
# --- the REST API, if you want it in the cluster too -------------------------
|
|
#
|
|
# Same image, different command; it needs no MCP_HTTP_TOKEN and answers on 8000.
|
|
# The schema has to exist before the API serves it, which is what the init
|
|
# container is for:
|
|
#
|
|
# ---
|
|
# apiVersion: apps/v1
|
|
# kind: Deployment
|
|
# metadata:
|
|
# name: paper-doc-api
|
|
# namespace: paper-doc
|
|
# spec:
|
|
# replicas: 1
|
|
# selector:
|
|
# matchLabels: {app.kubernetes.io/name: paper-doc, app.kubernetes.io/component: api}
|
|
# template:
|
|
# metadata:
|
|
# labels: {app.kubernetes.io/name: paper-doc, app.kubernetes.io/component: api}
|
|
# spec:
|
|
# imagePullSecrets: [{name: aliyun-acr}]
|
|
# initContainers:
|
|
# - name: migrate
|
|
# image: registry.cn-hangzhou.aliyuncs.com/mcp_skill/paper-doc-mcp:v8
|
|
# command: ["alembic", "upgrade", "head"]
|
|
# envFrom: [{configMapRef: {name: paper-doc-config}}]
|
|
# env: [...] # the same secret keys as above; the MinIO
|
|
# # pair is what lets the API serve the figures
|
|
# containers:
|
|
# - name: api
|
|
# image: registry.cn-hangzhou.aliyuncs.com/mcp_skill/paper-doc-mcp:v8
|
|
# command: ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
|
|
# ports: [{name: http, containerPort: 8000}]
|
|
# envFrom: [{configMapRef: {name: paper-doc-config}}]
|
|
# env: [...]
|
|
# readinessProbe: {httpGet: {path: /api/health, port: http}}
|